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 perguntaA confiança é…Fórmula
choiceo 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)
scoreo 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 distante1 − spread / spread of an even distribution, com piso em 0
probabilitya 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.88 tem confiança 0.85. Uma probabilidade de 0.9412 tem confiança 0.8824; 0.03 tem 0.94; 0.5 tem 0.
  • 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.

minConfidenceSinaliza probabilidades entre
0.50,25 e 0,75
0.60,2 e 0,8
0.80,1 e 0,9
0.90,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.5 dispara quando o peso pende para critical.
  • 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 perguntaDistribuição
choiceuma entrada por opção, na ordem das opções, other por último
scoreuma 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 uma minConfidence.

Nesta página