Обзор назначений
Что происходит после решения (по варианту, уровню, порогу вероятности или итоговому действию) — готовые ответы, структурированный вывод, ответы 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-объект, проверенный по вашим полям. См. Структурированный вывод. |
llm | LLM | Dcision вызывает OpenRouter или Vercel AI Gateway с вашим ключом | Модель отвечает по промпту маршрута; её текст возвращается в ответе. |
agent | Агент | Dcision вызывает endpoint вашего агента | sync: ответ агента возвращается в ответе. async: передача дальше, доставляемая в фоне. |
workflow | Workflow | Dcision, в фоне | Запускает n8n, Make, Zapier, Pipedream или любой URL workflow с переменными маршрута. |
webhook | Вебхук | Dcision, в фоне | Отправляет POST с подписанным результатом решения на ваш URL. |
http | API-запрос | 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.
{
"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 показывают небольшой счётчик привязанных к ним назначений. Выберите узел, чтобы редактировать его в инспекторе.
Палитра, каждая из её групп и инспектор сворачиваются; раскладка запоминается в вашем браузере, а выбор узла снова раскрывает свёрнутый инспектор.
В схеме
{
"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}}\"}"
}
}
]
}| Поле | Тип | По умолчанию | Описание |
|---|---|---|---|
key | string | — | Уникален среди назначений решения; snake_case, до 48 символов. Идентифицирует запись в ответах, доставках и на вкладке «Обзор». |
description | string | — | Необязательно, до 2 000 символов. |
enabled | boolean | true | Выключенные назначения никогда не срабатывают. |
when | object | каждое решение | conditions (AND) и actions — см. Триггеры. |
type | string | — | reply, json, llm, agent, workflow, webhook, http или function. |
params | object | {} | До 30 переменных — см. Параметры и шаблоны. |
reply, json, llm, agent, workflow, webhook, http, function | object | — | Настройки типа: ровно тот блок, который указан в type. |
Сохранение или публикация схемы с недопустимым назначением завершается ошибкой 422 INVALID_SCHEMA с путём вроде destinations.1.workflow.url — редактор даёт на него ссылку К ошибке.
Роли
| Действие | Кто |
|---|---|
| Добавлять, редактировать и удалять назначения (они — часть решения), публиковать их | Участники, администраторы и владелец |
| Повторно отправлять неудавшуюся доставку | Участники, администраторы и владелец |
| Видеть доставки и их статус | Все в рабочем пространстве, включая наблюдателей |
| Видеть названия секретов рабочего пространства | Участники, администраторы и владелец |
| Добавлять, заменять и удалять секреты; показывать или менять секрет подписи | Администраторы и владелец |
Что дальше
Триггеры
Варианты, уровни, пороги, минимальная уверенность и итоговые действия.
Вебхуки
Подписанное событие, его заголовки и как его проверить.
Доставка и повторы
Доставка at-least-once, шесть попыток, статусы и повторные отправки.
Тестирование назначений
Предпросмотр, «Выполнять назначения по-настоящему» и livemode.
Маршрутизация по намерению
Классифицируйте каждый запрос одним быстрым вызовом и направьте его самому дешёвому подходящему обработчику — коду, специализированной LLM или человеку. На основе шаблона Customer Service Router.
Триггеры назначений
Когда срабатывает назначение — условия на ответы, уверенность, взвешенные уровни и composites, итоговые действия, минимальная уверенность на маршрут, уровни score, пороги вероятности — и в каком порядке.