Композиты
Объединяйте несколько ответов в одно число с весами, которыми вы управляете, — Σ(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 }
]
}| Свойство | Тип | Обязательно | Описание |
|---|---|---|---|
key | string | Да | snake_case, уникален среди вопросов и композитов решения. Ключ в composites ответа и в политиках. |
description | string | Нет | До 500 символов. Только документация: движку не отправляется. |
terms | array | Да | От 1 до 20 слагаемых. |
Каждое слагаемое указывает на один вопрос:
| Свойство | Тип | Обязательно | Описание |
|---|---|---|---|
question | string | Да | Ключ вопроса этого решения. |
option | string | Только для вопросов choice | Вариант, чья вероятность учитывается, — обязателен для вопроса choice, отклоняется для остальных. |
weight | number | Да | От −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"
}См. Политики и действия.
В редакторе
На вкладке Редактор решения карточка Композиты находится между «Вопросами» и «Политиками»:
- Нажмите Добавить композит и дайте ему имя — например,
lead_score— с необязательным описанием. - Каждое слагаемое читается как вес × вопрос: задайте вес и выберите вопрос. Для вопроса choice выберите также вариант, отображаемый как
p(option); слагаемые score подписаны нормализованный уровень, а слагаемые probability — p(yes). - Добавить слагаемое для каждого измерения, до 20.
После этого композиты появляются в разделе Композиты списка полей каждого правила политики. Переименование композита обновляет правила, которые с него начинаются; после удаления композита проверьте карточку Политики — условия, которые всё ещё на него ссылаются, помечаются как проблемы, требующие исправления. Визуальный конструктор пока не показывает композиты — редактируйте их на вкладке «Редактор».
Советы
- Одно измерение на вопрос. Композит хорош настолько, насколько хороши его слагаемые: атомарные, буквальные вопросы — см. Как писать хорошие вопросы.
- Настраивайте веса, а не формулировки. Веса меняют ранжирование, не затрагивая того, что читает движок, и каждое изменение выходит новой версией.
- Несколько взглядов на одни и те же ответы. Два композита по одним и тем же вопросам — соответствие Senior IC и Engineering Manager — ничего не стоят дополнительно: ни нового вопроса, ни нового вызова движка.
- Используйте отрицательные веса для дисквалифицирующих факторов, например
lead_score = 2 × purchase_intent + 1 × priority − 3 × spam. - Задавайте пороги, а не интерполируйте. Взвешенные уровни хороши для решений «выше или ниже»; не используйте их, чтобы восстановить точное число между двумя уровнями.
Вопросы
Вопросы choice, score и probability — структурированные инструкции и критерии, что API возвращает для каждого, взвешенные уровни, зарезервированный вариант other и минимальная уверенность.
Политики и действия
Как пишутся и вычисляются правила политик с условиями AND и как вычисляются action и action_reason каждого ответа — политика, вариант other, низкая уверенность, по умолчанию или ошибка движка.