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
200sem essa pergunta emresult, e a decisão toma a sua ação de fallback comaction_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_mseinput_cost_usdquando o estado tem arquivos, eestimated_cost_usdagora 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}aceitamultipart/form-data— campos de texto viram strings do estado, arquivos vão para camposimage,audioefile, e uma partestateopcional 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-liveexporta uma decisão publicada como adelegationde uma sessão de voz em tempo real da OpenAI, ePOST /v1/decisions/{slug}/openai-live/answersroda 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,audioefile: envie uma foto, um áudio ou um documento — PDF, Word, Excel, PowerPoint, OpenDocument, CSV, RTF, HTML, texto e mais — como uma URLdata:, uma URLhttps://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 responde422 INVALID_STATEem vez de413. - 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 — perguntasprobabilityvão comopredicateda 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"emetrics.modelo modelo exato, por exemplogpt-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 comonEngineError: "fallback"). Uma conta OpenAI sem créditos respondeENGINE_AUTH_FAILEDna 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 comDcision-Workspace. - Novo código de erro
SLUG_TAKEN(409): o sub-workspace já tem uma decisão com esse slug.replace_empty: truesubstitui 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.instructionscom "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/workspaceso 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/executionse no servidor MCP. - Editor embutível:
POST /v1/embed/sessionsabre 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/embedfaz a montagem. - MCP:
list_workspaceseupsert_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_workspaceseupsert_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_decisioncria um rascunho a partir de um schema;update_decisionedita o rascunho;deploy_decisiono 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_decisionedeploy_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— umrerank_scorede 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 emcontext, combinados numagradede 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
replyeopen_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:templatemonta o objeto a partir do estado, das respostas e dos parâmetros, sem chamar modelo;extractdeixa 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. outputna resposta.POST /v1/decisions/{slug}devolve o objeto da primeira saída estruturada concluída numoutputde nível superior (nullquando nenhuma pôde ser montada). Uma saída estruturada nunca faz a decisão falhar: um problema volta na sua entrada comissues(JSON Pointer + mensagem).GET /v1/executionsdevolveoutputquando a decisão armazena saídas; comstoreOutputdesligado, 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.engineopcional ("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 suaLAYA_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çoshttps://públicos. metrics.engineagora informa o engine que rodou ("jev"ou"laya"), emetrics.modelo checkpoint do Laya que respondeu, por exemplolaya/multilingual. Chamadas ao Laya são estimadas comestimated_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/meagora informaplan.hard_cap: falsepara 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 — e402 SPEND_CAP_REACHED— o teto de gastos do ciclo foi atingido.402 QUOTA_EXCEEDEDpermanece 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_templateevalidate_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
curlpuro.
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 comcurlquando 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 segredowhsec_: um HMACDcision-Signaturecom janela de 300 segundos, ouAuthorization: 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/decisionslista as decisões do workspace eGET /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 HMACDcision-Signaturecom 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/executionstambém o devolve, e o documento OpenAPI descreve o evento de webhookdecision.completed.
Times e contas
- Papéis: Owner, Admin, Member e Viewer, aplicados em toda requisição do app.
403 FORBIDDENagora também cobre recusas por papel; perder o acesso a um workspace responde comdetails.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) edcision(Python 3.9+):decidecom 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_CONFLICTcomRetry-After: 1em vez de rodar de novo; erros liberam a chave. Veja Idempotência. 413 PAYLOAD_TOO_LARGEpara corpos acima de 128 KB (antes eraINVALID_REQUESTcom status 413), e409 CONFLICTquando duas criações concorrem.GET /openapi.jsonestá 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 decideedcision check-stateleem arrays JSON como estados em lista, edcision validatelista os destinos de um schema. - A CLI ainda não está no npm: compile-a a partir do código-fonte.
Documentação
- Novas seções: Destinos e SDKs. Novas páginas: Eventos de webhook, Time, papéis e conta e Visão geral e calibraçã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 umlabel. Veja Perguntas. - Limites maiores, alinhados ao Jev: até 64 perguntas, 254 opções mais
otherpor escolha, instruções de até 8.000 caracteres, descrições, níveis e critérios de até 2.000,contextde 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: ocontextda decisão é enviado sob essa chave reservada e não sobrescreve mais um campocontextque 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
compositese 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_STATEe 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 demax(p, 1 − p)— 0 num cara ou coroa. ReviseminConfidencee as regras de confiança em perguntas de probabilidade: um limiar antigotagora se comporta como2t − 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-latestoujev-preview.metrics.modelinforma 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,529e outras respostas5xx, respeitandoRetry-After. Picos na chave de engine compartilhada esperam por um slot livre em vez de falhar.onEngineError: "fallback": quando o engine falha, responde200com a ação de fallback eaction_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_tokensemetrics.output_tokensem 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-screeningecustomer-service-router— nove no total. O Lead Qualification ganha o compositelead_scoree o Support Routing uma confiança mínima emdepartment. - 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
otherera adicionada; o limite agora conta as opções além deother. - O
contextda decisão não substitui mais um campocontextdo estado.
Documentação
- Novas páginas: Padrões, Composites, Escrevendo boas perguntas, Obter conta e uso e Listar execuções.
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);
contextde negócio. - Incerteza embutida: uma opção reservada
otherem 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 poraction_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}devolvendoresult,confidence,action,action_reasonemetricstipados, com?include=probabilitiespara as distribuições completas.- API keys
dcs_live_…edcs_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 headersX-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,validateecheck-state— compilada a partir do código-fonte, já que@dcision/cliainda não está no npm. - Documentação em docs.dcision.io com busca,
/llms.txt,/llms-full.txte uma versão em Markdown de cada página.
Segurança e dados
O que a Dcision guarda e por quanto tempo, para onde vai o seu estado — destinos incluídos —, como chaves, segredos e senhas são protegidos, papéis e isolamento de workspace, e como manter dados sensíveis de fora.
Perguntas frequentes
Respostas para perguntas comuns sobre a Dcision — cobrança, cotas e créditos, chaves, modelos e latência, retenção de dados, deploys e integração.