Список и получение решений

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"
200 OK
{
  "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"
    }
  ]
}
ПолеТипОписание
dataarrayРешения рабочего пространства, сначала недавно обновлённые.
data[].slugstringSlug решения — его endpoint, POST /v1/decisions/{slug}.
data[].namestringНазвание решения.
data[].descriptionstring или nullОписание решения.
data[].statusstringdraft (ни разу не публиковалось), deployed или disabled (endpoint выключен).
data[].versioninteger или nullАктивная версия; null для черновика.
data[].updated_atstringКогда решение изменялось в последний раз, 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"
200 OK
{
  "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>" }
}
ПолеТипОписание
slugstringSlug решения.
namestringНазвание решения.
descriptionstring или nullОписание решения.
statusstringdraft, deployed или disabled.
versioninteger или nullАктивная версия; null для черновика.
state_schemaobject или nullСостояние, которое принимает активная версия, в виде JSON Schema — контракт API из редактора: { "type": "object", "required", "properties" }, { "type": "string" } для текстового состояния или { "type": "array", "items" } для состояния-списка. null для черновика.
questionsarrayВопросы по порядку. Пусто для черновика.
questions[].idstringКлюч вопроса — ключ его ответа в result и confidence.
questions[].typestringchoice, score или probability.
questions[].promptstring, object или arrayИнструкции вопроса в том виде, в каком они записаны в схеме.
questions[].optionsarrayКаким может быть ответ: варианты вопроса choice, включая other; метки уровней вопроса score, начиная с низшего; ["yes", "no"] для вопроса probability, чей result — вероятность ответа да.
questions[].min_confidencenumberТолько если у вопроса есть minConfidence: ниже него применяется действие fallback.
compositesarrayТолько для решений с композитами: id и description каждого.
actionsarrayДействия, которые может содержать ответ: continue, block, escalate и fallback. Пусто для черновика.
fallback_actionstringДействие для ответа other или низкой уверенности — см. Политики и действия. Отсутствует для черновика.
example_stateanyСостояние-заготовка правильной формы — строки как <field>, числа как 1.5, целые как 1, — с которого можно начать. Перед запуском замените значения. null для черновика.

Черновик отвечает 200 с version, state_schema и example_state, равными null, и пустыми questions и actions. Политики, назначения, настройки и context решения никогда не возвращаются.

Ошибки

СтатусКодКогда
401INVALID_API_KEYКлюч отсутствует, имеет неверный формат, неизвестен или отозван.
404DECISION_NOT_FOUNDВ рабочем пространстве ключа нет решения с этим slug, или slug имеет неверный формат.
429RATE_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"
200 OK
{
  "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"
}
ПолеТипОписание
decisionstringSlug решения.
versionintegerАктивная версия, из которой взяты вопросы.
delegation.typestringВсегда decisions.
delegation.modelstringМодель OpenAI Decisions, gpt-6-luna.
delegation.questionsarrayВопросы по порядку, переведённые так же, как для движка OpenAI Decisions: predicate (probability), choice с choices (value, description) и score с levels (label, description). У каждого есть name — ключ вопроса — и instructions.
answers_urlstringКуда отправлять ответы: путь 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 } ] }
      ] }'
ПолеТипОписание
answersarrayОбязательно, от 1 до 200 элементов: answers события decision.completed в том виде, в каком их прислал OpenAI, — predicate, choice, score или refusal, каждый с name вопроса.
modelstringНеобязательно. Модель, которая ответила; gpt-6-luna, если не указано. Записывается как metrics.model.
usageobjectНеобязательно. input_tokens и output_tokens решения в сессии, записываются вместе с выполнением.
stateanyНеобязательно. Контекст для назначений и журнала выполнений — например, состояние приложения во время звонка. Если передан, проверяется по схеме состояния решения.

?include=probabilities добавляет полные распределения, как в Запуске решения.

200 OK
{
  "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

СтатусКодКогда
400INVALID_REQUESTНет answers, их больше 200, или ответы не соответствуют опубликованным вопросам — отсутствует вопрос, choice не из вариантов, неверный тип ответа.
401INVALID_API_KEYКлюч отсутствует, имеет неверный формат, неизвестен или отозван.
402CREDITS_EXHAUSTED, SPEND_CAP_REACHED, QUOTA_EXCEEDEDТолько для ответов, как в Запуске решения.
404DECISION_NOT_FOUNDВ рабочем пространстве ключа нет решения с этим slug.
409DECISION_NOT_DEPLOYEDРешение ни разу не публиковалось. Endpoint ответов также возвращает DECISION_DISABLED для выключенного endpoint'а.
422INVALID_STATEТолько для ответов: необязательный state не соответствует схеме состояния.
429RATE_LIMITEDСлишком много запросов в текущую минуту.

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