
AG-UI
AG-UI(代理-使用者互動協定)是一個開放、輕量級、基於事件的協定,它透過即時串流、狀態管理和人機協作互動來標準化 AI 代理如何連接到前端應用程式。
https://ag-ui.com/?ref=aipure&utm_source=aipure

產品資訊
更新時間:2025年05月20日
什麼是 AG-UI
AG-UI 透過在後端 AI 代理和前端應用程式之間提供標準化的通訊層,解決了 AI 代理生態系統中的一個關鍵缺口。雖然像 LangChain、LangGraph 和 CrewAI 這樣的工具擅長協調複雜的 AI 工作流程,但代理和使用者介面之間的互動層仍然分散。AG-UI 透過建立一個結構化的協定來解決這個問題,該協定透過 JSON 事件流實現無縫的即時通訊,使開發者更容易建構互動式的 AI 驅動應用程式。
AG-UI 的主要功能
AG-UI 是一個開放、輕量級、基於事件的協議,用於標準化 AI 代理和前端應用程式之間的通訊。它提供即時串流、雙向互動和工具協調功能,同時透過一系列標準化事件,保持代理後端和前端介面之間的完美同步,從而輕鬆構建互動式 AI 驅動的應用程式。
即時事件串流: 支援 LLM 輸出的逐個 token 串流,並透過 16 種標準化事件類型實現即時 UI 更新,而無需阻塞完整回應
傳輸層靈活性: 支援多種傳輸機制,包括伺服器發送事件 (SSE)、WebSocket 和 Webhook,允許開發人員選擇最適合其架構的方法
工具協調: 使代理能夠呼叫函數、執行程式碼並與 API 互動,同時保持上下文並支援人機迴路批准流程
共享可變狀態: 維護前端和後端之間同步的狀態,用於逐步變化的演進計畫、表格或程式碼資料夾
AG-UI 的使用案例
AI 驅動的聊天介面: 構建具有即時串流回應和動態 UI 更新的互動式聊天應用程式
協作開發工具: 創建編碼助手和開發工具,其中 AI 代理與人類開發人員一起工作,並共享上下文
多代理系統: 開發多個 AI 代理協作並透過統一介面與使用者互動的應用程式
人機迴路工作流程: 構建需要人工監督和批准的系統,同時保持與 AI 代理的持續互動
優點
輕量級且易於與現有系統整合
與框架無關,支援多種傳輸方法
標準化的事件系統確保一致的通訊模式
缺點
相對較新的協議,規範不斷發展
與更成熟的協議相比,生態系統有限
如何使用 AG-UI
安裝 AG-UI: 根據您的技術堆疊,使用您的套件管理器 (npm/yarn/poetry) 安裝 AG-UI 協定和所需的依賴項
設定環境: 將您的 OpenAI API 金鑰設定為環境變數:export OPENAI_API_KEY=your-api-key
建立 AG-UI 代理: 實作一個代理類別,該類別擴展了 @ag-ui/client 中的 AbstractAgent 並實作了所需的事件發射器
定義事件處理常式: 為 16 個標準化的 AG-UI 事件設定處理常式,例如 RUN_STARTED、TEXT_MESSAGE_START、TEXT_MESSAGE_CONTENT 等
設定 HTTP 端點: 建立一個 HTTP 端點,該端點實作 AG-UI 協定以使用伺服器發送事件 (SSE) 處理代理-UI 通訊
連接前端 UI: 使用 CopilotKit React 元件或建構使用 AG-UI 事件流的自訂 UI 元件
啟用雙向通訊: 實作使用者輸入和回饋的處理常式,以啟用人與代理之間的協作工作流程
測試整合: 執行您的伺服器(例如 poetry run uvicorn endpoint:app --reload)並測試代理-UI 互動
新增進階功能: 根據您的用例需要,實作其他功能,例如工具呼叫、推理步驟、多模態支援
部署和擴展: 部署您的 AG-UI 實作,並在使用代理服務管理多個代理時進行擴展
AG-UI 常見問題
AG-UI 是一種開放、輕量級、基於事件的協議,它標準化了 AI 代理如何連接到前端應用程式。它充當 AI 驅動系統的通用翻譯器,以確保代理和使用者介面之間的流暢通訊。