Inspecionar sessões e acompanhar o uso
Inspecione uma sessão no Claude Console, leia o uso de tokens e o custo de lista dela e depure comportamentos inesperados do agente.
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 da sessão para ver o que esse trabalho consumiu.
Inspecionar uma sessão no Console
O visualizador de sessões só é acessível para Developers e Admins. Para abri-lo, vá até a barra lateral do Console e selecione Sessions em Managed Agents. 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. 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 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. |
| 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, repositórios e armazenamentos de memória 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 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.
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.
{
"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 de cada thread da sessão 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, portanto 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 periodicamente para observar esses totais. O evento session.usage traz o mesmo snapshot acumulado no stream da sessão e no histórico de eventos. O snapshot contém o objeto usage mais o budget da sessão, que é null quando a sessão não tem 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.
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 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. - 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.
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.
Was this page helpful?