Saltar para a documentação
Servidor MCP

Conversas com o assistente

As conversas com o assistente na aplicação.

Ferramentas de conversas com o assistente

FerramentaO que faz
listChatsAs conversas com o assistente na aplicação, das mais recentes para as mais antigas, com os seus títulos e quantas mensagens tem cada uma. query pesquisa nos títulos. Devolvidas uma página de cada vez.
getChatUma conversa pelo seu id.
renameChatDar um novo título a uma conversa.
deleteChatEliminar de vez uma conversa e cada mensagem que contém. Nada do que o assistente fez na caixa de correio é desfeito.

Só o proprietário do espaço de trabalho chega às conversas, através de um cliente ligado com todos os endereços. Ler precisa de threads:read e alterar de threads:write.

O assistente da aplicação não tem estas ferramentas, por isso uma conversa nunca muda de nome nem se elimina a si própria.

Referência

listChats

Âmbitosthreads:readApenas no MCP, não no assistente da appConjunto de ferramentascore

The conversations held with the assistant in the OpenEmail app, as its Chats page lists them, newest first, each with its title, id and how many messages it holds. query searches the titles. Only the workspace owner reaches them. One page at a time: when more follow, the last line gives a cursor to pass back for the next page.

Entradas

querystring
Até 200 caracteres
sortstring
Um de"newest""oldest""title"
limitinteger
Pelo menos 1No máximo 100
cursorstring
De 1 a 2048 caracteres

Também disponível em

API
GET /chats
SDK
chats.list()chats.listAll()chats.iterate()

getChat

Âmbitosthreads:readApenas no MCP, não no assistente da appConjunto de ferramentascore

One chat with the assistant by its id: its title, how many messages it holds and when it last changed.

Entradas

idstringObrigatório
Não vazio

Também disponível em

API
GET /chats/{id}
SDK
chats.get()

renameChat

Âmbitosthreads:writeApenas no MCP, não no assistente da appConjunto de ferramentascore

Give a chat with the assistant a new title.

Entradas

idstringObrigatório
Não vazio
titlestringObrigatório
De 1 a 120 caracteres

Também disponível em

API
PATCH /chats/{id}
SDK
chats.rename()

deleteChat

Âmbitosthreads:writeApenas no MCP, não no assistente da appConjunto de ferramentascore

Delete a chat with the assistant and every message in it, for good. Nothing it did in the mailbox is undone. Ask the person first.

Entradas

idstringObrigatório
Não vazio

Também disponível em

API
DELETE /chats/{id}
SDK
chats.delete()