Edição Markdown

AI-translated from English; not yet reviewed by a fluent editor.

# Audite uma sessão de um agente de programação com o AgentsView

> Encontre uma transcrição local conhecida de um agente de programação no AgentsView, examine os tokens registados e a proveniência dos custos e leia um relatório diário delimitado sem tratar estimativas como faturas.

By BIG CHANGE Editorial

Published: 2026-10-17T17:20:34.907Z
Updated: 2026-10-17T17:20:34.907Z
Canonical: https://bigchange.ai/blog/audit-coding-agent-session-agentsview

![Conceptual charcoal illustration of a local computer with one blank transcript line highlighted and an external drive beside it.](https://bigchange.ai/api/media/file/agentsview-local-session-audit-concept-v1.png)
AI-generated conceptual illustration by BIG CHANGE; no actual AgentsView interface, transcript, usage figure or billing result is depicted.

O AgentsView pode reunir registos de sessões de agentes de programação de várias ferramentas num arquivo local pesquisável. Este guia destina-se a um responsável de engenharia que precise de encontrar uma tarefa conhecida, examinar os campos de utilização efetivamente registados pelo agente e identificar a origem de qualquer valor de custo.

Este guia passo a passo baseia-se na documentação da versão v0.45.0 do AgentsView, de 9 de outubro de 2026, e nos guias atuais de início rápido e utilização de tokens, consultados em 17 de outubro. O BIG CHANGE não instalou o AgentsView, não importou uma transcrição nem testou estes passos. Verifique a versão instalada, pois a documentação e as listas de versões podem mudar.

## Antes de começar

Precisa de uma sessão concluída de um agente de programação que tenha autorização para ler, de uma expressão distintiva ou do ID de sessão dessa tarefa e de permissão para ler o respetivo diretório local de registos. O [Quick Start](https://www.agentsview.io/docs/quickstart/) enumera transferências para computadores de secretária com macOS, Windows e Linux, com pacotes wheel da CLI para Linux x86\_64 e aarch64, macOS x86\_64 e arm64, e Windows x86\_64 e arm64. A aplicação de secretária já vem empacotada; compilar a partir do código-fonte tem requisitos próprios de Go, Node e CGO. Segundo o guia de início rápido, o arquivo local básico não exige uma conta num serviço alojado nem uma chave de API.

Os registos de sessões podem conter prompts, código-fonte, entradas de ferramentas e segredos. Escolha apenas diretórios que a sua equipa permita examinar. Decida que fornecedores e diretórios de raiz o arquivo pode recolher **antes do primeiro arranque**: executar apenas `agentsview serve` descobre e sincroniza imediatamente as fontes compatíveis predefinidas. Mantenha a interface web no endereço de loopback documentado para este exercício. Não ative sincronização alojada de dados em bruto, envios para PostgreSQL ou ClickHouse, publicação em Gist, informações geradas ou um endpoint alojado de embeddings apenas para responder a esta pergunta. A pesquisa semântica é opcional; a pesquisa comum de texto integral funciona com o índice local.

## 1. Instale e identifique o executável

Escolha um método no [guia de instalação](https://www.agentsview.io/docs/quickstart/). Para uma CLI autónoma, a instalação permanente com Python documentada é:

```sh
pip install agentsview
agentsview --version
```

O guia também disponibiliza `uvx agentsview` para executar sem instalação permanente, instaladores específicos de cada plataforma e pacotes para computador. No macOS, o cask do Homebrew liga a CLI incluída na aplicação; uma aplicação instalada a partir de um DMG pode exigir que o diretório da CLI seja acrescentado ao `PATH`. Confirme que executável é encontrado pela sua shell antes de confiar na respetiva versão. O GitHub identifica [v0.45.0](https://github.com/kenn-io/agentsview/releases/tag/v0.45.0) como a versão de 9 de outubro, mas use o seu próprio resultado de `--version` ao interpretar os ecrãs e o esquema do relatório.

## 2. Restrinja as fontes antes da primeira sincronização

Para uma instalação da CLI ou da aplicação de secretária no anfitrião, prepare um diretório de dados novo e o respetivo `config.toml` **antes** de iniciar o AgentsView. O [guia de configuração](https://www.agentsview.io/docs/configuration/#disabling-session-providers) documenta `disabled_agents` para excluir fornecedores do sistema de ficheiros local e `[agents.<id>].dirs` para substituir as raízes predefinidas de um fornecedor. Enumere **todos os IDs dos outros fornecedores** da [tabela Session Discovery](https://www.agentsview.io/docs/configuration/#session-discovery) desse guia em `disabled_agents` e defina o `dirs` do único fornecedor autorizado como o diretório de raiz aprovado. Por exemplo, `[agents.codex]` com `dirs = ["/approved/codex/sessions"]` substitui os diretórios predefinidos do Codex; adapte o caminho ao seu sistema. Se não tiver uma lista de exclusão completa, não inicie ainda o daemon do anfitrião. Uma única substituição de `CODEX_SESSIONS_DIR` ou `CLAUDE_PROJECTS_DIR` altera a raiz desse fornecedor, mas deixa os restantes disponíveis para a sua própria descoberta predefinida.

Use um `AGENTSVIEW_DATA_DIR` novo nesta auditoria se um arquivo existente já puder conter sessões não relacionadas. O guia de configuração diz que as sessões anteriormente arquivadas de fornecedores desativados continuam disponíveis; alterar a definição não limpa um arquivo antigo. Diz também que `disabled_agents` abrange a descoberta e a monitorização locais, não as importações ou exportações remotas; deixe anfitriões remotos e destinos de exportação por configurar nesta tarefa local.

Um contentor isolado é a alternativa quando não é prático manter uma lista de exclusão de todos os outros fornecedores. O [exemplo de Docker no Quick Start](https://www.agentsview.io/docs/quickstart/#docker) publica a interface apenas em `127.0.0.1`, monta uma fonte de um agente só para leitura e usa um volume de dados separado. Monte **apenas** a raiz da fonte autorizada e defina a variável de diretório correspondente num contentor novo; omita as outras montagens do [exemplo de Compose do projeto](https://github.com/kenn-io/agentsview/blob/main/docker-compose.prod.yaml). Um contentor só vê os diretórios de sessões do anfitrião explicitamente montados. As imagens Docker publicadas abrangem Linux amd64 e arm64; esta via exige uma instalação funcional do Docker.

## 3. Crie o arquivo local

Para a CLI do anfitrião com âmbito restrito, inicie o servidor em primeiro plano documentado:

```sh
agentsview serve
```

Depois de aplicar e verificar o âmbito das fontes no passo 2, isto inicializa `~/.agentsview/sessions.db` ou o diretório de dados escolhido, descobre registos dos agentes ativados, sincroniza-os, monitoriza alterações e abre `http://127.0.0.1:8080`. Mantenha esse terminal aberto. Se preferir um processo em segundo plano, use `agentsview daemon start` e `agentsview daemon status`; a aplicação de secretária gere o seu próprio backend. Um servidor compatível já em execução pode limitar-se a indicar o seu URL, pelo que deve verificar se existe um daemon em execução antes de assumir que a nova configuração controlou a recolha de dados.

Se escolheu o contentor isolado, inicie-o com o comando Docker documentado depois de verificar a sua única montagem de fonte só de leitura e o volume de dados novo. Use a interface de loopback e execute os relatórios posteriores da CLI do `agentsview` nesse contentor, para que leiam o mesmo arquivo. Não execute simultaneamente no anfitrião um `serve` sem restrição das fontes.

Verifique se a fonte da tarefa conhecida aparece e se os fornecedores indesejados não aparecem. Se faltar a sessão, examine o caminho aprovado, a definição do fornecedor e o estado da sincronização antes de concluir que não existe sessão. Execute `agentsview sync` quando precisar de incorporar ficheiros recentemente alterados antes de um relatório; o servidor também monitoriza alterações. Volte a verificar o âmbito configurado antes de qualquer nova sincronização completa.

## 4. Encontre a tarefa e verifique a transcrição

Na interface web, use `Ctrl/Cmd+K` para procurar uma expressão literal distintiva da tarefa conhecida. Restrinja a lista por projeto, agente ou data, abra um candidato e examine as mensagens e chamadas de ferramentas. Se já tiver o ID de sessão completo ou UUID, `Ctrl/Cmd+G` abre-a diretamente. Estes controlos estão documentados no [Quick Start](https://www.agentsview.io/docs/quickstart/). Registe o agente, o ID de sessão e a data para associar o resultado de utilização à conversa certa.

Se a pesquisa literal não encontrar a tarefa, experimente uma expressão mais curta e confirme que o agente de origem escreveu uma transcrição local num diretório que o AgentsView consiga ler. Uma tarefa presente apenas num serviço remoto, num formato não suportado ou num diretório fora das raízes configuradas não pode ser recuperada procurando mais. Não ative indexação semântica nem carregamento de transcrições como solução habitual para uma fonte local em falta.

## 5. Examine os campos de utilização da sessão

Abra a vista de utilização da sessão encontrada e identifique os campos registados de modelo, entrada, saída, criação de cache e leitura de cache que estejam presentes. O [guia de utilização de tokens](https://www.agentsview.io/docs/token-usage/) classifica os relatórios de custos como **experimentais e ainda em evolução**. O AgentsView recolhe metadados de modelos e tokens dos registos de origem e preserva a utilização de tokens em bruto nas linhas das mensagens. Usa custos explícitos comunicados pela fonte quando estão disponíveis; caso contrário, calcula um custo a partir dos tokens utilizáveis e das tarifas do modelo. A sua proveniência em JSON designa estes casos como `reported`, `computed` ou `mixed`.

Se quiser guardar um registo legível por máquina dessa única sessão, o [exemplo de CLI do projeto](https://www.agentsview.io/) usa `agentsview session usage SESSION_ID --format json`. Substitua `SESSION_ID` pelo ID que verificou na transcrição e guarde o JSON com a nota da tarefa. Verifique o modelo comunicado, as categorias de tokens e a fonte do custo nessa saída antes de citar qualquer total.

Trate um campo vazio ou um modelo em falta como desconhecido. O AgentsView não consegue reconstruir utilização que o agente nunca registou. As suas notas de versão dizem que a importação de Junie CLI exclui conversas e chamadas de ferramentas que só existem na IDE, enquanto a alternativa de texto simples do Antigravity contém a transcrição sem utilização de tokens nem custo. São exemplos concretos de que uma sessão pesquisável não tem necessariamente um valor completo de despesa. Um valor comunicado pela fonte também pode descrever o total de uma sessão, enquanto a repartição por modelos continua a ser estimada.

## 6. Delimite o relatório diário

Use os filtros de data, projeto e agente da página Usage para examinar o dia da sessão. A página também disponibiliza a tabela Top Sessions by Cost com ligações para as transcrições individuais. Para um relatório auditável no terminal, substitua a data local e o nome do agente da sessão em:

```sh
agentsview usage daily --since YYYY-MM-DD --until YYYY-MM-DD --agent codex --breakdown
```

A tabela diária separa entrada sem cache, saída, criação de cache e leituras de cache, com linhas por modelo quando `--breakdown` está definido. A data é agrupada pelo fuso horário do sistema, a menos que `--timezone` seja indicado. O total de um dia pode incluir outras sessões desse agente; serve para verificar o âmbito e a ordem de grandeza, não é o custo de uma única tarefa. Guarde o ID de sessão junto do relatório diário e verifique que linhas lhe pertencem realmente.

Para um relatório sem obter o catálogo de preços, acrescente `--offline`. Segundo o AgentsView, isto lê o arquivo existente sem sincronizar fontes nem iniciar o daemon e usa preços alternativos incluídos. Atualize primeiro o arquivo se as alterações recentes da sessão forem importantes; um relatório offline não consegue descobrir registos novos. Os comandos normais de utilização podem obter preços do LiteLLM e do OpenRouter, enquanto o catálogo incluído envelhece com a versão instalada.

## 7. Interprete o valor e pare o serviço

Identifique cada valor segundo a sua proveniência. `Computed` significa que o AgentsView multiplicou os tokens registados pelas tarifas selecionadas. `Reported` significa que a fonte forneceu um custo explícito. `Mixed` significa que o relatório combina tipos. Mesmo um valor comunicado pela fonte não demonstra que uma fatura do fornecedor relativa à conta inteira tenha sido reconciliada. Compare de forma independente os registos de faturação ou do plano do fornecedor relevante, sobretudo quando importam níveis de serviço, descontos ou franquias de subscrição. A documentação do AgentsView diz que não consegue inferir preços Batch, Flex, Priority, regionais ou de cache de uma hora quando a utilização guardada omite esse nível. Alguns tokens do lado das ferramentas não constam das transcrições locais.

A verificação de sucesso é uma transcrição encontrada cujo agente, ID e data correspondam à vista de utilização selecionada, com os campos de modelo e tokens disponíveis registados e os indisponíveis marcados como desconhecidos. O resultado é um arquivo local pesquisável e uma nota de utilização da tarefa ou do dia com âmbito delimitado, não uma fatura. Pare um `agentsview serve` em primeiro plano com `Ctrl+C`, ou pare um servidor em segundo plano com `agentsview daemon stop`. O [Quick Start](https://www.agentsview.io/docs/quickstart/) diz que parar o daemon interrompe tanto a interface web como a monitorização das sessões.

## A grande mudança

Uma transcrição local dá à discussão de custos um ponto de partida rastreável. O responsável de engenharia pode seguir um valor até uma tarefa específica registada e perceber se veio do agente ou de um catálogo de preços. Quando o registo está incompleto, o relatório deve preservar essa lacuna.

## Fontes e leituras adicionais

- [Notas da versão v0.45.0 do AgentsView](https://github.com/kenn-io/agentsview/releases/tag/v0.45.0): alterações datadas na cobertura de agentes, nos cartões Usage, na sincronização e no comportamento dos preços. Uma nota de versão é um registo do fornecedor, não um teste do BIG CHANGE.
- [AgentsView Quick Start](https://www.agentsview.io/docs/quickstart/): vias de instalação suportadas, comandos de servidor e daemon, configuração de fontes e controlos de pesquisa local.
- [Configuração do AgentsView](https://www.agentsview.io/docs/configuration/): descoberta de fontes, exclusão de fornecedores, localização do arquivo e limites desses controlos.
- [Utilização de tokens e custos do AgentsView](https://www.agentsview.io/docs/token-usage/): cobertura das fontes, relatórios de utilização, proveniência dos preços, modo offline e limitações conhecidas dos relatórios.
- [Repositório do AgentsView](https://github.com/kenn-io/agentsview): código-fonte e licença MIT; o repositório descreve o arquivo predefinido como local.

## Sources

- [Notas da versão v0.45.0 do AgentsView](https://github.com/kenn-io/agentsview/releases/tag/v0.45.0) — Versão datada e alterações de funcionalidades e cobertura.
- [AgentsView Quick Start](https://www.agentsview.io/docs/quickstart/) — Instalação, execução, seleção de fontes e controlos de pesquisa.
- [Configuração do AgentsView](https://www.agentsview.io/docs/configuration/) — Descoberta de fontes, exclusões de fornecedores, diretório de dados e limites dos controlos.
- [Utilização de tokens e custos do AgentsView](https://www.agentsview.io/docs/token-usage/) — Relatórios experimentais de utilização, proveniência dos preços e limitações.
- [Repositório de código-fonte do AgentsView](https://github.com/kenn-io/agentsview) — Código-fonte, descrição do projeto e licença MIT.