@agentplat/runtime

中文文档
1.5.1发布于 2026/11/04Apache-2.0TypeScriptES Module构建来源已验证近 30 天下载 2573

AgentPlat 的中性可执行代理运行时间 .

中文使用文档
文档目录5 节
  1. 安装( 开发者预览)
  2. 执行合同
  3. 运行时间检查站
  4. 持久的认知效应
  5. 便携式多种制剂

@ agentplat/ 运行时间

供应商中立代理运行时间合同和小型可执行运行时间.

安装( 开发者预览)

明确安装协调预览 :

npm install @agentplat/runtime@next

全部留着 @agentplat/* 软件包在同一版本中。 npm 的默认 latest 标记可以指向更古老的预览。 见 释放通道 用于发行状态和版本选择.

DefaultAgentRuntime 按平台、发送运行和流式提供者事件分列的注册提供者适配器。 模型提供者适配器是独立的包,因此应用程序可以选择自己的提供者和证书策略.

ChatAgentProvider 调整下层 @agentplat/model 合同与一项合同 代理生成。 它适合简单的聊天和生成. 供应商 例如 @agentplat/provider-openai 应用程序需要时仍然可用 由 SDK 管理的代理环路和由 那个适配器.

AgentStreamEvent 是一个受歧视的工会。 已完成的活动曝光 usage, (中文(简体) ), model, (中文(简体) ), finishReason 财务报告和审定财务报表 latencyMs 当供养者报喜的时候, 所以高层次的管弦乐手可以保留真实的会计而不是 估计征兆.

执行合同

提供者适配器必须治疗 RuntimeExecutionContext.signal 作为合作社 取消请求。 开工前先检查一下 传给下游的SDK 或网络调用,并停止启动新工作或外部效果 终止后。 这让房间超时 和失去的执行租赁取消 基本供应商的操作.

RuntimeExecutionContext.runId 是逻辑运行的一能键。 没错 当适配器能够产生外部效应或 呼叫可以重审 : 当 runId 缺席和 每次重试都要重用相同的值. 转发给支持提供者 一能键,或者在适配器的分解机制中使用,所以一个 逻辑运行不能两次应用同样的效果 .

运行时间检查站

供应商可声明支持 pre_action 结束 AgentProvider.supportedCheckpoints 并引用所提供的检查站回调 内 RuntimeExecutionContext 在启动工具或外部前 效应。 使用高级运行时间 pre_step 财务报告和审定财务报表 post_output 围绕提供者 执行。 被拒绝的检查站必须在受保护之前阻止提供者 操作开始 .

DefaultAgentRuntime.supportsCheckpoint 让呼叫者在关闭前失败 援引无法执行所需行动边界的提供者。 已宣布为 支助是供应商遵守合同;必须测试适配器以确保 每个受保护的路径引用 pre_action。 。 。 .

持久的认知效应

CognitiveAgentRuntimeV2 治疗 memory_mutation 财务报告和审定财务报表 tool 和效果一样 一个 任一操作的广告适配器必须同时提供明确的 CognitiveDurableOperationStoreV2 (单位:千美元) CognitiveEffectSinkV2; 建筑业 在没有边界时没有关闭 。 运行时间从不发送这些 通过适配器的一般操作 execute 方法.

在发送前,耐用仓库在解剖上保留了TUPLE tenantId/sessionId/operationId,将其与完整的请求文摘相绑定 主张预期会话修改。 水槽得到稳定的能耐 键和请求摘要。 内容 apply 执行必须在解剖上重复 那对,同时 lookup 崩溃时必须返回持久的汇收/结果 调和。 该商店然后解剖 移动操作从 prepared 改为 applied 与会话状态 CAS. 重放返回记录 结果, 相互冲突的请求摘要失败, 而第二个操作无法花费 同一届会议修订本。 持久运行记录省略了请求的有效载荷,但 保留应用结果和原始结果以进行精确的重放, 因此生产 存储必须加密并按照其数据分类管理该产出. A 类 prepared 无法确定沉没状态的记录 块会话修订; 运算符必须调节,而不是删除 保留并有可能产生重复效果.

此协议仅在配置时防止逻辑应用程序重复 {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}沉船尊重其独能合同 它不声称完全一交货 外部系统:一体化必须使用下游独能 API或者在报告成功前长期核对他们自己的收据. 这个 a. 用于当地执行和确定性测试 多流程部署必须提供交易持久的实施.

便携式多种制剂

@agentplat/runtime/adapter 为语言,视觉, 行动、政策、象征、混合和海关代理人。 一份清单宣布 模式、互动模式、取消行为和恢复支持 一个不可改变的适配器执行。 应用商谈这些能力 在打开会话之前,不相容的同伴在执行前失败.

PortableAgentSessionRuntimeV1 使每场会议受适配器执行的约束, 一个版本的本地控制执行和一个被修改的角色. 每个步骤都使用 比较和设定状态,一个稳定的一能键和明确的源区,用于 观察。 产出和惰性行动建议在 配置的控件批准相关的步骤、输出后和动作前 检查站。 控制错误无法关闭 .

会话可以被暂停,检查,恢复,指定后继角色和 关闭。 适应器可执行配对 exportCheckpoint 财务报告和审定财务报表 importCheckpoint 在未使用中移动便携式应用程序状态的钩子 语句与完全相同的适配器版本和执行。 进口 文摘检查,在恢复前暂停,并具有同等能力 转让。 角色更新必须构成一个未中断的相同修改链 目标。 Ephemer 证书只提供给适配器的呼叫,而且 从未坚持、出口或显示用于控制.

连接此协议与当前运行时间的两座桥梁 :

  • createAgentRuntimePortableAdapterV1 显示已有 AgentRuntime 代理通过便携式协议而不给予工具呼叫动作 权力.
  • createPortableAgentProviderV1 显示可移植会话为 AgentProvider,允许工作流程和集体使用被控制, 状态执行路径通过 DefaultAgentRuntime。 。 。 .

版本与发布记录

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

版本发布日期距今
1.5.1latest2026/11/043 天前
1.5.02026/10/317 天前
1.4.02026/10/2315 天前
1.3.02026/10/1622 天前
1.2.02026/10/011 个月前
1.1.02026/09/301 个月前

其他发布通道:agentplat-stage-74c331e7b716 → 0.3.0-beta.3,agentplat-stage-dbd047c3c9a9 → 0.3.0-beta.4,agentplat-stage-ffca668731c9 → 0.3.0-beta.4,agentplat-stage-61ee591e79b0 → 0.3.0-beta.4,agentplat-stage-dc16b2267584 → 0.3.0-beta.5,agentplat-stage-e43ff308bc22 → 0.3.0-beta.6。

关于 @agentplat/runtime 的常见问题

@agentplat/runtime 是什么?

AgentPlat 的中性可执行代理运行时间 .

如何安装 @agentplat/runtime?

在项目目录运行 npm install @agentplat/runtime,或使用 pnpm add / yarn add / bun add。

@agentplat/runtime 支持 TypeScript 吗?

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

@agentplat/runtime 支持 ESM 还是 CommonJS?

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

@agentplat/runtime 可以商用吗?

@agentplat/runtime 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@agentplat/runtime 的下载量有多少?

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

@agentplat/runtime 还在维护吗?

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