Agent Insight 用户指南 ​

Agent Insight 帮助用户记录 Agent 的执行过程，并通过评估器检查任务结果和执行轨迹。本手册介绍平台安装、Agent 接入、链路追踪和评测操作，适用于具备基本 Linux 操作知识的 Agent 开发者、测试人员和运维人员。

功能概览 ​

平台提供以下功能：

工作流程 ​

1. 管理员安装 Agent Insight，向用户提供可访问的平台地址。
2. 用户登录平台，在实际运行 Agent 的主机上配置 AcTrail 数据上报。
3. 用户运行一次 Agent 任务，在链路追踪中查看采集结果。
4. 用户配置评测模型，选择已有 Trace、参考答案和评估器，创建评测实验。
5. 用户对照原始输入输出检查评分依据，将典型样本保存为数据集。

采集和评测是两个独立环节。查看 Trace 不要求配置评测模型；创建普通实验需要已有 Trace，数据集不会自动驱动 Agent 重新执行任务。平台根据采集信息判断执行状态，“成功”不代表答案正确；评测得分是模型按指定规则作出的判断，需要结合原始记录理解。

平台安装内容 ​

管理员通过 RPM 安装平台，由 agent-insight.service 管理服务，用户通过浏览器访问。默认使用本地 SQLite 数据库，启动时自动初始化。安装步骤和数据路径见安装与维护。

接入准备 ​

• 采集 Agent 数据：用户需在运行任务的主机上准备业务 Agent、AcTrail 和官方 otel-http 插件，再配置向平台上报。AcTrail 与业务 Agent 属于接入侧环境，由使用方独立部署和配置。
• 进行模型评测：用户需准备可用的模型服务，并在平台中注册连接信息。

平台服务器与 Agent 主机可以是不同机器。Agent 主机需能访问平台地址；进行评测时，平台服务器需能访问模型服务。具体步骤见登录和接入 Agent和注册模型。

阅读顺序 ​

术语 ​

问题反馈可通过 Agent Insight Issues 提交。