Запуск решения

POST /v1/decisions/{slug} — путь, query-параметры, заголовки, тело запроса, все поля ответа и ошибки, с примерами на cURL, JavaScript и Python.

POST https://api.dcision.io/v1/decisions/{slug}

Запускает активную версию решения slug на состоянии и возвращает по одному типизированному ответу на каждый вопрос, уверенность каждого ответа, взвешенные уровни и композиты, действие, выбранное политиками решения, и — для решений с назначениями — что происходит дальше. На все вопросы отвечает один вызов движка.

Голосовая сессия GPT-Live, у которой ответы уже есть, вместо этого отправляет их в POST /v1/decisions/{slug}/openai-live/answers: те же политики, назначения и ответ, без вызова движка.

Запрос

Параметры пути

ПараметрОписание
slugSlug решения, который показан в редакторе и на вкладке Публикация — например, lead-qualification.

Query-параметры

ПараметрОписание
includeНеобязательный. probabilities добавляет в ответ полное распределение каждого вопроса. Значения через запятую; другие значения игнорируются.

Заголовки

ЗаголовокОбязательныйОписание
AuthorizationДаBearer dcs_live_… или Bearer dcs_test_… — см. Аутентификация.
Content-TypeДаapplication/json.
Idempotency-KeyНетОт 1 до 128 символов из A–Z a–z 0–9 . _ : -. В течение 24 часов повторно отдаёт сохранённый ответ успешного вызова — см. Идемпотентность.
X-Request-IDНетВаш ID корреляции (тот же набор символов). Возвращается в ответе и сохраняется вместе с выполнением.

Тело

{ "state": { "message": "We need pricing for 500 users and want to start next month.", "company_size": 500 } }
ПолеТипОписание
stateobject, string или arrayВход решения: объект для объектного состояния, непустая строка для текстового состояния, непустой массив (до 500 элементов) для состояния-списка. Проверяется по схеме состояния решения; необъявленные поля объекта принимаются и передаются движку. Поля image, audio и file принимают файл — см. Входные данные.

Остальные поля верхнего уровня игнорируются. Всё тело должно уместиться в 32 МБ (с запасом для файлов до 20 МБ каждый, 24 МБ в сумме); состояние без файлов должно уместиться в 128 КБ, а после чтения файлов — вместе с вопросами в бюджет токенов движка.

Примеры

curl -X POST https://api.dcision.io/v1/decisions/lead-qualification \
  -H "Authorization: Bearer $DCISION_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: lead-8421" \
  -d '{
    "state": {
      "message": "We need pricing for 500 users and want to start next month.",
      "company_size": 500,
      "source": "website"
    }
  }'

Решение с текстовым состоянием принимает строку:

curl -X POST https://api.dcision.io/v1/decisions/spam-detection \
  -H "Authorization: Bearer $DCISION_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "state": "Congratulations! You won a $1000 gift card, click here to claim now." }'

Решение с состоянием-списком принимает массив — здесь это переписка из чата для решения chat-triage, состояние которого — список строк:

curl -X POST https://api.dcision.io/v1/decisions/chat-triage \
  -H "Authorization: Bearer $DCISION_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "state": ["Hi!", "Can I get a quote for 50 seats?"] }'

Ответ

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
X-Request-ID: req_Qm8vT2kLx9Pw4Rz7Nc1B
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 59
X-RateLimit-Reset: 1791195060
{
  "decision_id": "dec_3fKq9ZtW1mXcV7bN2pLa",
  "execution_id": "exec_8HsT2kQw9ZyR4vMn1cXe",
  "schema": "lead-qualification",
  "version": 1,
  "result": {
    "purchase_intent": 0.9412,
    "priority": "high",
    "route": "sales"
  },
  "confidence": {
    "purchase_intent": 0.8824,
    "priority": 0.69,
    "route": 0.85
  },
  "scores": { "priority": 2.81 },
  "composites": { "lead_score": 0.8414 },
  "action": "continue",
  "action_reason": { "type": "default" },
  "metrics": {
    "latency_ms": 412,
    "engine": "jev",
    "model": "jev-1.13.0",
    "estimated_cost_usd": 0.00001575,
    "input_tokens": 375,
    "output_tokens": 36
  }
}
ПолеТипОписание
decision_idstringID решения (dec_…).
execution_idstringID этого запуска (exec_…), по нему можно искать в разделе Выполнения и через GET /v1/executions.
schemastringSlug решения.
versionintegerОпубликованная версия, которая ответила.
resultobjectПо одному ответу на вопрос, в порядке вопросов: вариант (choice), метка наиболее вероятного уровня (score) или вероятность ответа да от 0 до 1 (probability). Пусто после fallback из-за ошибки движка.
confidenceobjectПо одному числу от 0 до 1 на вопрос — см. Уверенность.
scoresobjectТолько для решений с вопросами score: взвешенный уровень каждого из них, отсчитываемый от 1 — см. Взвешенные уровни.
compositesobjectТолько для решений с композитами: значение каждого из них.
actionstringcontinue, block, escalate или fallback — см. Политики и действия.
action_reasonobjectПочему выбрано это действие (ниже).
probabilitiesobjectТолько с ?include=probabilities: распределение каждого вопроса.
outputobject или nullТолько когда сработало назначение структурированного вывода: объект первого завершившегося, проверенный по его полям, — null, если ни одно не завершилось.
destinationsarrayТолько для решений с назначениями: по одной записи на каждое сработавшее назначение, в порядке схемы, — [], если ни одно не сработало. См. ниже.
metrics.latency_msintegerВремя запуска внутри Dcision — проверка состояния, вызов движка, композиты и политики. Назначения LLM и агентов, которые выполняются после этого, не учитываются.
metrics.enginestringДвижок, который выполнил запуск: jev, laya или openai.
metrics.modelstringТочная версия модели, которая ответила, например jev-1.13.0, — даже если рабочее пространство использует псевдоним вроде jev-latest.
metrics.estimated_cost_usdnumberОценка стоимости вызова: входные токены движка × цена модели, плюс чтение файлов состояния, если они есть.
metrics.input_tokensintegerВходные токены вызова движка — именно их тарифицируют Jev и OpenAI Decisions.
metrics.output_tokensintegerВыходные токены вызова движка, для наблюдаемости: ни Jev, ни OpenAI Decisions их не тарифицируют.
metrics.input_filesintegerТолько если в состоянии есть файлы: сколько файлов прочитано.
metrics.input_processing_msintegerТолько с файлами: время на их загрузку и чтение, входит в latency_ms.
metrics.input_cost_usdnumberТолько с файлами: оценка стоимости их чтения через OpenAI (расшифровка, описание изображений, чтение файлов) — 0, если Dcision прочитал их сам. Входит в estimated_cost_usd.

action_reason

typeДополнительные поляЗначение
policyruleСработало правило политики номер rule (нумерация с 0).
other_optionquestionЭтот вопрос choice ответил other; применяется действие fallback.
refusalquestionДвижок (OpenAI Decisions) отказался отвечать на этот вопрос; его нет в result, применяется действие fallback.
low_confidencequestion, confidence, minConfidenceУверенность этого вопроса оказалась ниже его минимума; применяется действие fallback.
engine_errorcodeДвижок завершился с ошибкой code, а onEngineError решения равен fallback: применяется действие fallback, result пуст, и вызов не тарифицируется.
default—Ничего не сработало: continue.

Ключи вопросов — ваши

result, confidence, scores и probabilities индексируются ключами ваших вопросов, а composites — ключами ваших композитов, поэтому они никогда не пересекаются с полями верхнего уровня: result.action шаблона Spam Detection (его вопрос action: allow, review или block) — это не то же самое, что action верхнего уровня, выбранное его политиками.

destinations

Присутствует, когда у решения есть назначения. Каждая запись описывает одно сработавшее назначение — что оно вернуло или что Dcision поставил в очередь, — и назначения никогда не приводят к ошибке вызова: проблема отражается в соответствующей записи.

Все виды записей
[
  {
    "key": "sales_reply",
    "type": "reply",
    "text": "Thanks! Someone from our sales team will contact you today.",
    "buttons": ["Book a demo", "See pricing"]
  },
  {
    "key": "lead",
    "type": "json",
    "mode": "template",
    "status": "completed",
    "output": { "company_size": 500, "route": "sales", "start": "next month" }
  },
  {
    "key": "sales_llm",
    "type": "llm",
    "status": "completed",
    "text": "Thanks for reaching out! Someone from our sales team will contact you today to talk about your 500 users.",
    "model": "openai/gpt-5-mini",
    "usage": { "input_tokens": 61, "output_tokens": 27 }
  },
  {
    "key": "sales_agent",
    "type": "agent",
    "status": "completed",
    "reply": "I booked a demo for tomorrow at 10:00. You'll get an invitation by e-mail.",
    "response": { "reply": "I booked a demo for tomorrow at 10:00. You'll get an invitation by e-mail.", "booking_id": "bk_5521" }
  },
  { "key": "sales_summary", "type": "llm", "status": "failed", "error": "No answer from OpenRouter within 20 s." },
  { "key": "sales_crm", "type": "workflow", "status": "queued", "delivery_id": "dlv_8kJx2mQp4LzN7vR1tY6w" },
  { "key": "notify_sales", "type": "webhook", "status": "queued", "delivery_id": "dlv_Q2w9Lm4Xc7Rv1Tz8Wn3B" },
  { "key": "handoff", "type": "agent", "status": "queued", "delivery_id": "dlv_Hq2Lm9Xc4Rv1Tz8Wn3Bk" },
  { "key": "assign_owner", "type": "function", "function": "assignToSales", "params": { "email": "ana@acme.com", "route": "sales" } },
  { "key": "create_ticket", "type": "http", "status": "skipped", "reason": "missing_param", "param": "ticket_id" }
]
ПолеТипОписание
keystringКлюч назначения в решении.
typestringreply, json, llm, agent, workflow, webhook, http или function.
modestringjson: template (собирается из результата) или extract (заполняется LLM).
formatstringjson: ui, когда output — это экран json-render; для данных отсутствует.
outputobjectjson, который завершился: объект, проверенный по его полям.
issuesarrayjson, не прошедший проверку: { path, message } на каждую проблему, path — JSON Pointer.
statusstringЧто произошло (ниже). У фиксированных ответов и сработавших функций status нет.
textstringreply: сообщение. llm: ответ модели.
buttonsarrayreply: подписи кнопок.
modelstringllm и json в режиме extract: модель, которая ответила, как её указал провайдер.
usage.input_tokensintegerllm и json в режиме extract: входные токены, подсчитанные провайдером, — их тарифицирует провайдер, а не Dcision.
usage.output_tokensintegerllm: выходные токены, подсчитанные провайдером.
replystring или nullagent в режиме sync: ответ агента или null, если в его ответе не было поля reply.
responseanyagent в режиме sync: весь ответ агента или null, если он длиннее 16 000 символов.
errorstringЗаписи failed: почему не удался вызов LLM или агента — или структурированный вывод.
delivery_idstringЗаписи queued: ID dlv_…, отправляемый с каждой попыткой, — дедуплицируйте по нему.
functionstringfunction: обработчик, который должен вызвать ваш код.
paramsobjectfunction: аргументы вызова.
reasonstringЗаписи skipped: почему назначение не выполнилось (ниже).
paramstringskipped с missing_param: обязательный параметр, у которого не оказалось значения.
statusТипыЗначение
completedjson, llm, agentВывод собран, или модель либо агент ответили — вызывающая сторона дождалась этого.
failedjson, llm, agentВызов не удался или вывод не соответствует своим полям; решение при этом остаётся действительным. См. error (и issues).
queuedwebhook, http, workflow, agentDcision доставляет его в фоне, с повторными попытками, — см. Доставка и повторы.
skippedвсеНазначение подошло, но не выполнилось.
reasonЗначение
missing_paramУ параметра с пометкой required не было значения.
limitПодошло больше 10 назначений или больше 3 таких, которые заставляют вызывающую сторону ждать (ответы LLM, агенты sync и структурированные выводы в режиме extract).
unavailableДоставку не удалось поставить в очередь.

В Playground записи — это предпросмотр: "status": "preview" с запросом или промптом, который был бы отправлен, — если только вы не запускаете назначения по-настоящему. См. Тестирование назначений.

Ошибки

Ошибки используют стандартный формат. Этот endpoint возвращает следующие:

СтатусКоды
400INVALID_REQUEST — некорректный JSON, тело, которое не является объектом, недопустимый Idempotency-Key
401INVALID_API_KEY
402CREDITS_EXHAUSTED — включённый объём израсходован, а кредитов не осталось; SPEND_CAP_REACHED — достигнут лимит расходов цикла; QUOTA_EXCEEDED — израсходован включённый объём тарифа с жёстким лимитом
404DECISION_NOT_FOUND
409DECISION_NOT_DEPLOYED, DECISION_DISABLED, IDEMPOTENCY_CONFLICT — с Retry-After: 1, пока запрос с тем же ключом ещё выполняется
413PAYLOAD_TOO_LARGE — тело больше 32 МБ
422INVALID_STATE — в том числе состояние сверх бюджета токенов движка — и INVALID_SCHEMA
424ENGINE_NOT_CONFIGURED
429RATE_LIMITED
500INTERNAL_ERROR
502ENGINE_AUTH_FAILED, ENGINE_INVALID_REQUEST, ENGINE_ERROR
503ENGINE_RATE_LIMITED, ENGINE_UNAVAILABLE
504ENGINE_TIMEOUT

Ошибки движка возникают уже после собственных повторных попыток Dcision в пределах timeoutMs решения. Когда onEngineError решения равен fallback, ошибки движка 502, 503 и 504 превращаются в 200 с действием fallback и action_reason.type = "engine_error" — см. Настройки решения.

Порядок проверок

Если что-то не так сразу в нескольких местах, ошибку определяет первый неудачный шаг:

  1. API-ключ → 401 INVALID_API_KEY.
  2. Rate limit рабочего пространства → 429 RATE_LIMITED. Начиная с этого шага ответы содержат заголовки X-RateLimit-*.
  3. Формат slug → 404 DECISION_NOT_FOUND; тело → 400 INVALID_REQUEST.
  4. Идемпотентность: сохранённый ответ для того же ключа и запроса отдаётся сразу; тот же ключ с другим запросом → 409 IDEMPOTENCY_CONFLICT; тот же запрос ещё выполняется → 409 IDEMPOTENCY_CONFLICT с Retry-After: 1. В остальных случаях ключ резервируется за этим запросом — и освобождается снова, если какой-либо следующий шаг завершится ошибкой.
  5. Решение существует, включено и имеет опубликованную версию → 404 / 409.
  6. Включённый объём и кредиты: сверх включённых в тариф решений — доступные кредиты → 402 CREDITS_EXHAUSTED, затем лимит расходов → 402 SPEND_CAP_REACHED; тариф с жёстким лимитом → 402 QUOTA_EXCEEDED.
  7. Проверка состояния, затем бюджет токенов движка для состояния и вопросов → 422 INVALID_STATE.
  8. Вызов движка с повторными попытками в пределах timeoutMs → 424 / 502 / 503 / 504 при сбое или действие fallback при onEngineError: "fallback".
  9. Композиты и политики → action и action_reason.
  10. Назначения → ответы и функции возвращаются, вызовы LLM и агентов sync ожидаются, доставки ставятся в очередь — затем 200 OK.

Шаги с 7 по 10 записываются как выполнения, включая сбои. Тарифицируется только свежий 200 с шага 10 — не ошибки, не повторы и не fallback из-за ошибок движка. См. Тарифы, квоты и оплата.

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