GPT-Live (голос в реальном времени)
Позвольте голосовой сессии OpenAI GPT-Live задавать вопросы опубликованного решения, пока пользователь говорит, а затем выполняйте на её ответах политики, назначения и журнал решения.
Цель: голосовой ассистент на GPT-Live, голосовом режиме OpenAI в реальном времени, должен принимать решения прямо во время звонка — маршрутизировать звонящего, квалифицировать лид, остановить рискованный запрос. GPT-Live может делегировать эти решения OpenAI Decisions, пока пользователь говорит. Dcision передаёт этому делегированию вопросы вашего опубликованного решения и превращает ответы в действие с вашими политиками, назначениями и журналом выполнений.
Зачем проходить через Dcision
GPT-Live отвечает быстро, потому что решение принимается внутри голосовой сессии. Dcision добавляет то, чего сессия не хранит:
- Версионированные вопросы. Сессия задаёт вопросы опубликованной версии — те же, что выполняют API, вебхуки и MCP-сервер. Измените их в редакторе и опубликуйте; в коде голосового приложения ничего править не нужно.
- Политики. Правила,
minConfidenceи вариантotherпревращают ответы вcontinue,block,escalateилиfallback— см. Политики и действия. - Отказы. Вопрос, на который модель отказывается отвечать, получает fallback-действие решения с
action_reason: { "type": "refusal", "question": … }. - Назначения. Вебхуки, функции, фиксированные ответы и другие назначения срабатывают по результату.
- Аудит и статистика. Каждый вызов — это выполнение в Выполнениях, и он учитывается в Обзоре решения.
Как это работает
- Ваш сервер читает делегирование опубликованного решения:
GET /v1/decisions/{slug}/openai-live. - Он кладёт
delegationв запрос сессии GPT-Live (WebRTC). Затем GPT-Live сам вызывает OpenAI Decisions — нативное делегирование — с этими вопросами. - Сессия отправляет
session.delegation.created: сохранитеdelegation.id, чтобы распознавать события этого делегирования. - Каждый раз, когда сессия принимает решение, она отправляет
decision.completedсanswers. - Ваш сервер отправляет эти ответы в
POST /v1/decisions/{slug}/openai-live/answersи получает тот же ответ, что и при запуске:result,confidence,action,action_reason,destinationsиmetrics.
Храните API-ключ Dcision на своём сервере: браузер или телефон, в котором идёт голосовая сессия, никогда его не видит.
Экспорт делегирования
Сначала опубликуйте решение — для черновика endpoint отвечает 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. От Dcision приходит только delegation.
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 }
};Ключу OpenAI, который открывает соединение Live, нужно разрешение 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. Endpoint ответов принимает необязательный state: собственные данные приложения во время звонка — id клиента, корзину, аккаунт. Он проверяется по схеме состояния решения и доходит до назначений ({{state.customer_id}}) и журнала выполнений. Чтобы сессия тоже принимала решения с учётом этих данных, отправьте тот же снимок в сессию через decision.item.create.
Во время сессии
- Новые вопросы посреди звонка. После публикации экспортируйте делегирование заново и отправьте его через
session.update; уже идущий звонок до этого момента сохраняет свои вопросы. - Реакция на транскрипт.
session.triggersсsession.input_transcript.deltaилиsession.output_transcript.deltaпозволяет сессии реагировать на то, что говорится, — см. руководство OpenAI. - Собственное делегирование. Вместо нативного делегирования GPT-Live может передать решение вашему приложению. Тогда приложение может вызвать
POST /v1/decisions/{slug}с транскриптом в качестве state; это добавляет один круг запроса, зато работает на любом движке.
Оплата и лимиты
- Каждый вызов endpoint'а ответов тарифицируется как запуск: он засчитывается в решения, включённые в тариф, а затем расходует кредиты. Экспорт делегирования — это чтение, и он не тарифицируется.
metrics.engineравен"openai", аmetrics.estimated_cost_usd—0: OpenAI выставляет счёт за сессию Live, включая решения, вашему аккаунту OpenAI.- У выполнения источник API, провайдер OpenAI и учётные данные live. Теневой режим на этих ответах не запускается.
- Endpoint ответов делит окно rate limit решений и не поддерживает
Idempotency-Key: повтор выполняется — и тарифицируется — заново.
Модерация изображений
Проверяйте загруженное пользователем фото до публикации — недопустимый контент, спам и соответствие подписи — и блокируйте или эскалируйте его с шаблоном Image Moderation.
Как писать хорошие вопросы
Инструкции, варианты и критерии, на которые Jev отвечает надёжно, — буквальные формулировки, математика и даты в коде, меньше косвенности, отфильтрованное состояние, порядок вариантов и без генерации текста.