Saltar para o conteúdo principal
Use o recurso Conversations quando quiser que a API MKA1 mantenha o estado da conversa entre requisicoes de Responses. Isso e util para chats de multiplos turnos, threads de suporte e fluxos de trabalho onde voce deseja consultar ou editar o historico salvo posteriormente.

​
Criar uma conversa

Crie uma conversa primeiro. Voce pode anexar metadados para manter seu proprio contexto de sessao ou roteamento. 
import { SDK } from '@meetkai/mka1';

const mka1 = new SDK({
  bearerAuth: `Bearer ${YOUR_API_KEY}`,
});

const conv = await mka1.llm.conversations.create({
  metadata: {
    session_id: 'web-42',
    channel: 'support',
  },
}, { headers: { 'X-On-Behalf-Of': '<end-user-id>' } });
Se sua requisicao nao estiver vinculada a um usuario final especifico, omita X-On-Behalf-Of. Consulte o guia de autenticacao para ver o padrao completo.

​
Adicionar itens a conversa

Adicione um ou mais itens com POST /api/v1/llm/conversations/{conversation_id}/items. 
const items = await mka1.llm.conversations.createItems({
  conversationId: 'conv_abc123',
  createItemsRequest: {
    items: [
      {
        type: 'message',
        role: 'user',
        content: 'Summarize the latest support ticket.',
      },
    ],
  },
}, { headers: { 'X-On-Behalf-Of': '<end-user-id>' } });
Use este endpoint quando quiser escrever o historico explicitamente antes de chamar o recurso Responses.

​
Continuar o fluxo com o recurso Responses

Passe o ID da conversa na sua proxima requisicao de Responses. Isso permite que a API MKA1 utilize o estado salvo da conversa. 
const result = await mka1.llm.responses.create({
  model: 'meetkai:functionary-urdu-mini-pak',
  conversation: 'conv_abc123',
  input: 'Turn that summary into a customer-ready reply.',
});
Voce tambem pode continuar adicionando itens a mesma conversa conforme a troca avanca.

​
Ler, atualizar ou limpar uma conversa

Use os endpoints de Conversations para:
  • Listar conversas para a conta ou usuario final atual (GET /api/v1/llm/conversations).
  • Filtrar listas com after, limit, order, metadata e search.
  • Buscar uma conversa por ID (GET /api/v1/llm/conversations/{conversation_id}).
  • Atualizar metadados da conversa (POST /api/v1/llm/conversations/{conversation_id}).
  • Listar itens em uma conversa (GET /api/v1/llm/conversations/{conversation_id}/items).
  • Buscar um unico item (GET /api/v1/llm/conversations/{conversation_id}/items/{item_id}).
  • Excluir itens (individual ou em lote) via:
    • DELETE /api/v1/llm/conversations/{conversation_id}/items/{item_id}
    • DELETE /api/v1/llm/conversations/{conversation_id}/items com { "item_ids": ["item_..."] }
  • Excluir a conversa (DELETE /api/v1/llm/conversations/{conversation_id}).
Observacao: excluir uma conversa nao exclui seus itens. Use a aba Referencia da API para ver os formatos exatos de requisicao e resposta de cada operacao.

​
Quando usar conversas vs previous_response_id

Use uma conversa quando:
  • Voce quer um container reutilizavel para muitos turnos.
  • Voce precisa listar ou gerenciar itens salvos posteriormente.
  • Voce quer anexar metadados a thread em andamento.
Use previous_response_id quando:
  • Voce so precisa continuar a partir de uma resposta anterior.
  • Voce nao precisa de um recurso de conversa armazenado separadamente.
Para o padrao do lado da resposta, veja gerar uma resposta.