FactVerse AI Agent 文档使用指南
FactVerse AI Agent 文档围绕实际实施工作组织：理解平台边界、连接受控 MCP 客户端、设计工作流、查看示例、排查失败路径，并完成验证与交接。
使用本页为当前任务选择合适的文档。
文档选择流程
从这里开始
| 任务 | 使用 |
|---|---|
| 了解 FactVerse AI Agent 是什么 | 概览 |
| 解释受控 Agent Platform 运行模型 | Agent Platform 概览 |
| 规划用户如何找到租户专属 Agent | Agent Hub |
| 配置、变更或停用 Agent | Agent 生命周期与配置 |
| 定义风险级别和复核关口 | 风险治理与安全 |
| 第一次连接 MCP 客户端 | 快速开始 |
| 规划 endpoint、API key、scope 和审批边界 | 访问与 Scope 规划 |
| 确认可实际调用的工具 | 运行时工具发现 |
| 规划工具结果、草稿和审批处理方式 | 工具执行治理 |
| 检查资产、信号、文档和场景是否就绪 | 数据就绪度 |
| 理解租户、资产、scope、审批和审计概念 | 核心概念 |
| 查看请求和输出模式 | 示例 |
| 构建任务型工作流 | 工作流指南 |
| 记录证据、复核决策、动作和反馈 | 工作流运行记录 |
| 排查连接、scope、数据或仿真失败 | 故障排查 |
| 准备验收和运营交接 | 验证与交接 |
平台与治理页面
当任务关注 Agent Platform 本身，而不是某一个工作流配方时，优先使用这些页面。
| 页面 | 用途 | 配合阅读 |
|---|---|---|
| Agent Platform 概览 | 说明运行模型、租户上下文、Agent 配置、工具调度和复核关口。 | 架构参考 |
| Agent Hub | 规划操作员如何找到已批准 Agent、理解状态并启动受控工作流。 | 工作流指南 |
| Agent 生命周期与配置 | 定义 Agent 如何申请、配置、验证、变更、暂停或停用。 | 验证与交接 |
| 风险治理与安全 | 决定只读、计算和写入动作所需的复核级别、证据和审批边界。 | 访问与 Scope 规划 |
| 运行时工具发现 | 验证指定客户端、endpoint、key、scope 和租户上下文实际暴露的工具。 | 工具参考 |
| 工具执行治理 | 定义工具调用如何形成证据、建议、草稿或已批准记录。 | 工作流运行记录 |
工作流方向
FactVerse AI Agent 文档当前聚焦三个工作流方向。
| 方向 | 场景说明 | 工作流指南 |
|---|---|---|
| 设施运营 | 设施运营 | 设施运营工作流指南 |
| 预测性维护 | 预测性维护 | 预测性维护工作流指南 |
| Physical AI | Physical AI | Physical AI 工作流指南 |
场景说明用于理解业务背景。准备数据、选择 scope、设计工具流程、定义复核点和记录结果时，使用工作流指南。
参考页面
| 参考 | 用途 |
|---|---|
| MCP 概览 | 理解受控工具访问和 endpoint 结构。 |
| MCP 接入指南 | 配置 MCP 客户端和连接设置。 |
| MCP 能力指南 | 理解 endpoint 系列、能力类别和工作流选择。 |
| MCP Scope 矩阵 | 规划 scope、复核人和访问包。 |
| MCP 错误与审计 | 诊断失败路径并保留复核记录。 |
| 工具参考 | 查看工具名称、scope、说明和参数。 |
| Scope 参考 | 查看 endpoint、module 和 scope 要求。 |
工具参考用于规划和复核。具体客户环境和 API key 可调用哪些工具，以运行时工具发现为准。
复核模式
完整的 Agent 工作流应让这些信息可见：
- 租户、站点、资产、设备或场景边界；
- 客户端使用的 endpoint 和 scope；
- 来源系统、时间戳和数据质量说明；
- 工具结果、证据和假设；
- 复核负责人和审批状态；
- 最终工单、巡检、场景或验证记录。