Запуск решения
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: те же политики, назначения и ответ, без вызова движка.
Запрос
Параметры пути
| Параметр | Описание |
|---|---|
slug | Slug решения, который показан в редакторе и на вкладке Публикация — например, 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 } }| Поле | Тип | Описание |
|---|---|---|
state | object, 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_id | string | ID решения (dec_…). |
execution_id | string | ID этого запуска (exec_…), по нему можно искать в разделе Выполнения и через GET /v1/executions. |
schema | string | Slug решения. |
version | integer | Опубликованная версия, которая ответила. |
result | object | По одному ответу на вопрос, в порядке вопросов: вариант (choice), метка наиболее вероятного уровня (score) или вероятность ответа да от 0 до 1 (probability). Пусто после fallback из-за ошибки движка. |
confidence | object | По одному числу от 0 до 1 на вопрос — см. Уверенность. |
scores | object | Только для решений с вопросами score: взвешенный уровень каждого из них, отсчитываемый от 1 — см. Взвешенные уровни. |
composites | object | Только для решений с композитами: значение каждого из них. |
action | string | continue, block, escalate или fallback — см. Политики и действия. |
action_reason | object | Почему выбрано это действие (ниже). |
probabilities | object | Только с ?include=probabilities: распределение каждого вопроса. |
output | object или null | Только когда сработало назначение структурированного вывода: объект первого завершившегося, проверенный по его полям, — null, если ни одно не завершилось. |
destinations | array | Только для решений с назначениями: по одной записи на каждое сработавшее назначение, в порядке схемы, — [], если ни одно не сработало. См. ниже. |
metrics.latency_ms | integer | Время запуска внутри Dcision — проверка состояния, вызов движка, композиты и политики. Назначения LLM и агентов, которые выполняются после этого, не учитываются. |
metrics.engine | string | Движок, который выполнил запуск: jev, laya или openai. |
metrics.model | string | Точная версия модели, которая ответила, например jev-1.13.0, — даже если рабочее пространство использует псевдоним вроде jev-latest. |
metrics.estimated_cost_usd | number | Оценка стоимости вызова: входные токены движка × цена модели, плюс чтение файлов состояния, если они есть. |
metrics.input_tokens | integer | Входные токены вызова движка — именно их тарифицируют Jev и OpenAI Decisions. |
metrics.output_tokens | integer | Выходные токены вызова движка, для наблюдаемости: ни Jev, ни OpenAI Decisions их не тарифицируют. |
metrics.input_files | integer | Только если в состоянии есть файлы: сколько файлов прочитано. |
metrics.input_processing_ms | integer | Только с файлами: время на их загрузку и чтение, входит в latency_ms. |
metrics.input_cost_usd | number | Только с файлами: оценка стоимости их чтения через OpenAI (расшифровка, описание изображений, чтение файлов) — 0, если Dcision прочитал их сам. Входит в estimated_cost_usd. |
action_reason
type | Дополнительные поля | Значение |
|---|---|---|
policy | rule | Сработало правило политики номер rule (нумерация с 0). |
other_option | question | Этот вопрос choice ответил other; применяется действие fallback. |
refusal | question | Движок (OpenAI Decisions) отказался отвечать на этот вопрос; его нет в result, применяется действие fallback. |
low_confidence | question, confidence, minConfidence | Уверенность этого вопроса оказалась ниже его минимума; применяется действие fallback. |
engine_error | code | Движок завершился с ошибкой 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" }
]| Поле | Тип | Описание |
|---|---|---|
key | string | Ключ назначения в решении. |
type | string | reply, json, llm, agent, workflow, webhook, http или function. |
mode | string | json: template (собирается из результата) или extract (заполняется LLM). |
format | string | json: ui, когда output — это экран json-render; для данных отсутствует. |
output | object | json, который завершился: объект, проверенный по его полям. |
issues | array | json, не прошедший проверку: { path, message } на каждую проблему, path — JSON Pointer. |
status | string | Что произошло (ниже). У фиксированных ответов и сработавших функций status нет. |
text | string | reply: сообщение. llm: ответ модели. |
buttons | array | reply: подписи кнопок. |
model | string | llm и json в режиме extract: модель, которая ответила, как её указал провайдер. |
usage.input_tokens | integer | llm и json в режиме extract: входные токены, подсчитанные провайдером, — их тарифицирует провайдер, а не Dcision. |
usage.output_tokens | integer | llm: выходные токены, подсчитанные провайдером. |
reply | string или null | agent в режиме sync: ответ агента или null, если в его ответе не было поля reply. |
response | any | agent в режиме sync: весь ответ агента или null, если он длиннее 16 000 символов. |
error | string | Записи failed: почему не удался вызов LLM или агента — или структурированный вывод. |
delivery_id | string | Записи queued: ID dlv_…, отправляемый с каждой попыткой, — дедуплицируйте по нему. |
function | string | function: обработчик, который должен вызвать ваш код. |
params | object | function: аргументы вызова. |
reason | string | Записи skipped: почему назначение не выполнилось (ниже). |
param | string | skipped с missing_param: обязательный параметр, у которого не оказалось значения. |
status | Типы | Значение |
|---|---|---|
completed | json, llm, agent | Вывод собран, или модель либо агент ответили — вызывающая сторона дождалась этого. |
failed | json, llm, agent | Вызов не удался или вывод не соответствует своим полям; решение при этом остаётся действительным. См. error (и issues). |
queued | webhook, http, workflow, agent | Dcision доставляет его в фоне, с повторными попытками, — см. Доставка и повторы. |
skipped | все | Назначение подошло, но не выполнилось. |
reason | Значение |
|---|---|
missing_param | У параметра с пометкой required не было значения. |
limit | Подошло больше 10 назначений или больше 3 таких, которые заставляют вызывающую сторону ждать (ответы LLM, агенты sync и структурированные выводы в режиме extract). |
unavailable | Доставку не удалось поставить в очередь. |
В Playground записи — это предпросмотр: "status": "preview" с запросом или промптом, который был бы отправлен, — если только вы не запускаете назначения по-настоящему. См. Тестирование назначений.
Ошибки
Ошибки используют стандартный формат. Этот endpoint возвращает следующие:
| Статус | Коды |
|---|---|
| 400 | INVALID_REQUEST — некорректный JSON, тело, которое не является объектом, недопустимый Idempotency-Key |
| 401 | INVALID_API_KEY |
| 402 | CREDITS_EXHAUSTED — включённый объём израсходован, а кредитов не осталось; SPEND_CAP_REACHED — достигнут лимит расходов цикла; QUOTA_EXCEEDED — израсходован включённый объём тарифа с жёстким лимитом |
| 404 | DECISION_NOT_FOUND |
| 409 | DECISION_NOT_DEPLOYED, DECISION_DISABLED, IDEMPOTENCY_CONFLICT — с Retry-After: 1, пока запрос с тем же ключом ещё выполняется |
| 413 | PAYLOAD_TOO_LARGE — тело больше 32 МБ |
| 422 | INVALID_STATE — в том числе состояние сверх бюджета токенов движка — и INVALID_SCHEMA |
| 424 | ENGINE_NOT_CONFIGURED |
| 429 | RATE_LIMITED |
| 500 | INTERNAL_ERROR |
| 502 | ENGINE_AUTH_FAILED, ENGINE_INVALID_REQUEST, ENGINE_ERROR |
| 503 | ENGINE_RATE_LIMITED, ENGINE_UNAVAILABLE |
| 504 | ENGINE_TIMEOUT |
Ошибки движка возникают уже после собственных повторных попыток Dcision в пределах timeoutMs решения. Когда onEngineError решения равен fallback, ошибки движка 502, 503 и 504 превращаются в 200 с действием fallback и action_reason.type = "engine_error" — см. Настройки решения.
Порядок проверок
Если что-то не так сразу в нескольких местах, ошибку определяет первый неудачный шаг:
- API-ключ →
401 INVALID_API_KEY. - Rate limit рабочего пространства →
429 RATE_LIMITED. Начиная с этого шага ответы содержат заголовкиX-RateLimit-*. - Формат slug →
404 DECISION_NOT_FOUND; тело →400 INVALID_REQUEST. - Идемпотентность: сохранённый ответ для того же ключа и запроса отдаётся сразу; тот же ключ с другим запросом →
409 IDEMPOTENCY_CONFLICT; тот же запрос ещё выполняется →409 IDEMPOTENCY_CONFLICTсRetry-After: 1. В остальных случаях ключ резервируется за этим запросом — и освобождается снова, если какой-либо следующий шаг завершится ошибкой. - Решение существует, включено и имеет опубликованную версию →
404/409. - Включённый объём и кредиты: сверх включённых в тариф решений — доступные кредиты →
402 CREDITS_EXHAUSTED, затем лимит расходов →402 SPEND_CAP_REACHED; тариф с жёстким лимитом →402 QUOTA_EXCEEDED. - Проверка состояния, затем бюджет токенов движка для состояния и вопросов →
422 INVALID_STATE. - Вызов движка с повторными попытками в пределах
timeoutMs→424/502/503/504при сбое или действие fallback приonEngineError: "fallback". - Композиты и политики →
actionиaction_reason. - Назначения → ответы и функции возвращаются, вызовы LLM и агентов
syncожидаются, доставки ставятся в очередь — затем200 OK.
Шаги с 7 по 10 записываются как выполнения, включая сбои. Тарифицируется только свежий 200 с шага 10 — не ошибки, не повторы и не fallback из-за ошибок движка. См. Тарифы, квоты и оплата.
Аутентификация
Аутентификация с помощью API-ключей Bearer (dcs_live_ и dcs_test_) — как их создавать, хранить, ротировать и отзывать — и где они работают.
Список и получение решений
GET /v1/decisions и GET /v1/decisions/{slug} — решения рабочего пространства API-ключа и контракт активной версии каждого — плюс делегирование решения в GPT-Live и его endpoint ответов.