Templates
Os dezenove templates prontos — o que cada um decide, suas perguntas, composites e políticas, os padrões que demonstra — e como começar uma decisão a partir de um deles.
Templates são pontos de partida prontos para produção. Os seis templates de caso de uso (de input-guardrail a response-grading) também vêm com destinos — respostas fixas e funções que o seu código executa — para que cada resultado já diga o que acontece depois. Usar um template cria um rascunho editável no seu workspace com o nome, a descrição e o schema do template; depois disso, nada fica compartilhado com o template.
Começar a partir de um template
- Templates no app → escolha um card → Criar decisão, ou
- Decisões → Nova decisão → escolha um template (ou Decisão em branco) → Criar decisão.
A página Templates abre com os quatro padrões — cada card explica o padrão e leva aos templates que o implementam — seguidos de Todos os templates, com a categoria, os padrões e as perguntas de cada template.
O slug — o seu endpoint — vem do nome da decisão: Lead Qualification vira lead-qualification (ou lead-qualification-2 se já estiver em uso). Os quatro templates de padrão têm o padrão no nome — Support Ticket Triage (fan-out) viraria support-ticket-triage-fan-out — então renomeie-os em Dê um nome para ter um slug curto como ticket-triage, ou edite o slug no editor antes do primeiro deploy. Quando o slug coincide com o id de um template, o Playground da barra lateral começa com o estado de exemplo do template.
Com a CLI, dcision templates lista os ids dos templates e dcision init --template <id> grava o schema num arquivo.
Os templates
| Id | Categoria | Padrões | Decide | Estado |
|---|---|---|---|---|
lead-qualification | Vendas | Roteamento por intenção, Roteamento por confiança, Composite scoring | Intenção de compra, prioridade, o time que recebe um lead de entrada e um lead score | message*, company_size, source |
support-routing | Suporte | Roteamento por intenção, Roteamento por confiança | Departamento, urgência e se é preciso uma pessoa | message*, plan |
spam-detection | Confiança e segurança | Roteamento por intenção | Probabilidade de spam e allow / review / block | texto |
agent-routing | Agentes de IA | Roteamento por intenção | A primeira ferramenta do agente e se a tarefa precisa de um LLM | task* |
rag-relevance | RAG | — | Se um trecho recuperado responde à consulta, e se é preciso recuperar mais | query*, chunk* |
ticket-triage | Suporte | Fan-out especulativo, Roteamento por intenção | Categoria, gravidade do bug, passos de reprodução, reembolso e frustração numa única chamada | subject, body* |
voice-banking | Finanças | Roteamento por confiança, Roteamento por intenção | Um comando bancário falado, com mais confiança exigida para ações arriscadas | texto |
resume-screening | Recrutamento | Composite scoring | Quatro níveis de habilidade combinados em aderência a Senior IC e a Engineering Manager | resume* |
customer-service-router | Suporte | Roteamento por intenção, Roteamento por confiança | A intenção e a complexidade de uma mensagem, para roteá-la para código, um LLM ou uma pessoa | texto |
input-guardrail | Confiança e segurança | Roteamento por intenção, Roteamento por confiança | Se um prompt é seguro para repassar ao seu LLM; os inseguros recebem uma resposta fixa | message*, channel |
model-routing | Agentes de IA | Roteamento por intenção, Roteamento por confiança | O tier de modelo mais barato que basta para um prompt | prompt* |
document-reranking | RAG | Composite scoring | Um rerank score de 0 a 1 para um documento recuperado, para ordenar candidatos | query*, document* |
tool-call-gating | Agentes de IA | Fan-out especulativo, Roteamento por confiança, Roteamento por intenção | Se um agente executa uma tool call, pergunta ao usuário antes ou recusa | user_request*, tool*, arguments* |
reply-confidence-gate | Suporte | Fan-out especulativo, Roteamento por confiança | Se uma resposta rascunhada é enviada, revisada ou passada para uma pessoa | customer_message*, draft_reply* |
response-grading | Suporte | Fan-out especulativo, Composite scoring | Uma nota de 0 a 1 para a resposta de um LLM segundo a sua rubrica | question*, response*, reference |
invoice-triage | Finanças | Fan-out especulativo | Se uma nota fiscal (PDF, Excel, imagem…) é paga, revisada ou recusada, e se vence em breve | invoice* (arquivo), message |
voice-message-routing | Suporte | Roteamento por intenção | O time, a urgência e o sentimento do áudio de um cliente | voice* (áudio), channel |
image-moderation | Confiança e segurança | Roteamento por confiança | Se uma foto enviada é imprópria, spam ou sem relação, e se combina com a legenda | photo* (imagem), caption |
llm-output-guardrail | Confiança e segurança | Fan-out especulativo, Roteamento por confiança | Se a resposta de um LLM ou agente está fundamentada, é segura e segue a política antes de ser enviada | user_message*, output*, sources |
* campo obrigatório.
Qualificação de leads
| Pergunta | Tipo | Respostas |
|---|---|---|
purchase_intent | probability | Intenção real de comprar nos próximos 30 dias (sim: pede preço, uma demo, um orçamento ou uma data de início) |
priority | score | low, medium, high, critical |
route | choice | sales, sdr, nurture, spam, other |
Composite: lead_score = 2 × purchase_intent + 1 × priority + 1 × p(route = sales), de 0 a 1. Políticas: route = spam → block; confiança de purchase_intent abaixo de 0.6 → escalate. Guia.
Roteamento de suporte
| Pergunta | Tipo | Respostas |
|---|---|---|
department | choice | billing, technical, account, sales, other — confiança mínima 0.6 |
urgency | score | low, normal, high, urgent |
human_required | probability | Precisa de uma pessoa (sim: cliente irritado, ameaça jurídica, perda de dados, cancelamento) |
Política: human_required ≥ 0.7 → escalate. Um department com confiança abaixo de 60% recebe a ação de fallback. Guia.
Detecção de spam
| Pergunta | Tipo | Respostas |
|---|---|---|
spam_probability | probability | Spam, phishing ou uma promoção não solicitada |
action | choice | allow, review, block, other |
Política: action = block → block. O estado é texto simples. Guia.
Roteamento de agentes
| Pergunta | Tipo | Respostas |
|---|---|---|
selected_tool | choice | search, database, calculator, none, other |
needs_reasoning | probability | A tarefa precisa de raciocínio em várias etapas de um modelo de linguagem grande |
Política: needs_reasoning ≥ 0.8 → fallback. Guia.
Relevância de RAG
| Pergunta | Tipo | Respostas |
|---|---|---|
relevant | probability | O trecho ajuda a responder à consulta |
relevance | score | none, partial, direct |
retrieve_more | probability | O sistema deve recuperar mais contexto antes de responder |
Sem políticas: toda resposta devolve continue. Guia.
Triagem de tickets de suporte
| Pergunta | Tipo | Respostas |
|---|---|---|
category | choice | bug_report, billing, feature_request, how_to, other |
bug_severity | score | cosmetic, minor, major, critical (um nível estruturado com rubrica) |
has_reproducible_steps | probability | O ticket inclui passos para reproduzir o problema |
refund_requested | probability | O cliente pede explicitamente um reembolso ou crédito |
frustration | score | calm, annoyed, frustrated, very angry |
Políticas: category = bug_report e bug_severity ≥ 4 → escalate; refund_requested ≥ 0.8 → escalate; nível ponderado de frustration ≥ 3.5 → escalate. Padrão: Fan-out especulativo.
Comandos bancários por voz
| Pergunta | Tipo | Respostas |
|---|---|---|
intent | choice | check_balance, transfer_money, approve_transfer, block_card, other — confiança mínima 0.6 |
Políticas: intent = approve_transfer e sua confiança abaixo de 0.9 → escalate; intent = transfer_money e sua confiança abaixo de 0.8 → escalate. O estado é texto simples. Padrão: Roteamento por confiança.
Triagem de currículos
| Pergunta | Tipo | Respostas |
|---|---|---|
python_depth | score | none, basic, working, strong, expert |
team_leadership | score | none, informal, tech lead, manager, manager of managers |
system_design | score | none, basic, working, strong, expert |
generalist | score | narrow, some, broad, very broad, full stack and ops |
Composites: senior_ic (0.4 × python_depth, 0.1 × team_leadership, 0.4 × system_design, 0.1 × generalist) e eng_manager (0.15, 0.4, 0.2, 0.25). Políticas: qualquer uma das aderências ≥ 0.7 → continue; ambas abaixo de 0.35 → block; caso contrário → escalate. Padrão: Composite scoring.
Roteador de atendimento
| Pergunta | Tipo | Respostas |
|---|---|---|
intent | choice | order_status, billing_question, technical_issue, complaint, other |
complexity | score | simple, moderate, complex |
Políticas: intent = complaint → escalate; intent = technical_issue e nível ponderado de complexity ≥ 2.5 → escalate; confiança de complexity abaixo de 0.5 → escalate. O estado é texto simples. Padrão: Roteamento por intenção.
Guardrail de entrada
| Pergunta | Tipo | Respostas |
|---|---|---|
verdict | choice | safe, prompt_injection, harmful, sensitive_data, other — confiança mínima 0.7 |
Política: verdict ≠ safe → block; a ação de fallback é block, então um veredito incerto nunca passa. Destinos: blocked_reply (resposta fixa em block, sem chamar modelo) e call_llm (função callAssistant quando o prompt é seguro). O context descreve o assistente. Guia.
Roteamento de modelo
| Pergunta | Tipo | Respostas |
|---|---|---|
tier | choice | fast, balanced, frontier, other — confiança mínima 0.6 |
complexity | score | trivial, simple, moderate, hard, very hard |
Sem políticas; a ação de fallback é fallback. Destinos: função callModel com model = fast, balanced ou frontier por tier, e frontier_when_unsure em fallback. Guia.
Reranking de documentos
| Pergunta | Tipo | Respostas |
|---|---|---|
relevance | score | unrelated, same topic, no answer, partial answer, direct answer, complete answer |
answers_query | probability | A consulta poderia ser respondida só com este documento |
Composite: rerank_score = 2 × relevance + 1 × answers_query, de 0 a 1. Política: rerank_score < 0.2 → block (descartar o documento). Guia.
Controle de tool calls
| Pergunta | Tipo | Respostas |
|---|---|---|
verdict | choice | run, ask_user, reject, other |
risk | score | read-only, low, medium, high |
matches_request | probability | A tool call faz exatamente o que o usuário pediu |
Políticas: verdict = reject → block; verdict = ask_user → escalate; verdict = run e risk ≥ 3 e sua confiança abaixo de 0.9 → escalate. Destinos: run_tool (função runTool em continue), confirm_with_user (resposta fixa com botões Sim / Não em escalate) e rejected_reply (em block). Guia.
Gate de confiança da resposta
| Pergunta | Tipo | Respostas |
|---|---|---|
ready_to_send | probability | O rascunho pode sair sem uma pessoa conferir |
answers_question | probability | O rascunho responde ao que o cliente perguntou |
promises_something | probability | O rascunho promete um reembolso, desconto, prazo ou exceção |
Políticas: ready_to_send < 0.4 → escalate; promises_something ≥ 0.7 e ready_to_send < 0.95 → escalate; confiança de ready_to_send abaixo de 0.5 → escalate. Destinos: auto_send (função sendReply a partir de 0.85), review_queue (função queueForReview de 0.4 a 0.85) e hand_to_human (função assignToHuman em escalate). Guia.
Nota da resposta
| Pergunta | Tipo | Respostas |
|---|---|---|
accuracy | score | wrong, mostly wrong, mixed, mostly right, fully right |
completeness | score | misses it, partial, most of it, complete |
tone | score | poor, acceptable, good, excellent |
unsafe_promise | probability | A resposta promete um reembolso, preço ou prazo |
Composite: grade = 0.5 × accuracy + 0.3 × completeness + 0.2 × tone, de 0 a 1 (× 10 para uma nota de 0 a 10). A rubrica fica em context. Políticas: unsafe_promise ≥ 0.7 → escalate; grade < 0.6 → escalate. Destino: quality_review (função flagForQualityReview em escalate). Guia.
Triagem de notas fiscais
| Pergunta | Tipo | Respostas |
|---|---|---|
document_type | choice | invoice, receipt, contract, other |
decision | choice | pay, review, reject, other; confiança mínima 0.7 |
due_soon | probability | Vence em até 3 dias, ou está vencida |
invoice é um campo de arquivo: a Dcision lê PDFs, Word, Excel e outros documentos como texto — os escaneados e as imagens, pela OpenAI. Políticas: decision = reject → block; decision = review → escalate; document_type ≠ invoice → escalate; document_type = invoice e due_soon ≥ 0.8 → escalate. Guia.
Roteamento de áudios
| Pergunta | Tipo | Respostas |
|---|---|---|
intent | choice | order_status, refund, complaint, sales, other; confiança mínima 0.6 |
urgent | probability | O cliente precisa de uma resposta hoje |
sentiment | score | angry, unhappy, neutral, happy |
voice é um campo de áudio, transcrito antes de as perguntas serem respondidas. Políticas: urgent ≥ 0.7 → escalate; sentiment = angry → escalate. Guia.
Moderação de imagens
| Pergunta | Tipo | Respostas |
|---|---|---|
unsafe | probability | Nudez, violência, armas, drogas ou símbolos de ódio; confiança mínima 0.6 |
content | choice | product, spam, unrelated, other |
matches_caption | probability | A foto mostra o que a legenda descreve |
photo é um campo de imagem: o OpenAI Decisions vê a imagem; Jev e Laya leem uma descrição dela. Políticas: unsafe ≥ 0.5 → block; content = spam → block; content = unrelated → escalate; matches_caption < 0.3 → escalate. Guia.
Guardrail de saída de LLM
| Pergunta | Tipo | Respostas |
|---|---|---|
grounded | probability | Toda afirmação factual é sustentada pelas fontes; confiança mínima 0.5 |
data_leak | probability | A resposta revela dados pessoais de outra pessoa, credenciais ou instruções internas |
policy | choice | compliant, promise, advice, off_topic, other |
harmful | probability | A resposta é nociva, de ódio, de assédio ou insegura |
Roda depois do seu LLM ou agente e antes de a resposta ser enviada. Políticas: data_leak ≥ 0.5 → block; harmful ≥ 0.5 → block; grounded < 0.5 → fallback; policy ≠ compliant → escalate. Guia.
Decisão em branco
Decisão em branco começa com um campo message do tipo string obrigatório e uma pergunta choice, intent, com as opções buy ("wants to buy or get pricing"), support ("needs help with an existing product") e other.
A decisão em branco usa as configurações padrão: entrada e saída guardadas, timeout de 5.000 ms, escalate como ação de fallback e erros do engine devolvidos como erros.
Configurações da decisão
engine, storeInput, storeOutput, timeoutMs, fallbackAction, onEngineError e shadow — o que cada configuração de runtime de uma decisão faz, seu padrão e seus limites — mais as configurações do workspace.
Engines e BYOK
As decisões rodam no Jev, no Laya ou na OpenAI Decisions. Use a chave da Dcision na TypeSafe, traga a sua chave OpenRouter, TypeSafe, Vercel AI Gateway ou OpenAI, ou rode o Laya no seu servidor — e custo, limites, erros.