智能體（Agent）

概述

智能體頁面（側邊欄選單 智能體）是工作空間中瀏覽和使用 AI 代理的入口。它支援兩種代理類型：

A2A 協議代理：第三方按 A2A 協議對外提供的標準化 Agent，新增一個 URL 即可對話
傳統代理（QuestionAnswer / Flow 類型）：在 GPTBots 平台上發佈的智能體，透過 iframe 嵌入

關鍵差異：和 Work 不同，智能體頁面是一個應用市集 —— 你調用的是別人或自己已經做好的 Agent，而不是從零開始一次任務。

入口

Web：https://www.gptbots.ai/工作区/agent
APP：左側選單「智能體」

列表檢視

智能體以卡片網格形式展示：

元素	說明
圖示 + 名稱	代理頭像和顯示名稱
類型徽章	`Agent`（傳統代理）或 `A2A`（A2A 協議代理）
描述	代理能力簡介
統計	使用次數、收藏數等
收藏星標	點擊收藏，收藏後可在「我的收藏」快速找到

篩選

頂部分類標籤：全部 / Default / 自訂分類（如財務 / 行政 / 產研 / 法務）
關鍵字搜尋：右上角搜尋框
我的收藏：右上角按鈕，僅顯示已收藏的代理

A2A 代理

新增 A2A 代理

透過 Agent Card URL 新增標準 A2A 協議代理：

在智能體頁面，點擊 新增 A2A 代理 按鈕（僅管理員）
輸入代理的 Agent Card URL（例如 https://agent.example.com/.well-known/agent.json）
系統自動取得代理資訊（頭像、名稱、描述、能力列表）
設定分類和顯示名稱
儲存後代理出現在列表中

什麼是 Agent Card URL？ 它是第三方 A2A 代理暴露的 HTTP 端點，回傳代理的身分描述資訊（JSON 格式）。通常由代理開發者提供。

A2A 對話

點擊代理卡片進入 A2aChatView 對話介面：

功能	說明
SSE 串流回應	即時接收代理回覆
結構化回應	支援 text / file / data / a2ui 四種內容區塊
會話管理	自動複用已有會話，或強制新建
訊息歷史	瀏覽歷史對話記錄

結構化回應類型：

Part 類型	渲染方式
`text`	Markdown 渲染（含數學公式、程式碼高亮、表格）
`file`	檔案附件（內嵌圖片或下載連結）
`data`	JSON 資料（程式碼區塊格式展示）
`a2ui`	Agent-to-UI 互動元件（A2UIRenderer 渲染）

協議技術詳解請參考 A2A 協議。

跨帳號調用

A2A 代理支援跨帳號 Gateway 派發 —— 當一個使用者從 Web 端調用 enterprise 範圍的代理時，請求會透過 Gateway 路由到目標節點執行。詳見多節點架構 — 權限彈窗分發規則。

傳統代理

傳統代理（QuestionAnswer / Flow 類型）透過 iframe 嵌入 Space Web 的代理詳情頁面。

類型	說明
QuestionAnswer	問答型代理，基於 RAG 知識庫
Flow	流程型代理，基於編排好的工作流

點擊傳統代理卡片後，進入 AgentDetailPage，嵌入 Space Web 的 /space/agent-details/{botId} 頁面。

權限控制

角色	操作
所有成員	瀏覽列表、搜尋、篩選、收藏、與代理對話
管理員	新增、編輯、刪除代理

管理員權限透過 canManageAgents() 檢查（角色為 Owner / Admin 或具備特定權限碼）。

操作指南

如何新增 A2A 代理

在開發空間建構發佈 Agent 後，可以在整合頁面點擊發佈到工作空間。
在工作空間-空間管理-企業資源-Agent 頁面，管理員可以審核是否上線。
審核通過後，該 Agent 將展示在工作空間列表中，在工作空間側邊欄點擊 智能體
找到自己剛上線的 Agent，點擊卡片即可進入對話介面

如何與代理對話

在智能體頁面找到目標代理卡片
點擊卡片進入對話介面
輸入訊息，按 Enter 傳送
等待代理回覆（SSE 串流，即時顯示）

提示：系統預設複用上一次的會話。如果想開啟全新對話，點擊「新建會話」按鈕。

常見問題

代理連線失敗

確認 Agent Card URL 可從目前網路存取
確認 URL 是 HTTPS 且非內網位址（系統有 SSRF 防護）
如果代理需要認證，確認 authType 和憑證設定正確

代理回覆為空或格式異常

可能是代理端問題，嘗試重新傳送
檢查代理是否支援中文（部分代理可能只支援英文）