> ## Documentation Index
> Fetch the complete documentation index at: https://docs.befailproof.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Leia um trace

> Encontre o evento que mudou o curso de uma sessão do agente.

Um trace transforma um fluxo plano de eventos na história causal da execução. Leia-o a partir da primeira divergência, não de trás para frente a partir do último erro.

## Abra o trace

<Tabs>
  <Tab title="Dashboard">
    1. Vá em **Observe → Sessions** e abra uma sessão.
    2. Use o resumo do perfil para verificar resultado, tempo, erros e pontuações de avaliação.
    3. Percorra a linha do tempo e o minimapa. Filtre tipos de eventos ou período quando a sessão for muito grande.
    4. Selecione um evento para inspecioná-lo. Use **export** para JSON do avaliador, ou copie a URL da página para compartilhar um link direto para a evidência selecionada.

           <img src="https://mintcdn.com/exosphere/WgPwQzedeDNwJBTy/images/dashboard/session-detail.png?fit=max&auto=format&n=WgPwQzedeDNwJBTy&q=85&s=7b5f022dd5c485565a8cd92b2e936235" alt="Uma visão detalhada de sessão com seu grafo de execução, linha do tempo de eventos, painel de avaliação e resumo de ferramentas, modelo e hooks." width="3200" height="2000" data-path="images/dashboard/session-detail.png" />
  </Tab>

  <Tab title="CLI">
    ```bash theme={null}
    fp --json sessions --session-id <session-id>
    fp events --session-id <session-id> --order asc --all
    fp --json events --full --session-id <session-id> --all
    ```

    Use primeiro o feed de eventos leve. Solicite payloads completos apenas quando os resumos dos eventos não contiverem evidências suficientes.
  </Tab>
</Tabs>

<Steps>
  <Step title="Oriente-se">
    Confirme o agente, o ambiente, o tempo, o resultado e a duração; em seguida, verifique erros, spans longos, ferramentas repetidas, esperas humanas e decisões de política negadas.
  </Step>

  <Step title="Expanda o primeiro evento suspeito">
    Inspecione sua requisição, resposta, entrada e saída da ferramenta e ID de correlação. Conteúdo sensível fica visível somente quando a captura de transcrição está habilitada e suas permissões permitem.
  </Step>

  <Step title="Inspecione o contexto anterior">
    A causa geralmente está um evento antes: uma resposta incorreta do modelo, resultado de ferramenta ausente ou premissa desatualizada.
  </Step>

  <Step title="Transforme a evidência em ação">
    Adicione a sessão a um escopo de auditoria, vincule-a a um problema ou use o modo de falha para criar uma política.
  </Step>
</Steps>

<Warning>
  Duração longa nem sempre significa latência do modelo. Separe o tempo de modelo, ferramenta, hook e espera humana antes de decidir o que corrigir.
</Warning>