# @agentplat/runtime 中文文档

规范地址：https://npmcn.com/package/%40agentplat/runtime/

版本：1\.5\.1
npm 元数据更新时间：2026-11-03T19:55:28.364Z
中文译文更新时间：2026-11-06T17:34:59.060Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40agentplat/runtime
原文对照：https://npmcn.com/package/%40agentplat/runtime/?lang=original
项目主页：https://github.com/Agentplat/agentplat#readme
源码仓库：https://github.com/Agentplat/agentplat

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

- 包体积（解压后）：334 kB，47 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：4 个
- 首次发布：2026-07-14T22:41:25.372Z
- 最新版本发布：2026-11-03T19:55:28.022Z
- 近 30 天下载量：2573（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：28（近 12 个月 28 个）

## 中文简介

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

## 安装

```sh
npm install @agentplat/runtime
```

也可以使用：`pnpm add @agentplat/runtime`、`yarn add @agentplat/runtime`、`bun add @agentplat/runtime`

## README

# @ agentplat/ 运行时间

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

## 安装( 开发者预览)

明确安装协调预览 :

```sh
npm install @agentplat/runtime@next
```

全部留着 `@agentplat/*` 软件包在同一版本中。 npm 的默认 `latest` 标记可以指向更古老的预览。 见 [释放通道](https://github.com/Agentplat/agentplat/blob/main/docs/release-channels.md) 用于发行状态和版本选择.

`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 是什么？

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（4 天前）；至今共发布 28 个版本，其中过去 12 个月发布了 28 个；首次发布于 2026/07/15。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。