操作场景
Agent 可观测支持采集 AI Agent 在运行过程中产生的会话、调用链、模型调用、工具调用和 Token 消耗等数据，并上报到日志服务（Cloud Log Service，CLS）进行检索分析。
由于 AI Agent 的形态和技术栈差异较大，Agent 可观测提供了多种接入方式。本文帮助您快速确定适用于自身场景的接入方式。
选择接入方式
请在下表中找到您的接入对象，即可确定接入方式并进入对应文档。
场景 | 接入对象 | 接入方式 |
AI Agent | CodeBuddy、WorkBuddy、Claude Code、Codex、Cursor、MiMo Code、OpenClaw、Pi Coding Agent、Hermes Agent、OpenCode | 容器环境：接入 AI Agent（容器环境） |
| DeepSeek Harness | |
Agent 框架和自研应用 | AgentScope 应用 | |
| OpenAI Agents SDK 应用 | |
| 其他 Agent 框架或自研应用 | |
接入方式对比
如果您的接入对象支持多种接入方式，或需要评估接入成本，请参考下表。
能力或环境 | Onesuite-Pilot 采集器 | 官方 SDK 与插件 | Langfuse SDK 上报 |
接入操作 | 执行一条安装命令，无需修改应用代码 | 安装依赖并新增初始化代码 | 调整 Exporter 配置 |
支持的系统与环境 | macOS、Linux、Windows 主机；TKE 容器环境 | 取决于应用运行环境 | 取决于应用运行环境 |
升级影响 | 支持自动升级，无需重启应用 | 更新依赖包版本，需要重启应用 | 更新依赖包版本，需要重启应用 |
注意事项
可组合接入。同时使用现成 AI Agent 和自研应用时，可分别通过采集器和 SDK 接入，数据汇总到同一个 Agent 可观测应用中统一查看。所有接入方式上报的 Trace 数据均遵循同一套语义规范，可在同一应用中统一检索分析。
同一实例请勿启用多条上报路径。例如同时启用 Onesuite-Pilot 采集器和 DeepSeek Harness 插件并上报到同一日志主题，会导致同一次任务产生重复 Trace。
开始接入
无论采用哪种接入方式，均需先创建 Agent 可观测应用。
1. 登录 日志服务控制台 > Agent 可观测，单击应用接入创建应用。
2. 获取该应用的 Trace 日志主题 ID，用于后续接入配置。
3. 参见上方表格中的接入文档完成接入。
说明：
各接入文档均提供 Skill 接入方式。使用支持 Skill 的 AI 工具时，可由 AI 自动创建或复用日志主题、识别运行环境并完成接入与验证，减少手动配置。
其他操作
验证接入状态：按照具体接入文档检查目标数据是否已写入，并排查无数据问题。
查看观测数据：在 Agent 可观测 页面查看 Agent、模型和工具调用的执行关系、耗时和 Token 消耗。
