Политики и действия
Как пишутся и вычисляются правила политик с условиями AND и как вычисляются action и action_reason каждого ответа — политика, вариант other, низкая уверенность, по умолчанию или ошибка движка.
Вопросы дают ответы; политики превращают ответы в действие, по которому ваш код может ветвиться. Каждый успешный ответ содержит и action, и объясняющий его action_reason.
Действия
| Действие | Значение по соглашению |
|---|---|
continue | Продолжить по автоматическому пути. |
block | Остановиться: отклонить, отбросить или поместить событие в карантин. |
escalate | Передать человеку или на более высокий уровень. |
fallback | Пойти по запасному пути — например, к более крупной модели или к дополнительному поиску. |
Действия — это метки для вашего кода. Dcision сам ничего не блокирует и не перенаправляет: решение с действием block всё равно отвечает 200 OK, а действие применяет ваше приложение.
Правила политик
Правило — это одно условие, необязательные условия and и действие, которое возвращается, когда выполняются все они:
{ "field": "route", "on": "output", "operator": "eq", "value": "spam", "action": "block" }| Свойство | Тип | По умолчанию | Описание |
|---|---|---|---|
field | string | — | Ключ вопроса — или composite — в этом решении. |
on | string | output | Что сравнивать: ответ (output), его confidence или взвешенный уровень вопроса score (score). |
operator | string | — | eq, neq, gt, gte, lt или lte. |
value | string или number | — | Значение для сравнения (строки до 255 символов). |
and | array | — | До 5 дополнительных условий — у каждого свои field, on, operator и value, — которые тоже должны выполняться. |
action | string | — | continue, block, escalate или fallback. |
В решении до 50 правил. Что принимают value и operator, зависит от поля и от on:
| Поле | on | Сравнивает | value | Операторы |
|---|---|---|---|---|
| вопрос choice | output | выбранный вариант (регистр и пробелы по краям игнорируются) | вариант, строкой | eq, neq |
| вопрос score | output | наиболее вероятный уровень (1 = низший) | номер уровня или подпись уровня | все шесть |
| вопрос score | score | взвешенный уровень, от 1 — может оказаться между уровнями, например 2.4 | число | все шесть |
| вопрос probability | output | вероятность yes | число от 0 до 1 | все шесть |
| любой вопрос | confidence | уверенность ответа | число от 0 до 1 | все шесть |
| composite | output | значение composite | число | все шесть |
Правила, нарушающие эти ограничения, делают схему некорректной (422 INVALID_SCHEMA), например "Choice outputs only support eq / neq.", "Unknown question \"intent\".", "Only score questions have a weighted level." или "Compare a composite's value with a number.".
Условия AND
Составные правила нужны большинству паттернов. Чтобы правило сработало, должно выполняться каждое его условие. Из шаблонов:
| Шаблон | Правило |
|---|---|
ticket-triage | category = bug_report AND bug_severity ≥ 4 → escalate |
voice-banking | intent = approve_transfer AND уверенность intent < 0.9 → escalate |
customer-service-router | intent = technical_issue AND взвешенный уровень complexity ≥ 2.5 → escalate |
resume-screening | senior_ic < 0.35 AND eng_manager < 0.35 → block |
В JSON первое выглядит так:
{
"field": "category",
"on": "output",
"operator": "eq",
"value": "bug_report",
"and": [{ "field": "bug_severity", "on": "output", "operator": "gte", "value": 4 }],
"action": "escalate"
}Условия одного правила могут использовать разные вопросы и composites или один и тот же вопрос дважды — его ответ и его уверенность, как в voice-banking. Для OR напишите два правила с одним действием.
Как вычисляется действие
После ответа движка Dcision вычисляет composites, затем проходит пять шагов и останавливается на первом подходящем:
Политики, по порядку. Первое правило, все условия которого выполняются, задаёт действие.
action_reason → { "type": "policy", "rule": 1 } — rule — это индекс правила с отсчётом от 0 (приложение показывает его как «Сработало правило политики №2»).
Вопрос, на который движок отказался отвечать. OpenAI Decisions может отказаться отвечать на вопрос; первый вопрос с отказом в порядке вопросов запускает действие fallback решения. У него нет записи в result, и политики по нему никогда не срабатывают.
action_reason → { "type": "refusal", "question": "route" }
Choice с ответом other. Первый вопрос choice в порядке вопросов, ответ на который — зарезервированный вариант other, запускает действие fallback решения (settings.fallbackAction, по умолчанию escalate).
action_reason → { "type": "other_option", "question": "route" }
Низкая уверенность. Первый вопрос в порядке вопросов, уверенность которого ниже его minConfidence, запускает действие fallback.
action_reason → { "type": "low_confidence", "question": "route", "confidence": 0.52, "minConfidence": 0.8 }
По умолчанию. Ничего не подошло: действие — continue.
action_reason → { "type": "default" }
Политики всегда побеждают: правило вроде route eq other → block имеет приоритет над действием fallback.
Шестая причина существует вне этих шагов. Когда движок даёт сбой и onEngineError решения равен fallback, вычислять нечего: ответ содержит действие fallback и { "type": "engine_error", "code": "ENGINE_TIMEOUT" }.
Разбор примера
У шаблона Квалификация лидов два правила и действие fallback по умолчанию, escalate:
[
{ "field": "route", "on": "output", "operator": "eq", "value": "spam", "action": "block" },
{ "field": "purchase_intent", "on": "confidence", "operator": "lt", "value": 0.6, "action": "escalate" }
]result | confidence.purchase_intent | action | action_reason |
|---|---|---|---|
route: "sales", purchase_intent: 0.9412 | 0.8824 | continue | { "type": "default" } |
route: "spam", purchase_intent: 0.03 | 0.94 | block | { "type": "policy", "rule": 0 } |
route: "sdr", purchase_intent: 0.45 | 0.1 | escalate | { "type": "policy", "rule": 1 } |
route: "other", purchase_intent: 0.15 | 0.7 | escalate | { "type": "other_option", "question": "route" } |
Уверенность вероятности равна |2p − 1|, поэтому правило 1 передаёт человеку каждый лид, у которого purchase_intent лежит между 0.2 и 0.8.
В редакторе
Карточка Политики читает каждое правило как IF условие THEN действие:
- Добавить правило создаёт правило по первому вопросу.
- Выберите поле — сначала вопросы, затем композиты — и что сравнивать: ответ, уверенность или, для вопроса score, взвешенный уровень. Затем оператор и значение.
- + AND добавляет условие, до 5. У каждого свои поле, сравнение, оператор и значение.
- Выберите действие после THEN.
Правила вычисляются сверху вниз. Переименование или удаление вопроса обновляет или удаляет правила, которые с него начинаются; условия and и термы composites, указывающие на уже несуществующий вопрос, отмечаются как проблемы, которые нужно исправить.
Действия по результату
switch (decision.action) {
case "continue":
return routeTo(decision.result.route);
case "block":
return discard(lead);
case "escalate":
return sendToHuman(lead, decision.action_reason);
case "fallback":
return askLargerModel(lead);
}Ошибки движка: ошибка или действие — выбирать вам
По умолчанию, когда у движка истекает время или он даёт сбой, API возвращает ошибку, например 504 ENGINE_TIMEOUT, и никакого действия: решите в своём коде, что означает ошибка, — обычно это тот же путь, что и escalate. Задайте onEngineError равным fallback, чтобы вместо этого получать 200 с действием fallback и action_reason.type = "engine_error"; такие ответы не тарифицируются. См. Настройки решения и Ошибки.
Советы
- Ставьте самые специфичные правила первыми: побеждает первое совпадение. Составные правила (
and) обычно идут перед простыми, которые они уточняют. - Используйте
on: "confidence"сlt, чтобы передавать человеку ответы, в которых движок не уверен, — или задайтеminConfidenceу вопроса, чтобы использовать вместо этого действие fallback. Сочетайте оба для порогов по действиям. - Используйте
on: "score", чтобы действовать между уровнями —frustration ≥ 3.5, — а не ждать, пока победит верхний уровень. - Оставляйте
blockдля однозначных результатов (спам, злоупотребления), а неуверенность пусть идёт вescalate. - Политики — часть схемы: изменение вступает в силу для клиентов API, только когда вы публикуете новую версию.
Композиты
Объединяйте несколько ответов в одно число с весами, которыми вы управляете, — Σ(weight × value) / Σ|weight| — возвращайте его в composites и используйте в политиках.
Уверенность и вероятности
Что означает уверенность для каждого типа вопроса на единой шкале 0–1, как она влияет на minConfidence, взвешенные уровни, полные распределения вероятностей и почти ничьи.