Visão geral dos padrões
Os quatro padrões de arquitetura da TypeSafe — fan-out especulativo, roteamento por confiança, pontuação composta e roteamento por intenção — e como cada um se traduz em recursos e templates da Dcision.
O Jev responde perguntas pequenas e literais com rapidez. Bons sistemas combinam muitas delas. A TypeSafe documenta quatro padrões de arquitetura para fazer isso bem, e a Dcision transforma cada um em recursos de primeira classe do decision schema — com um template que o implementa de ponta a ponta.
| Padrão | O que faz | Benefícios | Na Dcision | Template |
|---|---|---|---|---|
| Fan-out especulativo | Faz numa só chamada todas as perguntas de que o fluxo pode precisar e deixa as regras decidirem quais respostas importam. | Custo, velocidade | Todas as perguntas numa decisão; condições and condicionam as respostas especulativas. | ticket-triage |
| Roteamento por confiança | Usa a confiança como um segundo eixo: a resposta diz o quê, a confiança diz se vale agir. | Confiabilidade, segurança | minConfidence por pergunta e regras on: "confidence", um limiar por ação. | voice-banking |
| Pontuação composta | Divide um julgamento em notas atômicas e as combina com pesos que você controla. | Custo, confiabilidade, velocidade | Uma pergunta por dimensão e compostos, utilizáveis em regras. | resume-screening |
| Roteamento por intenção | Classifica cada pedido com uma chamada rápida e o envia ao responsável capaz mais barato. | Custo, velocidade | Uma pergunta choice para a intenção (com o other reservado), regras para o que uma pessoa precisa ver. | customer-service-router |
Por que padrões
Toda decisão é uma chamada ao engine: o Jev lê o estado uma vez e responde todas as perguntas em paralelo, então adicionar perguntas quase não muda a latência, e a Dcision cobra uma decisão por chamada, não importa quantas perguntas ela tenha. Os padrões aproveitam isso, e o fato de que toda resposta vem com uma probabilidade calibrada:
- Pergunte mais, não com mais frequência — o fan-out responde uma árvore de decisão inteira numa ida e volta.
- Aja só quando houver segurança suficiente — o roteamento por confiança ajusta a confiança exigida ao risco de cada ação.
- Mantenha a matemática fora do modelo — a pontuação composta combina respostas atômicas com pesos guardados na decisão.
- Gaste os recursos caros por último — o roteamento por intenção manda consultas para o código, casos difíceis para LLMs especialistas e o resto para pessoas.
Os blocos de construção
| Recurso | Útil para |
|---|---|
| Até 64 perguntas por decisão, respondidas numa chamada | fan-out, pontuação composta, roteamento por intenção |
Regras de política com até 5 condições and, a primeira que casar vence | fan-out, roteamento por confiança, roteamento por intenção |
minConfidence por pergunta e regras sobre confidence | roteamento por confiança |
Níveis ponderados de perguntas score (scores, regras on: "score") | fan-out, roteamento por intenção |
Compostos, devolvidos em composites e utilizáveis em regras | pontuação composta |
A opção reservada other e a ação de fallback | roteamento por intenção, roteamento por confiança |
onEngineError: "fallback" — uma ação segura quando o engine falha | todo padrão num caminho que sempre precisa responder |
Veja Decision schema, Políticas e ações e Configurações da decisão.
Padrões no app
- Templates abre com uma seção Padrões: um card por padrão com o que ele é, quando usar, como montá-lo na Dcision, os benefícios, links para os templates que o implementam e para o guia da TypeSafe. Abaixo dela, Todos os templates mostra os padrões de cada template como badges.
- Nova decisão lista os padrões de cada template ao lado do número de perguntas.
- O painel Padrões do editor, abaixo do decision schema na aba Editor, diz quantos dos quatro padrões a decisão usa. Cada item se expande para explicar o padrão e mostrar como esta decisão o usa (Aqui) ou como adotá-lo (Experimente).
O painel detecta um padrão a partir do schema:
| Padrão | Detectado quando a decisão tem… |
|---|---|
| Fan-out especulativo | 4 ou mais perguntas, ou 3 ou mais com uma regra cujas condições usam campos diferentes |
| Roteamento por confiança | uma pergunta com confiança mínima, ou uma regra sobre confidence |
| Pontuação composta | pelo menos um composto |
| Roteamento por intenção | uma pergunta choice com pelo menos 3 opções além de other, ou uma regra sobre uma resposta choice |
Padrões se combinam
A maioria das decisões em produção usa mais de um padrão. O template Qualificação de leads encaminha o lead para um time (roteamento por intenção), escala quando purchase_intent não tem confiança suficiente (roteamento por confiança) e ranqueia os leads com lead_score (pontuação composta) — numa chamada. Templates lista os padrões de cada template.
Escreva perguntas que o engine consegue responder
Os padrões combinam respostas; cada resposta ainda precisa ser boa. Mantenha as perguntas atômicas e literais, deixe matemática e datas no código e envie só o estado de que as perguntas precisam — veja Escrevendo boas perguntas.
Execuções e uso
Toda execução é registrada com a versão, o motivo da ação, a confiança e — se você permitir — a entrada e a saída. Encontre execuções, leia o uso e saiba por quanto tempo os logs ficam guardados.
Fan-out especulativo
Faça numa só chamada todas as perguntas de que um fluxo pode precisar — o Jev responde em paralelo — e deixe as regras AND e o seu código decidirem quais respostas importam. Baseado no template de triagem de tickets.