Обзор назначений

Что происходит после решения (по варианту, уровню, порогу вероятности или итоговому действию) — готовые ответы, структурированный вывод, ответы LLM, ваш агент, workflow, подписанные вебхуки, HTTP-запросы и функции.

Решение отвечает на вопрос что: result, confidence и action. Назначения говорят, что происходит дальше для каждого результата, — как ветки голосового меню. Привяжите одно или несколько назначений к варианту (route = sales), уровню оценки (priority = critical), порогу вероятности (purchase_intent ≥ 0.8) или итоговому действию (escalate), и каждый вызов, который туда попадает, отвечает вызывающей стороне, передаёт случай дальше или сообщает вашему коду, что запустить.

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

state ──▶ answers ──▶ composites ──▶ policies ──▶ action ──▶ destinations
                                                               ├─ answer the caller: fixed reply · structured output · LLM · agent
                                                               ├─ hand off:          workflow · webhook · API request
                                                               └─ your code:         function

Типы назначений

ТипВ приложенииКто выполняетЧто происходит
replyГотовый ответDcision формирует егоВозвращает в ответе готовое сообщение — текст и кнопки. Без вызова модели.
jsonСтруктурированный вывод (JSON)Dcision — по шаблону или с помощью LLM на вашем ключеВозвращает в поле output ответа JSON-объект, проверенный по вашим полям. См. Структурированный вывод.
llmLLMDcision вызывает OpenRouter или Vercel AI Gateway с вашим ключомМодель отвечает по промпту маршрута; её текст возвращается в ответе.
agentАгентDcision вызывает endpoint вашего агентаsync: ответ агента возвращается в ответе. async: передача дальше, доставляемая в фоне.
workflowWorkflowDcision, в фонеЗапускает n8n, Make, Zapier, Pipedream или любой URL workflow с переменными маршрута.
webhookВебхукDcision, в фонеОтправляет POST с подписанным результатом решения на ваш URL.
httpAPI-запросDcision, в фонеВызывает любой API: метод, URL, заголовки и тело JSON с переменными и секретами.
functionФункцияВаш кодВ ответе указаны функция и её параметры; SDK вызывают ваш обработчик.

Редактор группирует их так же: Ответить вызывающему (готовый ответ, структурированный вывод, LLM, агент), Передать дальше (workflow, вебхук, API-запрос) и Ваш код (функция).

Что выбрать

  • Сразу ответить конечному пользователю заранее известным текстом — подтверждение, ссылка, кнопки быстрого ответа: готовый ответ. Он ничего не стоит и не добавляет задержки.
  • Ответить сгенерированным текстом, специфичным для маршрута — «вы — отдел биллинга…»: ответ LLM с вашим ключом OpenRouter или Vercel AI Gateway.
  • Передать работу вашему собственному агенту с его инструментами и памятью: агент — sync, чтобы сразу вернуть его ответ, async, чтобы передать дальше.
  • Запустить no-code-автоматизацию в n8n, Make, Zapier или Pipedream: workflow.
  • Уведомить ваш бэкенд подписанным событием: вебхук.
  • Напрямую вызвать сторонний API — создать лид в CRM, открыть тикет, написать в Slack — с токеном, который хранится в секретах рабочего пространства: API-запрос.
  • Выполнить код в процессе, который вызвал решение: функция, которую вызывают SDK.

Решение может их сочетать: route = sales может вернуть готовый ответ, и запустить workflow CRM, и сообщить вашему коду, что нужно назначить ответственного.

Что возвращает вызов

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

  • Готовые ответы и функции возвращаются сразу.
  • Ответы LLM и агенты в режиме sync вызываются, пока вызывающая сторона ждёт, — параллельно, каждый со своим таймаутом, — и их ответы возвращаются.
  • Вебхуки, API-запросы, workflow и агенты в режиме async ставятся в очередь и доставляются в фоне, с повторными попытками: в ответе возвращается их delivery_id.
200 OK — Lead Qualification с назначениями
{
  "decision_id": "dec_3fKq9ZtW1mXcV7bN2pLa",
  "execution_id": "exec_8HsT2kQw9ZyR4vMn1cXe",
  "schema": "lead-qualification",
  "version": 4,
  "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" },
  "destinations": [
    {
      "key": "sales_reply",
      "type": "reply",
      "text": "Thanks! Someone from our sales team will contact you today.",
      "buttons": ["Book a demo", "See pricing"]
    },
    { "key": "sales_crm", "type": "workflow", "status": "queued", "delivery_id": "dlv_8kJx2mQp4LzN7vR1tY6w" },
    {
      "key": "hot_lead",
      "type": "function",
      "function": "assignToSales",
      "params": { "message": "We need pricing for 500 users and want to start next month." }
    }
  ],
  "metrics": {
    "latency_ms": 418,
    "engine": "jev",
    "model": "jev-1.13.0",
    "estimated_cost_usd": 0.00001575,
    "input_tokens": 375,
    "output_tokens": 36
  }
}

destinations присутствует всегда, когда у решения есть назначения, — [], если ни одно не сработало, — и отсутствует в остальных случаях. Каждая запись описана в разделе Запуск решения.

Назначения никогда не ломают решение

Назначение, которое не может выполниться, — отсутствующий параметр, LLM без ключа, недоступный агент, переполненная очередь — отражается в собственной записи (skipped или failed). Решение всё равно отвечает 200 со своим результатом и действием и тарифицируется как любое другое.

Настройка в редакторе

Выберите ответ

В карточке Вопросы редактора у каждого варианта choice в его строке есть селектор Назначение. Он показывает тип уже привязанного назначения (с +1, +2…, если их больше); на зарезервированном варианте other он показывает Fallback · escalate — действие fallback решения, — пока вы не привяжете назначение.

  • У вопросов score есть строка назначений по уровням: по одному селектору на уровень.
  • У вопросов probability есть Назначение, когда … ≥ …: порог вероятности ответа да, по умолчанию 0.8.

Выберите тип

Нажмите на селектор, чтобы открыть панель Когда route = sales. Она перечисляет назначения этого ответа, которые можно редактировать на месте; Добавить назначение показывает восемь типов в виде карточек, сгруппированных в Ответить вызывающему, Передать дальше и Ваш код.

Настройте его

У каждого назначения есть ключ (snake_case, уникальный в пределах решения), переключатель Активно и:

  • Когда — условия, при которых оно срабатывает. Панель уже содержит route = sales; задайте для этого маршрута Минимальную уверенность в процентах, добавьте другие условия или потребуйте итоговое действие. См. Триггеры.
  • Настройки типа — текст ответа, модель и промпт, endpoint агента, URL…
  • Параметры — переменные, которые оно использует, из поля или с фиксированным значением. См. Параметры и шаблоны.

Протестируйте и опубликуйте

Запустите черновик в Playground: назначения показываются как предпросмотр — ничего не отправляется, — пока вы не включите Выполнять назначения по-настоящему. Затем опубликуйте: вызовы API запускают назначения новой версии.

Карточка Назначения, которая идёт в редакторе после Политик, перечисляет все назначения решения (до 20) и позволяет добавлять назначения, не привязанные к одному ответу, — например, каждое решение или действие — escalate.

В визуальном конструкторе

В палитре конструктора есть группа Назначения с восемью типами. Назначения отображаются как узлы после узла Результат, соединённые ребром с подписью триггера (route = sales · route confidence ≥ 0.8), — пунктирным, если назначение выключено. Варианты choice показывают небольшой счётчик привязанных к ним назначений. Выберите узел, чтобы редактировать его в инспекторе.

Палитра, каждая из её групп и инспектор сворачиваются; раскладка запоминается в вашем браузере, а выбор узла снова раскрывает свёрнутый инспектор.

В схеме

decision.json (фрагмент)
{
  "destinations": [
    {
      "key": "sales_reply",
      "type": "reply",
      "when": { "conditions": [{ "field": "route", "on": "output", "operator": "eq", "value": "sales" }] },
      "reply": { "text": "Thanks! Someone from our sales team will contact you today.", "buttons": ["Book a demo", "See pricing"] }
    },
    {
      "key": "sales_crm",
      "type": "workflow",
      "when": {
        "conditions": [
          { "field": "route", "on": "output", "operator": "eq", "value": "sales" },
          { "field": "route", "on": "confidence", "operator": "gte", "value": 0.8 }
        ]
      },
      "params": {
        "message": { "from": "state.message", "required": true },
        "company_size": { "from": "state.company_size" },
        "lead_score": { "from": "composites.lead_score" }
      },
      "workflow": { "platform": "n8n", "url": "{{secrets.N8N_LEADS_WEBHOOK}}", "name": "New sales lead" }
    },
    {
      "key": "hot_lead",
      "type": "function",
      "when": { "conditions": [{ "field": "purchase_intent", "on": "output", "operator": "gte", "value": 0.8 }] },
      "params": { "message": { "from": "state.message" } },
      "function": { "name": "assignToSales" }
    },
    {
      "key": "escalation_alert",
      "type": "http",
      "when": { "actions": ["escalate"] },
      "http": {
        "method": "POST",
        "url": "{{secrets.SLACK_WEBHOOK}}",
        "body": "{\"text\": \"A lead needs a person: {{decision.slug}} execution {{execution.id}}\"}"
      }
    }
  ]
}
ПолеТипПо умолчаниюОписание
keystring—Уникален среди назначений решения; snake_case, до 48 символов. Идентифицирует запись в ответах, доставках и на вкладке «Обзор».
descriptionstring—Необязательно, до 2 000 символов.
enabledbooleantrueВыключенные назначения никогда не срабатывают.
whenobjectкаждое решениеconditions (AND) и actions — см. Триггеры.
typestring—reply, json, llm, agent, workflow, webhook, http или function.
paramsobject{}До 30 переменных — см. Параметры и шаблоны.
reply, json, llm, agent, workflow, webhook, http, functionobject—Настройки типа: ровно тот блок, который указан в type.

Сохранение или публикация схемы с недопустимым назначением завершается ошибкой 422 INVALID_SCHEMA с путём вроде destinations.1.workflow.url — редактор даёт на него ссылку К ошибке.

Роли

ДействиеКто
Добавлять, редактировать и удалять назначения (они — часть решения), публиковать ихУчастники, администраторы и владелец
Повторно отправлять неудавшуюся доставкуУчастники, администраторы и владелец
Видеть доставки и их статусВсе в рабочем пространстве, включая наблюдателей
Видеть названия секретов рабочего пространстваУчастники, администраторы и владелец
Добавлять, заменять и удалять секреты; показывать или менять секрет подписиАдминистраторы и владелец

См. Команда, роли и аккаунт.

Что дальше

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