以下是根据您的要求翻译的中文版本，保留了原文结构、技术术语和代码块：

CopilotKit

文档 · 示例 · 企业智能平台 · Discord

使用生成式 UI、共享状态和人机协同工作流构建智能体原生应用。

什么是 CopilotKit

CopilotKit 是一款顶级的 SDK，用于构建全栈智能体应用、生成式 UI 和聊天应用。我们是 AG-UI 协议背后的公司——该协议已被 Google、LangChain、AWS、Microsoft、Mastra、PydanticAI 等公司采用！

Whole.Generative.UI.v5.mp4

1 分钟为你的应用添加 AI

功能特性：

• 聊天 UI – 基于 React 的聊天界面，支持消息流式传输、工具调用和智能体响应。
• 后端工具渲染 – 允许智能体调用后端工具，这些工具返回的 UI 组件直接在客户端渲染。
• 生成式 UI – 允许智能体根据用户意图和智能体状态，在运行时动态生成和更新 UI 组件。
• 共享状态 – 一个同步的状态层，智能体和 UI 组件可以实时读写。
• 人机协同 – 允许智能体在执行过程中暂停，请求用户输入、确认或编辑，然后再继续。

full-headless-chat.mp4

快速开始

新项目：

npx copilotkit@latest create -f 

现有项目：

npx copilotkit@latest init

cpk-cli.mp4

这能给你带来什么：

• CopilotKit 已安装 – 核心包已在你的应用中完全配置好
• Provider 已配置 – 上下文、状态和 hooks 已准备好使用
• 智能体 <> UI 已连接 – 智能体可以流式传输操作并立即渲染 UI
• 可部署 – 你的应用已准备好部署

[完整入门指南 →](#)

工作原理：

CopilotKit 将你的 UI、智能体和工具连接成一个单一的交互循环。这实现了：

• 可以向用户请求输入的智能体
• 可以渲染 UI 的工具
• 跨步骤和会话的有状态工作流

⭐️ useAgent Hook

useAgent hook 是 useCoAgent 的适当超集，直接位于 AG-UI 之上，提供对智能体连接的更多控制。

// 以编程方式访问和控制你的智能体
const { agent } = useAgent({ agentId: "my_agent" });

// 渲染和更新智能体的状态
return (
  

    
{agent.state.city}
     agent.setState({ city: "NYC" })}>Set City
  
);

[查看 useAgent 文档以了解更多 →](#)

CopilotKit.UseAgent.Graphic.Motion_2.mp4

生成式 UI

生成式 UI 是 CopilotKit 的核心模式，允许智能体在其工作流程中动态渲染 UI。

demo-generative-ui.mp4

比较三种类型：

• 静态（AG-UI 协议）
• 声明式（A2UI）
• 开放式（MCP 应用与开放 JSON）

[生成式 UI 教育仓库 →](#)

🖥️ AG-UI：智能体-用户交互协议

将智能体工作流连接到面向用户的应用，并在整个智能体栈中提供深度合作伙伴关系和第一方集成——包括 LangGraph、CrewAI 等。

npx create-ag-ui-app my-agent-app

[在 AG-UI README 中了解更多 →](#)

🤝 社区与最新动态

有问题或需要帮助？[加入我们的 Discord →](#) [阅读文档 →](#) [尝试 Copilot Cloud →](#)

及时了解我们的最新发布！ [在 LinkedIn 上关注我们 →](#) [在 X 上关注我们 →](#)

🙋🏽‍♂️ 贡献

感谢你对 CopilotKit 的贡献兴趣！💜 我们重视所有贡献，无论是代码、文档、创建演示应用，还是仅仅传播信息。以下是一些有用的资源，帮助你开始：

• 对于代码贡献，请参阅 [CONTRIBUTING.md](#)。
• 对于文档相关贡献，请查看 [文档贡献指南](#)。
• 想贡献但不确定如何做？[加入我们的 Discord](#)，我们会帮助你！

安装为 Claude Code 插件

CopilotKit monorepo 同时作为 Claude Code 插件——安装后即可使用全部 9 项技能（3 个包元技能 + 6 个生命周期旅程技能）。

将仓库添加为 Claude Code 市场：

claude plugin marketplace add https://github.com/CopilotKit/CopilotKit
claude plugin install copilotkit

技能从仓库根目录的 skills//SKILL.md 中发现。三个包元技能（runtime、react-core、a2ui-renderer）是 packages//skills// 下源文件的镜像——不要直接编辑镜像。要更新内容，请编辑 packages/*/skills/ 下的源文件，然后运行：

pnpm sync:plugin-skills

一个 lefthook 预提交检查（pnpm check:plugin-skills）会拒绝导致镜像漂移的提交。插件版本固定在 packages/runtime/package.json 中，并由同一脚本保持同步。

技能清单

| Slug | 类型 | 来源 | |------|------|------| | runtime | 核心 | packages/runtime/skills/runtime/ | | react-core | 框架 | packages/react-core/skills/react-core/ | | a2ui-renderer | 框架 | packages/a2ui-renderer/skills/a2ui-renderer/ | | 0-to-working-chat | 生命周期 | skills/0-to-working-chat/ | | spa-without-runtime | 生命周期 | skills/spa-without-runtime/ | | go-to-production | 生命周期 | skills/go-to-production/ | | scale-to-multi-agent | 生命周期 | skills/scale-to-multi-agent/ | | v1-to-v2-migration | 生命周期 | skills/v1-to-v2-migration/ | | debug-and-troubleshoot | 生命周期 | skills/debug-and-troubleshoot/ |

📄 许可证

本仓库的源代码基于 MIT 许可证提供。