GPT-Live(实时语音)
让 OpenAI GPT-Live 语音会话在用户说话时提出已部署决策的问题,然后在其回答上运行决策的策略、目的地和日志。
目标:基于 GPT-Live(OpenAI 的实时语音)构建的语音助手需要在通话过程中做出决定——为来电者分流、筛选潜在客户、阻止有风险的请求。GPT-Live 可以在用户说话时把这些决策委托给 OpenAI Decisions。Dcision 为这种委托提供你已部署决策的问题,并用你的策略、目的地和执行日志把回答转化为行动。
为什么要经过 Dcision
GPT-Live 之所以回答得快,是因为决策发生在语音会话内部。Dcision 补上了会话本身不保留的东西:
- 有版本的问题。会话提出的是已部署版本的问题——与 API、webhook 和 MCP 服务器运行的问题相同。在编辑器中修改并部署即可;语音应用的代码无需任何改动。
- 策略。规则、
minConfidence和other选项会把回答转化为continue、block、escalate或fallback——参见策略与行动。 - 拒绝回答。模型拒绝回答的问题会得到决策的 fallback 行动,并带有
action_reason: { "type": "refusal", "question": … }。 - 目的地。Webhook、函数、固定回复和其他目的地会根据结果触发。
- 审计与统计。每次调用都是执行记录中的一次执行,并计入决策的概览。
工作原理
- 你的服务器读取已部署决策的委托:
GET /v1/decisions/{slug}/openai-live。 - 它把
delegation放入 GPT-Live 会话请求(WebRTC)。随后 GPT-Live 会自己用这些问题调用 OpenAI Decisions——即原生委托。 - 会话发送
session.delegation.created:保存delegation.id,以识别这个委托的事件。 - 每当会话做出决策,它都会发送带有
answers的decision.completed。 - 你的服务器把这些回答发送到
POST /v1/decisions/{slug}/openai-live/answers,并得到与一次运行相同的响应:result、confidence、action、action_reason、destinations和metrics。
请把 Dcision API 密钥保存在你的服务器上:承载语音会话的浏览器或手机永远看不到它。
导出委托
先部署决策——对于草稿,该端点返回 409 DECISION_NOT_DEPLOYED。然后:
curl https://api.dcision.io/v1/decisions/lead-qualification/openai-live \
-H "Authorization: Bearer $DCISION_API_KEY"响应包含 delegation——{ "type": "decisions", "model": "gpt-6-luna", "questions": [ … ] }——以及 answers_url。每个问题都以问题的键作为 name,带有其 instructions,以及带描述的 choices 或 levels。完整响应见 API 参考。
打开 Live 会话
下面的代码仅作示意:会话请求、WebRTC 握手和事件均以 OpenAI 的 GPT-Live 指南为准。只有 delegation 来自 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 }
};打开 Live 连接的 OpenAI 密钥需要 api.decisions.write 权限。
转发回答
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 });
});按事件携带的原样发送回答:predicate、choice、score 或 refusal,每项都带有问题的 name。与已部署问题不匹配的回答——缺少某个问题、choice 不是可选项之一——会返回 400 INVALID_REQUEST。如果有 model 和 usage(input_tokens、output_tokens),请一并加入;它们会随执行一起记录。
用 state 添加上下文。回答端点接受可选的 state:通话期间应用自己的数据——客户 id、购物车、账户。它会根据决策的状态 schema 进行校验,并传递给目的地({{state.customer_id}})和执行日志。若想让会话也基于这些数据做决策,请通过 decision.item.create 把同一份快照发送给会话。
会话期间
- 通话中途的新问题。部署之后,重新导出委托并通过
session.update发送;正在进行的通话在此之前会保留原有问题。 - 对转录做出反应。搭配
session.input_transcript.delta或session.output_transcript.delta的session.triggers让会话可以对正在说的内容做出反应——参见 OpenAI 的指南。 - 自定义委托。GPT-Live 也可以不使用原生委托,而是把决策交给你的应用。你的应用随后可以把转录作为状态调用
POST /v1/decisions/{slug};这会多一次往返,但可以在任何引擎上运行。