CopilotKit 是一个专为 React 应用构建的开源 AI 副驾驶和智能体开发框架。它提供了优雅的基础设施和可定制的 UI 组件，使开发者能够轻松地将具有状态感知能力的 AI 聊天机器人和自主代理深度集成到应用程序中，而无需处理复杂的基础设施细节。
一分钟了解#
CopilotKit 是一套让 React 开发者快速构建"AI 原生应用"的工具链。它不仅仅是聊天窗口组件，更是一个能理解并操作应用状态的"智能体前端"。通过 React Hooks 和组件，它让 AI 能够直接与应用的前端逻辑交互，实现自动生成 UI、执行前端操作以及复杂的多步骤工作流。
核心价值：在几分钟内将强大的 AI 智能体集成到 React 应用中，实现从"对话"到"实际行动"的跨越。
快速上手#
安装难度：低 - 提供了 CLI 初始化工具，开箱即用。
# 使用 CLI 快速创建新项目或集成到现有项目
npx copilotkit@latest create
适合我的场景吗？
- ✅ React/Next.js 开发者：如果你正在使用 React 生态，并希望添加 AI 功能，这是目前最丝滑的解决方案。
- ✅ 需要深度集成：如果你需要 AI 修改应用状态（如修改表单、更新图表）而不仅仅是聊天，这个库非常合适。
- ❌ 非 React 项目：虽然后端部分理论上通用，但前端组件强依赖 React，非 React 项目集成成本较高。
核心能力#
1. 状态感知的智能体 (useAgent)#
这是 CopilotKit 的核心 Hook，允许你创建一个与 React 状态绑定的 AI 代理。
- 具体表现：你可以将应用中的
state（例如当前选中的城市、表单内容）直接暴露给 AI，AI 可以根据上下文修改这些状态，驱动 UI 更新。 实际价值：实现了真正的"可操作 AI"，让 AI 能像用户一样操作界面，而不仅仅是生成文本。
2. 生成式 UI (Generative UI)#
允许 AI 根据上下文动态渲染 React 组件。
- 具体表现：AI 可以决定"现在应该显示一个天气卡片"或者"现在应该显示一个图表"，并直接生成对应的 JSX。 实际价值：极大提升了 AI 交互的灵活性，用户体验从"阅读文字"变成了"交互操作"。
3. 前端工具集成#
让 AI 能够直接调用前端定义的函数。
- 具体表现：开发者定义
useFrontendTool，AI 可以通过自然语言意图触发这些函数，例如"把这几行数据添加到表格中"。 实际价值：通过自然语言执行复杂的业务逻辑，无需用户手动点击多个按钮。
4. 人机协作#
在 AI 执行敏感操作前引入人工确认。
- 具体表现：当 AI 意图执行某些关键操作（如发送邮件、删除数据）时，系统会弹出确认窗口，等待用户批准后才会继续。 实际价值：在赋予 AI 自主能力的同时，保留了必要的安全控制边界。
5. 无头 UI 与预构建组件#
- 具体表现：你可以使用完全自定义的
useAgent构建自己独特的界面，也可以直接使用<CopilotSidebar>等现成组件。 实际价值：既满足了快速上线的需求，又保证了品牌定制化的灵活性。