AG-UI:Agent 進入前端產品介面的事件協定
AG-UI(Agent-User Interaction Protocol)是一個開源、輕量、事件式協定,用來標準化 AI agent 後端與使用者前端應用之間的互動。它補上 MCP 與 A2A 沒有處理的那一層:不是「agent 怎麼拿工具」或「agent 怎麼跟 agent 溝通」,而是「agent 怎麼安全、即時、可觀測地進入產品 UI」。
AG-UI 是 agent ↔ frontend 的互動協定。它把 agent 執行過程拆成標準事件流,讓前端可以處理串流文字、工具呼叫、狀態同步、進度活動與人類介入。
產品內建 copilot、客服/營運工作台、資料分析助理、human-in-the-loop 流程、會動態生成 UI 的 agent 應用。
README 的說法很清楚:MCP 給 agent 工具,A2A 讓 agent 彼此溝通,AG-UI 則把 agent 帶進 user-facing applications。
GitHub repo 約 13.8k stars、MIT License,整合面包含 LangGraph、CrewAI、Google ADK、Microsoft Agent Framework、Mastra、Pydantic AI、Agno、LlamaIndex、AWS Strands 等。
| 層級 | AG-UI 解決的問題 | 產品端效果 |
|---|---|---|
| Lifecycle | RUN_STARTED、RUN_FINISHED、RUN_ERROR、STEP_STARTED、STEP_FINISHED | 前端可顯示任務開始/結束、步驟進度、錯誤復原與 loading 狀態 |
| Text streaming | TEXT_MESSAGE_START / CONTENT / END | 穩定處理串流回覆,不必每個 agent framework 自己定義格式 |
| Tool calls | TOOL_CALL_START、TOOL_CALL_ARGS、TOOL_CALL_END、TOOL_CALL_RESULT | 工具執行可視化、參數/結果可追蹤,適合審核與除錯 |
| State sync | STATE_SNAPSHOT、STATE_DELTA、MESSAGES_SNAPSHOT | agent 與 UI 共享狀態,支援表單、圖表、工作流面板同步更新 |
| Activity / custom | ACTIVITY_SNAPSHOT、ACTIVITY_DELTA、RAW、CUSTOM | 保留擴充空間,可承載框架特有事件或產品自訂活動訊號 |
建立 AG-UI 應用:
npx create-ag-ui-app my-agent-app
JavaScript core SDK:
npm install @ag-ui/core
Python core SDK:
pip install ag-ui-protocol
README 強調 AG-UI 可搭配任意事件傳輸層,例如 SSE、WebSocket、webhook;協定重點不是綁定某個 transport,而是標準化事件語意。
官方文件列出 JS、Python,以及 Kotlin、Go、Dart、Java、Rust、Ruby、C++ 等 community SDK;.NET、Nim、Flowise、Langflow 等仍在進行中或需要協作。
README 列出的核心能力包含 real-time agentic chat、雙向狀態同步、generative UI、即時 context enrichment、frontend tool integration、human-in-the-loop collaboration。
- 如果 agent 只是在後端產生一次性文字,AG-UI 可能過重;如果需要產品內互動、狀態同步或工具呼叫可視化,就值得評估。
- 先確認現有 agent framework 是否已有整合:LangGraph、CrewAI、Google ADK、Microsoft Agent Framework、Mastra、Pydantic AI、Agno、LlamaIndex 等可降低導入成本。
- 把事件流當成前端 contract:不要只追求 demo 能跑,還要設計錯誤狀態、interrupt / human approval、工具結果展示與 audit log。
- 若產品已有自訂 WebSocket/SSE protocol,評估是否用 middleware 轉換成 AG-UI event,而不是重寫整個 agent backend。
- 注意 AG-UI 是互動協定,不是權限模型、安全沙箱或 tool governance;工具授權、資料隔離、審核紀錄仍要在產品架構中另外設計。
GitHub: ag-ui-protocol/ag-ui
Docs: ag-ui.com
README checked: 2026-05-26;GitHub API metadata checked: stars 13,818、forks 1,237、MIT License、default branch main。