Confiança e probabilidades
O que a confiança significa para cada tipo de pergunta numa escala única de 0 a 1, como ela afeta minConfidence, níveis ponderados, as distribuições completas e os quase empates.
O engine não escolhe apenas uma resposta: ele devolve uma distribuição de probabilidade para cada pergunta. A Dcision a transforma numa confiança por pergunta — sempre — e pode devolver a distribuição completa quando você pede.
Probabilidades calibradas
O Jev é treinado com RLCD — reinforcement learning for calibrated decisions — para devolver probabilidades que significam o que dizem. Ao longo de muitas previsões de um modelo bem calibrado, resultados que recebem probabilidade 0,2 acontecem cerca de 20% das vezes, e resultados que recebem 0,8, cerca de 80% das vezes. Essa é uma propriedade de grupos de respostas, não uma garantia sobre uma resposta isolada — e é exatamente isso que faz limiares, escalonamento e auditoria funcionarem.
Confiança
confidence tem um número de 0 a 1 por pergunta, indexado como result. Ela segue a definição da TypeSafe, de modo que todo tipo de pergunta compartilha uma única escala: 1 quando toda a probabilidade está numa resposta, 0 quando ela está distribuída igualmente ou a resposta é cara ou coroa.
| Tipo de pergunta | A confiança é… | Fórmula |
|---|---|---|
choice | o quanto a opção escolhida fica acima de uma divisão igual entre todas as n opções, other incluída | (p_max − 1/n) / (1 − 1/n) |
score | o quanto a distribuição se concentra em torno do nível mais provável — probabilidade num nível vizinho a reduz menos do que probabilidade num nível distante | 1 − spread / spread of an even distribution, com piso em 0 |
probability | a distância de um cara ou coroa | |2p − 1| |
- Para perguntas de escolha e de nota, a Dcision usa a confiança informada pelo engine, calculada com essas fórmulas; ela só as aplica por conta própria se o engine a omitir.
- Exemplos: uma escolha com cinco opções e
p_max = 0.88tem confiança0.85. Uma probabilidade de0.9412tem confiança0.8824;0.03tem0.94;0.5tem0. - Para perguntas de nota,
spreadé a distância ponderada pela probabilidade, em níveis, a partir do nível mais provável. Com três níveis,(0, 0.5, 0.5)— dividida entre vizinhos — tem confiança 0,25, enquanto(0.5, 0, 0.5)— dividida entre extremos opostos — tem confiança 0.
Use a confiança em políticas ("on": "confidence") ou com a minConfidence de uma pergunta para mandar respostas incertas a uma pessoa — veja Roteamento por confiança.
Confiança mínima em perguntas de probabilidade
Como a confiança de uma probabilidade é |2p − 1|, um limiar sobre ela sinaliza uma faixa de probabilidades em torno de 0,5: uma resposta fica abaixo de uma confiança mínima c quando p cai estritamente entre (1 − c) / 2 e (1 + c) / 2.
minConfidence | Sinaliza probabilidades entre |
|---|---|
| 0.5 | 0,25 e 0,75 |
| 0.6 | 0,2 e 0,8 |
| 0.8 | 0,1 e 0,9 |
| 0.9 | 0,05 e 0,95 |
O mesmo vale para regras com "on": "confidence": a confiança de purchase_intent lt 0.6 combina com todo p entre 0,2 e 0,8. O editor mostra a faixa ao lado do controle Confiança mínima das perguntas de probabilidade.
Vindo da v0.1?
Até a v0.2 (5 de outubro de 2026), a confiança de uma probabilidade era max(p, 1 − p). O novo valor é menor para a mesma resposta — p = 0.8 tinha confiança 0,8 e agora tem 0,6. Para manter o comportamento de um limiar antigo t, use 2t − 1: um 0.8 antigo vira 0.6. Perguntas de escolha e de nota continuam usando a confiança do próprio engine; quando um provedor a omite, a Dcision agora aplica as fórmulas acima em vez da maior probabilidade. Revise a minConfidence e as regras de confiança em perguntas de probabilidade no Playground e depois publique uma nova versão.
Níveis ponderados
Para toda pergunta de nota, a resposta também traz scores: o nível ponderado pela probabilidade, contado a partir de 1. Com a distribuição low 0.02 · medium 0.21 · high 0.71 · critical 0.06, o nível mais provável é high (3), e o nível ponderado é 1 × 0.02 + 2 × 0.21 + 3 × 0.71 + 4 × 0.06 = 2.81.
{
"result": { "priority": "high" },
"confidence": { "priority": 0.69 },
"scores": { "priority": 2.81 }
}- Use-o em regras com
"on": "score"para agir entre níveis —priority ≥ 3.5dispara quando o peso pende paracritical. - Os composites o usam, normalizado para 0–1, como o valor de um termo de nota.
- Use-o para limiares e ranking, não para reconstruir uma quantidade exata: níveis de nota são categorias, não uma régua.
Distribuições completas
Adicione include=probabilities à query string:
curl -X POST "https://api.dcision.io/v1/decisions/lead-qualification?include=probabilities" \
-H "Authorization: Bearer $DCISION_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "state": { "message": "We need pricing for 500 users and want to start next month.", "company_size": 500 } }'A resposta ganha um objeto probabilities, entre action_reason e metrics:
{
"result": { "purchase_intent": 0.9412, "priority": "high", "route": "sales" },
"confidence": { "purchase_intent": 0.8824, "priority": 0.69, "route": 0.85 },
"scores": { "priority": 2.81 },
"composites": { "lead_score": 0.8414 },
"action": "continue",
"action_reason": { "type": "default" },
"probabilities": {
"purchase_intent": { "yes": 0.9412, "no": 0.0588 },
"priority": { "low": 0.02, "medium": 0.21, "high": 0.71, "critical": 0.06 },
"route": { "sales": 0.88, "sdr": 0.09, "nurture": 0.02, "spam": 0, "other": 0.01 }
}
}| Tipo de pergunta | Distribuição |
|---|---|
choice | uma entrada por opção, na ordem das opções, other por último |
score | uma entrada por rótulo, do menor para o maior |
probability | { "yes": p, "no": 1 − p } |
Todos os valores são arredondados para 4 casas decimais. include aceita uma lista separada por vírgulas; probabilities é o único valor reconhecido hoje. As distribuições não mudam o preço de uma chamada.
O Playground sempre mostra as distribuições, e as execuções as guardam quando storeOutput está ligado.
Quase empates
Duas opções estão em quase empate quando a segunda colocada tem mais de 20% de probabilidade e fica menos de 15 pontos atrás da primeira — por exemplo { "sales": 0.46, "sdr": 0.40 }. O Playground sinaliza:
Quase empate: as opções do topo estão próximas. Deixe as descrições das opções mais distintas (adicione exclusões).
Um quase empate geralmente significa que duas descrições de opção se sobrepõem. Reescreva-as como critérios mutuamente exclusivos ("algum interesse, mas ainda sem orçamento nem prazo") e teste de novo — a comparação com a execução anterior mostra se a resposta mudou.
Usando distribuições no seu código
- Segunda melhor. Quando a ação é
escalate, mostre a quem revisa as duas opções do topo com suas probabilidades. - Sua própria medida. A distribuição é tudo de que você precisa para calcular outra estatística — a maior probabilidade, ou a razão entre as duas opções do topo — quando ela servir melhor à sua decisão.
- Calibre os limiares. Compare a confiança de execuções passadas — em Execuções ou via
GET /v1/executions— com o que realmente aconteceu antes de escolher umaminConfidence.
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.
Versões e deploy
Rascunhos, versões imutáveis, deploys, slugs, desativar, duplicar e excluir decisões — e o que os seus clientes da API veem em cada etapa.