Files
2026-07-13 09:55:09 +00:00

12 KiB
Raw Permalink Blame History

Note

本文档由 WeHub 基于上游 README 翻译整理,属于社区翻译,非官方中文文档。
English · 原始项目 · 上游 README
原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。

FavIcon

CopilotKit

构建 面向智能体(agent-native)的应用 —— 适用于任意框架、任意界面。

为 React、Angular、Vue、React Native 提供生成式 UIGenerative UI)、共享状态(shared state)和人机协同(human-in-the-loop)工作流 —— 并延伸至浏览器之外。

CopilotKit



什么是 CopilotKit

CopilotKit 是业界一流的 SDK,用于构建全栈智能体(agentic)应用、生成式 UI 和聊天应用。

最初只是一个 React 库,现已发展为 多平台智能体框架:同一个智能体可同时驱动你的 Web 应用、移动应用和团队的 Slack 工作区。

我们正是 AG-UI Protocol 背后的公司 —— 已被 Google、LangChain、AWS、Microsoft、Mastra、PydanticAI 等采纳!

快速开始

五分钟内即可启动运行。你只需一个 LLM API 密钥(OpenAI、Anthropic、Gemini 等)。

npx copilotkit@latest create

智能体技能(Agent Skills

CopilotKit 提供 agent skills,用于教导你的编程智能体(Claude Code、Codex、Cursor、Gemini 等)如何安装、构建、集成、调试和升级 CopilotKit。

安装到任意项目目录:

npx copilotkit@latest skills install

随时再次运行即可更新到最新技能。

让你的应用焕发生机

https://github.com/user-attachments/assets/72b7b4f3-b6e7-460c-a932-5746fe3c8db3

1 分钟为你的应用接入 AI

功能特性:

  • Chat UI – 完全可定制的聊天界面,支持消息流式传输、工具调用和智能体响应。
  • Backend Tool Rendering – 让智能体可调用后端工具,返回的 UI 组件直接在客户端渲染。
  • Generative UI – 智能体可根据用户意图和智能体状态,在运行时动态生成并更新 UI 组件。
  • Shared State – 同步状态层,智能体和 UI 组件均可实时读写。
  • Human-in-the-Loop – 智能体可暂停执行,在继续之前请求用户输入、确认或编辑。
  • Self-Learning (抢先体验) – 通过上下文强化学习(CLHFContinuous Learning from Human Feedback)根据用户反馈持续改进的智能体。

🧩 适配你的技术栈

一套智能体后端。适配所有前端。

平台 状态 快速开始
⚛️ React / Next.js GA 快速开始
🅰️ Angular 已支持 源代码 - 快速入门即将推出
💚 Vue 已支持 源代码 - 快速入门即将推出
📱 React Native 已支持 快速开始
💬 Slack / MS Teams / Discord / Google Chat 🟡 Beta 申请抢先体验

智能体逻辑保持不变 —— AG-UI 负责线协议,CopilotKit 负责各框架的 UI 层。

💬 超越浏览器:Slack 与 Microsoft TeamsDiscord、Google Chat 即将推出……)

你的智能体可在 Web 应用之外运行并生成生成式 UI(了解更多).

CopilotKit 现可让你将 同一个智能体 部署到用户日常工作的平台:

  • Slack – 智能体作为一等 Slack 应用:频道内即可使用线程、工具调用和人机协同审批。
  • Microsoft Teams – 将智能体工作流带入企业,接入组织已有的协作平台。

🔒 抢先体验: 我们正在为团队开通接入。

👉 申请抢先体验 →

🧠 自学习智能体

通过持续学习不断改进你的产品。

借助 Continuous Learning from Human Feedback (CLHF) —— CopilotKit Intelligence Platform, 的一部分 —— 智能体在每次交互中不断进步:

  • In-context reinforcement learning – 智能体根据用户交互自动改进,无需微调模型。
  • Automatic prompt augmentation – 智能体行为根据近期交互与结果自适应调整。
  • Per-user adaptation – 智能体学习个人偏好,随时间推移为每位用户提供更好的体验。
  • Threads & persistence – 完整交互历史 —— 生成式 UI、人机协同、共享状态 —— 跨会话持久保存。

可通过 CopilotKit Cloud 或自托管方式使用。

🔒 抢先体验: 我们正在为团队开通接入。

👉 申请抢先体验 →

https://github.com/user-attachments/assets/7372b27b-8def-40fb-a11d-1f6585f556ad

你将获得:

  • CopilotKit installed 核心包已在你的应用中完整配置
  • Provider configured – 上下文、状态和 hooks 已就绪可用
  • Agent <> UI connected – 智能体可流式传输操作并即时渲染 UI
  • Deployment-ready 你的应用已可部署

完整入门指南 →

工作原理:

CopilotKit 将你的 UI、智能体和工具连接为单一交互循环。

CopilotKit Diagram — Motion x2 6 sec version

由此可实现:

  • 向用户请求输入的智能体
  • 可渲染 UI 的工具
  • 跨步骤与会话的有状态工作流
  • 同一智能体,部署于 Web、移动和聊天平台

useAgent Hook

useAgent hook 直接构建于 AG-UI 之上,让你对智能体连接拥有完整的编程控制。

// Programmatically access and control your agents
const { agent } = useAgent({ agentId: "my_agent" });

// Render and update your agent's state
return <div>
  <h1>{agent.state.city}</h1>
  <button onClick={() => agent.setState({ city: "NYC" })}>
    Set City
  </button>
</div>

查看 useAgent 文档 了解更多。

https://github.com/user-attachments/assets/67928406-8abc-49a1-a851-98018b52174f

生成式 UIGenerative UI

生成式 UIGenerative UI)是 CopilotKit 的核心模式,允许智能体(agent)在工作流中动态渲染 UI。

https://github.com/user-attachments/assets/3cfacac0-4ffd-457a-96f9-d7951e4ab7b6

对比三种类型

image

探索:

生成式 UI 教学仓库 →

🖥️ AG-UI:智能体–用户交互协议(The AgentUser Interaction Protocol

将智能体工作流连接到面向用户的应用,在智能体技术栈中拥有深度合作与第一方集成——涵盖 LangChain、CrewAI、Mastra、PydanticAI 等。

AG-UI


npx create-ag-ui-app my-agent-app
在 AG-UI README 中了解更多 →

🤝 社区

有问题或需要帮助?

加入我们的 Discord →
阅读文档 →
试用企业智能平台(Enterprise Intelligence Platform)→

及时了解我们的最新发布!

在 LinkedIn 上关注我们 →
在 X 上关注我们 →

🙋🏽‍♂️ 贡献

感谢你有兴趣为 CopilotKit 做出贡献!💜

我们重视所有贡献,无论是通过代码、文档、创建演示应用,还是仅仅传播项目理念。

以下是一些实用资源,可帮助你入门:

📄 许可证

本仓库的源代码依据 MIT License.