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,
minConfidencee a opçãoothertransformam as respostas emcontinue,block,escalateoufallback— 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
- O seu servidor lê a delegação de uma decisão publicada:
GET /v1/decisions/{slug}/openai-live. - Ele coloca
delegationna 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. - A sessão envia
session.delegation.created: guardedelegation.id, para reconhecer os eventos dessa delegação. - Cada vez que a sessão decide, ela envia
decision.completedcom asanswers. - O seu servidor posta essas respostas em
POST /v1/decisions/{slug}/openai-live/answerse recebe a mesma resposta de uma execução:result,confidence,action,action_reason,destinationsemetrics.
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.
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
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 }),
});
}
}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.triggerscomsession.input_transcript.deltaousession.output_transcript.deltadeixa 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"emetrics.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.
Moderação de imagens
Confira uma foto enviada por um usuário antes de ir ao ar — conteúdo impróprio, spam e se ela combina com a legenda — e bloqueie ou escale, com o template Moderação de imagens.
Escrevendo boas perguntas
Formule instruções, opções e critérios que o Jev responde com confiabilidade — redação literal, matemática e datas no código, menos indireção, um estado filtrado, ordem das opções e nada de gerar texto.