选择 AI Agent 接入方式

更新时间:
复制 MD 格式

接入中心用于将 AI Agent、Agent 框架、自研 Agent 及其运行时行为接入 AgentLoop。接入后,可以根据接入方式使用可观测、审计和评估等产品能力。接入前,根据 Agent 类型、运行环境和目标产品选择合适的接入方式。

选择接入方式

下表中的符号说明如下:

  • ✅:基本支持。

  • ❌:当前不支持。

接入对象覆盖

接入对象

AI 系统运行时日志(eBPF

LoongSuite Pilot

语言与框架探针

常见 Agent

Claude CodeOpenClawQwenPaw、Hermes 等;❌ Codex

Claude CodeCodexCursorQoderQoder CNQoder Work;❌ 其他 Agent

OpenClawQwenPaw、Hermes、Coze;❌ 其他 Agent

常见 Agent 框架

LangChainLangGraph、Dify、AgentScope

LangChainLangGraphAgentScope;❌ 其他框架

Python 自研 Agent

Node.js 自研 Agent

Rust 自研 Agent

其他语言自研 Agent

支持部分对象或存在明确的能力边界。

产品能力与运行环境

能力或环境

AI 系统运行时日志(eBPF

LoongSuite Pilot

语言与框架探针

可观测产品

审计产品

评估产品

系统与环境

Linux 主机、Docker、Kubernetes

Linux、macOS、Windows 开发环境

Linux、macOS、Windows 主机及容器环境

升级影响

手动升级采集器,无需重启业务

自动升级采集组件,无需重启业务

主机手动更新、容器自动更新,需要重启应用

以上能力以目标对象受支持且数据采集成功为前提。

  1. AI 系统运行时日志通过 eBPF 对常见 Linux 运行时提供通用覆盖能力。Codex 使用 Rust 和特殊 TLS 实现,LLM 载荷采集能力受限。

  2. 语言与框架探针需要按语言、Agent 或框架进行适配。

  3. AI 系统运行时日志的可观测链路当前尚未开放。eBPF 可能无法直接获取原生 Session、Turn、Step 标识及框架内部状态。

  4. 语言与框架探针的审计链路当前尚未开放。

选型建议

在受支持的 Linux 主机或容器环境中,建议优先使用 AI 系统运行时日志(eBPF)。需要原生 Agent 或框架上下文时,可以同时使用 LoongSuite Pilot 或语言与框架探针。

组合接入

AI 系统运行时日志、LoongSuite Pilot 和语言与框架探针可以组合使用,不是互斥的接入方式:

  • AI 系统运行时日志通过 eBPF 采集通用模型交互和 Runtime 事实。

  • LoongSuite Pilot 或语言与框架探针补充原生 Session、Turn、Step 及框架状态。

  • 需要同时观察 Agent 上下文与进程、文件、网络等运行时行为时,可以组合使用多种接入方式。

数据脱敏

接入配置支持按需开启端侧数据脱敏,对手机号、身份证号、邮箱地址、IP 地址、座机电话和银行卡号等敏感信息进行处理。数据脱敏默认关闭,具体配置以对应接入项为准。

找到对应接入项

登录 AgentLoop,在左侧导航栏单击接入中心,根据接入对象选择对应的接入项。

接入对象

接入中心入口

详情文档

AI Coding Agent

在 AI 应用接入中选择 Claude CodeCodexCursorQoderQoder CNQoder Work 等对应接入项

AI 应用接入:AI Coding Agent

Agent 及平台

在 AI 应用接入中选择 OpenClawQwenPaw、Hermes 或 Coze 等对应接入项

接入 OpenClaw 应用接入 Hermes Agent 应用

Agent 框架及自研应用

在 AI 应用接入中选择 AgentScopeLangChain / LangGraphDifyPythonNode.js 等对应接入项

接入 AgentScope(Python)应用接入 Dify 应用接入 LangChain & LangGraph 应用

AI 系统运行时

在 AI 节点接入中选择 AI 系统运行时日志,适用于 Linux 主机、Docker 和 Kubernetes 环境

接入 AI 系统运行时日志

需要使用 AI Agent 自动编排应用监控接入流程时,参见通过 AI Agent 接入 AgentLoop 应用监控

接入后的下一步

  • 验证接入状态:按照具体接入文档检查目标数据是否已写入,并排查无数据问题。

  • 查看可观测数据:查看模型调用、Token 使用量、Agent 链路和工具调用等数据。

  • 开启审计能力:在审计管理中配置应用、运行时风险检测和语义检测选项。

  • 使用审计事实:在审计事实中浏览 Session,查看 Token 分析和行为分析。

  • 评估 Agent 轨迹:创建轨迹数据集并配置评估任务,分析 Agent 执行质量。