Latitude

O que é Latitude?

Latitude é uma plataforma open-source de observabilidade e monitoramento de agentes de IA projetada para monitorar cada passo realizado pelo Claude Code. Ela captura rastros detalhados de uma sessão de agente — como prompts, chamadas de ferramentas, saída de comandos e arquivos tocados — para que as equipes possam entender falhas em produção e verificar se as correções funcionaram.

O propósito principal do Latitude é tornar o comportamento do agente observável de ponta a ponta. Ele ajuda a detectar possíveis problemas, investigar o que realmente aconteceu durante uma sessão e rastrear custos e uso no nível da sessão.

Principais Recursos

• Rastros de sessão para cada turno: Latitude registra o que o Claude Code executa durante uma sessão, incluindo os prompts envolvidos em cada passo, chamadas de ferramentas, saída do Bash e os arquivos tocados pelo agente.
• Captura em tempo de execução do system prompt e esquemas de ferramentas: Os rastros incluem o system prompt real e os esquemas de ferramentas compostos pelo Claude Code em tempo de execução, não apenas o que você esperava enviar.
• Detecção de falhas e monitoramento de problemas: A plataforma destaca sinais de monitoramento para o que falha em produção, permitindo investigar problemas subjacentes.
• Visibilidade de custo por sessão: Você pode visualizar custos no nível de prompt, sessão e workspace, com base na atividade da sessão capturada.
• Estatísticas de uso e controle de despesas: Latitude rastreia o uso de tokens para ajudar a regular despesas ao longo do tempo.
• Captura de tráfego ao vivo para avaliação: Ele pode capturar entradas, saídas e contexto reais de tráfego ao vivo para apoiar descoberta de falhas, análise no estilo eval e fluxos de feedback humano.

Como Usar o Latitude

1. Instale a telemetria localmente: Execute o comando fornecido para instalar a telemetria do Latitude para Claude Code (o site mostra um comando npx -y @latitude-data/claude-code-telemetry install).
2. Configure o hook/preload e o lançador de agente: O instalador configura um hook, preload e um launchctl .plist como parte da configuração de monitoramento na sua máquina.
3. Crie uma conta gratuita no Latitude: Cadastre-se no Latitude para monitorar o comportamento do agente em vários projetos.
4. Inicie o monitoramento e revise os rastros: Após a configuração, use as visualizações de rastros e monitoramento para inspecionar turnos, chamadas de ferramentas, saídas e arquivos relacionados, e rastrear uso e custos.

Casos de Uso

• Depuração de falha de agente em produção: Quando o Claude Code falha, use os rastros capturados pelo Latitude (prompts, chamadas de ferramentas, saída do Bash e arquivos tocados) para identificar o que deu errado na sessão específica.
• Verificação de que uma correção funcionou: Após alterações em prompts, ferramentas ou fluxos de trabalho, compare os rastros de sessão resultantes para confirmar que o novo system prompt/esquemas de ferramentas e as chamadas de ferramentas subsequentes se comportaram como esperado.
• Auditoria do que o agente realmente fez: Investigue preocupações relacionadas a conformidade ou segurança revisando os arquivos precisos tocados pelo agente e as saídas de comandos exatas registradas para cada turno.
• Gerenciamento de gastos com tokens: Use a visibilidade de custo por sessão e estatísticas de uso de tokens para entender o custo de cada tarefa nos níveis de prompt/sessão/workspace e regular despesas.
• Construção de evals a partir de tráfego real: Capture entradas, saídas e contexto reais de sessões ao vivo para apoiar feedback humano, descoberta de falhas e fluxos de avaliação.

FAQ

O Latitude é específico para Claude Code?
Latitude é descrito como monitorando o comportamento do Claude Code, incluindo o system prompt e os esquemas de ferramentas que ele compõe em tempo de execução.

Quais dados o Latitude coleta durante uma sessão?
A página afirma que captura prompts, chamadas de ferramentas, saída do Bash e arquivos tocados pelo agente, e também registra o system prompt e esquemas de ferramentas usados em tempo de execução.

Como começar a monitorar?
O site indica que você instala a telemetria do Latitude localmente usando um comando instalador npx, depois se cadastra no Latitude para monitorar comportamento em vários projetos.

O Latitude fornece visibilidade de custos?
Sim. Ele lista “Custo por sessão”, com visibilidade descrita nos níveis por prompt, por sessão e por workspace.

O Latitude suporta fluxos de avaliação e feedback?
A página menciona captura de entradas/saídas/contexto reais de tráfego ao vivo para apoiar “human feedback”, “Failure discovery”, “Playground” e “Evals”.

Alternativas

• Instrumentação baseada em OpenTelemetry para apps de LLM: Se você quiser uma pilha de observabilidade centrada em OpenTelemetry, pode construir traces personalizados ao redor das execuções do seu agente. Latitude se posiciona como uma camada de observabilidade focada em agentes para o comportamento do Claude Code.
• Monitoramento geral de aplicações (logs/métricas/traces): Ferramentas focadas na saúde do sistema (logs/métricas/APM) podem ajudar a detectar falhas, mas podem não capturar contexto específico do agente, como prompts do sistema, esquemas de ferramentas e detalhes de chamadas de ferramentas por turno.
• Frameworks de avaliação de agentes: Ferramentas focadas em avaliação podem ajudar a testar prompts e comportamento de agentes contra conjuntos de dados, mas frequentemente exigem entradas sintéticas; Latitude enfatiza a captura de tráfego ao vivo para entradas e saídas reais.