Agent 生命周期与配置
FactVerse AI Agent 应作为运营能力来管理。每个已配置的 Agent 都需要明确业务目的、负责人、用户入口、数据上下文、工具边界、复核路径和运行记录。
准备为租户启用新 Agent、调整现有 Agent,或判断某个 Agent 是否可以进入常规使用时,请使用本页。
生命周期流程
配置包
Agent 出现在 Agent Hub 之前,应先准备一份简短的配置包。
| 字段 | 价值 | 复核问题 |
|---|---|---|
| Agent 名称 | 为用户提供可识别的入口。 | 目标用户是否能直接理解这个名称? |
| 目的 | 将 Agent 绑定到具体运营任务。 | 它支持什么决策、记录或工作流? |
| 负责人 | 明确谁负责运行和变更。 | 谁接受行为变更和复核结果? |
| 状态 | 显示 Agent 当前可用、受限、计划中或已退役。 | 用户今天是否应该进入这个 Agent? |
| 入口路由 | 把用户带到正确模块、仪表板、助手或工作流。 | 入口是否符合用户预期的工作方式? |
| 数据依赖 | 列出 Agent 需要的来源系统、文档、场景和记录。 | 新鲜度和质量要求是否清楚? |
| 工具边界 | 定义 Agent 可以发现和调用的工具。 | 可见工具是否匹配 Agent 的目的和权限? |
| 复核边界 | 定义只读、分析、草稿、确认和审批行为。 | 哪些输出可直接接受,哪些需要复核? |
| 运行记录 | 保留证据、决策、动作和反馈。 | 后续复核人是否能还原当时发生了什么? |
规划 Agent
先定义运营任务,再选择适合该任务的模型、工具和复核路径。有效的 Agent 规划应说明:
- 哪个用户角色或团队会使用它;
- 租户、站点、资产组、设备、场景或工作记录边界;
- Agent 负责处理的常见问题、任务或决策包;
- 涉及的数据来源和产品模块;
- 预期输出类型;
- 高影响结果的复核人或审批负责人。
如果来源质量会影响输出,请把规划连接到数据就绪度。
配置 Hub 入口
Agent Hub 应为每个已配置 Agent 显示简洁入口。
| Hub 项目 | 配置建议 |
|---|---|
| 名称 | 使用业务能力或运营角色。 |
| 摘要 | 用一句话说明任务。 |
| 状态 | 统一使用可用、受限、计划中或已退役等状态。 |
| 入口 | 链接到模块页面、工作流、仪表板、助手或审批路径。 |
| 数据健康 | 当数据延迟、缺失或正在复核会影响回答时,应明确展示。 |
| 复核说明 | 告诉用户 Agent 返回的是证据、草稿,还是需要审批的动作。 |
完整入口模型见 Agent Hub。
绑定工具与访问权限
工具访问应跟随 Agent 目的。
- 确认 Agent 的运营任务。
- 选择完成该任务所需的最小工具集。
- 让 MCP scope 和租户权限匹配这些工具。
- 确认每个工具是只读、分析、生成草稿还是可触发动作。
- 使用目标用户实际使用的访问包测试运行时工具发现。
- 上线前记录缺失工具、被阻止工具或 scope 缺口。
准备访问包时,请参考访问与 Scope 规划和 MCP 工具参考。
上线前验证
常规使用前,应用一组小型验证用例覆盖正常、弱数据和动作被阻止的情况。
| 验证范围 | 检查内容 |
|---|---|
| 身份和租户边界 | Agent 只能看到预期的租户、站点、资产和权限上下文。 |
| 数据就绪度 | 必需的记录、信号、文档和场景存在,或明确显示缺口。 |
| 运行时工具发现 | Agent 在实际环境中看到预期工具。 |
| 证据质量 | 回答包含来源引用、时间戳、假设和未解决缺口。 |
| 复核行为 | 草稿、确认、审批和被阻止动作都走配置好的复核路径。 |
| 运行记录 | 工具调用、输出、复核决策和反馈被记录下来。 |
请使用工作流运行记录整理验证证据。
运行与改进
常规运行期间,应保持轻量复核节奏。
| 运营信号 | 处理方式 |
|---|---|
| 数据反复缺失 | 先修复来源映射、新鲜度或文档,再扩大使用范围。 |
| 工具频繁被阻止 | 检查 scope、模块启用状态和 Agent 工具绑定。 |
| 回答可信度较低 | 为工作流补充来源证据、示例或复核反馈。 |
| 复核拥堵 | 明确不同输出类型由谁审批。 |
| 已接受的修正 | 将修正结果反馈到工作流设计和运行手册中。 |
| 使用率下降 | 检查入口、名称或任务边界是否贴合真实工作。 |
变更或退役 Agent
变更应作为受控更新处理。调整工具访问、复核边界或入口路由之前,应记录原因、预期用户影响和验证计划。
当来源系统、负责人、入口或运营目的已经不匹配当前工作时,应退役 Agent。历史运行记录需要保留,Hub 中的活跃入口应移除。
上线检查表
| 检查项 | 就绪标准 |
|---|---|
| 目的 | Agent 有明确运营任务和用户角色。 |
| 负责人 | 产品或运营负责人接受变更和复核结果。 |
| 数据 | 来源系统、文档、场景和记录有新鲜度要求。 |
| 访问 | MCP endpoint、scope、租户权限和工具发现已经测试。 |
| 复核 | 输出类型和审批路径清楚。 |
| 证据 | 工作流可以生成来源引用和运行记录。 |
| 交接 | 用户知道从哪里进入 Agent,以及在哪里反馈问题。 |
相关页面
| 需求 | 页面 |
|---|---|
| 理解平台模型 | Agent Platform 总览 |
| 设计用户入口 | Agent Hub |
| 规划来源就绪度 | 数据就绪度 |
| 规划访问和 scope | 访问与 Scope 规划 |
| 保存验证证据 | 工作流运行记录 |