Триггеры назначений
Когда срабатывает назначение — условия на ответы, уверенность, взвешенные уровни и composites, итоговые действия, минимальная уверенность на маршрут, уровни score, пороги вероятности — и в каком порядке.
У каждого назначения есть объект when. Оно срабатывает, когда итоговое действие решения входит в when.actions (если вы их задали) и выполняется каждое условие из when.conditions:
{
"conditions": [
{ "field": "route", "on": "output", "operator": "eq", "value": "sales" },
{ "field": "route", "on": "confidence", "operator": "gte", "value": 0.8 }
],
"actions": ["continue"]
}| Свойство | Тип | По умолчанию | Описание |
|---|---|---|---|
conditions | array | [] | До 5 условий, все из которых должны выполняться. Та же форма, что у условия политики: field, on (output, confidence или score), operator и value. |
actions | array | — | Срабатывать, только если итоговое действие — одно из этих: continue, block, escalate, fallback. |
Пустой when срабатывает после каждого решения.
Для варианта
Самый частый триггер — и то, что создаёт кнопка Назначение у варианта: ответ на вопрос равен этому варианту.
{ "conditions": [{ "field": "route", "on": "output", "operator": "eq", "value": "sales" }] }Используйте neq для «любой маршрут, кроме spam». Зарезервированный вариант other — такой же ответ, как и остальные: назначение на route = other срабатывает, когда ни один вариант не подходит, а действие fallback решения (по умолчанию escalate) сообщает вашему коду, что нужно посмотреть человеку.
Минимальная уверенность на маршрут
Поле Минимальная уверенность у назначения добавляет условие confidence ≥ по тому же вопросу, так что маршрут срабатывает, только когда движок достаточно уверен:
{
"conditions": [
{ "field": "route", "on": "output", "operator": "eq", "value": "sales" },
{ "field": "route", "on": "confidence", "operator": "gte", "value": 0.8 }
]
}Оно не зависит от собственного minConfidence вопроса, который меняет действие: ответ с низкой уверенностью получает действие fallback и action_reason.type = "low_confidence", какими бы ни были назначения. Сочетайте оба или задайте каждому маршруту собственный порог — маршрут возврата денег может требовать 0.9, а маршрут «отправить статью» — принимать 0.6. См. маршрутизацию с порогом уверенности.
Для уровня score
Селекторы вопроса score создают условие на наиболее вероятный уровень:
{ "conditions": [{ "field": "priority", "on": "output", "operator": "eq", "value": "critical" }] }Уровни также можно сравнивать по номеру (1 = первый уровень) любым оператором — "operator": "gte", "value": 3 означает high или critical на шкале из четырёх уровней — или по взвешенному уровню с "on": "score", который может оказаться между уровнями: "on": "score", "operator": "gte", "value": 3.5.
Пороги вероятности
Назначение, когда … ≥ … у вопроса probability создаёт порог на вероятность yes, по умолчанию 0.8:
{ "conditions": [{ "field": "purchase_intent", "on": "output", "operator": "gte", "value": 0.8 }] }Composites и другие ответы
Условие может использовать любой вопрос или composite решения, так что назначение не обязано следовать за вопросом, к панели которого оно относится: lead_score ≥ 0.75 отправляет горячие лиды в workflow независимо от маршрута.
{
"conditions": [
{ "field": "lead_score", "on": "output", "operator": "gte", "value": 0.75 },
{ "field": "route", "on": "output", "operator": "neq", "value": "spam" }
]
}Итоговые действия
actions привязывает назначение к вердикту, а не к ответу — каждый escalate пишет в Slack, каждый block открывает тикет модерации:
{ "actions": ["escalate"] }Если заданы и conditions, и actions, должны выполняться оба.
Проверка
Условия подчиняются правилам условий политик и проверяются при сохранении или публикации — иначе 422 INVALID_SCHEMA:
fieldдолжно быть вопросом или composite решения;- ответы choice поддерживают только
eqиneq, а значение должно быть одним из вариантов; - вероятности и уверенность — числа от 0 до 1:
0.7, а не70; - уровни score идут от 1 до числа уровней, либо используется подпись уровня;
- composites идут от −1 до 1 (от 0 до 1 при положительных весах).
Вычисление
После выбора действия Dcision проходит по назначениям в порядке схемы:
- Выключенное назначение (
"enabled": false) игнорируется. - Проверяются его
actionsиconditions. Неподходящие назначения не оставляют записи. - Вычисляются его параметры. Если у параметра с пометкой
requiredнет значения, назначение не срабатывает: его запись содержит"status": "skipped", "reason": "missing_param"и называетparam. - За одно выполнение срабатывает не более 10 назначений, и не более 3 из них могут заставить вызывающего ждать — ответы LLM и агенты в режиме
sync. Сверх этого запись содержит"status": "skipped", "reason": "limit". - Остальные выполняются: ответы и функции возвращаются, вызовы LLM и агентов
syncожидаются параллельно, а фоновые доставки ставятся в очередь.
Когда движок даёт сбой
С onEngineError: "fallback" сбой движка отвечает 200 с действием fallback и без ответов. Тогда:
- назначения с условиями не срабатывают — сравнивать не с чем;
- назначения без условий срабатывают, с фильтром по
actions, если он задан, — подходящее место для оповещения вроде escalate → уведомить дежурного; - переменные
result.*,confidence.*,scores.*иcomposites.*равныnull.
Ответы fallback повторяются по-настоящему
Fallback при ошибке движка не сохраняется для идемпотентности: повтор вызова с тем же Idempotency-Key снова запускает решение, и его назначения снова срабатывают с новыми ID доставок. Дедуплицируйте такие оповещения на своей стороне — например, по ID собственной записи.
Повторы
Идемпотентный повтор возвращает сохранённый ответ — включая записи destinations и их ID доставок — и ничего не запускает повторно. Однако SDK снова вызывают функции повторённого ответа, поэтому делайте обработчики функций идемпотентными.
Обзор назначений
Что происходит после решения (по варианту, уровню, порогу вероятности или итоговому действию) — готовые ответы, структурированный вывод, ответы LLM, ваш агент, workflow, подписанные вебхуки, HTTP-запросы и функции.
Параметры и шаблоны
Передача значений в назначение — параметры из поля или фиксированного значения, обязательные параметры, переменные {{…}} в URL, заголовках, телах и текстах и то, как каждое место их кодирует.