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 }
]
}| Propriedade | Tipo | Obrigatório | Descrição |
|---|---|---|---|
key | string | Sim | snake_case, única entre as perguntas e os composites da decisão. A chave em composites na resposta e nas políticas. |
description | string | Não | Até 500 caracteres. Só documentação: não é enviada ao engine. |
terms | array | Sim | De 1 a 20 termos. |
Cada termo aponta para uma pergunta:
| Propriedade | Tipo | Obrigatório | Descrição |
|---|---|---|---|
question | string | Sim | A chave de uma pergunta desta decisão. |
option | string | Só em perguntas de choice | A opção cuja probabilidade conta — obrigatória numa pergunta de choice, rejeitada nas demais. |
weight | number | Sim | De −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 pergunta | Valor do termo |
|---|---|
probability | a probabilidade de sim — a própria resposta |
score | o nível ponderado normalizado, (level − 1) / (levels − 1): 0 no primeiro nível, 1 no último. O nível ponderado é o devolvido em scores |
choice | a 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.8414Na 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:
- Clique em Adicionar composto e dê um nome a ele — por exemplo,
lead_score— com uma descrição opcional. - 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). - 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.
Perguntas
Perguntas de choice, score e probability — instruções e critérios estruturados, o que a API devolve para cada uma, níveis ponderados, a opção reservada other e a confiança mínima.
Políticas e ações
Como as regras de política com condições AND são escritas e avaliadas, e como a action e o action_reason de cada resposta são calculados — política, opção other, baixa confiança, padrão ou erro do engine.