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.

RegistradoObservações
Decisão e versãov3, ou draft para execuções no Playground
OrigemAPI ou Playground
Status e erroSucesso ou Erro, com o código e a mensagem de erro
Ação e motivo da açãopara execuções com sucesso
Latência, modelo, tokens de entrada e saída, custo estimadoo modelo é a versão exata que respondeu
Request IDo 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çõessó quando o storeOutput está ligado
Destinosas 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):

PlanoRetenção de logs
Genesis7 dias
Developer14 dias
Growth30 dias
Enterprise365 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.

Nesta página