@guuey/agent-client

中文文档
0.36.0发布于 2026/11/15MITTypeScriptES Module构建来源已验证近 30 天下载 7937

Guuey 代理运行时间的客户端 SDK: useAgentInvoke 反应接钩+纯SSE助攻能说出/agent/invoke流线合同,外加相接线-历史读取平面. 主机适配器(存储 / id / 运输)被注入,所以它运行在我们身上

中文使用文档
文档目录5 节
  1. 三个入境点
  2. 反应示例
  3. 无反应地开转
  4. 反应原生/ 地铁
  5. 支助

@guey/代理客户

一个客户SDK 盖伊 代理串流合同 :

  • POST /agent/invoke ——服务器-恒星-事件流(session 编号 : message 编号 : done 编号 : error 折叠成平面记录.
  • GET /threads/:id/messages ——被标注的历史读出平面,所以 在任何新的流线开始前重新装入对话 .

钩子为站台-不可知:线形d存储,客户端-消息-id 生成,而网络传输(也包含身份)是 被注入为适配器,因此同一核心在web(Next.js)和React Introduct上运行.

npm install @guuey/agent-client

三个入境点

导入目录反应?
@guuey/agent-clientSSE 帮手, invokeTurn线条历史的读者, createWebAdapters,所有公共类型.没有
@guuey/agent-client/react这个 useAgentInvoke 钩 (+) applyHistoryResult) (中文(简体) ).对
@guuey/agent-client/transport仅引用运输 + 来宾识别块 — 0 @guuey/mcp-apps-host 在导入图中.没有

根子路径是 React-free ——导入它从不拉入 React. 反应 (单位:千美元)react >=18是一个 选项对等点:仅限 ./react 子路径需要它,所以 npm 不为您安装它 。 如果您导入 @guuey/agent-client/react,添加 react 给自己的依附者.

反应示例

import { useAgentInvoke } from "@guuey/agent-client/react";
import { createWebAdapters } from "@guuey/agent-client";

export function Chat({ endpointUrl, appId }: { endpointUrl: string; appId: string }) {
  const adapters = createWebAdapters({ getAccessToken: async () => myToken });
  const { messages, send, status, activeTool, error } = useAgentInvoke({
    endpointUrl,
    appId,
    adapters,
  });

  return (
    <>
      {messages.map((m, i) => (
        <p key={i} data-role={m.role}>
          {m.text}
        </p>
      ))}
      {status === "connecting" && <p>Waking up…</p>}
      {status === "using-tool" && <p>Using {activeTool}…</p>}
      {error && <p role="alert">{error}</p>}
      <button disabled={status !== "ready"} onClick={() => send("hello")}>
        Send
      </button>
    </>
  );
}

status 在转弯的生命周期中行走—— ready → connecting → thinking 编号 : using-tool (与 activeTool 名称工具) / responding 回到你身边 ready失败从未占据 status他们降落在 error 编辑 作曲再现. 完整的词汇记录在 页面存档备份,存于互联网档案馆. docs.guuey.com/sdk。 。 。 .

在本地反应时,提供自己的适配器(AsyncStorage + an) expo/fetch 运输) createWebAdapters ——钩子合同完全相同.

无反应地开转

invokeTurn 和钩子一样行走的电线 和纯电动发电机一样 用于节点吊带,游戏回路,或任何拥有自转状态机器的主机. 它的事件流也是观察通道:工具结果以 类型 tool.done AgEvents,所以遥测是过滤器,而不是回调API.

import { invokeTurn, toInvokeUrl, fetchStreamTransport } from "@guuey/agent-client";

const req = {
  url: toInvokeUrl(endpointUrl),
  body: { input, clientMessageId: crypto.randomUUID() },
  signal: controller.signal,
};
// `getBearer` is resolved per attempt — a retry re-reads a fresh token.
const transport = (r) => fetchStreamTransport(r, null, null, { getBearer });

for await (const ev of invokeTurn(req, transport)) {
  if (ev.kind !== "message") continue;
  for (const agEvent of ev.agEvents) {
    if (agEvent.type === "tool.done") {
      telemetry.record(agEvent.toolCallId, agEvent.outcome ?? "ok");
    }
  }
  render(ev.assistantText); // full folded text — no delta bookkeeping
}

运输机为冷起步503(重新部署后窗口)和 能力拒绝POD_SATURATED, (中文(简体) ), WORKER_POD_RESOURCE_EXHAUSTED本身, 在第一个流出字节后从不; 调谐或通过它禁用 coldStartRetry 选项.

反应原生/ 地铁

每个切入点都决定采用汇编的无害环境管理 dist/,用于 Metro 和 节点和网络捆绑。 一个股票博览会或反应本地地铁配置将它捆绑起来: 没有自定义解析器也没有 transpilePackages- 需要样式配置.

支助

问题和帮助:Discord上的贵人社区—— https://guuey.com/discord (英语)。 。 。 . 错误和特性请求 : https://github.com/wisguuey/guey-sdks/ 问题。 。 。 .

版本与发布记录

@guuey/agent-client 共发布 77 个版本,首次发布于 2026/07/20;过去 12 个月发布了 77 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.36.0latest2026/11/152 天前
0.35.02026/11/116 天前
0.34.02026/11/0610 天前
0.33.02026/11/0610 天前
0.32.02026/11/0610 天前
0.31.12026/09/291 个月前

其他发布通道:next → 0.16.15。

关于 @guuey/agent-client 的常见问题

@guuey/agent-client 是什么?

Guuey 代理运行时间的客户端 SDK: useAgentInvoke 反应接钩+纯SSE助攻能说出/agent/invoke流线合同,外加相接线-历史读取平面. 主机适配器(存储 / id / 运输)被注入,所以它运行在我们身上

如何安装 @guuey/agent-client?

在项目目录运行 npm install @guuey/agent-client,或使用 pnpm add / yarn add / bun add。

@guuey/agent-client 支持 TypeScript 吗?

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

@guuey/agent-client 支持 ESM 还是 CommonJS?

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

@guuey/agent-client 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22.12.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@guuey/agent-client 可以商用吗?

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

@guuey/agent-client 的下载量有多少?

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

@guuey/agent-client 还在维护吗?

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