Planilha do custo total de um agente de IA

Atualizado October 8, 2026 · publicado originalmente October 8, 2026

Resposta rápida: O total de tokens de um modelo não é o custo total de um agente. Uma execução em produção também pode consumir busca hospedada, execução de código, armazenamento, novas tentativas, modelos de fallback...

O total de tokens de um modelo não é o custo total de um agente. Uma execução em produção também pode consumir busca hospedada, execução de código, armazenamento, novas tentativas, modelos de fallback e revisão humana. Uma planilha útil liga cada cobrança a um ID de execução e mantém as cobranças medidas do provedor separadas dos custos indiretos rateados e das estimativas de mão de obra.

Esta planilha complementa o custo por tarefa bem-sucedida: primeiro reúna o livro-razão de custos completo e depois divida pelos resultados que passaram no teste de sucesso definido. Ela também estende a cobrança separada de ferramentas até um registro financeiro repetível.

Comece com uma linha por evento

Use um ID de fluxo de trabalho estável para a intenção do usuário e um ID de execução para cada tentativa. Registre carimbo de data e hora, ambiente, equipe ou tenant, fluxo de trabalho, execução, provedor, serviço, ID do recurso, quantidade, unidade, versão da tabela de preços, moeda e fonte da fatura ou da medição. Mantenha um evento por chamada de modelo, chamada de ferramenta, job de computação ou item de revisão. Isso torna as novas tentativas visíveis e permite que as finanças concilie os totais sem adivinhar qual operação aninhada os gerou.

Colunas da planilha

Modelo: provedor, modelo, unidades de entrada, saída, cache e raciocínio quando expostas, tarifa medida e cobrança direta.
Ferramentas: busca, recuperação, navegador, execução de código e outros serviços medidos, com contagem de chamadas ou tempo de execução e cobrança direta.
Computação e armazenamento: tempo de execução de sandbox ou contêiner, tempo de acelerador ou CPU, armazenamento persistente e cobranças de rede, se faturadas.
Trabalho de confiabilidade: novas tentativas, chamadas de fallback, ramos abandonados e execuções de reparo. Mantenha-os no custo total da execução mesmo quando não produziram nenhuma saída útil.
Verificação: chamadas de avaliadores e minutos de revisão humana, com o custo de mão de obra marcado como estimativa interna, e não como cobrança de fatura do provedor.
Plataforma compartilhada: rateios de orquestração, observabilidade, capacidade reservada ou armazenamento compartilhado, cada um com seu critério de rateio e período.

Calcule o custo direto e o custo total separadamente

O custo direto da execução é a soma das cobranças medidas de modelo, ferramentas, computação e armazenamento atribuídas àquela execução. O custo total (fully loaded) soma a parcela declarada dos custos indiretos da plataforma e da mão de obra de revisão. Use um critério estável para os custos compartilhados, como tempo de execução medido, capacidade reservada ou um rateio documentado por execução. Publique o critério e sua janela de tempo; não distribua custos fixos por contagem de tokens, a menos que os tokens realmente expliquem o consumo de recursos.

Um pequeno exemplo hipotético esclarece a fórmula: se uma execução tem $0,40 em cobranças de modelo, $0,10 em ferramentas, $0,20 em computação de sandbox e $0,30 de custo rateado de revisão e plataforma, informe $0,70 diretos e $1,00 totais. Esses valores ilustram apenas a aritmética; não são um preço de mercado nem uma referência.

Mantenha tentativas e resultados distintos

Conte cada tentativa no gasto e depois classifique o fluxo de trabalho final como bem-sucedido, com falha, abandonado ou que exigiu conclusão humana, segundo uma regra explícita. Informe o custo por fluxo de trabalho concluído junto com a taxa de sucesso, a taxa de novas tentativas e o esforço de revisão. Para uma métrica de tarefa bem-sucedida, use o gasto elegível total do período dividido pelo número de fluxos de trabalho que passaram no teste de sucesso. Não retire execuções com falha do numerador nem conte etapas intermediárias do agente como sucessos separados.

Concilie e governe a planilha

Concilie os totais dos eventos com as faturas dos provedores e as exportações de cobrança da nuvem depois que os dados de uso se estabilizarem. Explique separadamente créditos, descontos, mínimos, eventos tardios e conversão de moeda. Guarde a fonte do preço e a data de vigência para que os custos históricos possam ser recalculados sem aplicar a tarifa de hoje ao uso do mês passado.

Atribua um responsável a cada fluxo de trabalho e defina um orçamento por execução, um orçamento agregado por período e um caminho de escalonamento. Quando um fluxo de trabalho ultrapassar o orçamento, registre o motivo e se foi autorizado a continuar. Para padrões de aplicação em tempo de execução, veja os três orçamentos para agentes autônomos.

Perguntas frequentes

O que deve constar em uma planilha de custos de agentes?

Registre o uso do modelo, as ferramentas cobradas, a computação, o armazenamento, as novas tentativas, as chamadas de fallback, a verificação e, identificados separadamente, os rateios da plataforma compartilhada e as estimativas de mão de obra.

As execuções de agente com falha devem entrar no custo por tarefa?

Inclua o gasto delas no total. Informe a contagem de fluxos de trabalho bem-sucedidos usando uma regra de sucesso declarada, para que as falhas continuem visíveis na economia unitária.

Como evito contar duas vezes os custos de plataforma compartilhada?

Mantenha as cobranças diretas associadas ao seu evento, rateie os custos compartilhados em um livro-razão separado com um único critério publicado e concilie o total rateado com o pool de custos da plataforma.