@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-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 给自己的依附者.
反应示例
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/ 问题。 。 。 .