# CopilotKit – 开源 AI Agent 开放框架，全栈 Agent UI 基础设施

- Link: https://paooo.com/aigc-news/22408/
- Published: 2026-06-08T13:08:12+08:00
- Author: Prompt 语宙研究院

⚡ [Prompt](https://paooo.com/ai-image-prompts/) 语宙 AI 导读 · 30 秒核心看点

 * 三种 Generative UI 覆盖从品牌一致到开放探索的全场景，[Agent](https://paooo.com/trends/)
   不再只会聊天。
 * AG-UI 协议支持双向状态同步、人工审批中断和持久会话，适合生产级 Agent 应用。
 * 可用 npx 一键接入现有项目，支持 Web、Mobile、Slack 等多端统一运行。

## CopilotKit是什么

CopilotKit 是开源的AI原生应用前端操作系统。工具支持三种 Generative UI 模式，包含
受控、声明式 A2UI、开放式，让 AI Agent 不再停留在聊天框，能直接在应用内实时生成交互
界面。团队推出了 AG-UI 协议，实现双向状态同步、Human-in-the-Loop、持久 Threads 等
功能，一次集成可多端全通。

阅读目录

 * [CopilotKit是什么](https://paooo.com/aigc-news/22408/#copilotkit%e6%98%af%e4%bb%80%e4%b9%88)
 * [CopilotKit的主要功能](https://paooo.com/aigc-news/22408/#copilotkit%e7%9a%84%e4%b8%bb%e8%a6%81%e5%8a%9f%e8%83%bd)
 * [CopilotKit的技术原理](https://paooo.com/aigc-news/22408/#copilotkit%e7%9a%84%e6%8a%80%e6%9c%af%e5%8e%9f%e7%90%86)
 * [如何使用CopilotKit](https://paooo.com/aigc-news/22408/#%e5%a6%82%e4%bd%95%e4%bd%bf%e7%94%a8copilotkit)
 * [CopilotKit的核心优势](https://paooo.com/aigc-news/22408/#copilotkit%e7%9a%84%e6%a0%b8%e5%bf%83%e4%bc%98%e5%8a%bf)
 * [CopilotKit的项目地址](https://paooo.com/aigc-news/22408/#copilotkit%e7%9a%84%e9%a1%b9%e7%9b%ae%e5%9c%b0%e5%9d%80)
 * [CopilotKit的同类竞品对比](https://paooo.com/aigc-news/22408/#copilotkit%e7%9a%84%e5%90%8c%e7%b1%bb%e7%ab%9e%e5%93%81%e5%af%b9%e6%af%94)
 * [CopilotKit的应用场景](https://paooo.com/aigc-news/22408/#copilotkit%e7%9a%84%e5%ba%94%e7%94%a8%e5%9c%ba%e6%99%af)

![CopilotKit](https://paooo.com/wp-content/uploads/2026/06/CopilotKit-website-1.
avif)

## CopilotKit的主要功能

 * **三种 Generative UI 模式**
    - **受控模式（Controlled）**：开发者预定义 React 组件，Agent 只负责挑选组件和
      填充数据，确保品牌风格完全一致。
    - **声明式模式（A2UI）**：Agent 输出 JSON schema，前端自动映射成组件，适合覆盖
      长尾低频功能而无需手写代码。
    - **开放式模式（Open-ended）**：Agent 直接生成 HTML 或驱动 Excalidraw 等工具，
      适合一次性探索性可视化场景。
 * **双向状态同步**：Agent 能直接修改状态，实现前端与 Agent 的实时双向绑定。
 * **Human-in-the-Loop**：Agent 可在关键执行节点暂停，弹出确认框请求用户审批后再
   继续操作。
 * **持久 Threads**：所有对话、状态、生成的 UI 自动持久化，用户下次打开应用可从断
   点无缝续接。
 * **AG-UI 协议全栈打通**：作为行业标准协议，支持一次编写 Agent 逻辑，在 Web、Mobile、
   Slack 等多端同时运行。

## CopilotKit的技术原理

 * **AG-UI 协议层**：协议定义了 AI Agent 与用户界面之间的实时通信标准。工具通过标准
   化的消息格式和事件流，让 Agent 能直接生成结构化 UI 指令，实现从对话到操作界面
   的范式转换。
 * **三种 Generative UI 渲染机制**：受控模式通过预注册的 React 组件映射表，让 LLM
   在工具调用时仅返回组件 ID 与数据载荷，前端按固定渲染管线执行；A2UI 声明式模式
   由 Agent 输出符合 JSON schema 的 UI 描述，前端运行时通过动态组件解析器将 schema
   映射为可交互元素；开放式模式能直接渲染 Agent 生成的 HTML 字符串或沙箱化 iframe。
 * **双向状态同步架构**：前端通过 `useAgent` 等 Hook 与 CopilotKit Runtime 建立 
   WebSocket 或 SSE 长连接，应用状态以共享状态树（Shared State）形式暴露给 Agent。
   Agent 侧通过协议层读取状态快照，执行工具调用后回写状态变更，前端订阅状态 diff
   自动重渲染，形成闭环。
 * **Human-in-the-Loop 中断机制**：Runtime 在执行链中插入中断节点（Interrupt Node），
   当 Agent 调用需要人工确认的工具时，执行流暂停并向前端发送中断事件（Interrupt 
   Event），渲染审批 UI。用户确认后，前端将审批结果（Approval/ Rejection）回传 Runtime，
   执行流恢复，Agent 继续后续步骤。
 * **持久化 Threads 与会话管理**：所有对话消息、中间状态、生成的 UI 节点及用户审批
   记录均按 Thread ID 持久化到存储层。用户重新接入时，Runtime 根据 Thread ID 加载
   完整上下文，Agent 从断点状态恢复执行，实现跨会话的连续性。

## 如何使用CopilotKit

 * **新项目快速启动**：执行 `npx copilotkit@latest create -f <framework>` 一键创建
   带 CopilotKit 的模板项目。
 * **现有项目集成**：执行 `npx copilotkit@latest init` 自动安装核心包、配置 Provider、
   连接 Agent 与 UI。
 * **接入 Agent 状态**：用 `useAgent` hook 读取和修改 Agent 状态，例如 `agent.state.
   city` 和 `agent.setState()`。
 * **定义 Copilot Actions**：将现有 API 调用或业务函数注册为 LLM 可调用的 actions，
   实现工具调用闭环。
 * **部署上线**：完成配置后可直接部署，支持自托管或 CopilotKit Cloud 企业版。

## CopilotKit的核心优势

 * **协议级标准**：团队是 AG-UI 协议缔造者，已被 Google、Microsoft、Amazon、LangChain、
   Mastra 等巨头采用，生态兼容性强。
 * **三种 UI 模式覆盖全场景**：从严格受控到完全开放，满足不同业务对品牌一致性和灵活
   性的双重需求。
 * **前端状态深度集成**：不同于普通聊天组件，CopilotKit 能与应用内部状态双向同步。
 * **生产级 Human-in-the-Loop**：内置审批流机制，让 Agent 在关键操作前主动请求人工
   确认，降低风险。
 * **跨端一次集成**：基于 AG-UI 协议，同一套 Agent 逻辑可同时跑在 Web、移动端和 
   Slack 等渠道。

## CopilotKit的项目地址

 * **GitHub仓库**：https://github.com/CopilotKit/CopilotKit

## CopilotKit的同类竞品对比

  |  对比维度 |  **CopilotKit** |  **Assistant-ui** |  
   |  **核心定位** |  全栈 Agent UI 基础设施（前端组件 + 运行时 + 协议） |  开源 React 组件库，专注 AI 聊天界面 |  
 |  **UI 生成方式** |  Agent 主动生成界面：支持受控组件、A2UI JSON 映射、开放式 HTML 三种模式 |  静态预置组件：Thread、Message、Composer、Suggestion 等，Agent 不生成新 UI |  
 |  **状态管理** |  双向深度同步：Agent 可读写应用内部状态，前端自动响应 |  单向消息流：主要管理对话消息列表，应用状态需手动桥接 |  
 |  **Human-in-the-Loop** |  执行流原生中断：Agent 暂停 → 渲染审批 UI → 用户确认 → 自动恢复 |  消息级拦截：可插入自定义消息内容，但无执行流控制机制 |  
 |  **后端耦合** |  自带 Runtime，同时深度集成 LangGraph、Mastra、CrewAI 等 |  纯前端，需自行对接 [OpenAI](https://paooo.com/tag/openai/)、LangChain、Convex 等后端 |  
 |  **持久化** |  内置 Thread 持久化（内存/Redis/数据库），断点续接 |  依赖外部后端实现，本身不提供存储层 |  
 |  **工具调用渲染** |  自动生成对应交互组件（表单、按钮、图表等） |  基础展示工具调用名称和参数，无动态交互组件 |  
 |  **协议标准** |  AG-UI 协议缔造者，定义 Agent-UI 交互标准 |  遵循通用消息格式，无专属协议 |  
 |  **上手成本** |  中等：需理解 Runtime、Actions、三种 UI 模式 |  较低：纯 React 组件，按文档组装即可 |  
 |  **适用场景** |  在复杂 SaaS 中嵌入能”动手”的智能 Copilot |  快速搭建标准 AI 聊天机器人界面 |

## CopilotKit的应用场景

 * **SaaS 产品内嵌 Copilot**：在 CRM、ERP、数据分析后台等现有产品中嵌入 AI 助手，
   让用户通过对话直接操作复杂功能。
 * **AI 原生应用开发**：构建以 Agent 为核心的新一代应用，Agent 可实时生成表单、看板、
   日历等交互界面。
 * **长尾功能自动化**：通过 A2UI 模式让 Agent 自动生成低频功能界面（如发票申请、
   设备预订），减少开发人力。
 * **跨平台 Agent 部署**：基于 AG-UI 协议，将同一 Agent 同时部署到 Web 应用、移动
   端和 Slack 机器人。

❓ 常见问题解答（FAQ）

CopilotKit 适合做什么场景？

CopilotKit 适合把 AI Agent 嵌入真实应用流程中，尤其是需要在前端直接生成界面、修改
状态、请求人工确认的场景，如智能助手、业务操作台和多端协作应用。

CopilotKit 的三种 UI 模式有什么区别？

受控模式由开发者预定义组件，强调品牌一致；声明式 A2UI 由 Agent 输出 JSON schema，
适合长尾功能；开放式模式可直接生成 HTML 或驱动工具，适合探索性可视化。

CopilotKit 如何接入现有项目？

可通过 npx copilotkit@latest init 快速初始化，随后用 useAgent 读取和修改状态，并
把现有 API 或业务函数注册为 Copilot Actions，形成可调用的工具闭环。

🔬 语宙深潜追问 · 进阶实操拆解

CopilotKit最适合接哪类Agent？

最适合需要人机协作、状态频繁变化的 Agent，比如客服工单、销售辅助、数据分析和内容
编辑。它的优势不是“会说话”，而是能把建议变成界面操作，并保留人工接管能力，减少来回
复制粘贴。

如何设计Human-in-the-Loop不打断体验？

把人工确认点放在高风险步骤，而不是每一步都弹窗。常见做法是让 Agent 先预填、预览和
解释，再由用户一键确认。这样既保留控制权，又不会让交互变成“半自动半手工”的低效流程。

🗳️ 读者观点微投票 · 您的实战立场是？

Agent UI该做聊天框还是直接操作界面？

🕸️ 语宙向量知识图谱 · 语义强关联深度内链

[💻 所属权威专题：Claude & AI 编程 / MCP →](https://paooo.com/topics/claude-mcp-coding/)

 * [Agent Squad – 开源的多 Agents 对话编排框架](https://paooo.com/aigc-news/18773/)
 * [谷歌重磅开源A2UI：AI Agent 3秒生成原生界面，告别前端代码！开发者效率革命](https://paooo.com/aigc-news/12611/)
 * [OpenAI Agent Kit：AI智能体开发神器！一键构建生产级Agent，可视化拖拽+多工具集成](https://paooo.com/aigc-news/13253/)
 * [高德与阿里重磅开源AGenUI：三端原生A2UI框架，让AI Agent输出直接变为可交互界面](https://paooo.com/aigc-news/10574/)

[🏛️ Prompt 语宙研究院](https://paooo.com/author/paooo-research/) · Prompt 语宙研究院（
paooo.com Research）专注于前沿多模态大模型架构拆解、AI Agent 工作流评测、AIGC 提示
词工程（Prompt Engineering）与全球高增长 AI 生产力工具实测追踪，致力于为中文开发
者与创作者提供一手、可复现的深度技术洞察。

[📄 Markdown 纯净版](https://paooo.com/aigc-news/22408/?format=md)

💡 这篇内容对您有启发吗？

[📡 RSS 订阅](https://paooo.com/feed/)[✨ 提交 AI 工具 / 合作](https://paooo.com/submit-tool/)

**🚀 Prompt 语宙 AI 创作者生态：**探索 2,800+ 全球实用 AI 工具与高精度生图提示词
咒语库

[🧭 语宙 AI 导航 (ai.paooo.com)](https://ai.paooo.com/)[🎨 AI 生图 Prompt 库](https://paooo.com/ai-image-prompts/)
[📚 核心专题导航](https://paooo.com/topics/)[⚡ AIGC 早报生成器](https://paooo.com/mtool/)
