@assistant-ui/react-ag-ui

中文文档
0.1.1发布于 2026/10/28MITTypeScriptES Module构建来源已验证近 30 天下载 35万

AG-UI 协议适配器

中文使用文档
文档目录4 节
  1. 安装
  2. 使用量
  3. 副剂
  4. 另见

@assistant-ui/react-ag-ui

AG- UI 协议 合并 @assistant-ui/react组合 @ag-ui/client 助理- ui 运行时间中的代理, 因此任何 AG- UI 兼容后端( Copilot Kit,自定义 Python/ Go/ TS 代理) 可以驱动标准助理- ui 组件 .

安装

npm install @assistant-ui/react @assistant-ui/react-ag-ui @ag-ui/client@^1.0.3

使用量

"use client";

import { useMemo } from "react";
import { AssistantRuntimeProvider } from "@assistant-ui/react";
import { HttpAgent } from "@ag-ui/client";
import { useAgUiRuntime } from "@assistant-ui/react-ag-ui";

export function Provider({ children }: { children: React.ReactNode }) {
  const agent = useMemo(
    () => new HttpAgent({ url: process.env.NEXT_PUBLIC_AGUI_AGENT_URL! }),
    [],
  );
  const runtime = useAgUiRuntime({ agent });

  return (
    <AssistantRuntimeProvider runtime={runtime}>
      {children}
    </AssistantRuntimeProvider>
  );
}

副剂

AG- UI 后端, 运行子代理( 代理工具模式) 释放 SUBAGENT_STARTED 编号 : SUBAGENT_FINISHED 编号 : SUBAGENT_ERROR 加一个 subagentRunId 每个副剂所产生的事件。 这个适配器组将每个子剂运行一个嵌入式助理消息, 并将其附加到产卵工具呼叫中 ToolCallMessagePart.messages添加到 SUBAGENT_STARTED.parentToolCallId。 。 。 . PartPrimitive.Messages 使它没有额外的接线, 和子代理的名称,描述,结果, 错误代码骑在消息的 agui 元数据.

一种无可达到的产卵呼号的子剂(parentToolCallId 是可选的, 可能给此运行命名从未见过的呼叫, 或两个运行可能互相命名) 无处可居, 因此其输出在母线程中而不是被丢弃 。 这符合协议本身的预放相容性中间器件的降级.

子代理前端执行工具的调用方式与根代理的调用方式相同: 调用嵌入 ToolCallMessagePart.messages 可达到 getPendingToolCalls(),解决 addToolResult,其结果在简历中作为 tool 在产卵助理记录上, 同样的平整的线形 这些电话在亚物剂归属之前.

批准门也覆盖了嵌入式呼叫:一个门,将一个子剂扫描的呼叫项目命名到嵌入式部分,前端工具在闸门打开时未执行,决定记录通过 respondToToolApproval 降落在被窝中的部分,一个未决定的大门的结果从未被出口到后端.

有两个限制值得你先知道 然后再依赖这个:

  • 嵌入式结构无法活过重载. 线条还原读取了平平的线形,所以一个被还原的子剂活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活 成果和决定得到保留;只有筑巢才没有.

  • 被窝住的人没有被窃听. A 类 SUBAGENT_FINISHED 带有 suspended 结果标记了嵌入式信息 requires-action,以及 interruptIds 保存在信件元数据上,但是还没有恢复路径来回答它们.

另见

  • @assistant-ui/react-a2a a2A v1.0 协议.
  • @assistant-ui/react-langgraph 给LangGraph SDK探员.

完整的 API 参考、多行设置和中断处理 助理-ui.com/docs/运行时间/ag-ui。见 examples/with-ag-ui 一个完整的应用程序.

版本与发布记录

@assistant-ui/react-ag-ui 共发布 68 个版本,首次发布于 2025/11/19;过去 12 个月发布了 68 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.1.1latest2026/10/2810 天前
0.1.02026/10/2315 天前
0.0.712026/10/2018 天前
0.0.702026/10/1622 天前
0.0.692026/10/1325 天前
0.0.682026/10/1226 天前

关于 @assistant-ui/react-ag-ui 的常见问题

@assistant-ui/react-ag-ui 是什么?

AG-UI 协议适配器

如何安装 @assistant-ui/react-ag-ui?

在项目目录运行 npm install @assistant-ui/react-ag-ui,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(^18 || ^19)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@assistant-ui/react-ag-ui 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@assistant-ui/react-ag-ui 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@assistant-ui/react-ag-ui 可以商用吗?

@assistant-ui/react-ag-ui 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@assistant-ui/react-ag-ui 的下载量有多少?

根据 npm 官方下载统计,@assistant-ui/react-ag-ui 在 2026/10/07 – 2026/11/05 这 30 天内被下载 349,870 次,日均约 11,662 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@assistant-ui/react-ag-ui 还在维护吗?

最新版本 0.1.1 发布于 2026/10/28(10 天前);至今共发布 68 个版本,其中过去 12 个月发布了 68 个;首次发布于 2025/11/19。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。