AI Agent 运营指南
当 AI Agent 工作流从早期验证进入受控试点或生产运行时,应使用这些指南。这里关注访问权限、数据、运行记录、审核、问题排查和输出示例。
前置条件
使用这些运营指南前,团队应先确认:
- 已选择配置好的 Agent 或集成入口;
- 已确定工作流负责人和复核人;
- 已识别租户、站点、资产、设备、场景或工作记录边界;
- 已列出所需来源系统和文档;
- 已选择首个 MCP endpoint 和 scope 包;
- 首次验证运行会以只读方式开始。
指南地图
| 指南 | 什么时候使用 | 主要输出 |
|---|---|---|
| Agent 生命周期与配置 | 租户 Agent 需要申请、配置、变更、暂停或停用 | Agent 目的、负责人、边界、启用工具、验证状态和变更记录 |
| 风险治理与安全 | 工作流可能使用计算工具、草稿动作或较高风险的运营输出 | 风险级别、复核关口、证据要求和审批规则 |
| 访问与 Scope 规划 | 客户端、工作流或集成需要 endpoint 和 API key | Endpoint 选择、scope 列表、key 负责人和审批边界 |
| 运行时工具发现 | 配置好的客户端需要在实施前证明哪些工具可见 | 运行时工具列表、缺失工具诊断和 scope/模块确认 |
| 工具执行治理 | 工具调用需要统一处理为证据、建议、草稿或已批准记录 | 执行结果规则、复核说明、草稿动作边界和审计证据 |
| 数据就绪 | 工作流需要可靠的资产、信号、文档、场景或工单上下文 | 数据缺口清单、来源映射和质量检查 |
| 工作流运行记录 | 工作流执行结果需要后续复盘或审计 | 输入边界、工具调用、来源引用、审核记录和最终结果 |
| 验证与交接 | 试点需要交给运营、维护或工程团队接收 | 验收检查、负责人交接、支持边界和改进闭环 |
| 问题排查 | 客户端、scope、数据、工具或输出问题阻塞工作流 | 排查路径和交给责任团队的证据 |
| 示例 | 团队在实施前需要请求和响应样例 | 示例 prompt、工具上下文、输出格式和审核说明 |
运营顺序
- 确认 Agent 目的、负责人、用户入口和生命周期状态。
- 明确工作流边界、endpoint、scope 和 key 负责人。
- 列出运行时工具,并与预期 endpoint 和 scope 包对照。
- 检查所需资产、信号、文档、场景和工作记录是否就绪。
- 先以只读方式运行工作流,并记录工具输出与来源引用。
- 只有在假设和复核负责人可见后,再加入计算工具。
- 写入动作必须作为草稿进入审批、审计和回滚流程。
- 复盘已完成运行,把确认过的修正反馈到数据层和知识层。
审核关口
| 关口 | 必须检查 |
|---|---|
| 访问关口 | 客户端只能看到 endpoint 和 scope 允许的工具。 |
| 数据关口 | 来源记录能稳定对应到资产、位置、场景或工单标识。 |
| 输出关口 | 回答包含来源引用、假设和未解决缺口。 |
| 动作关口 | 任何写入动作在负责人批准前保持草稿状态。 |
| 交接关口 | 运营团队清楚 key、工作流、异常和支持由谁负责。 |
预期输出
| 输出 | 来源 |
|---|---|
| Agent 配置摘要 | Agent 生命周期与配置。 |
| 访问计划 | 访问与 Scope 规划。 |
| 运行时工具发现快照 | 运行时工具发现。 |
| 风险与审批说明 | 风险治理与安全。 |
| 数据就绪说明 | 数据就绪和 DFS 页面。 |
| 工具执行策略 | 工具执行治理。 |
| 只读验证结果 | 工作流指南和示例。 |
| 运行记录 | 工作流运行记录。 |
| 验收包 | 验证与交接。 |
| 问题证据 | 故障排查和 MCP 错误与审计。 |
失败处理
| 问题 | 下一页 |
|---|---|
| 客户端无法连接或列出工具 | 故障排查 和 MCP 错误与审计 |
| Agent 配置变化或应停用 | Agent 生命周期与配置 |
| Scope 包过宽或过窄 | 访问与 Scope 规划 |
| 预期工具缺失或出现了不应暴露的工具 | 运行时工具发现 |
| 工具结果需要成为草稿动作或已批准记录 | 工具执行治理 |
| 来源数据过期或不完整 | 数据就绪 和 DFS |
| 输出无法被接受 | 工作流运行记录 和 验证与交接 |
选择下一页
- 客户端或权限模型仍在设计时,从 访问与 Scope 规划 开始。
- 需要创建、变更、暂停或停用配置好的 Agent 时,从 Agent 生命周期与配置 开始。
- 客户端已连接但需要验证可见工具集时,从 运行时工具发现 开始。
- 工作流依赖外部系统、DFS 管道或客户文档时,从 数据就绪 开始。
- 团队已有可运行试点并需要稳定复盘证据时,从 工作流运行记录 开始。