Триггеры назначений

Когда срабатывает назначение — условия на ответы, уверенность, взвешенные уровни и 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"]
}
СвойствоТипПо умолчаниюОписание
conditionsarray[]До 5 условий, все из которых должны выполняться. Та же форма, что у условия политики: field, on (output, confidence или score), operator и value.
actionsarray—Срабатывать, только если итоговое действие — одно из этих: 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 проходит по назначениям в порядке схемы:

  1. Выключенное назначение ("enabled": false) игнорируется.
  2. Проверяются его actions и conditions. Неподходящие назначения не оставляют записи.
  3. Вычисляются его параметры. Если у параметра с пометкой required нет значения, назначение не срабатывает: его запись содержит "status": "skipped", "reason": "missing_param" и называет param.
  4. За одно выполнение срабатывает не более 10 назначений, и не более 3 из них могут заставить вызывающего ждать — ответы LLM и агенты в режиме sync. Сверх этого запись содержит "status": "skipped", "reason": "limit".
  5. Остальные выполняются: ответы и функции возвращаются, вызовы LLM и агентов sync ожидаются параллельно, а фоновые доставки ставятся в очередь.

Когда движок даёт сбой

С onEngineError: "fallback" сбой движка отвечает 200 с действием fallback и без ответов. Тогда:

  • назначения с условиями не срабатывают — сравнивать не с чем;
  • назначения без условий срабатывают, с фильтром по actions, если он задан, — подходящее место для оповещения вроде escalate → уведомить дежурного;
  • переменные result.*, confidence.*, scores.* и composites.* равны null.

Ответы fallback повторяются по-настоящему

Fallback при ошибке движка не сохраняется для идемпотентности: повтор вызова с тем же Idempotency-Key снова запускает решение, и его назначения снова срабатывают с новыми ID доставок. Дедуплицируйте такие оповещения на своей стороне — например, по ID собственной записи.

Повторы

Идемпотентный повтор возвращает сохранённый ответ — включая записи destinations и их ID доставок — и ничего не запускает повторно. Однако SDK снова вызывают функции повторённого ответа, поэтому делайте обработчики функций идемпотентными.

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