Changelog

Notas de versão da Dcision — v1.9 modo sombra e GPT-Live; v1.8 arquivos; v1.7 engine OpenAI; v1.6 mover sub-workspaces; v1.5 prompts de 32k; v1.4 parceiros; v1.3 execuções; v1.0 construtor; v0.1 lançamento.

v1.9 — 18 de outubro de 2026 · Modo sombra, comparação de engines e GPT-Live

  • Recusas têm motivo próprio. Uma pergunta que a OpenAI Decisions se recusa a responder não faz mais a execução falhar: ela responde 200 sem essa pergunta em result, e a decisão toma a sua ação de fallback com action_reason: { "type": "refusal", "question": "<key>" }. Ordem: políticas → recusa → other → baixa confiança → continue. Veja Como a ação é calculada.
  • Leitura de arquivos em metrics: input_files, input_processing_ms e input_cost_usd quando o estado tem arquivos, e estimated_cost_usd agora inclui o custo da transcrição (gpt-4o-transcribe), da descrição de imagens e da leitura de arquivos (gpt-5-mini). Veja Entradas.
  • Webhook de entrada com arquivos: POST /v1/hooks/{token} aceita multipart/form-data — campos de texto viram strings do estado, arquivos vão para campos image, audio e file, e uma parte state opcional traz o JSON de partida — e bodies de até 32 MB. O estado sem os arquivos continua limitado a 128 KB. Veja Envie arquivos.
  • Quatro novos templates: Triagem de notas fiscais (invoice-triage), Roteamento de áudios (voice-message-routing), Moderação de imagens (image-moderation) e Guardrail de saída de LLM (llm-output-guardrail) — a Dcision antes do LLM para rotear, e depois dele como guardrail. O site tem uma nova seção Use antes e depois do LLM.
  • Modo sombra: settings.shadow = { engine, sampleRate } roda uma amostra das execuções de produção (10% por padrão) num segundo engine em segundo plano — mesma entrada, sem efeito na resposta, sem créditos da Dcision, sem destinos. O card Modo sombra da Visão geral mostra a concordância no geral e por pergunta. Veja shadow.
  • Playground → Comparar motores: o mesmo estado e o mesmo rascunho no Jev, no Laya e na OpenAI Decisions de uma vez, lado a lado, com as divergências destacadas. Veja Compare os engines.
  • GPT-Live: GET /v1/decisions/{slug}/openai-live exporta uma decisão publicada como a delegation de uma sessão de voz em tempo real da OpenAI, e POST /v1/decisions/{slug}/openai-live/answers roda as políticas, os destinos e o log sobre as respostas da sessão — cobrado como uma execução, sem custo de engine. Veja o guia do GPT-Live.

v1.8 — 17 de outubro de 2026 · Imagens, voz e documentos como entrada

  • Novos tipos de campo de estado image, audio e file: envie uma foto, um áudio ou um documento — PDF, Word, Excel, PowerPoint, OpenDocument, CSV, RTF, HTML, texto e mais — como uma URL data:, uma URL https:// ou { "data", "filename" }. Veja Entradas.
  • A própria Dcision lê os documentos e os converte em texto (sem custo), transcreve o áudio e, para Jev e Laya, descreve as imagens com a OpenAI; a OpenAI Decisions recebe as imagens como imagens. O engine, os destinos e o log de execuções veem { kind, file, text, … } — nunca os bytes.
  • Requisições de execução (POST /v1/decisions/{slug} e o Playground) aceitam até 32 MB: 20 MB por arquivo, 24 MB por estado. Um estado acima de 128 KB sem arquivos agora responde 422 INVALID_STATE em vez de 413.
  • Playground: um seletor de arquivo por campo de arquivo e Gravar para campos de áudio. SDKs: fileFromBytes / fileFromUrl (TypeScript), file_from_path / file_from_bytes / file_from_url (Python). CLI: --file <field>=<path>.

v1.7 — 17 de outubro de 2026 · OpenAI Decisions como terceiro engine

  • A OpenAI Decisions se junta a Jev e Laya: escolha-a como engine padrão do workspace em Configurações → Engine, ou para uma decisão em Engine e runtime → Engine (settings.engine: "openai"). O Jev continua sendo o padrão. As decisões rodam sem mudanças — perguntas probability vão como predicate da OpenAI. Veja OpenAI Decisions.
  • Roda na sua chave OpenAI (Configurações → Engine → Chave OpenAI), cobrada pela OpenAI a US$ 0,10 por 1M de tokens de entrada; metrics.engine é "openai" e metrics.model o modelo exato, por exemplo gpt-6-luna.
  • Uma pergunta que a OpenAI se recusa a responder faz a execução falhar com ENGINE_ERROR (ou cair na ação de fallback com onEngineError: "fallback"). Uma conta OpenAI sem créditos responde ENGINE_AUTH_FAILED na hora, sem retries.

v1.6 — 9 de outubro de 2026 · Parceiros: mover decisões, abrir sub-workspaces no app

  • Mova uma decisão para um sub-workspace com todo o seu histórico — versões, execuções, entregas e chat do agente: POST /v1/decisions/{slug}/move (to, replace_empty) ou ⋯ → Mover para um sub-workspace na página da decisão (Owners e Admins). O uso já cobrado fica no seu workspace. Depois da mudança, chame a decisão com Dcision-Workspace.
  • Novo código de erro SLUG_TAKEN (409): o sub-workspace já tem uma decisão com esse slug. replace_empty: true substitui uma cópia que nunca rodou.
  • Configurações → Parceiro → Abrir mostra as decisões de um sub-workspace dentro do app da Dcision. Os membros do seu workspace as editam; Viewers só leem.

v1.5 — 9 de outubro de 2026 · Prompts de agente mais longos, schemas maiores

  • Instruções de agente com até 32.000 caracteres (eram 8.000): o prompt da rota de um destino de agente agora comporta um playbook inteiro. O contador do editor mostra o novo limite; um prompt mais longo é recusado em destinations.N.agent.instructions com "The route's prompt can have at most 32,000 characters." Prompts de LLM e instruções de saída estruturada continuam em 8.000.
  • Decision schemas de até 1 MB: salvar um rascunho, o Playground e POST /mcp (validate_schema, create_decision, update_decision) aceitam corpos de até 1 MB, então uma decisão com muitas rotas de agente longas é salva. Todas as outras requisições mantêm o limite de 128 KB, e o estado continua limitado a 128 KB em todo lugar (INVALID_STATE). Veja Limites.

v1.4 — 9 de outubro de 2026 · Parceiros: sub-workspaces e o editor embutível

Agora os apps podem oferecer a Dcision aos seus próprios clientes. Ative o modo parceiro em Configurações → Parceiro (guia).

  • Sub-workspaces: um por cliente do seu app, pelo seu próprio id — POST /v1/workspaces o cria ou atualiza (external_id), copiando para ele, se você quiser, as suas decisões publicadas. Decisões, execuções e destinos ficam isolados por cliente; o uso é cobrado no seu workspace, com limites opcionais por cliente.
  • Header Dcision-Workspace: a sua API key executa, lê e constrói no sub-workspace de um cliente — em /v1/decisions, /v1/me, /v1/executions e no servidor MCP.
  • Editor embutível: POST /v1/embed/sessions abre a Dcision para um dos seus usuários finais dentro do seu app (iframe): lista de decisões, templates, criação com o agente, editor, construtor visual, playground, deploy e execuções — com permissões por sessão e eventos para a sua página. @dcision/embed faz a montagem.
  • MCP: list_workspaces e upsert_workspace. O servidor agora tem catorze ferramentas: get_account, list_decisions, get_decision, check_state, run_decision, list_executions, list_templates, get_template, validate_schema, create_decision, update_decision, deploy_decision, list_workspaces e upsert_workspace.
  • Novo código de erro WORKSPACE_NOT_FOUND (404). O limite de decisões do plano também conta as decisões dos seus sub-workspaces.

v1.3 — 8 de outubro de 2026 · Aba Execuções

  • Cada decisão tem uma aba Execuções: as suas execuções, com filtros por status, origem (API, Playground, webhook), ação, versão (ou rascunho), período e ID da execução. Clicar numa execução abre os detalhes numa gaveta lateral — entrada, respostas, saída estruturada, distribuições, destinos — com links para as execuções mais novas e mais antigas. O link da gaveta (?id=exec_…) pode ser compartilhado.
  • A página Execuções do workspace usa os mesmos filtros e a mesma gaveta.

v1.2 — 8 de outubro de 2026 · Regerar API keys

  • Regerar em API Keys substitui uma chave por um novo segredo, mantendo o nome e o ambiente. A chave antiga para de funcionar na hora (INVALID_API_KEY); a nova é mostrada uma única vez. Use para rotacionar uma chave que vazou ou como rotação de rotina.
  • Endpoint do painel: POST /api-keys/{id}/regenerate (só por sessão — API keys não podem rotacionar a si mesmas).

v1.1 — 8 de outubro de 2026 · Construa decisões via MCP

Agora os agentes podem criar, editar e publicar decisões pelo servidor MCP.

  • create_decision cria um rascunho a partir de um schema; update_decision edita o rascunho; deploy_decision o publica (anotada como destrutiva, para que os clientes perguntem antes).
  • As escritas são feitas em nome do autor da API key. Excluir e desativar decisões continua sendo feito no app.
  • O servidor agora tem doze ferramentas: get_account, list_decisions, get_decision, check_state, run_decision, list_executions, list_templates, get_template, validate_schema, create_decision, update_decision e deploy_decision.

v1.0 — 8 de outubro de 2026 · Criar com o agente

Descreva uma decisão e o agente da Dcision a constrói. Veja Criar com o agente.

  • Nova decisão começa com Descreva a decisão: o agente cria as perguntas, as regras e os destinos; os templates e a decisão em branco ficam abaixo.
  • Construtor visual: a coluna da esquerda tem as abas Chat e Componentes. Cada mudança que o agente faz entra como uma nova revisão do rascunho e aparece no canvas ao vivo.
  • O agente trabalha só na decisão da conversa, nunca faz deploy e nunca lida com segredos. Viewers podem ler a conversa.

v0.9 — 7 de outubro de 2026 · Templates de casos de uso

Seis novos templates para os pontos em que um modelo de decisão se encaixa em volta de um LLM — cada um vem com as suas regras e os seus destinos, então cada resultado já diz o que acontece depois. Veja Templates.

  • input-guardrail — o prompt é seguro para repassar? Os inseguros recebem uma resposta fixa, sem chamar nenhum modelo.
  • model-routing — o nível de modelo mais barato que basta (fast, balanced, frontier); prompts pouco claros vão para o modelo frontier.
  • document-reranking — um rerank_score de 0 a 1 por documento recuperado, para ordenar os candidatos e descartar os irrelevantes.
  • tool-call-gating — executar a ferramenta, pedir confirmação ao usuário (com botões Sim / Não) ou recusar; chamadas arriscadas exigem 90% de confiança.
  • reply-confidence-gate — envio automático a partir de 0,85, revisão de 0,4 a 0,85, uma pessoa abaixo de 0,4.
  • response-grading — precisão, completude e tom contra a rubrica em context, combinados numa grade de 0 a 1.

Cada um tem um guia com uma chamada curl e o código que age sobre a resposta. Quinze templates no total.

v0.8 — 7 de outubro de 2026 · Telas (json-render)

Uma saída estruturada agora pode ser uma tela: com "format": "ui", ela devolve uma spec do json-render que o seu app renderiza nativamente. Veja Telas.

  • Catálogo: um subconjunto exato dos componentes shadcn do json-render — Card, Stack, Grid, Separator, Heading, Text, Badge, Alert, Table, Image, Avatar, Progress, Button e Link — com as ações reply e open_url. Renderize com @json-render/react + @json-render/shadcn.
  • Construída a partir de um template (sem modelo) ou por um LLM com a sua chave OpenRouter ou Vercel AI Gateway, a partir do prompt de catálogo do json-render.
  • Verificada antes de sair da Dcision: as correções automáticas e as checagens de estrutura do json-render, mais props por componente, ações conhecidas com parâmetros válidos, apenas links e imagens https://, apenas valores finais. Telas de LLM que falham recebem um reparo.
  • O editor mostra a prévia da tela enquanto você digita; o Playground e o log de execuções a renderizam.

v0.7 — 7 de outubro de 2026 · Saída estruturada

Agora as decisões podem devolver um objeto pronto para o seu sistema, validado contra campos que você define. Veja Saída estruturada.

Destinos

  • Novo tipo de destino json (Saída estruturada). Defina os campos da saída (um objeto JSON Schema — texto, números, sim/não, listas, objetos aninhados, valores permitidos) e preencha-os de duas formas: template monta o objeto a partir do estado, das respostas e dos parâmetros, sem chamar modelo; extract deixa um LLM preenchê-lo a partir do estado, na sua chave OpenRouter ou Vercel AI Gateway, no modo estrito de saída estruturada do provedor, com um reparo automático.
  • output na resposta. POST /v1/decisions/{slug} devolve o objeto da primeira saída estruturada concluída num output de nível superior (null quando nenhuma pôde ser montada). Uma saída estruturada nunca faz a decisão falhar: um problema volta na sua entrada com issues (JSON Pointer + mensagem).
  • GET /v1/executions devolve output quando a decisão armazena saídas; com storeOutput desligado, ele não é guardado.
  • Os SDKs expõem decision.output — dcision.decide<Result, Output>(…) o tipa em TypeScript — e a CLI o imprime.
  • Renomear uma pergunta agora também atualiza as variáveis em respostas fixas, prompts de LLM e de agente, URLs de workflow e templates de saída estruturada.

v0.6 — 6 de outubro de 2026 · Engine Laya

Agora as decisões podem rodar no Laya, um modelo de decisão open source (Apache 2.0) da Convai Innovations, além do Jev. Veja Engines e BYOK.

Engines

  • Engine padrão por workspace. Configurações → Engine escolhe Jev ou Laya para todas as decisões do workspace; cada engine mantém a sua própria credencial e o seu modelo.
  • Engine por decisão. O novo settings.engine opcional ("jev" ou "laya") fixa uma decisão num engine; sem ele, a decisão segue o padrão do workspace.
  • Laya no seu servidor. Salve a URL do seu laya-serve — e a sua LAYA_API_KEY, se definida — em Configurações → Engine → Servidor Laya, e depois clique em Testar. Modelos: auto (o Laya escolhe o checkpoint pelo idioma), english, multilingual, typed-decisions. A Dcision só chama endereços https:// públicos.
  • metrics.engine agora informa o engine que rodou ("jev" ou "laya"), e metrics.model o checkpoint do Laya que respondeu, por exemplo laya/multilingual. Chamadas ao Laya são estimadas com estimated_cost_usd: 0.

v0.5 — 6 de outubro de 2026 · Créditos pré-pagos

As decisões além do volume incluído no plano agora são pagas com créditos pré-pagos, em vez de excedente na fatura. Veja Créditos.

Cobrança

  • Plano + créditos. Os planos mantêm as decisões incluídas por ciclo de cobrança; além delas, as decisões são pagas com os créditos do workspace ao preço por 1M do plano — US$ 12 (R$ 60) no Genesis e no Developer, US$ 9 (R$ 45) no Growth. As assinaturas cobram apenas o preço base.
  • O Genesis deixa de ser um limite rígido: depois do seu 1M de decisões grátis por mês, ele continua rodando enquanto o workspace tiver créditos. GET /v1/me agora informa plan.hard_cap: false para o Genesis.
  • Ordem de consumo: as decisões incluídas, depois os créditos promocionais (primeiro os que expiram antes), depois o saldo pago, que nunca expira.
  • Bônus por cartão: adicionar um cartão dá US$ 20 (R$ 100) em créditos promocionais, válidos por 90 dias — uma vez por workspace e uma vez por cartão.
  • Compre créditos com cartão no checkout da Stripe, de US$ 10 a US$ 1.000 (R$ 50 a R$ 5.000) por compra, na moeda de cobrança do workspace.
  • Recarga automática (opcional, com o consentimento explícito do Owner): quando o crédito disponível cai abaixo de um gatilho, o cartão salvo é cobrado no valor escolhido — no máximo 10 vezes em 24 horas; um cartão recusado a pausa e envia um e-mail aos owners.
  • Teto de gastos por ciclo de cobrança (opcional, ilimitado por padrão) e vouchers que adicionam créditos promocionais.
  • Só o Owner compra créditos e muda essas configurações; todos os demais no workspace veem os créditos apenas para leitura.

API

  • Novos erros: 402 CREDITS_EXHAUSTED — as decisões incluídas acabaram e não há créditos restantes — e 402 SPEND_CAP_REACHED — o teto de gastos do ciclo foi atingido. 402 QUOTA_EXCEEDED permanece apenas para planos configurados com limite rígido ou sem preço por 1M. Veja Erros.

v0.4 — 5 de outubro de 2026 · Servidor MCP, Claude Code e webhooks de entrada

Agora os agentes podem usar a Dcision diretamente, e qualquer sistema pode disparar uma decisão com uma URL.

Servidor MCP

  • https://api.dcision.io/mcp, um servidor MCP remoto (Streamable HTTP) autenticado com a sua API key: get_account, list_decisions, get_decision, check_state, run_decision, list_executions, list_templates, get_template e validate_schema. Mesmas chaves, limites e cobrança da API; só run_decision é cobrada. Veja Servidor MCP.
  • Funciona com Claude Code, Cursor, VS Code, Claude Desktop, Codex e Gemini CLI — e com curl puro.

Claude Code

  • A skill da Dcision, publicada em https://docs.dcision.io/skills/dcision/SKILL.md: como as decisões funcionam, como escrever e validar um decision schema, quais chamadas são cobradas e como usar a API com curl quando o servidor MCP não está conectado. Veja Usar a Dcision no Claude Code.

Webhook de entrada

  • Toda decisão pode ter uma URL de webhook — POST https://api.dcision.io/v1/hooks/whk_… — que roda a sua versão ativa sem API key, para formulários, CRMs, Zapier, n8n e Make. Envie { "state": … } ou o payload bruto, e proteja-a com um segredo whsec_: um HMAC Dcision-Signature com janela de 300 segundos, ou Authorization: Bearer whsec_…. Veja Webhook de entrada.
  • Gerenciado na nova aba Avançado da decisão: ligue ou desligue, rotacione a URL, gere o segredo, envie um teste e acompanhe as chamadas mais recentes ao vivo.
  • Execuções por webhook são cobradas como chamadas de API e aparecem nas execuções com source: "webhook".

API

  • GET /v1/decisions lista as decisões do workspace e GET /v1/decisions/{slug} devolve o que a versão ativa de uma decisão aceita e responde — state schema, perguntas e opções, ações e um estado de exemplo. Ambos usam a janela de rate limit de leitura e não são cobrados.

v0.3 — 5 de outubro de 2026 · Destinos, times e SDKs

As decisões agora agem sobre os seus resultados, os workspaces viram times e chegam os SDKs oficiais.

Destinos

  • O que acontece depois, por resultado. Associe destinos a uma opção de escolha, um nível de nota, um limiar de probabilidade ou uma ação final. Sete tipos: respostas fixas e respostas de LLM devolvidas na resposta, agentes que respondem ou assumem o atendimento, workflows (n8n, Make, Zapier, Pipedream), webhooks assinados, requisições de API com variáveis e segredos, e funções que o seu código executa.
  • No editor: um seletor Destino em cada opção e nível, Destino quando … ≥ … em perguntas de probabilidade, uma confiança mínima por rota e nós de destino no construtor visual — cuja paleta e cujo inspetor agora podem ser recolhidos.
  • Entregues para você: webhooks, requisições de API, workflows e passagens para agentes são entregues pelo menos uma vez, com 6 tentativas ao longo de cerca de 7 horas, Retry-After, timeout de 10 segundos, sem redirecionamentos, proteção contra SSRF e um HMAC Dcision-Signature com rotação sem downtime. Entregas que falharam podem ser reenviadas.
  • Segredos do workspace ({{secrets.NAME}}), criptografados e mascarados em todo lugar.
  • Testados com segurança: o Playground mostra a prévia dos destinos — com segredos mascarados — até você ativar Executar destinos de verdade; chaves de teste e o Playground entregam com livemode: false.
  • API: as respostas trazem um array destinations, GET /v1/executions também o devolve, e o documento OpenAPI descreve o evento de webhook decision.completed.

Times e contas

  • Papéis: Owner, Admin, Member e Viewer, aplicados em toda requisição do app. 403 FORBIDDEN agora também cobre recusas por papel; perder o acesso a um workspace responde com details.reason = "workspace_access".
  • Convites por e-mail, válidos por 7 dias, aceitos no login ou pelo link.
  • Vários workspaces por pessoa — até 10 como owner — com dados da organização impressos nas faturas; sair, remover, transferir a propriedade e excluir um workspace.
  • Contas: uma senha opcional, Sair de todos os dispositivos e um idioma para os e-mails — inglês, português, espanhol, russo ou chinês.

Veja Time, papéis e conta.

Visão geral

  • Toda decisão abre numa aba Visão geral: execuções, taxa de sucesso, latência, custo, ações e motivos, estatísticas por pergunta das 2.000 execuções mais recentes, contagens de destinos e sugestões de calibração — a partir de 20 execuções, cada uma com os números por trás dela. Veja Visão geral e calibração.

SDKs

  • @dcision/sdk (TypeScript, Node.js, Bun, Deno, edge) e dcision (Python 3.9+): decide com retries que nunca executam uma decisão duas vezes, despacho de funções, verificação de webhooks, me() e execuções. Ainda não publicados: compile-os a partir do código-fonte — veja SDKs.

API

  • As chaves de idempotência são reservadas antes da execução. Uma requisição concorrente com a mesma chave recebe 409 IDEMPOTENCY_CONFLICT com Retry-After: 1 em vez de rodar de novo; erros liberam a chave. Veja Idempotência.
  • 413 PAYLOAD_TOO_LARGE para corpos acima de 128 KB (antes era INVALID_REQUEST com status 413), e 409 CONFLICT quando duas criações concorrem.
  • GET /openapi.json está documentado.

Decisões

  • Validação de regras mais rígida ao salvar ou fazer deploy: os valores das regras são checados contra as opções, os níveis e os intervalos com que são comparados — "Use a number between 0 and 1 (e.g. 0.7, not 70)." As versões publicadas continuam rodando sem mudanças.

Cobrança

  • Depois que um plano pago termina no meio do mês, o Genesis só conta as decisões feitas depois do término; um cancelamento feito no portal do cliente pode ser retomado no app; as ações de cobrança têm rate limit.

CLI

  • Estados em lista: dcision decide e dcision check-state leem arrays JSON como estados em lista, e dcision validate lista os destinos de um schema.
  • A CLI ainda não está no npm: compile-a a partir do código-fonte.

Documentação

v0.2 — 5 de outubro de 2026 · Cobertura completa do Jev e padrões

A Dcision agora cobre tudo o que o Jev oferece, e os padrões de arquitetura da TypeSafe são recursos de primeira classe.

Decisões

  • Entradas estruturadas: instruções, descrições de opções, níveis de nota e critérios de probabilidade aceitam objetos e arrays JSON além de texto, e as instruções podem apontar para campos do estado com crases. As descrições de opções são opcionais (null), e um nível de nota pode ser uma rubrica com um label. Veja Perguntas.
  • Limites maiores, alinhados ao Jev: até 64 perguntas, 254 opções mais other por escolha, instruções de até 8.000 caracteres, descrições, níveis e critérios de até 2.000, context de até 8.000, 50 regras de política. Veja Limites.
  • Estado em lista: uma decisão pode receber um array de strings ou objetos — a transcrição de um chat, um lote de registros — com até 500 itens. Estados de texto chegam ao engine como strings simples.
  • decision_context: o context da decisão é enviado sob essa chave reservada e não sobrescreve mais um campo context que a sua aplicação envia.
  • Níveis ponderados: as respostas incluem scores, o nível ponderado por probabilidade de cada pergunta de nota, e as regras podem compará-lo com "on": "score".
  • Composites: combinações ponderadas de respostas, devolvidas em composites e utilizáveis em regras. Veja Composites.
  • Condições AND: uma regra pode exigir até 5 condições a mais, entre perguntas, confiança, níveis ponderados e composites.
  • Orçamento de tokens: estados que não cabem no orçamento do Jev — cerca de 32.000 tokens para o estado mais a pergunta mais longa, 64.000 para o estado mais todas as perguntas — falham rápido com 422 INVALID_STATE e uma mensagem clara.

Confiança

  • A confiança segue as fórmulas da TypeSafe numa única escala de 0 a 1. Para perguntas de probabilidade, agora é |2p − 1| em vez de max(p, 1 − p) — 0 num cara ou coroa. Revise minConfidence e as regras de confiança em perguntas de probabilidade: um limiar antigo t agora se comporta como 2t − 1. Veja Confiança e probabilidades.

Engine

  • A chave de engine da Dcision roda diretamente na TypeSafe, com escolha de modelo em Configurações → Engine: jev-1.13.0 (fixado, padrão), jev-latest ou jev-preview. metrics.model informa a versão exata que respondeu.
  • timeoutMs é o prazo de engine da decisão, com até 2 retries dentro dele em erros de rede, 429, 503, 529 e outras respostas 5xx, respeitando Retry-After. Picos na chave de engine compartilhada esperam por um slot livre em vez de falhar.
  • onEngineError: "fallback": quando o engine falha, responde 200 com a ação de fallback e action_reason.type = "engine_error" em vez de um erro — não é cobrado nem armazenado para idempotência. Veja Configurações da decisão.
  • Métricas de tokens: metrics.input_tokens e metrics.output_tokens em toda resposta. As estimativas de custo usam só os tokens de entrada — o Jev não cobra a saída.

API

  • GET /v1/me: o workspace da chave, a chave, os limites do plano e o uso do período atual.
  • GET /v1/executions: execuções recentes com respostas, ação e métricas, filtradas por decisão e status, com paginação por cursor. As entradas nunca são devolvidas.
  • Ambos usam as mesmas API keys, com uma janela de rate limit separada da das decisões.

Padrões e templates

  • Quatro padrões da TypeSafe — fan-out especulativo, roteamento por confiança, composite scoring e roteamento por intenção — documentados com construções passo a passo.
  • Quatro novos templates, um por padrão: ticket-triage, voice-banking, resume-screening e customer-service-router — nove no total. O Lead Qualification ganha o composite lead_score e o Support Routing uma confiança mínima em department.
  • A página Templates é organizada por padrão, e o editor tem um painel Padrões que mostra quais padrões uma decisão usa e como adotar os outros.

Correções

  • Uma pergunta de escolha podia acabar com uma opção a mais que o limite depois que other era adicionada; o limite agora conta as opções além de other.
  • O context da decisão não substitui mais um campo context do estado.

Documentação

v0.1 — outubro de 2026 · Lançamento

A primeira versão pública da Dcision, Decision as a Service.

Decisões

  • Decision schema: estado de objeto com campos tipados ou estado de texto; até 20 perguntas choice, score e probability (64 desde a v0.2); context de negócio.
  • Incerteza embutida: uma opção reservada other em toda pergunta de escolha, confiança mínima por pergunta e uma ação de fallback.
  • Políticas sobre respostas ou confiança (eq, neq, gt, gte, lt, lte) e quatro ações — continue, block, escalate, fallback — explicadas por action_reason.
  • Editor e construtor visual sobre o mesmo rascunho, com salvamento automático, detecção de conflitos e uma prévia ao vivo do contrato da API.
  • Cinco templates: qualificação de leads, roteamento de suporte, detecção de spam, roteamento de agentes e relevância de RAG.
  • Playground que executa rascunhos não salvos, mostra distribuições e quase empates, compara execuções e reexecuta entradas anteriores.
  • Deploys como versões imutáveis, slugs travados depois do primeiro deploy, desativar e ativar sem perder nenhuma versão.

API

  • POST https://api.dcision.io/v1/decisions/{slug} devolvendo result, confidence, action, action_reason e metrics tipados, com ?include=probabilities para as distribuições completas.
  • API keys dcs_live_… e dcs_test_…: mostradas uma única vez, armazenadas como hashes, revogáveis.
  • Idempotency-Key com replays por 24 horas, correlação por X-Request-ID, rate limits por workspace com headers X-RateLimit-* e um formato único de erro.

Engines

  • Jev (TypeSafe System One) como primeiro engine.
  • Chave de engine da Dcision incluída em todo plano, ou traga a sua própria chave para OpenRouter, TypeSafe ou Vercel AI Gateway — criptografada com AES-256-GCM.

Observabilidade

  • Execuções com motivo da ação, confiança, distribuições, modelo, latência, custo estimado e request ID; armazenamento da entrada e da saída configurável por decisão.
  • Uso e Painel com volume, percentis de latência, taxa de erro e custo estimado do engine; retenção de logs por plano.

Planos e cobrança

  • Planos Genesis (grátis, 1M de decisões por mês), Developer, Growth e Enterprise, mensais ou anuais, em USD ou BRL.
  • Checkout da Stripe, upgrades imediatos com cobrança proporcional, downgrades no fim do ciclo, cancelamento no fim do período, faturas e e-mails de cota em 80% e 100%.

Ferramentas

  • CLI dcision: login, decide, templates, init, validate e check-state — compilada a partir do código-fonte, já que @dcision/cli ainda não está no npm.
  • Documentação em docs.dcision.io com busca, /llms.txt, /llms-full.txt e uma versão em Markdown de cada página.

Nesta página