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": … }.
  • Назначения. Вебхуки, функции, фиксированные ответы и другие назначения срабатывают по результату.
  • Аудит и статистика. Каждый вызов — это выполнение в Выполнениях, и он учитывается в Обзоре решения.

Как это работает

  1. Ваш сервер читает делегирование опубликованного решения: GET /v1/decisions/{slug}/openai-live.
  2. Он кладёт delegation в запрос сессии GPT-Live (WebRTC). Затем GPT-Live сам вызывает OpenAI Decisions — нативное делегирование — с этими вопросами.
  3. Сессия отправляет session.delegation.created: сохраните delegation.id, чтобы распознавать события этого делегирования.
  4. Каждый раз, когда сессия принимает решение, она отправляет decision.completed с answers.
  5. Ваш сервер отправляет эти ответы в 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: повтор выполняется — и тарифицируется — заново.

На этой странице