Criar uma conversa
Crie uma conversa para armazenar e recuperar o estado da conversa em chamadas da API de Resposta.
Autorizações
Gateway auth: send Authorization: Bearer <mka1-api-key>. For multi-user server-side integrations, you can also send X-On-Behalf-Of: <external-user-id>.
Cabeçalhos
Optional external end-user identifier forwarded by the API gateway.
Corpo
Itens iniciais para incluir no contexto da conversa. Máx. 20 itens por vez.
20Item de mensagem de entrada: Uma mensagem com papel e conteúdo. Use isso para turnos de usuário, assistente, sistema ou desenvolvedor em entradas estruturadas.
- Input message item
- Output message item
- Output audio item
- File search call item
- Computer call item
- Computer call output item
- Web search call item
- Function call item
- Function call output item
- Reasoning item
- Image generation call item
- Code interpreter call item
- Local shell call item
- Local shell call output item
- Shell call item
- Shell call output item
- MCP list tools item
- MCP approval request item
- MCP approval response item
- MCP call item
- Custom tool call item
- Custom tool call output item
- Item reference item
- Compaction item
Conjunto de 16 pares chave-valor para armazenar informações adicionais.
Resposta
OK
O ID único da conversa
O tipo de objeto, sempre 'conversa'
Timestamp Unix de quando a conversa foi criada
Timestamp Unix de quando a conversa foi excluída suavemente, ou nulo se não foi excluída.
Conjunto de 16 pares chave-valor. Chaves com no máximo 64 caracteres, valores com no máximo 512 caracteres.
Identidade do proprietário da conversa. Pode ser um hash SHA256 ou userId:externalUserId bruto, dependendo do MODO_DE_IDENTIDADE.