Saltar para o conteúdo principal
Use o recurso Responses quando quiser que a API MKA1 retorne texto. Comece com uma string simples para prompts diretos. Use itens de mensagem quando precisar de roles explícitos ou estado de conversa.

​
Enviar um prompt simples

Passe uma string em input para uma requisição de turno único. A resposta inclui o texto gerado em output_text. 
import { SDK } from '@meetkai/mka1';

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

const result = await mka1.llm.responses.create({
  model: 'meetkai:functionary-urdu-mini-pak',
  input: 'Write a one-sentence summary of the MKA1 API.',
}, { headers: { 'X-On-Behalf-Of': '<end-user-id>' } });
Se voce nao estiver agindo em nome de um usuario final, omita X-On-Behalf-Of.

​
Adicionar instrucoes

Use instructions para definir o comportamento antes que o modelo veja a entrada do usuario. Mantenha as instrucoes curtas e especificas. 
const result = await mka1.llm.responses.create({
  model: 'meetkai:functionary-urdu-mini-pak',
  instructions: 'You are a support assistant. Reply in plain English. Keep answers under 80 words.',
  input: 'Explain what embeddings are used for.',
});

​
Enviar mensagens estruturadas

Use um array de itens de mensagem em input quando quiser roles explicitos. Cada item de mensagem usa type, role e content. 
const result = await mka1.llm.responses.create({
  model: 'meetkai:functionary-urdu-mini-pak',
  input: [
    { type: 'message', role: 'developer', content: 'Answer as a technical writer. Keep the reply concise.' },
    { type: 'message', role: 'user', content: 'Draft a short product update about faster response times.' },
  ],
});
Esse padrao e util quando voce quer que o corpo da requisicao carregue o historico de mensagens diretamente.

​
Continuar uma troca de multiplos turnos

Use previous_response_id para continuar a partir de uma resposta anterior sem reenviar o historico completo. 
const second = await mka1.llm.responses.create({
  model: 'meetkai:functionary-urdu-mini-pak',
  previousResponseId: 'resp_123',
  input: 'Now turn that into an email subject line.',
});
Se voce precisar de um container de conversa reutilizavel, crie um com o recurso Conversations e entao passe o ID da conversa em conversation. 
const conv = await mka1.llm.conversations.create({
  metadata: { session_id: 'web-42' },
});

const result = await mka1.llm.responses.create({
  model: 'meetkai:functionary-urdu-mini-pak',
  conversation: conv.id,
  input: 'What should I ask next to refine this draft?',
});
Consulte as paginas de Conversations e Responses na Referencia da API para ver o fluxo completo do recurso.

​
Transmitir texto conforme e gerado

Defina stream como true para receber eventos server-sent em vez de esperar pela resposta completa. 
import { CreateAcceptEnum } from '@meetkai/mka1/sdk/responses';

const result = await mka1.llm.responses.create({
  model: 'meetkai:functionary-urdu-mini-pak',
  input: 'Write three release notes bullets for our docs update.',
  stream: true,
}, { acceptHeaderOverride: CreateAcceptEnum.TextEventStream });
Use streaming quando quiser renderizar a saida parcial conforme ela chega.

​
Proximos passos