> ## 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.

# 会话

> 从单次 Agent 运行的完整记录开始排查。

当 Agent 行为异常时，会话是最佳的排查起点。它将属于同一次运行的模型请求、响应、工具调用、人工交互、错误、评估以及策略决策汇聚在一起。

<div style={{ position: "relative", width: "100%", paddingBottom: "56.25%", height: 0, overflow: "hidden", borderRadius: "12px", margin: "1.5rem 0" }}>
  <iframe src="https://www.youtube.com/embed/VWxukZc5k7s?rel=0&playsinline=1" title="Agent tracing with Failproof AI" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture; fullscreen" allowFullScreen style={{ position: "absolute", top: 0, left: 0, width: "100%", height: "100%", border: 0 }} />
</div>

跟踪单次 Agent 运行的完整过程——从目标设定，到模型调用、工具使用，直至最终响应。

## 查找会话

<Tabs>
  <Tab title="控制台">
    1. 在云端侧边栏中，进入 **Observe → Sessions**。
    2. 设置时间范围，然后按环境、状态、Agent 或会话 ID 进行筛选。
    3. 如需按质量、成本、Token 或延迟进行切片，可添加评分或指标范围。
    4. 点击某行即可打开其追踪详情。分享时可使用会话 ID 旁边的复制按钮。

           <img src="https://mintcdn.com/exosphere/WgPwQzedeDNwJBTy/images/dashboard/sessions-list.png?fit=max&auto=format&n=WgPwQzedeDNwJBTy&q=85&s=f1fb545746143e87b8b5daedabfc5559" alt="Sessions 列表，每行对应一次运行，支持按环境、Agent、状态和评估评分进行筛选。" width="3200" height="2000" data-path="images/dashboard/sessions-list.png" />
  </Tab>

  <Tab title="CLI">
    ```bash theme={null}
    fp sessions --env production --since 24h
    fp sessions --status error,timeout --agent-id checkout-agent
    fp --json sessions --session-id <session-id>
    ```

    使用 `--agents` 展开多 Agent 运行，`--all` 分页获取所有结果，或使用 `--fields` 自定义输出列。
  </Tab>
</Tabs>

## 你可以做什么

* 按 Agent、环境、时间、模型、事件类型或错误状态查找运行记录。
* 追踪产生某一结果的完整事件序列。
* 对比成功与失败的运行记录。
* 查看审计发现或告警事件所依据的证据。
* 导出会话以获取离线记录。

## 可靠的排查顺序

1. 确认会话目标和运行环境。
2. 找到第一个错误或非预期决策——而不仅仅是最终的失败点。
3. 检查该时刻之前的模型上下文和工具输入。
4. 检查重试次数、延迟情况和人工中断。
5. 审查评估评分和策略决策。

<Card title="解读追踪记录" icon="route" href="/zh/sessions/read-a-trace">
  了解如何从会话摘要追溯到导致该结果的具体事件。
</Card>