Composites

Combine várias respostas num único número com pesos que você controla — Σ(peso × valor) / Σ|peso| — devolva-o em composites e use-o em políticas.

Um composite é uma combinação ponderada de respostas que a Dcision calcula depois que o engine responde. Use um para ranquear (um lead score, a aderência de um currículo, um score de risco), para aplicar um limiar sobre vários sinais de uma vez, ou simplesmente para manter os pesos na decisão em vez de num prompt.

O engine responde perguntas pequenas e atômicas; o composite faz a aritmética. Essa divisão importa: o Jev é bom de julgamento e fraco de matemática, então a matemática fica na Dcision — exata, versionada e fácil de ajustar. É o padrão de composite scoring embutido no schema.

Defina um composite

Os composites ficam no array composites do schema. Este vem do template Qualificação de leads:

{
  "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 }
  ]
}
PropriedadeTipoObrigatórioDescrição
keystringSimsnake_case, única entre as perguntas e os composites da decisão. A chave em composites na resposta e nas políticas.
descriptionstringNãoAté 500 caracteres. Só documentação: não é enviada ao engine.
termsarraySimDe 1 a 20 termos.

Cada termo aponta para uma pergunta:

PropriedadeTipoObrigatórioDescrição
questionstringSimA chave de uma pergunta desta decisão.
optionstringSó em perguntas de choiceA opção cuja probabilidade conta — obrigatória numa pergunta de choice, rejeitada nas demais.
weightnumberSimDe −100 a 100, diferente de 0. Pesos negativos subtraem.

Uma decisão tem até 20 composites. Erros tornam o schema inválido (422 INVALID_SCHEMA) com mensagens como Unknown question "intent"., "route" has no option "buyer". ou Pick the option whose probability counts.

Como o valor é calculado

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

Cada termo contribui com um valor entre 0 e 1:

Tipo de perguntaValor do termo
probabilitya probabilidade de sim — a própria resposta
scoreo nível ponderado normalizado, (level − 1) / (levels − 1): 0 no primeiro nível, 1 no último. O nível ponderado é o devolvido em scores
choicea probabilidade de option na distribuição da pergunta
  • Com pesos positivos, o composite fica entre 0 e 1; com pesos negativos, entre −1 e 1.
  • Ele é arredondado para 4 casas decimais.
  • Termos sem uma resposta utilizável são ignorados, e um composite sem nenhum termo utilizável fica de fora da resposta.

Para o lead acima — purchase_intent 0.9412, priority no nível ponderado 2.81 numa escala de 4 níveis, route = sales com probabilidade 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

Na resposta

A resposta ganha um objeto composites, indexado pelas chaves dos seus composites, sempre que a decisão define composites:

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

O Playground mostra os composites num card próprio, o Contrato da API do editor os lista como números, e as execuções os guardam quando storeOutput está ligado.

Nas políticas

Uma regra de política pode comparar um composite com um número, com qualquer um dos seis operadores — on continua output, o padrão:

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

Os composites se combinam com condições and como qualquer outro campo. O template Triagem de currículos bloqueia um candidato só quando as duas aderências de cargo são baixas:

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

Veja Políticas e ações.

No editor

Na aba Editor da decisão, o card Compostos fica entre Perguntas e Políticas:

  1. Clique em Adicionar composto e dê um nome a ele — por exemplo, lead_score — com uma descrição opcional.
  2. Cada termo se lê peso × pergunta: defina o peso e escolha a pergunta. Para uma pergunta de choice, escolha também a opção, mostrada como p(option); termos de score dizem nível normalizado e termos de probability, p(sim).
  3. Adicionar termo para cada dimensão, até 20.

Os composites então aparecem em Compostos na lista de campos de toda regra de política. Renomear um composite atualiza as regras que começam com ele; depois de remover um, revise o card Políticas — as condições que ainda apontam para ele são sinalizadas como problemas a corrigir. O construtor visual ainda não mostra composites — edite-os na aba Editor.

Dicas

  • Uma dimensão por pergunta. Um composite só é tão bom quanto os seus termos: perguntas atômicas e literais — veja Escrevendo boas perguntas.
  • Ajuste os pesos, não o texto. Os pesos mudam o ranking sem mexer no que o engine lê, e cada mudança sai como uma nova versão.
  • Várias visões das mesmas respostas. Dois composites sobre as mesmas perguntas — aderência a Senior IC e a Engineering Manager — não custam nada a mais: nenhuma pergunta nova, nenhuma chamada nova ao engine.
  • Use pesos negativos para fatores eliminatórios, por exemplo lead_score = 2 × purchase_intent + 1 × priority − 3 × spam.
  • Use limiares, não interpole. Os níveis ponderados são bons para decisões de "acima ou abaixo"; não os use para reconstruir um número exato entre dois níveis.

Nesta página