# Uso e orçamentos de IA

Veja o uso de tokens, os custos estimados e a atividade em projetos, modelos e agentes.

Abra o relatório de uso pelo contador de uso do assistente. Ele reúne em uma só visão a atividade do assistente integrado e dos agentes de CLI, incluindo o trabalho concluído e as execuções interrompidas que usaram tokens.

## Leia o relatório

Filtre por projeto, agente, provedor, modelo ou sessão e defina as datas com **De** e **Até** ou com um intervalo rápido como **7d** ou **Este mês**. As datas e as horas estão em UTC. Os tokens diários e a atividade por hora mostram quando o trabalho aconteceu; os totais agrupados ajudam a comparar para onde o uso foi. **Exportar CSV** salva o relatório.

O relatório separa entrada, saída, leituras de cache e criação de cache quando o ambiente de execução os fornece. Uma medição pode ser informada, estimada ou indisponível. **Desconhecido** significa que o ambiente de execução não forneceu informações suficientes; não significa zero.

## Entenda as estimativas de custo

As estimativas de custo de API usam os preços de modelo disponíveis e as medições de tokens. Os agentes de CLI podem usar uma assinatura ou outro tipo de cobrança. As contagens de tokens deles não são uma fatura nem uma medida do limite restante da conta.

Use a própria página de cobrança do provedor para ver o valor real cobrado.

## Defina um orçamento de projeto

Com um projeto aberto, defina o **Orçamento de IA** em **Configurações → Assistente de IA → Provedores e chaves**. Digite um valor em dólares americanos e escolha **Salvar o orçamento**; **Zerar o orçamento** o remove. O cartão mostra o gasto estimado até agora.

Um orçamento de projeto pode avisar antes de uma execução do assistente integrado quando o uso registrado chega a 80% do limite e bloquear uma nova execução quando o limite é atingido. É uma verificação antes de começar o trabalho, e não um corte durante uma resposta em andamento.

As verificações de orçamento não cobrem todos os agentes externos nem todos os ambientes de execução de tarefas de pesquisa. Use os limites do próprio provedor quando precisar de um limite de gasto aplicado pelo serviço.