# @guuey/agent-client 中文文档

规范地址：https://npmcn.com/package/%40guuey/agent-client/

版本：0\.36\.0
npm 元数据更新时间：2026-11-14T17:05:25.401Z
中文译文更新时间：2026-11-17T04:06:41.054Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40guuey/agent-client
原文对照：https://npmcn.com/package/%40guuey/agent-client/?lang=original
项目主页：https://guuey.com/
源码仓库：https://github.com/withguuey/guuey-sdks

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：750 kB，91 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.12\.0
- 运行依赖：2 个
- peer 依赖：react \>=18
- 首次发布：2026-07-20T00:05:45.537Z
- 最新版本发布：2026-11-14T17:05:25.036Z
- 近 30 天下载量：7937（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：77（近 12 个月 77 个）

## 中文简介

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

## 安装

```sh
npm install @guuey/agent-client
```

也可以使用：`pnpm add @guuey/agent-client`、`yarn add @guuey/agent-client`、`bun add @guuey/agent-client`

## README

# @guey/代理客户

一个客户SDK [盖伊](https://guuey.com/) 代理串流合同 :

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

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

```bash
npm install @guuey/agent-client
```

## 三个入境点

| 导入 | 目录 | 反应? |
| --- | --- | --- |
| `@guuey/agent-client` | SSE 帮手, `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` 给自己的依附者.

## 反应示例

```tsx
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](https://docs.guuey.com/sdk)。 。 。 .

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

## 无反应地开转

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

```ts
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://guuey.com/discord)。 。 。 . 错误和特性请求 : [https://github.com/wisguuey/guey-sdks/ 问题](https://github.com/withguuey/guuey-sdks/issues)。 。 。 .

## 常见问题

### @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 和提交记录判断。

