Политики и действия

Как пишутся и вычисляются правила политик с условиями 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" }
СвойствоТипПо умолчаниюОписание
fieldstring—Ключ вопроса — или composite — в этом решении.
onstringoutputЧто сравнивать: ответ (output), его confidence или взвешенный уровень вопроса score (score).
operatorstring—eq, neq, gt, gte, lt или lte.
valuestring или number—Значение для сравнения (строки до 255 символов).
andarray—До 5 дополнительных условий — у каждого свои field, on, operator и value, — которые тоже должны выполняться.
actionstring—continue, block, escalate или fallback.

В решении до 50 правил. Что принимают value и operator, зависит от поля и от on:

ПолеonСравниваетvalueОператоры
вопрос choiceoutputвыбранный вариант (регистр и пробелы по краям игнорируются)вариант, строкойeq, neq
вопрос scoreoutputнаиболее вероятный уровень (1 = низший)номер уровня или подпись уровнявсе шесть
вопрос scorescoreвзвешенный уровень, от 1 — может оказаться между уровнями, например 2.4числовсе шесть
вопрос probabilityoutputвероятность yesчисло от 0 до 1все шесть
любой вопросconfidenceуверенность ответачисло от 0 до 1все шесть
compositeoutputзначение 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-triagecategory = bug_report AND bug_severity ≥ 4 → escalate
voice-bankingintent = approve_transfer AND уверенность intent < 0.9 → escalate
customer-service-routerintent = technical_issue AND взвешенный уровень complexity ≥ 2.5 → escalate
resume-screeningsenior_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" }
]
resultconfidence.purchase_intentactionaction_reason
route: "sales", purchase_intent: 0.94120.8824continue{ "type": "default" }
route: "spam", purchase_intent: 0.030.94block{ "type": "policy", "rule": 0 }
route: "sdr", purchase_intent: 0.450.1escalate{ "type": "policy", "rule": 1 }
route: "other", purchase_intent: 0.150.7escalate{ "type": "other_option", "question": "route" }

Уверенность вероятности равна |2p − 1|, поэтому правило 1 передаёт человеку каждый лид, у которого purchase_intent лежит между 0.2 и 0.8.

В редакторе

Карточка Политики читает каждое правило как IF условие THEN действие:

  1. Добавить правило создаёт правило по первому вопросу.
  2. Выберите поле — сначала вопросы, затем композиты — и что сравнивать: ответ, уверенность или, для вопроса score, взвешенный уровень. Затем оператор и значение.
  3. + AND добавляет условие, до 5. У каждого свои поле, сравнение, оператор и значение.
  4. Выберите действие после 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, только когда вы публикуете новую версию.

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