AI Tools
AG-UI：Agent 進入前端產品介面的事件協定
AG-UI 是開源、事件式的 Agent-User Interaction Protocol，補上 agent 與前端產品互動的標準化協定層；適合需要串流、工具呼叫可視化、狀態同步、generative UI 與 human-in-the-loop 的 agent app。
2026年5月26日3 分鐘閱讀👁 6
Agent UI Protocol · GitHub Tool Profile
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 等。
為什麼值得收進知識庫：Agent 產品化的瓶頸通常不在「模型會不會回答」，而在前端如何即時顯示推理狀態、工具呼叫、局部結果、共享狀態、人類確認與錯誤復原。AG-UI 把這些互動抽成事件協定，等於提供一個 agent-native frontend contract。
| 層級 | 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