智能体运行追踪 | Alephant Documentation

智能体运行追踪将单个 AI 请求关联到其所属的更大任务。

请求日志很有用，但生产环境中的智能体通常会执行多步骤工作：模型调用、工具调用、重试、工作流分支、策略决策，有时还包括支付事件。Alephant 将这些活动视为一次运行，以便团队端到端地了解发生了什么。

追踪模型

对象	用途
Workspace	顶层租户和计费边界
Department	预算、成员和策略覆盖的组织范围
Agent	应用程序、服务、工作流或自主智能体受治理的身份
Virtual Key	用于路由流量和归属用量的范围限定凭据
Session	一系列相关交互或工作流步骤
Run	一次智能体任务或工作流的执行
Step	模型调用、工具调用、API 调用、支付事件、策略检查或工作流操作
Request	通过 Alephant Gateway 路由的兼容 provider 的 LLM 请求

一次运行追踪可包含：

网关请求可包含可选请求头，帮助 Alephant 将请求归组到 session 和 run：

请求头	用途
`x-request-id`	用于幂等性和日志查找的稳定请求标识符
`Alephant-Agent-Id`	用于智能体运行归属的稳定 Alephant agent ID
`Alephant-Run-Id`	一次任务执行 ID，在同一 run 的所有模型/工具调用中复用
`alephant-session-id`	将多个请求归组到同一 session
`alephant-session-path`	记录 workflow 或 route 路径
`alephant-session-name`	人类可读的 session 标签
`alephant-property-*`	用于筛选和归属的自定义元数据
`alephant-prompt-id`	将用量关联到 prompt template

当应用程序、框架或工作流引擎已知任务上下文时，请使用这些请求头。如果没有 session 请求头，Alephant 仍会记录 Virtual Key 的请求级元数据。

有关包含 curl、TypeScript、Python 和 n8n 示例的详细设置指南，请参阅智能体 ID 与运行 ID。

请求日志展示单个模型调用。运行追踪说明更大的执行上下文：哪个智能体执行了操作、哪个工作流步骤产生调用、应用了哪个策略决策，以及总运行成本如何构成。

session 是更广泛的交互或工作流上下文。run 是该上下文中的一次执行。例如，一个支持自动化 session 可以包含多次智能体运行、工具调用和后续模型请求。

每一步都可能产生模型成本、工具成本、支付成本或收入。Alephant 将这些信号汇总到智能体、工作流、session、department 和 workspace。