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.
Geral
A Dcision é um LLM?
Não. A Dcision é uma camada de decisão: você define perguntas estruturadas e políticas, e toda chamada devolve respostas tipadas, confiança e uma ação. As respostas vêm de um motor de decisão — Jev (o System One da TypeSafe, o padrão), OpenAI Decisions ou Laya — um modelo que devolve distribuições de probabilidade em vez de texto gerado. Use a Dcision para decidir se e para onde mandar o trabalho; deixe o seu LLM, agente ou time fazer o trabalho.
Qual modelo responde às minhas decisões?
O engine da decisão, ou o padrão do workspace — Jev, a menos que um admin tenha mudado. Na chave de engine da Dcision, o Jev roda na TypeSafe com o modelo escolhido em Configurações → Engine — jev-1.13.0 (fixado, o padrão), jev-latest ou jev-preview. A OpenAI Decisions roda gpt-6-luna na sua chave OpenAI, e o Laya roda no seu servidor. Com a sua própria chave, o provedor e o modelo que você escolheu. metrics.model sempre informa a versão exata que respondeu. Veja Engines e BYOK.
Quais linguagens e SDKs são suportados?
Qualquer linguagem que consiga enviar uma requisição HTTPS com JSON — a API é um único POST; veja os exemplos em cURL, JavaScript e Python em Executar uma decisão. Os SDKs oficiais para TypeScript e Python acrescentam retries que nunca executam uma decisão duas vezes, destinos de função e verificação de webhooks; eles ainda não estão no npm nem no PyPI, então compile-os a partir do código-fonte. A CLI cobre o terminal e o CI.
Uma decisão pode chamar os meus sistemas ou responder aos meus usuários?
Sim, com destinos: para cada opção, nível, limiar ou ação final, devolva uma resposta fixa ou uma resposta de LLM, passe para o seu agente, dispare um workflow, envie um webhook assinado, chame qualquer API com os seus segredos ou diga ao seu código qual função executar. As entregas são retentadas por cerca de 7 horas, e nada é enviado a partir do Playground até você ligar Executar destinos de verdade.
Posso chamar a API de um navegador ou de um app mobile?
Não. API keys são segredos: chame a Dcision do seu backend, de um worker ou do runtime do seu agente, e envie o resultado ao cliente se ele precisar.
Quão rápida é uma decisão?
Toda resposta informa metrics.latency_ms, e Uso mostra a latência média e a p95 das suas decisões. Todas as perguntas de uma decisão são respondidas numa única chamada ao engine, em paralelo, então perguntas extras acrescentam pouca latência. A chamada ao engine tem um prazo de 5 segundos por padrão, retries incluídos — defina-o por decisão com timeoutMs; uma chamada que passa dele falha com 504 ENGINE_TIMEOUT.
Uma decisão pode responder algo quando o engine está fora do ar?
Sim, se você optar por isso: com onEngineError: "fallback", uma falha do engine responde 200 com a ação de fallback da decisão e action_reason.type = "engine_error". Essas respostas não são cobradas. Veja Configurações da decisão.
Cobrança e cotas
O que conta como uma decisão cobrável?
Uma chamada bem-sucedida (200) a POST /v1/decisions/{slug}, uma vez por chamada, não importa quantas perguntas ela tenha. Execuções no Playground, erros, replays idempotentes, fallbacks por erro do engine e leituras (GET /v1/me, GET /v1/executions) são gratuitos. Chamadas com chaves de teste e com a sua própria chave de provedor contam como qualquer outra. Veja O que é cobrado.
Como verifico o meu uso pelo código?
GET /v1/me devolve as decisões cobráveis usadas no período atual, o volume incluído e as datas do período, com qualquer API key do workspace. Veja Obter conta e uso.
O que acontece depois das decisões incluídas — no Genesis também?
Todo plano continua rodando com créditos pré-pagos, ao preço do plano por 1M de decisões: US$12 no Genesis e no Developer, US$9 no Growth (R$60 e R$45 no Brasil). O Genesis não precisa de assinatura para isso. Sem créditos, as chamadas à API devolvem 402 CREDITS_EXHAUSTED até você adicionar créditos, o período reiniciar ou você fazer upgrade. O Playground continua funcionando. Veja Créditos.
Como consigo créditos?
O Proprietário os adiciona na página Cobrança: cadastrar 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 — e créditos podem ser comprados com cartão de US$10 a US$1,000 (R$50 a R$5,000). Créditos pagos nunca expiram. Vouchers também adicionam créditos promocionais.
Os créditos podem se recarregar sozinhos — e posso limitar o gasto?
Sim, ambos são opcionais. A recarga automática cobra no cartão salvo um valor escolhido sempre que o crédito disponível cai abaixo de um gatilho, depois que o Proprietário a autoriza; ela pode ser desligada a qualquer momento. Um teto de gasto por ciclo de cobrança interrompe as chamadas além do volume incluído com 402 SPEND_CAP_REACHED quando o gasto de créditos do ciclo chega a ele.
Usar a minha própria chave de provedor torna as decisões gratuitas?
Não. Com a sua própria chave, o provedor cobra a chamada ao engine, e a chamada bem-sucedida à API continua contando no seu plano da Dcision.
O que significa metrics.estimated_cost_usd?
Uma estimativa do custo do engine na chamada — metrics.input_tokens vezes o preço do modelo (Jev: US$0.042 por 1M de tokens de entrada; OpenAI Decisions: US$0.10; Laya: 0 — tokens de saída são gratuitos) — para comparar decisões. Não é o que a Dcision cobra de você.
Decisões
O que é a opção other que eu não adicionei?
Toda pergunta choice ganha uma opção reservada other para que o engine possa dizer "nenhuma destas" em vez de ser forçado a uma resposta errada. Quando ela é escolhida, a decisão aplica a sua ação de fallback. Veja Perguntas.
Por que a minha chamada devolveu escalate se nenhuma política diz isso?
Olhe o action_reason: other_option significa que uma choice respondeu other; low_confidence significa que uma resposta ficou abaixo do seu minConfidence; engine_error significa que o engine falhou numa decisão com onEngineError: "fallback". Os três aplicam a ação de fallback da decisão, escalate por padrão. Veja Políticas e ações.
Por que a confiança da minha pergunta probability é menor que a probabilidade?
Porque a confiança mede a certeza em qualquer direção, na mesma escala das perguntas choice e score: para uma probabilidade p, ela é |2p − 1|. Uma probabilidade de 0,9 — ou 0,1 — tem confiança 0,8; 0,5 tem confiança 0. Defina minConfidence com isso em mente: 0,6 sinaliza todo p entre 0,2 e 0,8. Veja Confiança e probabilidades.
O que são scores e composites na resposta?
scores traz o nível ponderado de cada pergunta score — a média dos seus níveis ponderada pela probabilidade, contando a partir de 1, então 2,4 fica entre o segundo e o terceiro nível. composites traz as combinações ponderadas de respostas da decisão, como um lead score. Ambos podem acionar políticas. Veja Perguntas e Composites.
Quantas perguntas uma decisão deve fazer?
Quantas o fluxo precisar, até 64: elas são respondidas numa única chamada, e a chamada é cobrada uma vez. Faça também as especulativas — as respostas de que você não precisa são simplesmente ignoradas. Mantenha cada pergunta atômica, e mantenha o estado dentro do orçamento de tokens. Veja Fan-out especulativo e Escrevendo boas perguntas.
block rejeita a minha requisição?
Não. Ações são rótulos para o seu código. A resposta é 200 OK com "action": "block", e a sua aplicação decide o que bloquear significa.
Editei a minha decisão, mas a API ainda responde do jeito antigo. Por quê?
A API roda a versão ativa. Edições mudam o rascunho; faça o deploy delas para criar uma nova versão. Veja Versões e deploy.
Posso mudar o slug?
Até o primeiro deploy. Depois disso o slug fica travado, porque os clientes o chamam.
Como faço rollback?
Versões são imutáveis e ficam listadas em Histórico de versões. Volte o rascunho para o schema anterior e faça o deploy — isso cria uma nova versão com a lógica antiga.
Por que o meu estado é rejeitado com 422 INVALID_STATE?
A mensagem diz qual é o problema: um campo obrigatório ausente, um tipo errado ("500" não é um number), uma decisão de texto que recebeu um objeto, uma decisão de lista que não recebeu um array, ou um estado maior que os limites — sozinho, ou somado às perguntas, para o orçamento de tokens do engine. Campos que o schema não declara não são problema.
Chave live ou de teste — qual devo usar?
Elas rodam as mesmas versões publicadas e são cobradas igual; a única diferença é que as entregas de destinos levam livemode: false com chaves de teste. Use chaves de teste para staging, CI e desenvolvimento local, para poder revogá-las sem mexer na produção.
Time e conta
O meu time pode compartilhar um workspace?
Sim. Convide pessoas por e-mail em Configurações → Membros como Admins, Membros ou Leitores — o convite vale por 7 dias e é aceito quando elas entram. Cada pessoa pode pertencer a vários workspaces e ser proprietária de até 10. Veja Time, papéis e conta.
Posso entrar com uma senha?
Sim, se você definir uma em Conta → Senha — o Google e os códigos por e-mail continuam funcionando. Trocá-la encerra as suas outras sessões, e Sair de todos os dispositivos encerra todas.
Dados
A Dcision guarda os estados que eu envio?
Por padrão, as execuções guardam o estado (storeInput) e as respostas (storeOutput) pelo tempo de retenção de logs do seu plano — 7 dias no Genesis. Desligue qualquer um dos dois por decisão. Estados guardados só aparecem no app: GET /v1/executions nunca os devolve. Veja Segurança e dados.
Quem processa os meus dados?
A Dcision valida o estado e o envia, com o contexto e as perguntas da decisão, ao provedor do engine: a TypeSafe, na conta da Dcision, por padrão, ou o provedor da sua própria chave (a OpenAI para a OpenAI Decisions; o seu próprio servidor para o Laya). Arquivos que precisam da OpenAI para serem lidos — áudio, imagens para o Jev ou o Laya, documentos escaneados — vão para a OpenAI com a chave OpenAI do workspace. Veja Para onde vai o seu estado.