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 有明確營運任務和負責人；
- 使用者能透過清晰名稱和完整術語理解能力；
- 所需資料來源和資料負責人已明確；
- 入口存在並匹配使用者工作流程；
- 可用工具符合預期風險邊界；
- 寫入動作有確認或審批路徑；
- 完成的工作可以追蹤到營運記錄。