Композиты

Объединяйте несколько ответов в одно число с весами, которыми вы управляете, — Σ(weight × value) / Σ|weight| — возвращайте его в composites и используйте в политиках.

Композит — это взвешенная комбинация ответов, которую Dcision вычисляет после ответа движка. Используйте его для ранжирования (оценка лида, соответствие резюме, оценка риска), для порога сразу по нескольким сигналам или просто чтобы хранить веса в решении, а не в промпте.

Движок отвечает на небольшие атомарные вопросы; композит выполняет арифметику. Это разделение важно: Jev хорош в суждениях и слаб в математике, поэтому математика остаётся в Dcision — точной, версионируемой и легко настраиваемой. Это паттерн композитной оценки, встроенный в схему.

Определение композита

Композиты находятся в массиве composites схемы. Этот взят из шаблона Lead Qualification:

{
  "key": "lead_score",
  "description": "0–1 ranking: intent counts double, priority adds, spam-like routes don't count",
  "terms": [
    { "question": "purchase_intent", "weight": 2 },
    { "question": "priority", "weight": 1 },
    { "question": "route", "option": "sales", "weight": 1 }
  ]
}
СвойствоТипОбязательноОписание
keystringДаsnake_case, уникален среди вопросов и композитов решения. Ключ в composites ответа и в политиках.
descriptionstringНетДо 500 символов. Только документация: движку не отправляется.
termsarrayДаОт 1 до 20 слагаемых.

Каждое слагаемое указывает на один вопрос:

СвойствоТипОбязательноОписание
questionstringДаКлюч вопроса этого решения.
optionstringТолько для вопросов choiceВариант, чья вероятность учитывается, — обязателен для вопроса choice, отклоняется для остальных.
weightnumberДаОт −100 до 100, не 0. Отрицательные веса вычитаются.

У решения может быть до 20 композитов. Ошибки делают схему некорректной (422 INVALID_SCHEMA) с сообщениями вроде Unknown question "intent"., "route" has no option "buyer". или Pick the option whose probability counts.

Как вычисляется значение

composite = Σ(weight × term value) / Σ|weight|

Каждое слагаемое даёт значение от 0 до 1:

Тип вопросаЗначение слагаемого
probabilityвероятность yes — сам ответ
scoreнормализованный взвешенный уровень, (level − 1) / (levels − 1): 0 на первом уровне, 1 на последнем. Взвешенный уровень — тот, что возвращается в scores
choiceвероятность option в распределении вопроса
  • При положительных весах композит находится между 0 и 1; при отрицательных — между −1 и 1.
  • Он округляется до 4 знаков после запятой.
  • Слагаемые без пригодного ответа пропускаются, а композит без единого пригодного слагаемого не попадает в ответ.

Для лида выше — purchase_intent 0.9412, priority на взвешенном уровне 2.81 по шкале из 4 уровней, route = sales с вероятностью 0.88:

priority term = (2.81 − 1) / (4 − 1) = 0.6033
lead_score    = (2 × 0.9412 + 1 × 0.6033 + 1 × 0.88) / (2 + 1 + 1) = 0.8414

В ответе

Ответ получает объект composites с ключами ваших композитов, если в решении определены композиты:

{
  "result": { "purchase_intent": 0.9412, "priority": "high", "route": "sales" },
  "scores": { "priority": 2.81 },
  "composites": { "lead_score": 0.8414 },
  "action": "continue"
}

Playground показывает композиты в отдельной карточке, Контракт API в редакторе перечисляет их как числа, а выполнения сохраняют их, когда включён storeOutput.

В политиках

Правило политики может сравнивать композит с числом с помощью любого из шести операторов — on остаётся output, значением по умолчанию:

{ "field": "lead_score", "operator": "gte", "value": 0.75, "action": "continue" }

Композиты комбинируются с условиями and, как любое другое поле. Шаблон Resume Screening блокирует кандидата, только когда оба соответствия ролям низкие:

{
  "field": "senior_ic",
  "on": "output",
  "operator": "lt",
  "value": 0.35,
  "and": [{ "field": "eng_manager", "on": "output", "operator": "lt", "value": 0.35 }],
  "action": "block"
}

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

В редакторе

На вкладке Редактор решения карточка Композиты находится между «Вопросами» и «Политиками»:

  1. Нажмите Добавить композит и дайте ему имя — например, lead_score — с необязательным описанием.
  2. Каждое слагаемое читается как вес × вопрос: задайте вес и выберите вопрос. Для вопроса choice выберите также вариант, отображаемый как p(option); слагаемые score подписаны нормализованный уровень, а слагаемые probability — p(yes).
  3. Добавить слагаемое для каждого измерения, до 20.

После этого композиты появляются в разделе Композиты списка полей каждого правила политики. Переименование композита обновляет правила, которые с него начинаются; после удаления композита проверьте карточку Политики — условия, которые всё ещё на него ссылаются, помечаются как проблемы, требующие исправления. Визуальный конструктор пока не показывает композиты — редактируйте их на вкладке «Редактор».

Советы

  • Одно измерение на вопрос. Композит хорош настолько, насколько хороши его слагаемые: атомарные, буквальные вопросы — см. Как писать хорошие вопросы.
  • Настраивайте веса, а не формулировки. Веса меняют ранжирование, не затрагивая того, что читает движок, и каждое изменение выходит новой версией.
  • Несколько взглядов на одни и те же ответы. Два композита по одним и тем же вопросам — соответствие Senior IC и Engineering Manager — ничего не стоят дополнительно: ни нового вопроса, ни нового вызова движка.
  • Используйте отрицательные веса для дисквалифицирующих факторов, например lead_score = 2 × purchase_intent + 1 × priority − 3 × spam.
  • Задавайте пороги, а не интерполируйте. Взвешенные уровни хороши для решений «выше или ниже»; не используйте их, чтобы восстановить точное число между двумя уровнями.

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