Agent Hub
Agent Hub 是租户环境中已配置 FactVerse AI Agent 的用户入口。它展示哪些 Agent 可用、每个 Agent 支持什么任务、当前是否可进入，以及用户下一步应去哪里。
当团队规划客户、操作员、工程师或实施团队如何发现并进入 Agent 工作流时，请使用本页。
Agent Hub 应回答的问题
| 问题 | Agent Hub 的回答 |
|---|---|
| 当前租户有哪些 Agent？ | 按租户配置的 Agent 清单。 |
| 这个 Agent 支持什么任务？ | 与运营任务对应的简短能力说明。 |
| 用户现在能否进入？ | 可用状态和入口。 |
| 它依赖哪些数据？ | 数据健康提示或源数据准备页面链接。 |
| 下一步做什么？ | 进入模块页面、仪表盘、助手、工作流或审批路径。 |
Agent Hub 是实时产品入口，应反映当前环境中已配置且有实际用途的 Agent。
Agent 卡片模型
每张 Agent 卡片应保留少量关键信息。
| 字段 | 作用 |
|---|---|
| Agent 名称 | 用户能识别的客户可见名称。 |
| 状态 | 标明 Agent 已可用、正在推出或暂不可用。 |
| 能力摘要 | 说明该 Agent 支持的运营任务。 |
| 入口 | 用户进入 Agent 工作的位置。 |
| 数据健康信号 | 提示所需上游数据是否可用、延迟、缺失或待审核。 |
| 审核边界 | 标明输出是只读结果、草稿，还是需要审批的动作。 |
命名要务实。卡片标题应使用用户能识别的业务能力或运营角色。
状态行为
| 状态 | 产品行为 |
|---|---|
| 可用 | 用户可以打开 Agent 入口并运行支持的工作流。 |
| 受限 | Agent 可以查看，但数据、权限范围或工作流准备情况限制了可执行内容。 |
| 规划中 | 当租户中显示未来能力时，卡片应指向合适的产品负责人或发布说明。 |
| 空状态 | 如果租户没有配置 Agent，应显示当前租户专属的空状态。 |
当前租户专属的空状态可以让 Hub 始终贴合实际环境。它应说明当前租户没有可用 Agent，并引导用户检查访问配置、模块启用或联系对应管理员，而不是展示通用产品目录。
Agent Hub 中的数据健康
Agent 是否有用，取决于数据是否准备好。只要 Agent 依赖实时或近期同步的数据源，Agent Hub 就应呈现数据健康上下文。
| 来源类型 | 示例 |
|---|---|
| Platform 记录 | 租户、站点、资产、设备、位置、权限 |
| DFS 数据 | 连接器同步状态、字段映射、质量检查、融合任务输出 |
| Inspector 记录 | 报警、巡检、工单、操作员备注 |
| Designer 上下文 | 场景版本、模型资产版本、SimReady 包、仿真设置 |
| 文档 | 手册、SOP、流程文件、证据文件 |
当数据健康较弱时，应引导用户查看数据准备或相关模块文档，再返回有依据的回答。
当某个 Agent 依赖多个来源时，Agent Hub 也可以展示汇总后的数据健康状态。例如 CMMS Assistant 可能同时依赖工单、资产身份、现场信号、文档和提供商同步状态。卡片应清楚显示最弱的必需来源，让用户知道当前工作流是可用、受限，还是等待上游修复。
工具可见性
Agent Hub 与运行时工具发现相关联。租户看到的工具，应来自该环境已配置 Agent、已启用模块和访问权限范围。
这意味着：
- 工具可能存在于产品中，并且只对具备正确绑定和 scope 的 Agent 可见；
- 模块可以已启用，但只暴露该工作流配置过的工具；
- 具备写入能力的工具可以可见，但执行前仍可能需要确认或人工审核；
- 工具缺失时，应检查 endpoint、权限范围、模块启用状态和 Agent 绑定。
规划时可使用 MCP 工具参考，实际环境以运行时发现结果为准。
用户流程
新增 Agent Hub 入口前的检查
新增 Agent 到 Hub 前，请确认：
- Agent 有明确运营任务和负责人；
- 用户能通过清晰名称和完整术语理解能力；
- 所需数据源和数据负责人已明确；
- 入口存在并匹配用户工作流；
- 可用工具符合预期风险边界；
- 写入动作有确认或审批路径；
- 完成的工作可以追踪到运营记录。