@buoy-gg/agent-core

中文文档
7.0.87发布于 2026/11/07TypeScriptESM + CJS零依赖近 30 天下载 5187

Ask Buoy 的无头代理核心 - 工具目录, BYO- 模型提供者, 转回循环和效果分类账, 让 LLM 驱动 Buoy devtools

中文使用文档
文档目录3 节
  1. 用这个
  2. 文档
  3. 许可证

@ buoy- gg/ 代理核心

Ask Buoy使用的无头引擎. 它没有React,React Induct,或节点内置导入.

它规定:

  • 工具目录 – 从一个源文件生成的Buoy工具动作. JSON-Schema 参数已验证 在此之前 发送,每动作效果类(读/写/破坏性),每动作放出-建立真理:需要只发展能力的行动会被拒绝解释,绝不允许假冒成功. 参数计划描述每个动作接受的名称和值.
  • 转圈 ——提供者流线(Anthropic和OpenAI有线形状,在提供者提供时迅速缓存),独立发送的工具读取重叠,结果编辑(证书字段名) 财务报告和审定财务报表 、 值形状 、 自通取取、 循环检测、 弹出前的历史压缩、 和步骤和时间封顶 —— 有 stopReason 每页 done,持有仍在应用的改变的回合最后从内存中掉出,一个被节奏或过大的请求被狭义地重试:只有在溪流没有产生,所以没有运行两次.
  • 证据库 每一个结果在修改后都保持完整,所以 ask-buoy.retrieve 可以在24k读取一个结果切出的任何部分,或者重新读取模型在写作之前所看到的确切内容. 在记忆中,会议范围从未持续.
  • 成果检查 5个写作在着陆后被读取(存储、存储和缓存编辑、导航、超标规则); 裁决在工具结果和a上 tool-verified 事件: verified 编号 : unverified (已着陆,尚不可见——何以使之如此)/ failed (一改一从来.
  • 托肯校正 ——预算以代币记账并按提供者自己的用法报告衡量的比例进行折算,而不是猜测出4个字符/音符.
  • 地面摘要 ——从工具本身构建的紧凑,无值的运行中的应用程序图片:路由路径,存储并存储密钥名称,挂载先查询密钥,以及项目 形状 以未知名称命名,而不是留待猜测。 以深度,宽度和字符总数为界,因此由几百个记录所键入的商店无法将"契约"素描变成即时最出名的东西.
  • 效果分类账 - 特工改变了什么 怎样放回去 存储写入和查询- cache 编辑是预读的, 因此撤消恢复了之前的精确值; 任何无法被撤销的都报告为永久而不是隐藏 .
  • 政策 ——批准门(默认情况下破坏性地等待人用水龙头),允许/拒绝规则,按呼批准,只读模式,以及默认关闭的安全Store值门. requestApproval 可能解决 { approved, reason, trust }:一个有下降的音符逐字到达模型 trust 免去会议这一动作的名片——只批准,从未有过政策.
  • 程序 —— 说 context.procedures 是应用程序的游戏本 id — summary 在即时,身体由引擎服务 ask-buoy.openProcedure。 。 。 .
  • 块 ——封闭的,申报性的UI目录(buoy_ui模型作者对工具结果预测的引擎生成的收据作出了丰富的反应.

一个主机提供模型端点、协议、模型、可用动作和 dispatch(toolId, action, params) 函数。 主机还必须强制访问账户,认证模型请求,并处理权限和生命周期事件.

用这个

对于 React 本地聊天界面, 使用 @buoy-gg/ask-buoy, React Industrial 聊天表就是以此为基础建立的. 它安装这个引擎作为依赖.

直接用于自定义主机. 这是集成草图: endpoint, (中文(简体) ), model, (中文(简体) ), myDispatch,以及 availableActions 来自您的主机, 它不是一个独立的应用程序.

import { createAskBuoySession } from "@buoy-gg/agent-core";

const session = createAskBuoySession({
  endpoint, protocol: "anthropic", model,
  dispatch: myDispatch,           // (toolId, action, params) => Promise<unknown>
  availableActions,               // what this host can actually reach
  isRelease: false,
});

for await (const event of session.send("what did the last network call return?")) {
  // text deltas, reasoning, tool starts/ends, blocks, approvals, token usage
}

内置目录验证支持动作及其参数. 仅发布您主机可以发送的动作, 并查阅 Ask Buoy 配置指南, 用于政策和自定义工具集成 .

文档

浮标.gg/docs/工具/水缸

许可证

见 浮标.gg 许可证发放.

版本与发布记录

@buoy-gg/agent-core 共发布 54 个版本,首次发布于 2026/09/03;过去 12 个月发布了 54 个版本。

版本发布日期距今
7.0.87latest2026/11/071 天前
7.0.862026/11/062 天前
7.0.852026/11/053 天前
7.0.842026/11/035 天前
7.0.832026/11/035 天前
7.0.822026/11/036 天前

关于 @buoy-gg/agent-core 的常见问题

@buoy-gg/agent-core 是什么?

Ask Buoy 的无头代理核心 - 工具目录, BYO- 模型提供者, 转回循环和效果分类账, 让 LLM 驱动 Buoy devtools

如何安装 @buoy-gg/agent-core?

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

@buoy-gg/agent-core 支持 TypeScript 吗?

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

@buoy-gg/agent-core 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@buoy-gg/agent-core 可以商用吗?

@buoy-gg/agent-core 使用 未声明 许可。package.json 没有声明许可证。没有许可证的代码默认保留全部权利,商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括,不构成法律意见,请以许可原文为准。

@buoy-gg/agent-core 的下载量有多少?

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

@buoy-gg/agent-core 还在维护吗?

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