--- title: Inspecionar sessões e acompanhar o uso url: https://platform.claude.com/docs/pt-BR/managed-agents/session-observability description: Inspecione uma sessão no Claude Console, leia o uso de tokens e o custo de lista dela e depure comportamentos inesperados do agente. featureMetadata: topic: title: Managed Agents url: https://platform.claude.com/docs/en/managed-agents/overview status: beta betaHeader: managed-agents-2026-04-01 --- Use o visualizador de sessões no Claude Console para inspecionar o que um agente fez em uma sessão, sem escrever nenhum código. Use os totais de `usage` (csharp, go: `Usage`) da sessão para ver o que esse trabalho consumiu. ## Inspecionar uma sessão no Console O visualizador de sessões só está acessível para Developers e Admins. Para abri-lo, acesse a página [Sessions](https://platform.claude.com/sessions) (`platform.claude.com/sessions`) no Claude Console. A lista mostra todas as sessões no workspace com seu status, agente, uso de tokens, custo e horário de criação. Selecione uma sessão para abri-la. O visualizador de sessões mostra: * **Minimapa da linha do tempo:** Uma visão geral com zoom da atividade da sessão ao longo do tempo, com uma faixa por thread em sessões [multiagente](https://platform.claude.com/docs/pt-BR/managed-agents/multiagent-orchestration). Selecione uma faixa para ver essa thread ou selecione uma marca para ir até o evento correspondente. * **Transcrição:** A conversa agrupada por requisição ao modelo, incluindo o pensamento, as chamadas de ferramentas com suas entradas e resultados e o texto das mensagens à medida que é transmitido via streaming. Você pode filtrar os eventos e copiá-los ou baixá-los como JSON. * **Inspector:** Um painel lateral redimensionável com detalhes sobre a sessão, em cinco abas. | Aba do Inspector | O que mostra | | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Session** | Os detalhes e metadados da sessão, seu custo acumulado ao longo do tempo e o gasto em relação ao [orçamento](https://platform.claude.com/docs/pt-BR/managed-agents/budgets) da sessão, quando houver um definido. | | **Events** | Todos os eventos brutos da thread atual, na ordem em que o servidor os enviou. Selecione um evento para ver seu JSON. Uma mensagem transmitida via streaming enquanto a página estava aberta também tem uma visualização **Deltas** de seus [deltas de eventos](https://platform.claude.com/docs/pt-BR/managed-agents/event-deltas). | | **Tools** | As ferramentas com as quais os agentes da sessão estão configurados, junto com contagens de chamadas, falhas e duração mediana. Selecione uma ferramenta para ver suas chamadas e ir até uma delas na transcrição. | | **Resources** | [Arquivos](https://platform.claude.com/docs/pt-BR/managed-agents/files), [repositórios](https://platform.claude.com/docs/pt-BR/managed-agents/github) e [armazenamentos de memória](https://platform.claude.com/docs/pt-BR/managed-agents/memory) montados em seus caminhos no contêiner, incluindo as memórias em cada armazenamento e as alterações que esta sessão fez neles. Também lista os arquivos que o agente gravou em `/mnt/session/outputs` e as [skills](https://platform.claude.com/docs/pt-BR/managed-agents/skills) anexadas aos agentes da sessão. | | **Threads** | Todas as threads com seu status, tamanho de contexto e custo. Selecione uma thread para ver seus detalhes, como o agente, o modelo, o uso de contexto e o custo. | Acrescente `?event={event_id}` a uma URL de sessão para abrir a sessão em um evento específico. Com `ant beta:sessions connect`, você pode abrir o mesmo visualizador a partir da CLI `ant` ou acompanhar a sessão no seu terminal. Consulte [Conectar-se a uma sessão do Managed Agents a partir do seu terminal](https://platform.claude.com/docs/pt-BR/cli-sdks-libraries/cli/sessions-connect). ## Acompanhar o uso O objeto de sessão inclui um campo `usage` com o uso cumulativo da sessão: contagens de tokens, uso de ferramentas do servidor, tempo ativo e o custo de lista rastreado. Busque a sessão depois que ela ficar ociosa para ler os totais mais recentes. ```json { "id": "sesn_01...", "status": "idle", "usage": { "input_tokens": 5000, "output_tokens": 3200, "cache_read_input_tokens": 20000, "cache_creation": { "ephemeral_5m_input_tokens": 2000, "ephemeral_1h_input_tokens": 0 }, "list_cost": { "amount": "187", "currency": "USD" }, "active_seconds": 342.5, "server_tool_use": { "web_search_requests": 3, "web_fetch_requests": 0 } } } ``` | Campo | Descrição | | ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `input_tokens` | Tokens de entrada não armazenados em cache em todas as chamadas ao modelo na sessão. | | `output_tokens` | Total de tokens de saída em todas as chamadas ao modelo na sessão. | | `cache_read_input_tokens` | Tokens lidos do cache de prompt. | | `cache_creation` | Tokens de criação de cache, discriminados por tempo de vida do cache (`ephemeral_5m_input_tokens` e `ephemeral_1h_input_tokens`). | | `list_cost` | O consumo acumulado da sessão precificado pelas tarifas públicas de lista, como um número inteiro de centavos em uma string, com um código de moeda. | | `active_seconds` | O tempo acumulado durante o qual a sessão teve pelo menos uma thread em execução. A atividade sobreposta de threads simultâneas é contada uma única vez. O custo de tempo de execução da sessão é precificado com base nessa duração. | | `server_tool_use` | Contagens de requisições de ferramentas executadas no servidor, para fins de precificação. As requisições de pesquisa na web são incluídas no custo de lista por requisição. As requisições de busca na web não têm cobrança por requisição e não são medidas, então `web_fetch_requests` mostra `0`. | As entradas de cache usam um TTL de 5 minutos por padrão, então turnos consecutivos dentro dessa janela se beneficiam de leituras de cache, que reduzem o custo por token. O objeto `stats` da sessão tem seu próprio `active_seconds`, que soma o tempo ativo de cada thread em vez de contar a atividade sobreposta uma única vez. ### Uso por thread O `usage` próprio de cada [thread da sessão](https://platform.claude.com/docs/pt-BR/managed-agents/session-threads) também contém `list_cost` e `active_seconds`. Os valores por thread são arredondados de forma independente e excluem o custo de tempo de execução da sessão, então não somam exatamente o `list_cost` da sessão. O valor da sessão é o oficial. ### Ler o uso a partir do stream Você não precisa consultar a sessão repetidamente para observar esses totais. O evento `session.usage` traz o mesmo snapshot cumulativo no stream da sessão e no histórico de eventos. O snapshot contém o objeto `usage` (csharp, go: `Usage`), além do `budget` (csharp, go: `Budget`) da sessão, se ela tiver um. O evento é emitido nas transições para ociosidade, e não em um temporizador: * A sessão emite um imediatamente antes de ficar ociosa, qualquer que seja o motivo da parada. * A sessão emite um quando uma thread é pausada ao atingir um [orçamento de sessão](https://platform.claude.com/docs/pt-BR/managed-agents/budgets). ### Impor um limite de gastos Para impor um limite de gastos, defina um orçamento de sessão em vez de consultar o uso periodicamente e interromper a sessão você mesmo. A plataforma precifica o consumo da sessão continuamente e pausa cada thread antes de sua próxima requisição ao modelo assim que o custo de lista atinge o limite. Consulte [Quando uma sessão atinge seu orçamento](https://platform.claude.com/docs/pt-BR/managed-agents/budgets#when-a-session-reaches-its-budget) para ver como isso aparece no stream. ## Dicas de depuração * **Verifique os eventos da sessão:** A sessão relata erros por meio de eventos [`session.error`](https://platform.claude.com/docs/pt-BR/managed-agents/reference#event-types). * **Revise os resultados das ferramentas:** Falhas na execução de ferramentas frequentemente explicam comportamentos inesperados do agente. A aba **Tools** do Inspector mostra as falhas de cada ferramenta. * **Use prompts do sistema:** Adicione instruções de registro ao prompt do sistema para que o agente resuma o que fez e o que encontrou. * **Solucione problemas de pré-visualizações:** Se um stream que opta por deltas de eventos não se comportar como você espera, consulte [Solucionar problemas de pré-visualizações](https://platform.claude.com/docs/pt-BR/managed-agents/event-deltas#troubleshoot-previews). ## Próximos passos Envie eventos, faça streaming de respostas e interrompa ou redirecione sua sessão durante a execução. Limite os gastos de uma sessão com um orçamento rígido em dólares, aplicado com base nas tarifas públicas de lista.