CopilotKit v1.50 带来了全新的 useAgent 钩子，使 AG-UI 代理直接进入您的应用。

智能框架现在擅长推理和工具，但大多数团队仍需编写自定义代码，将智能体图转变为具有共享状态、流式输人和中断的健壮用户界面。 CopilotKit 针对最后这个环节。它是一个开源框架，可在您的应用中直接构建 AI 伴飞者以及应用内智能体，具备实时上下文和 UI 控制。（ 查看 CopilotKit GitHub）

CopilotKit 的 v1.50 版本在 AG-UI 代理用户交互协议上原位重构了项目。核心思想很简单；让 AG-UI 通过 useAgent 单一钩子定义智能体和 UI 间的所有流量作为任何应用的类型事件流。### useAgent，每个 AG-UI 智能体一个 React 钩子

AG-UI 定义了智能体后端和前端如何交换单个顺序的 JSON 编码事件。这些事件包括消息、工具调用、状态更新和生命周期信号，并且可以像 HTTP、Web Sockets 或甚至是 WebRTC 等任何传输一样进行流式传输。

CopilotKit v1.50 使用此协议作为原生传输层。不再为每个框架使用分开的适配器，现在所有内容都通过 AG-UI 直接通信。所有的这一切都通过新的 useAgent 使得易于访问ー—a 个 React 钩子，它可以对任何 AG-UI 智能体进行程序性控制。它订阅事件流，保留本地消息和共享状态的模型，并公开一个小的 API 以发送用户输入和 UI 意图。

在较高层次上，React 组件做三件事：

使用后端智能体的连接详情调用 useAgent。
读取当前状态，例如消息列表、流式增量（deltas）和智能体状态标志。
通过钩子调用 useAgent 方法以发送用户消息、触发工具或更新共享状态。

由于钩子仅取决于 AG-UI，因此相同的 UI 代码可以与不同的智能体框架一起使用，只要它们公开 AG-UI 端点。

上下文消息和共享状态

AG-UI 假设智能体应用是有状态的。协议标准化了上下文如何在 UI 和智能体之间移动。

在前端，CopilotKit 已经让开发者可以将应用程序数据注册为上下文，例如使用使 React 状态可读的钩子。在 AG-UI 模型中，这变成了明确的。状态快照和状态补丁事件保持后端和 UI 之间的同步。智能体看到一个一致的应用程序视图，UI 可以在无需自定义同步逻辑的情况下渲染相同的状态。

对于初级工程师来说，这移除了一个常见的模式。您不再需要在每次调用手动将 props 推入提示。状态随后会更新，并且 AG-UI 客户端将这些更新编码为事件，而后端智能体通过其 AG-UI 库消耗相同的州。

AG-UI，智能体和用户之间的协议层

AG-UI 定义为一项开放、轻量级的协议，该协议标准化了智能体如何连接到面向用户的代理。它专注于事件语义而不是传输。核心 SDK 提供强类型的事件模型和在 TypeScript、Python 等语言中的客户端。

JavaScript 包 @ag-ui/core 在客户端实现了基于流的基于事件的架构。它公开消息和状态模型、运行输入类型和事件实用工具，目前版本 0.0.41 在 npm 上的周下载量约为 178,751。在 Python 方面，ag-ui-protocol 包提供了规范的事件模型，上周下载量约为 619,035，而上个月约为 2,172,180。

CopilotKit v1.50 直接构建在这些组件之上。前端代码使用 CopilotKit React 原语，但在底层，与后端的连接是一个发送和接收标准事件的 AG-UI 客户端。

三大超级计算器之间的原生集成

AG-UI 概述列出了 Microsoft Agent Framework、Google Agent Development Kit、ADK 和 AWS Strands Agents 作为受支持的框架，每个框架都有专门的文档和演示。这些是由协议和框架所有者维护的原生集成。

Microsoft 发布了一个教程，展示了如何使用 .NET 或 Python 中的 Agent Framework 使用 AG-UI 构建服务器和客户端应用程序。Google 文档将 AG-UI 列在 ADK 文档的“代理 UI”部分下，CopilotKit 提供了一个关于构建 ADK 的完整指南以及 AG-UI 和 CopilotKit 堆栈。AWS Strands 通过官方教程和 CopilotKit 快速入门应用将 AG-UI 集成公开，它将 Strands 智能体后端连接到一个 React 客户端。

对于一个 React 团队来说，这意味着 useAgent 可以连接到这些框架中的任何一个定义的智能体，只要后端公开了 AG-UI 端点。前端代码保持不变，而智能体逻辑和托管环境可以改变。

围绕 CopilotKit 和 AG-UI 的生态系统增长

CopilotKit 将自己定位为应用内伴飞者的代理框架，拥有超过 20,000 个 GitHub 星级，被超过 100,000 名开发者信赖。

AG-UI 本身已经从一项协议提案发展成为多个框架之间的共享层。合作伙伴关系或集成包括与 LangGraph、CrewAI、Mastra、Pydantic AI、Agno、LlamaIndex 等的合作，以及 Kotlin、Go、Java、Rust 等语言的 SDK。这种跨框架的采用使得 useAgent 这样的通用钩子变得可行，因为它可以依赖于一致的事件模型。

关键要点

CopilotKit v1.50 将其前端层标准化在 AG-UI 上，所以所有智能体到 UI 的通信都是一个事件流，而不是每个后端的自定义链接。
新的 useAgent React 钩子允许一个组件连接到任何 AG-UI 兼容的智能体，并通过类型化接口公开消息、流令牌、工具和共享状态。
AG-UI 正式化上下文消息和共享状态为复制的仓库与事件源分销的增量，因此智能体和 UI 都共享一个一致的应用程序视图，而无需手动提示连接。
AG-UI 与 Microsoft Agent Framework、Google Agent Development Kit 和 AWS Strands Agents 进行了原生集成，这意味着相同的 CopilotKit UI 代码可以针对所有三大云中的智能体。
CopilotKit 和 AG-UI 显示了强大的生态系统牵引力，GitHub 采用率很高，并且 npm 的 @ag-ui/core 和 PyPI 的 ag-ui-protocol 的周下载量很高，这表明该协议正在成为代理应用程序的通用层。

如果您对在生产产品或业务中使用 CopilotKit 感兴趣，可以在这里预约时间：预约链接

原文首发于 MarkTechPost。