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.
Execuções
Toda execução — pela API ou pelo Playground, com sucesso ou não — é registrada como uma execução. O ID dela é o execution_id da resposta.
| Registrado | Observações |
|---|---|
| Decisão e versão | v3, ou draft para execuções no Playground |
| Origem | API ou Playground |
| Status e erro | Sucesso ou Erro, com o código e a mensagem de erro |
| Ação e motivo da ação | para execuções com sucesso |
| Latência, modelo, tokens de entrada e saída, custo estimado | o modelo é a versão exata que respondeu |
| Request ID | o X-Request-ID da chamada — o seu ou o que a Dcision gerou |
Entrada (state) | só quando o storeInput da decisão está ligado |
| Saída, confiança, níveis ponderados, composites, distribuições | só quando o storeOutput está ligado |
| Destinos | as entradas de destino da execução — respostas, respostas de LLM e de agente, funções com os params, entregas na fila — independentemente do que dizem storeInput e storeOutput |
Chamadas com falha também são registradas — incluindo estados inválidos (INVALID_STATE, orçamento de tokens incluído) e erros de engine — para você ver o que a sua integração envia. Uma chamada respondida com o fallback por erro de engine é registrada como Erro com o código do engine, embora a API tenha devolvido 200. Requisições rejeitadas antes de a decisão rodar — uma chave ou body inválido, uma decisão desconhecida, desativada ou sem deploy, um rate limit, um bloqueio de cota, um replay idempotente — não são registradas.
Encontrar uma execução
Execuções lista primeiro as execuções mais recentes, 50 por vez (Carregar anteriores para ver mais). Filtre por status, origem e decisão, ou busque pelo começo de um ID de execução ou pelo nome ou slug de uma decisão. Selecionar uma execução abre os detalhes: ação e motivo, erro, latência, modelo, custo estimado, request ID, entrada, saída e a distribuição de cada pergunta, os destinos com o status ao vivo das entregas — além de Rodar esta entrada de novo no Playground.
Registre os IDs
Guarde o execution_id junto com o registro sobre o qual a sua aplicação agiu, e envie o seu próprio X-Request-ID para correlacionar as execuções da Dcision com os seus logs.
Ler execuções pelo código
GET /v1/executions lista as mesmas execuções com uma API key — respostas, ação, motivo, status, código de erro e métricas, filtradas por decisão e status, das mais novas para as mais antigas. Ele nunca devolve a entrada: os estados guardados ficam no app, para os membros do workspace.
Uso
Uso resume hoje, os últimos 7 dias ou os últimos 30 dias:
- chamadas de API e execuções no Playground;
- decisões com sucesso e a taxa de erro;
- latência média de todas as execuções, e latência p50 e p95 das execuções com sucesso;
- custo estimado de engine e tokens de entrada;
- um gráfico de volume — por hora para hoje, por dia nos demais casos — com os erros como linha tracejada;
- uma divisão por decisão: chamadas, erros, latência média, custo estimado e participação.
O card do topo mostra as decisões cobráveis do período de cobrança atual em relação ao volume incluído no seu plano — também disponível pelo código com GET /v1/me. O Painel repete os números principais (decisões executadas, latência p95, taxa de sucesso, custo estimado de engine) com as suas decisões ativas, as execuções recentes e o checklist de primeiros passos.
Por decisão: a Visão geral
A primeira aba de toda decisão, Visão geral, resume as execuções de 7, 30 ou 90 dias — taxa de sucesso, latência, custo, ações e seus motivos, estatísticas por pergunta, destinos — e sugere o que calibrar. Veja Visão geral e calibração.
Retenção
Uma rotina diária apaga as execuções mais antigas que o menor valor entre a retenção do seu plano e a configuração do workspace (Configurações → Retenção do log de execuções):
| Plano | Retenção de logs |
|---|---|
| Genesis | 7 dias |
| Developer | 14 dias |
| Growth | 30 dias |
| Enterprise | 365 dias |
Por exemplo, um workspace Growth configurado para 7 dias guarda 7 dias; um workspace Genesis configurado para 90 dias guarda 7.
- Os gráficos e tabelas de uso são calculados a partir das execuções, então só cobrem execuções que ainda estão retidas.
- A cobrança não depende dos logs. As decisões cobráveis são contadas à parte, por hora, e esses contadores ficam guardados por cerca de 400 dias: a retenção nunca devolve cota nem muda o que você paga.
- Apagar uma decisão apaga as execuções dela imediatamente.
- As entregas de destinos seguem a própria retenção: são apagadas 30 dias depois de criadas — veja Entrega e retries.
Alertas de cota
Os proprietários do workspace recebem um e-mail quando as decisões cobráveis do período chegam a 80% e 100% do volume incluído — uma vez por nível por período. Veja Planos, cotas e cobrança.
Playground
Teste rascunhos — inclusive edições não salvas — com payloads reais, leia a confiança e as distribuições, pré-visualize destinos, compare execuções e engines e repita entradas de execuções anteriores.
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.