Conversations (IRPCConversationOperations)
Stores conversations with Aino and their chat turns in the vault, per user.
| gRPC service | MFiles.IRPCConversationOperations |
|---|---|
| Book and level | Vault API, standard |
| Methods | 6 |
| Proto file | mfiles/IRPCConversationOperations.proto |
Overview
A per-user history store for chat-style features. A Conversation has a title and a type; its ChatTurns hold the exchanged messages as text that the server stores without interpreting it. The vault does not run any agent here: the caller writes what it wants to keep.
- Create or rename a conversation: AddOrUpdateConversation.
- Add or change a chat turn: AddOrUpdateChatTurn.
- Read: GetConversations, GetConversationById, GetChatTurns.
- Delete a conversation with its chat turns: DeleteConversationById.
All methods need a vault session and no special vault rights. A conversation belongs to the user who created it; reading, renaming or deleting another user's conversation fails with "Access is denied.". Administrators get no exception.
Paging. GetConversations and
GetChatTurns return at most 100 items,
newest first (descending sort_key). For the next page, send the smallest sort_key you
received; the server returns the items whose sort_key is less than it. 0 starts from the
newest. more_results is true while older items remain.
Methods
| Method | Summary | Facts |
|---|---|---|
| AddOrUpdateChatTurn | Adds a chat turn to one of the caller's conversations, or replaces the content of an existing chat turn. | write session |
| AddOrUpdateConversation | Creates a conversation, or renames an existing one of the caller. | write session |
| DeleteConversationById | Deletes one of the caller's conversations and all its chat turns. | write session |
| GetChatTurns | Gets the chat turns of one of the caller's conversations, newest first, up to 100 per call. | write session |
| GetConversationById | Gets one of the caller's conversations by ID. | write session |
| GetConversations | Gets the caller's conversations, newest first, up to 100 per call. | write session |