> ## 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.
# Sessões
> Comece com o registro completo de uma execução do agente.
Uma sessão é o melhor ponto de partida quando um agente se comporta de forma inesperada. Ela reúne as requisições ao modelo, respostas, chamadas de ferramentas, interações humanas, erros, avaliações e decisões de políticas que pertencem a uma única execução.
Acompanhe uma execução do agente desde seu objetivo, passando pelas chamadas ao modelo e ferramentas, até a resposta final.
## Encontrar uma sessão
1. Na barra lateral do Cloud, vá para **Observe → Sessions**.
2. Defina o intervalo de tempo e filtre por ambiente, status, agente ou ID de sessão.
3. Adicione intervalos de pontuação ou métricas quando precisar de um recorte por qualidade, custo, tokens ou latência.
4. Selecione uma linha para abrir seu trace. Use o controle de cópia ao lado do ID de sessão ao compartilhá-lo.
```bash theme={null}
fp sessions --env production --since 24h
fp sessions --status error,timeout --agent-id checkout-agent
fp --json sessions --session-id
```
Adicione `--agents` para expandir execuções multi-agente, `--all` para paginar ou `--fields` para escolher as colunas de saída.
## O que você pode fazer
* Encontrar uma execução por agente, ambiente, tempo, modelo, tipo de evento ou estado de erro.
* Acompanhar a sequência exata que produziu um resultado.
* Comparar execuções bem-sucedidas e com falha.
* Abrir as evidências usadas por uma conclusão de auditoria ou incidente de alerta.
* Exportar uma sessão quando precisar de um registro offline.
## Uma ordem de investigação confiável
1. Confirme o objetivo da sessão e o ambiente.
2. Encontre o primeiro erro ou decisão inesperada — não apenas a falha final.
3. Inspecione o contexto do modelo e a entrada da ferramenta imediatamente antes disso.
4. Verifique tentativas repetidas, latência e interrupções humanas.
5. Revise as pontuações de avaliação e as decisões de políticas.
Aprenda como ir do resumo da sessão até o evento que causou o resultado.
