AG-UI（Agent-User Interaction）协议是一套开放、轻量、基于事件的协议，用于标准化 AI 智能体与面向用户的应用程序之间的连接方式。
用途：当需要在自己的代码中实现 AG-UI 协议事件、构建通过 AG-UI 与前端通信的智能体、理解事件类型及其结构、实现状态管理/工具调用/消息流式传输，或调试 AG-UI 事件流时使用本技能。
主要能力：提供协议的事件类型、事件模式、消息角色、工具定义与调用生命周期、状态同步等参考。事件类型包括生命周期事件（RUN_STARTED、RUN_FINISHED、RUN_ERROR、STEP_STARTED、STEP_FINISHED）、文本消息事件（TEXT_MESSAGE_START、TEXT_MESSAGE_CONTENT、TEXT_MESSAGE_END）、工具调用事件（TOOL_CALL_START、TOOL_CALL_ARGS、TOOL_CALL_END）、状态事件（STATE_SNAPSHOT、STATE_DELTA、MESSAGES_SNAPSHOT）以及自定义事件（RAW、CUSTOM）。事件模式有 Start-Content-End（增量流式传输文本与工具参数）、Snapshot-Delta（完整快照加 JSON Patch 更新实现状态同步）、Lifecycle（含强制开始/结束事件的运行监控）。消息角色包括 user、assistant、system、tool、activity、developer。工具定义包含 name、description、parameters（JSON Schema）。状态同步使用 STATE_SNAPSHOT 做完整状态替换，STATE_DELTA 做增量 JSON Patch（RFC 6902）更新。
使用方式：文档位于 docs/2025-11-27/ 目录，包含 introduction.md（协议概览与集成）、concepts/ 下的 architecture、events、messages、state、tools、agents、middleware、serialization，以及 quickstart/ 下的 introduction、server、clients。资料未提供具体安装命令或运行步骤。
适用场景：AI 智能体前端开发、事件流实现与调试、工具调用与状态同步设计。
限制：本文为协议参考资料，未提供收费、价格、平台支持范围或性能效果等信息。