CopilotKit

为多端应用构建生成式 UI、共享状态与人工介入式 Agent 体验。

Star 数
★ 39k
最近更新
今天
License
MIT
主语言
TypeScript

30 秒速览

运行形态
命令行工具代码库 / SDK开发框架
可在哪里用
通用 · 跨平台Codex · Claude Code · OpenAI API · Claude API
费用
有免费版,另有付费云服务
上手难度
低 · 几分钟可跑通
开始前需要
LLM 密钥,例如 OpenAI、Anthropic 或 GeminiShell / 命令行
典型场景
React 或 Next.js 团队希望在产品中加入可流式响应、支持工具调用的聊天界面时,可使用 CopilotKit 的 Chat UI 与 Agent 连接层。
不适合
  • 需要完全离线或数据不出本地的团队,Intelligence 默认走托管云
  • 只想用 Google Chat、iMessage 或 SMS 的团队,这些渠道仍在路线图上
  • 需要稳定生产级聊天渠道的团队,Discord、WhatsApp、Telegram 仍是适配器且托管连接未上线

这个 Agent 能做什么,适合哪些场景?

CopilotKit 是用于构建全栈 Agent 应用、生成式 UI 和聊天应用的 SDK,已从 React 库扩展为多平台框架。它覆盖 React/Next.js、Angular、Vue 和 React Native,并将 Slack、Microsoft Teams、Discord、Google Chat 列为浏览器外的交付方向,其中后四类聊天平台处于 Beta 或早期访问状态。其交互模型将 UI、Agent 与工具连接在同一循环中,支持流式消息、工具调用、Agent 响应、共享状态和人工确认。项目还围绕 AG-UI 协议提供 Agent 与用户界面的连接方式,并提供 useAgent Hook 以程序化访问 Agent 状态。使用者需要在自己的应用中配置 LLM 提供商并部署应用;README 未给出完整的生产部署配置。

通过 npx copilotkit@latest create 创建项目后,应用配置 LLM key,并使用 CopilotKit 的 Provider、状态和 Hooks 连接 Agent 与 UI。聊天 UI 可接收流式消息、工具调用和 Agent 响应;后端工具可返回由客户端直接渲染的 UI 组件。生成式 UI 可按用户意图和 Agent 状态在运行时生成或更新组件,共享状态层允许 Agent 与 UI 组件实时读写同一状态。useAgent({ agentId: "my_agent" }) 返回 agent,可读取如 agent.state.city 的状态,并通过 agent.setState({ city: "NYC" }) 更新状态;同一 Agent 逻辑可用于网页、移动端及已列出的聊天平台集成。

  1. React 或 Next.js 团队希望在产品中加入可流式响应、支持工具调用的聊天界面时,可使用 CopilotKit 的 Chat UI 与 Agent 连接层。
  2. Angular 团队要在现有前端中接入 Agent UI,并希望保留与其他前端相同的 Agent 逻辑时,可使用仓库标注为 Supported 的 Angular 支持。
  3. React Native 产品团队需要让移动端读取和更新 Agent 共享状态,并呈现 Agent 驱动的界面时,可采用 React Native 支持路径。
  4. 需要在工作流中让 Agent 停止并请求用户输入、确认或编辑的应用,可使用 human-in-the-loop 能力。
  5. 已有后端工具且希望工具结果以客户端 UI 组件呈现的团队,可使用 Backend Tool Rendering。
  6. 希望把同一 Agent 部署到 Slack 或 Microsoft Teams 工作流中的团队,可申请 README 标明的早期访问。

如何安装或部署这个 Agent?

准备一个 LLM key(README 举例为 OpenAI、Anthropic 或 Gemini),在项目目录的 shell 中运行:

npx copilotkit@latest create

README 未说明 Node.js 版本、生成器的交互参数或完整生产部署步骤。若要给编码 Agent 安装 CopilotKit skills,可运行:

npx copilotkit@latest skills install

如何使用这个 Agent?

创建并配置项目后,在 UI 中以 useAgent 连接指定 Agent:

const { agent } = useAgent({ agentId: "my_agent" });

随后可读取 agent.state.city,并在事件处理器中调用:

agent.setState({ city: "NYC" })

README 表明 Provider、上下文、状态和 Hooks 会在安装流程中配置,但未给出完整 Provider 配置代码或 Agent 后端示例。

这个 Agent 有哪些优点和局限?

优点
  • 以 AG-UI 为连接层,并通过 useAgent 暴露可编程的 Agent 状态读取与更新接口。
  • 同一 Agent 逻辑面向 React/Next.js、Angular、Vue 和 React Native,README 还列出 Slack 与 Microsoft Teams 的交付方向。
  • 同时覆盖聊天 UI、后端工具渲染、运行时生成式 UI、共享状态和人工介入流程,而不只提供单一聊天组件。
局限
  • 快速开始只给出 npx copilotkit@latest create,未说明 Node.js 版本、完整 Provider 配置或生产部署步骤。
  • Slack、Microsoft Teams、Discord 和 Google Chat 被标为 Beta 或早期访问,浏览器外部署不应视为普遍可用。
  • 自学习能力标为 early access;README 所述 Cloud 或 self-hosted 可用性未提供具体安装或运维细节。
  • 虽然列出 OpenAI、Anthropic 和 Gemini 的 LLM key,但 README 未展示各提供商配置、故障处理或模型兼容性细节。

这个 Agent 与同类方案有什么区别?

README 将生成式 UI 分为三类:Static(AG-UI Protocol)、Declarative(A2UI)和 Open-Ended(MCP Apps & Open JSON)。CopilotKit 将自身定位为连接 Agent 工作流与用户界面的 UI 层,并以 AG-UI 处理线协议。

与相关度最高的同类 agent 并排比较关键指标。

Agent 源码审查 形态 / 费用 Star 最近更新 主语言 完整支持的平台
CopilotKit 当前 49 · 缺口较多 命令行工具免费版 + 付费版 ★ 39k 今天 TypeScript Codex · Claude Code · OpenAI API · Claude API
FormKit 55 · 缺口较多 Agent 插件 / 技能免费版 + 付费版 ★ 4.8k 今天 TypeScript Codex · Claude Code
Appllama 移动应用设计技能 50 · 缺口较多 Agent 插件 / 技能免费版 + 付费版 ★ 4.9k 2 个月前 — Codex · Claude Code
GAIA UI 组件库 56 · 缺口较多 命令行工具免费 ★ 225 2 个月前 TypeScript —

FollowAgents 如何评估这个 Agent?

FollowAgents 源码审查 · FARS-2.1
缺口较多
49/ 100 五分制 2.5 / 5
本评测基于 2026年8月9日 的源码;此后该项目发布了 26 个正式版本,尚未复审。分数与结论只代表评测时的版本。 最近版本 ↓
信任安全 11/29
可靠稳定 8/14
适用触发 10/18
规范维护 10/18
有效结果 7/13
证据核验 3/8
查看各维度的扣分理由
信任安全11 / 29 · 1.9/5

证据显示:仓库包含安全策略(SECURITY.md),提供漏洞报告流程;依赖覆盖(package.json overrides)显示对已知漏洞的主动缓解;工作流(canary.yml)遵循最小权限原则,使用受限的GitHub App token。扣分原因:未发现明确的用户确认机制(如human-in-the-loop的代码实现),数据流透明度有限(README提及共享状态但未详细说明),敏感数据处理细节缺失,外部影响(如网络请求)未明确说明,回滚机制未提及,来源归属(如第三方代码)未明确。

可靠稳定8 / 14 · 2.9/5

证据显示:仓库结构清晰,使用Nx monorepo管理,测试脚本存在(package.json test),e2e测试覆盖布局和暗模式回归。扣分原因:依赖可用性未验证(静态审查),失败消息未在文档中明确,自一致性部分依赖文档与代码的一致性,但未完全验证。

适用触发10 / 18 · 2.8/5

证据显示:README明确列出支持的平台(React, Angular, Vue, React Native, Slack等),提供快速开始和示例,能力边界(如Generative UI类型)有说明。扣分原因:触发精度(如useAgent hook的触发条件)未详细说明,环境适配(如浏览器版本)未明确。

规范维护10 / 18 · 2.8/5

证据显示:README提供信息架构(功能列表、快速开始、文档链接),安装说明(npx copilotkit@latest create),示例(examples目录),MIT许可证,维护责任(贡献指南)。扣分原因:命名稳定性未明确(版本历史未提供),已知限制未列出,版本变更日志未提供。

有效结果7 / 13 · 2.7/5

证据显示:输出可用性(Generative UI可动态渲染),边际价值(多平台支持,AG-UI协议),成本效益(快速开始,免费开源)。扣分原因:成本效益未量化(如性能、资源消耗),边际价值部分依赖外部平台(如Slack)的早期访问。

证据核验3 / 8 · 1.9/5

证据显示:README中的声明(如AG-UI协议采用)有外部链接,但未提供具体证据;测试存在但未验证。扣分原因:声明可追溯性有限(未提供具体版本或文档),跨来源佐证不足(仅依赖README),事实与推断分离不明确(如'best-in-class'等营销语言)。

风险与缓解建议
  • 静态审查无法验证运行时行为,所有评分基于源代码和文档。
  • 依赖覆盖列表虽显示安全缓解,但未验证实际依赖树。
  • README中的营销声明(如'best-in-class')缺乏可验证证据。
  • 未提供版本变更日志,命名稳定性存疑。
证据充分度:低 评估于 2026年8月9日 审查版本 2328062960a1 评估后仓库已有新提交,评分可能未覆盖最新改动
查看完整评分方法 →

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. v1.84.1
    发布说明摘录
    This patch release improves A2UI catalog serialization so that composed custom component trees are correctly recognized by agent SDKs.
    在 GitHub 查看 ↗
  2. v1.84.0
    发布说明摘录
    Features - feat(genui-eval): measure the generative UI prompt across models, and ship the improved prompt (#8102) (d168487) Fixes - fix(react-core): show scroll-to-bottom only when messages are below (#8159) (3a956ad) - fix(react-core,vue): deprecate the inputMode prop CopilotChat ignores (#8152) (a7c4dde) - fix(react-native): pass CopilotChat's agent and thread to its hooks (#8136) (035c0db) - fix(vue): forward every chat-view slot through CopilotSidebar and CopilotPopup (#8135) (117de16) - fix(react-native): draw the interrupt element in the prebuilt chat (#8133) (bfb8236) …
    在 GitHub 查看 ↗
  3. channels/v0.12.0
    发布说明摘录
    Security - Includes security fixes for Teams and other Channels integrations. We recommend upgrading the supported @copilotkit/channels* packages used by your application to 0.12.0, including @copilotkit/channels and @copilotkit/channels-teams where installed. If you use Telegram, review the migration guidance below before upgrading. Features - Render static JSX as images in managed Slack and Teams messages. (#6146) - Combine rendered cards with native buttons and carousel layouts. (#6146) Fixes …
    在 GitHub 查看 ↗

常见问题

需要什么凭据?
快速开始要求一个 LLM key;README 举例为 OpenAI、Anthropic 或 Gemini。
能否用于 React 以外的前端?
可以。README 标注 Angular、Vue 和 React Native 为 Supported,并将 React/Next.js 标为 GA。
Slack 和 Microsoft Teams 是否已经普遍可用?
README 将这些浏览器外聊天平台路径标为 Beta 或早期访问,并要求申请早期访问。
是否能让用户在 Agent 执行中审批或修改?
可以。README 描述 human-in-the-loop 可让 Agent 暂停,向用户请求输入、确认或编辑后继续。
生产部署与失败恢复如何配置?
README 未给出完整生产部署、错误恢复或重试配置,需要在采用前从项目文档或代码进一步确认。
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关 Agents