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-appJavaScript core SDK：
npm install @ag-ui/corePython core SDK：
pip install ag-ui-protocolREADME 強調 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。