Список и получение решений
GET /v1/decisions и GET /v1/decisions/{slug} — решения рабочего пространства API-ключа и контракт активной версии каждого — плюс делегирование решения в GPT-Live и его endpoint ответов.
GET https://api.dcision.io/v1/decisions
GET https://api.dcision.io/v1/decisions/{slug}Два endpoint'а для чтения сообщают интеграции — или агенту через MCP-сервер, — какие решения существуют и что каждое принимает и отвечает, не открывая приложение. Они показывают только то, что раскрывает активная версия: черновик, который ни разу не публиковался, есть в списке, но его схема остаётся закрытой, пока вы его не опубликуете.
Оба используют те же API-ключи, что и решения, делят окно rate limit для чтения с GET /v1/me и GET /v1/executions и не тарифицируются.
Ещё два endpoint'а связывают опубликованное решение с голосовой сессией OpenAI в реальном времени — см. Делегирование GPT-Live.
Список решений
curl https://api.dcision.io/v1/decisions \
-H "Authorization: Bearer $DCISION_API_KEY"{
"data": [
{
"slug": "lead-qualification",
"name": "Lead Qualification",
"description": "Qualify inbound leads and route them to the right team.",
"status": "deployed",
"version": 3,
"updated_at": "2026-10-05T13:41:09.204Z"
},
{
"slug": "chat-triage",
"name": "Chat triage",
"description": null,
"status": "draft",
"version": null,
"updated_at": "2026-10-04T18:02:55.731Z"
}
]
}| Поле | Тип | Описание |
|---|---|---|
data | array | Решения рабочего пространства, сначала недавно обновлённые. |
data[].slug | string | Slug решения — его endpoint, POST /v1/decisions/{slug}. |
data[].name | string | Название решения. |
data[].description | string или null | Описание решения. |
data[].status | string | draft (ни разу не публиковалось), deployed или disabled (endpoint выключен). |
data[].version | integer или null | Активная версия; null для черновика. |
data[].updated_at | string | Когда решение изменялось в последний раз, ISO 8601. |
Запускаться могут только решения deployed: остальные отвечают 409 DECISION_NOT_DEPLOYED или 409 DECISION_DISABLED.
Получение решения
curl https://api.dcision.io/v1/decisions/lead-qualification \
-H "Authorization: Bearer $DCISION_API_KEY"{
"slug": "lead-qualification",
"name": "Lead Qualification",
"description": "Qualify inbound leads and route them to the right team.",
"status": "deployed",
"version": 3,
"state_schema": {
"type": "object",
"required": ["message"],
"properties": {
"message": { "type": "string", "description": "Inbound lead message" },
"company_size": { "type": "number", "description": "Employee count" },
"source": { "type": "string", "description": "website, referral, ads" }
}
},
"questions": [
{
"id": "purchase_intent",
"type": "probability",
"prompt": "Does this lead have real intent to buy in the next 30 days?",
"options": ["yes", "no"]
},
{
"id": "priority",
"type": "score",
"prompt": "How urgent is it to answer this lead?",
"options": ["low", "medium", "high", "critical"]
},
{
"id": "route",
"type": "choice",
"prompt": "Which team should receive this lead?",
"options": ["sales", "sdr", "nurture", "spam", "other"]
}
],
"composites": [
{ "id": "lead_score", "description": "0–1 ranking: intent counts double, priority adds, spam-like routes don't count" }
],
"actions": ["continue", "block", "escalate", "fallback"],
"fallback_action": "escalate",
"example_state": { "message": "<message>", "company_size": 1.5, "source": "<source>" }
}| Поле | Тип | Описание |
|---|---|---|
slug | string | Slug решения. |
name | string | Название решения. |
description | string или null | Описание решения. |
status | string | draft, deployed или disabled. |
version | integer или null | Активная версия; null для черновика. |
state_schema | object или null | Состояние, которое принимает активная версия, в виде JSON Schema — контракт API из редактора: { "type": "object", "required", "properties" }, { "type": "string" } для текстового состояния или { "type": "array", "items" } для состояния-списка. null для черновика. |
questions | array | Вопросы по порядку. Пусто для черновика. |
questions[].id | string | Ключ вопроса — ключ его ответа в result и confidence. |
questions[].type | string | choice, score или probability. |
questions[].prompt | string, object или array | Инструкции вопроса в том виде, в каком они записаны в схеме. |
questions[].options | array | Каким может быть ответ: варианты вопроса choice, включая other; метки уровней вопроса score, начиная с низшего; ["yes", "no"] для вопроса probability, чей result — вероятность ответа да. |
questions[].min_confidence | number | Только если у вопроса есть minConfidence: ниже него применяется действие fallback. |
composites | array | Только для решений с композитами: id и description каждого. |
actions | array | Действия, которые может содержать ответ: continue, block, escalate и fallback. Пусто для черновика. |
fallback_action | string | Действие для ответа other или низкой уверенности — см. Политики и действия. Отсутствует для черновика. |
example_state | any | Состояние-заготовка правильной формы — строки как <field>, числа как 1.5, целые как 1, — с которого можно начать. Перед запуском замените значения. null для черновика. |
Черновик отвечает 200 с version, state_schema и example_state, равными null, и пустыми questions и actions. Политики, назначения, настройки и context решения никогда не возвращаются.
Ошибки
| Статус | Код | Когда |
|---|---|---|
| 401 | INVALID_API_KEY | Ключ отсутствует, имеет неверный формат, неизвестен или отозван. |
| 404 | DECISION_NOT_FOUND | В рабочем пространстве ключа нет решения с этим slug, или slug имеет неверный формат. |
| 429 | RATE_LIMITED | Слишком много запросов на чтение в текущую минуту. |
Ключ видит только решения своего рабочего пространства.
Делегирование GPT-Live
GET https://api.dcision.io/v1/decisions/{slug}/openai-live
POST https://api.dcision.io/v1/decisions/{slug}/openai-live/answersСессия GPT-Live (голосовой режим OpenAI в реальном времени) может задавать OpenAI Decisions типизированные вопросы, пока пользователь говорит. Эти два endpoint'а заставляют её задавать вопросы вашего опубликованного решения и выполняют на полученных ответах политики, назначения и журнал выполнений решения. Руководство по GPT-Live показывает весь процесс.
Экспорт делегирования
GET /v1/decisions/{slug}/openai-live возвращает вопросы активной версии в формате OpenAI Decisions, готовые для запроса сессии в поле delegation. Он использует окно rate limit для чтения и не тарифицируется.
curl https://api.dcision.io/v1/decisions/lead-qualification/openai-live \
-H "Authorization: Bearer $DCISION_API_KEY"{
"decision": "lead-qualification",
"version": 3,
"delegation": {
"type": "decisions",
"model": "gpt-6-luna",
"questions": [
{
"type": "predicate",
"name": "purchase_intent",
"instructions": "Does this lead have real intent to buy in the next 30 days?\n\nTrue when: asks for pricing, a demo, a quote or a start date\nFalse when: just browsing, student, vendor or spam"
},
{
"type": "score",
"name": "priority",
"instructions": "How urgent is it to answer this lead?",
"levels": [{ "label": "low" }, { "label": "medium" }, { "label": "high" }, { "label": "critical" }]
},
{
"type": "choice",
"name": "route",
"instructions": "Which team should receive this lead?",
"choices": [
{ "value": "sales", "description": "high intent, ready to talk to sales" },
{ "value": "sdr", "description": "some intent, needs qualification" },
{ "value": "nurture", "description": "early stage, send content" },
{ "value": "spam", "description": "spam, vendor pitch or irrelevant" },
{ "value": "other", "description": "none of the options above" }
]
}
]
},
"answers_url": "/v1/decisions/lead-qualification/openai-live/answers"
}| Поле | Тип | Описание |
|---|---|---|
decision | string | Slug решения. |
version | integer | Активная версия, из которой взяты вопросы. |
delegation.type | string | Всегда decisions. |
delegation.model | string | Модель OpenAI Decisions, gpt-6-luna. |
delegation.questions | array | Вопросы по порядку, переведённые так же, как для движка OpenAI Decisions: predicate (probability), choice с choices (value, description) и score с levels (label, description). У каждого есть name — ключ вопроса — и instructions. |
answers_url | string | Куда отправлять ответы: путь POST /v1/decisions/{slug}/openai-live/answers. |
Экспортируются только вопросы: context, политики и назначения решения остаются в Dcision. Экспортируйте делегирование заново после каждой публикации, чтобы сессия задавала вопросы новой версии.
Отправка ответов
POST /v1/decisions/{slug}/openai-live/answers принимает answers из события decision.completed сессии и возвращает тот же ответ, что и POST /v1/decisions/{slug}. Движок не вызывается.
curl -X POST https://api.dcision.io/v1/decisions/lead-qualification/openai-live/answers \
-H "Authorization: Bearer $DCISION_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "model": "gpt-6-luna", "answers": [
{ "type": "predicate", "name": "purchase_intent", "probability": 0.92 },
{ "type": "score", "name": "priority", "score": 2.03, "probabilities": [
{ "value": 0, "label": "low", "probability": 0.02 }, { "value": 1, "label": "medium", "probability": 0.1 },
{ "value": 2, "label": "high", "probability": 0.71 }, { "value": 3, "label": "critical", "probability": 0.17 } ] },
{ "type": "choice", "name": "route", "choice": "sales", "probabilities": [
{ "value": "sales", "probability": 0.9 }, { "value": "sdr", "probability": 0.07 }, { "value": "other", "probability": 0.03 } ] }
] }'| Поле | Тип | Описание |
|---|---|---|
answers | array | Обязательно, от 1 до 200 элементов: answers события decision.completed в том виде, в каком их прислал OpenAI, — predicate, choice, score или refusal, каждый с name вопроса. |
model | string | Необязательно. Модель, которая ответила; gpt-6-luna, если не указано. Записывается как metrics.model. |
usage | object | Необязательно. input_tokens и output_tokens решения в сессии, записываются вместе с выполнением. |
state | any | Необязательно. Контекст для назначений и журнала выполнений — например, состояние приложения во время звонка. Если передан, проверяется по схеме состояния решения. |
?include=probabilities добавляет полные распределения, как в Запуске решения.
{
"decision_id": "dec_3fKq9ZtW1mXcV7bN2pLa",
"execution_id": "exec_Lv7Qm2Xc9Tn4Rb8Wk1Pz",
"schema": "lead-qualification",
"version": 3,
"result": { "purchase_intent": 0.92, "priority": "high", "route": "sales" },
"confidence": { "purchase_intent": 0.84, "priority": 0.69, "route": 0.875 },
"scores": { "priority": 3.03 },
"composites": { "lead_score": 0.8542 },
"action": "continue",
"action_reason": { "type": "default" },
"metrics": {
"latency_ms": 38,
"engine": "openai",
"model": "gpt-6-luna",
"estimated_cost_usd": 0,
"input_tokens": 0,
"output_tokens": 0
}
}- Те же правила, что и при запуске. Политики, проверки отказа,
otherиminConfidence, композиты и назначения выполняются на ответах;actionиaction_reasonозначают то же, что и везде. - Тарифицируется как запуск. Каждый вызов засчитывается в решения, включённые в тариф, а затем расходует кредиты.
metrics.estimated_cost_usdравен0: OpenAI уже выставил счёт за сессию Live. - Записывается как выполнение с источником API, движком
openaiи учётными данными live — оно видно в Выполнениях, в Обзоре решения и вGET /v1/executions. - Используется окно rate limit решений.
Idempotency-Keyне поддерживается: повторный вызов выполняется — и тарифицируется — заново.
Ошибки endpoint'ов GPT-Live
| Статус | Код | Когда |
|---|---|---|
| 400 | INVALID_REQUEST | Нет answers, их больше 200, или ответы не соответствуют опубликованным вопросам — отсутствует вопрос, choice не из вариантов, неверный тип ответа. |
| 401 | INVALID_API_KEY | Ключ отсутствует, имеет неверный формат, неизвестен или отозван. |
| 402 | CREDITS_EXHAUSTED, SPEND_CAP_REACHED, QUOTA_EXCEEDED | Только для ответов, как в Запуске решения. |
| 404 | DECISION_NOT_FOUND | В рабочем пространстве ключа нет решения с этим slug. |
| 409 | DECISION_NOT_DEPLOYED | Решение ни разу не публиковалось. Endpoint ответов также возвращает DECISION_DISABLED для выключенного endpoint'а. |
| 422 | INVALID_STATE | Только для ответов: необязательный state не соответствует схеме состояния. |
| 429 | RATE_LIMITED | Слишком много запросов в текущую минуту. |
Запуск решения
POST /v1/decisions/{slug} — путь, query-параметры, заголовки, тело запроса, все поля ответа и ошибки, с примерами на cURL, JavaScript и Python.
Аккаунт и использование
GET /v1/me — рабочее пространство, API-ключ и тариф, стоящие за ключом, плюс использование в текущем расчётном периоде. Проверяйте ключ в CI и следите за квотой из кода.