CopilotKit

一句话介绍

CopilotKit是一套面向开发者的AI Agent前端框架，用于把聊天、生成式界面、共享状态、工具调用和人工审批嵌入真实应用。它既有可自行部署的开源核心，也提供持久线程、托管检查和企业运维平台。

工具简介

CopilotKit不是面向普通用户的聊天机器人，而是构建Agent产品界面的SDK和运行时。开发者可以使用预制聊天组件快速上线，也可以采用Headless API完全控制布局和交互。

框架通过AG-UI连接用户界面与Agent后端，使同一个前端能够接入不同模型、框架或自定义Agent。企业智能平台则在开源运行时旁增加持久化、实时同步、检查控制台和多租户能力。

产品组成

主要功能

预制聊天组件

CopilotChat、CopilotSidebar和CopilotPopup可快速加入完整聊天界面，支持消息流、Agent响应和工具过程。团队可以修改标签、欢迎语、主题和交互行为。

Headless UI

Headless方式只提供状态与行为，不强制使用默认视觉组件。它适合已有设计系统、无障碍规范或复杂产品交互的团队，但需要更多前端工程投入。

生成式UI

Agent可以根据任务渲染开发者注册的React组件、包装后端工具结果或根据流式状态更新界面。也可以使用A2UI、MCP Apps等声明式或开放式方案，但开放程度越高，验证和隔离要求越高。

共享状态

应用界面与Agent可以读写同一份类型化状态，并通过事件增量同步。它适合筛选器、表单、画布和多步骤任务，但必须处理权限、冲突和服务端校验。

前端工具调用

开发者可把浏览器侧函数暴露为Agent工具，例如导航、更新表单或打开确认框。任何有外部副作用的工具都应增加权限检查、参数验证和用户确认。

人工介入

Agent可在关键步骤暂停，请求用户批准、编辑输入、重试或升级处理。该能力适合付款、删除、发布和高风险建议等必须保留人类控制的流程。

后端工具呈现

后端Agent调用工具时，前端可以用自定义卡片展示参数、进度和结果。这样用户能够理解Agent正在做什么，并在长任务中看到持续反馈。

多模态与语音

框架支持文件、图片等多模态附件，并在文档中提供语音与推理结果的界面能力。模型、存储和浏览器支持仍由具体集成和套餐决定。

持久线程与检查

Enterprise Intelligence可让对话跨刷新、设备和会话恢复，并在控制台检查线程和事件。开源核心可以由开发者自行实现持久化，但不会自动获得托管管理界面。

Channels多端入口

当前官方仓库明确支持Slack和Microsoft Teams，并让同一Agent保留工具、状态与人工审批模式。Discord、WhatsApp、Telegram、Google Chat、iMessage和短信仍标记为计划中，不能写成现已支持。

• 预制聊天、侧边栏和弹窗式Agent组件
• 完全自定义视觉的Headless前端接口
• 静态、声明式和开放式生成式UI方案
• Agent与应用之间的双向共享状态
• 前端工具调用和后端工具结果呈现
• 人工批准、修改、重试和升级流程
• 持久线程、实时同步和托管检查平台
• Slack与Microsoft Teams频道接入

AG-UI是什么

AG-UI是CopilotKit团队推动的开放事件协议，负责连接Agent与用户界面。它传输消息、状态变化、工具调用、生命周期和自定义事件，让前端不必为每个Agent框架设计一套私有通信格式。

这些协议不是互相替代关系。一个产品可以用AG-UI服务前端交互，用MCP访问工具，再通过A2A连接其他Agent。

支持的Agent框架

官方文档提供多条后端集成路线，包括内置Agent、LangGraph、CrewAI、Mastra、Google ADK、AWS Strands、PydanticAI、Microsoft Agent Framework、Agno、LlamaIndex和Claude Agent SDK等。

前端与渠道支持

使用教程

创建第一个CopilotKit应用

1. 准备Node.js 20或更高版本，并确定使用的模型服务与API密钥。
2. 使用官方CLI创建新项目，选择前端框架、Agent路线和是否启用持久线程。
3. 把密钥放在服务端环境变量中，不要写进客户端代码或版本库。
4. 启动本地项目，先验证流式聊天、错误状态和一次简单工具调用。
5. 加入身份认证、服务端授权和日志脱敏后，再部署到测试环境。

在现有应用中加入聊天

1. 安装前端核心、UI和运行时包，并按现有框架创建服务端运行时入口。
2. 在应用根部配置Provider，把Agent或模型连接注册到运行时。
3. 选择Chat、Sidebar或Popup组件，并匹配现有设计与移动端布局。
4. 添加一个只读前端工具，确认参数、结果和异常都能正确显示。
5. 逐步开放写操作，并对每个副作用增加用户确认和服务端权限检查。

连接现有Agent后端

1. 先确认后端框架是否已有官方AG-UI适配器，并选择对应文档版本。
2. 定义Agent标识、线程标识、初始状态和可调用工具的类型。
3. 将Agent注册到Copilot Runtime，并限制跨用户访问与请求渠道。
4. 测试消息流、状态增量、取消、重试和人工中断是否保持一致。
5. 在生产前模拟网络中断、重复事件、长任务和并发标签页。

部署持久线程平台

1. 先根据数据驻留和运维能力选择Copilot Cloud或自托管企业智能平台。
2. 云端方案创建组织和项目后生成项目级运行时密钥，并按环境分开。
3. 自托管方案准备Kubernetes、Postgres、Redis、OIDC、入口和密钥管理。
4. 配置运行时的平台地址与凭据，验证线程跨刷新和跨设备恢复。
5. 设置保留期、租户隔离、备份、密钥轮换、监控和事件处置流程。

生成式UI方案对比

适合哪些开发团队

• SaaS团队：在现有产品中加入上下文感知Copilot
• Agent创业团队：快速完成聊天、工具和生成式UI前端
• 企业内部平台：把流程Agent放进网页、Slack或Teams
• 数据产品团队：让Agent操控筛选器、表格和可视化组件
• 客服与运营团队：在关键动作前加入人工确认
• 多框架团队：通过AG-UI降低更换Agent后端的前端成本
• 合规团队：采用自托管持久层和项目级隔离管理对话

典型使用场景

开源核心与企业平台区别

开源核心足以构建可工作的Agent应用，不要求使用CopilotKit托管服务。需要跨会话持久化时，团队可以自己实现存储，也可以购买企业智能平台。

价格与套餐

截至2026年8月22日，当前官方定价页提供Developer、Pro、Team和Enterprise四档。早期产品PDF和旧版定价页面已出现不同金额，应以当前正式定价页为准。

Developer、Pro和Team都包含云托管、Inspector、前端SDK、Agent后端连接和Headless UI。Team增加专属Slack支持，Enterprise再增加SLA、优先修复、路线图参与和每周最多5小时工程支持。

Channels额度

Channels积分是CopilotKit频道能力的额度，不等同于底层模型Token。使用自带模型密钥时，模型推理费用通常由对应模型供应商另行收取。

部署方式

自托管企业智能平台不是下载一个单文件即可运行。官方部署路线需要Kubernetes、Postgres、Redis、OIDC身份源、入口、密钥轮换和监控能力。

产品优势

• 开源核心覆盖聊天、工具、状态和生成式UI完整链路
• AG-UI把前端与多种Agent框架解耦
• 预制组件与Headless路线兼顾速度和设计自由
• 人机协同能力适合有副作用的真实业务流程
• 官方集成覆盖TypeScript、Python和多家Agent框架
• 同一Agent可扩展到网页、移动端和团队频道
• 可从自托管开源核心逐步升级到持久化企业平台
• 活跃GitHub社区、示例和文档便于问题排查

使用限制与注意事项

• 它是开发框架，不是注册后即可直接使用的通用聊天机器人
• 开源框架免费不代表模型、向量库、托管和运维免费
• 复杂生成式UI需要严格限制组件、属性和可执行动作
• 共享状态和前端工具必须在服务端再次验证权限
• 持久线程、管理控制台和实时同步属于商业平台边界
• 自托管企业平台需要成熟的Kubernetes和数据库运维能力
• 移动与非React前端的文档成熟度可能低于React路线
• 计划中的消息平台不能按当前可用能力承诺给客户
• 官方文档与仓库的许可证文字存在不一致，应按具体版本核验

安全与隐私

CopilotKit会处在用户界面、Agent、模型和业务工具之间，安全设计必须覆盖每一层。前端隐藏按钮不等于权限控制，所有工具参数和用户身份都应在可信服务端重新验证。

官方隐私政策最后更新日期仍为2023年10月，说明会收集账户信息、使用信息、IP、浏览器与操作系统数据，并可能通过服务商处理数据。企业采购应索取更新的数据处理、保留、子处理方、安全和事件响应文件。

• 把模型密钥、平台密钥和工具凭据保存在服务端
• 为组织、项目、用户和线程建立明确隔离边界
• 把删除、付款、发布和外发操作置于人工确认之后
• 对Agent生成的组件属性和工具参数执行模式校验
• 防止提示注入内容直接触发高权限前端或后端工具
• 日志中脱敏消息、附件、Token、个人信息和业务数据
• 为持久线程设置保留期、导出、删除和备份策略
• 升级依赖前检查安全公告、迁移说明与许可证变化

GitHub、SDK与许可证

CopilotKit官方主仓库包含前端包、运行时、示例、CLI和Python SDK目录，当前公开页面显示约3.69万星和4600次复刻。仓库README与根许可证文件明确写为MIT许可证。

官方一处OSS对比文档仍写Apache 2.0，与当前主仓库存在冲突；AG-UI独立仓库当前也明确采用MIT许可证。实际发布或再分发时，应核对所安装包版本的许可证文件，而不是只依赖概述页。

基本信息

推荐指数

推荐指数为4.7分，满分5分。CopilotKit把Agent前端最困难的流式交互、工具呈现、共享状态、生成式UI和人机协同组织成较完整的开发栈。

它最适合有工程团队并准备把Agent嵌入真实产品的项目。选择前应明确开源与商业边界、模型成本、持久化需求、非React成熟度和许可证版本。

常见问题

CopilotKit免费吗？

开源核心可以免费使用，Developer云端套餐也永久免费。模型调用、外部数据库、云资源和团队运维成本通常需要另外承担。

最低付费套餐多少钱？

当前Pro为每月39美元，包含5000条线程、5天保留、10GB多模态存储和每月2000个Channels积分。

CopilotKit是聊天机器人吗？

不是现成的通用聊天服务，而是开发Agent聊天与交互界面的框架。用户需要提供模型或Agent后端并完成应用集成。

可以不用Copilot Cloud吗？

可以。开源核心能在自有基础设施运行，团队也可自行实现认证和持久化；托管平台主要提供现成持久线程、检查和运维能力。

支持哪些模型？

内置Agent可连接OpenAI、Anthropic、Google和兼容AI SDK的模型，也可通过外部Agent框架使用其他模型。模型可用性由具体后端决定。

支持LangGraph吗？

支持，官方提供Python、FastAPI和TypeScript等路线，也是功能覆盖较完整的集成之一。

AG-UI和MCP有什么区别？

AG-UI负责Agent与用户界面的实时交互，MCP负责Agent连接工具和数据。两者互补，常在同一应用中一起使用。

可以生成React组件吗？

可以，Agent可调用预注册组件、渲染后端工具结果或根据共享状态更新UI。生产环境应限制组件目录和属性范围。

支持人工审批吗？

支持，Agent可暂停并等待用户批准、编辑、重试或升级处理。真正的业务权限仍必须由服务端控制。

支持Slack和Teams吗？

当前两者都正式支持，并受各套餐组织数、频道数和积分限制。其他多个消息平台仍处在计划状态。

CopilotKit采用什么许可证？

当前GitHub主仓库和根许可证明确为MIT，但一处官方概述文档仍写Apache 2.0。应以实际使用版本的仓库和包内许可证为准。

企业智能平台开源吗？

不是。CopilotKit采用开源核心加商业企业平台的双层模式，持久线程、托管检查、多租户和企业支持属于商业能力。

总结

CopilotKit适合构建真正嵌入产品的AI Agent体验，而不只是独立聊天窗口。开源核心提供足够完整的聊天、工具、状态、生成式UI和人机协同能力。

项目进入生产后，应根据线程持久化、跨设备同步、管理控制台和合规需求决定自建还是购买企业平台，同时持续核对套餐、依赖和许可证变化。