GPT-Live (voz em tempo real)

Faça uma sessão de voz do GPT-Live da OpenAI perguntar as perguntas de uma decisão publicada enquanto o usuário fala, e rode as políticas, os destinos e o log da decisão sobre as respostas.

Objetivo: um assistente de voz feito com o GPT-Live, a voz em tempo real da OpenAI, precisa decidir durante a ligação — rotear quem liga, qualificar um lead, barrar um pedido arriscado. O GPT-Live pode delegar essas decisões à OpenAI Decisions enquanto o usuário fala. A Dcision entrega a essa delegação as perguntas da sua decisão publicada e transforma as respostas numa ação, com as suas políticas, os seus destinos e o log de execuções.

Por que passar pela Dcision

O GPT-Live responde rápido porque a decisão acontece dentro da sessão de voz. A Dcision acrescenta o que a sessão não guarda:

  • Perguntas versionadas. A sessão faz as perguntas da versão publicada — as mesmas que a API, os webhooks e o servidor MCP rodam. Mude-as no editor e faça o deploy; nada a editar no código do app de voz.
  • Políticas. Regras, minConfidence e a opção other transformam as respostas em continue, block, escalate ou fallback — veja Políticas e ações.
  • Recusas. Uma pergunta que o modelo se recusa a responder recebe a ação de fallback da decisão, com action_reason: { "type": "refusal", "question": … }.
  • Destinos. Webhooks, funções, respostas fixas e os outros destinos disparam conforme o resultado.
  • Auditoria e estatísticas. Toda chamada vira uma execução em Execuções e entra na Visão geral da decisão.

Como funciona

  1. O seu servidor lê a delegação de uma decisão publicada: GET /v1/decisions/{slug}/openai-live.
  2. Ele coloca delegation na requisição da sessão do GPT-Live (WebRTC). O GPT-Live então chama a OpenAI Decisions por conta própria — delegação nativa — com essas perguntas.
  3. A sessão envia session.delegation.created: guarde delegation.id, para reconhecer os eventos dessa delegação.
  4. Cada vez que a sessão decide, ela envia decision.completed com as answers.
  5. O seu servidor posta essas respostas em POST /v1/decisions/{slug}/openai-live/answers e recebe a mesma resposta de uma execução: result, confidence, action, action_reason, destinations e metrics.

Mantenha a API key da Dcision no seu servidor: o navegador ou o celular que segura a sessão de voz nunca a vê.

Exporte a delegação

Publique a decisão primeiro — o endpoint responde 409 DECISION_NOT_DEPLOYED para um rascunho. Depois:

curl https://api.dcision.io/v1/decisions/lead-qualification/openai-live \
  -H "Authorization: Bearer $DCISION_API_KEY"

A resposta traz delegation — { "type": "decisions", "model": "gpt-6-luna", "questions": [ … ] } — e answers_url. Cada pergunta tem a chave da pergunta como name, as suas instructions e choices ou levels com as descrições. A resposta completa está na referência da API.

Abra a sessão Live

O código abaixo é ilustrativo: a requisição da sessão, o handshake WebRTC e os eventos seguem o guia do GPT-Live da OpenAI. Só delegation vem da Dcision.

Servidor: monte a requisição da sessão (ilustrativo)
const live = await fetch("https://api.dcision.io/v1/decisions/lead-qualification/openai-live", {
  headers: { Authorization: `Bearer ${process.env.DCISION_API_KEY}` },
}).then((response) => response.json());

const sessionRequest = {
  // …model, voice, instructions and the rest of your GPT-Live session settings
  delegation: live.delegation, // { type: "decisions", model, questions }
};

A chave OpenAI que abre a conexão Live precisa da permissão api.decisions.write.

Repasse as respostas

Eventos da sessão (ilustrativo)
let delegationId = null;

function onLiveEvent(event) {
  if (event.type === "session.delegation.created") delegationId = event.delegation.id;
  if (event.type === "decision.completed") {
    // Your server calls Dcision with its API key.
    fetch("/live/answers", {
      method: "POST",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify({ answers: event.answers }),
    });
  }
}
Servidor: aplique as respostas
app.post("/live/answers", async (request, response) => {
  const decision = await fetch("https://api.dcision.io/v1/decisions/lead-qualification/openai-live/answers", {
    method: "POST",
    headers: { Authorization: `Bearer ${process.env.DCISION_API_KEY}`, "Content-Type": "application/json" },
    body: JSON.stringify({ answers: request.body.answers }),
  }).then((res) => res.json());

  if (decision.action === "block") return response.json({ say: "I can't help with that one." });
  if (decision.action === "escalate") return response.json({ transfer: true, reason: decision.action_reason });
  return response.json({ route: decision.result.route });
});

Envie as respostas como o evento as traz: predicate, choice, score ou refusal, cada uma com o name da pergunta. Respostas que não batem com as perguntas publicadas — uma pergunta faltando, uma choice que não é uma opção — respondem 400 INVALID_REQUEST. Acrescente model e usage (input_tokens, output_tokens) quando os tiver; eles ficam registrados com a execução.

Acrescente contexto com state. O endpoint de respostas aceita um state opcional: os dados do próprio app durante a ligação — o id do cliente, o carrinho, a conta. Ele é validado contra o state schema da decisão e chega aos destinos ({{state.customer_id}}) e ao log de execuções. Para a sessão decidir também com esses dados, envie o mesmo retrato à sessão com decision.item.create.

Durante a sessão

  • Novas perguntas no meio da ligação. Depois de um deploy, exporte a delegação de novo e envie-a com session.update; uma ligação em andamento mantém as perguntas até lá.
  • Reaja à transcrição. session.triggers com session.input_transcript.delta ou session.output_transcript.delta deixa a sessão agir sobre o que está sendo dito — veja o guia da OpenAI.
  • Delegação customizada. Em vez da delegação nativa, o GPT-Live pode passar a decisão para o seu app. O seu app pode então chamar POST /v1/decisions/{slug} com a transcrição como estado; isso acrescenta uma ida e volta, mas roda em qualquer engine.

Cobrança e limites

  • Cada chamada ao endpoint de respostas é cobrada como uma execução: conta para as decisões incluídas no plano e depois usa créditos. Exportar a delegação é uma leitura e não é cobrado.
  • metrics.engine é "openai" e metrics.estimated_cost_usd é 0: a OpenAI cobra a sessão Live, decisões incluídas, na sua conta OpenAI.
  • A execução tem origem API, provedor OpenAI e credencial live. O modo sombra não roda sobre essas respostas.
  • O endpoint de respostas compartilha a janela de rate limit de decisões e não suporta Idempotency-Key: um retry roda — e é cobrado — de novo.

Nesta página