# @agentskit/runtime 中文文档

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

版本：0\.11\.3
npm 元数据更新时间：2026-10-24T15:08:28.702Z
中文译文更新时间：2026-11-05T23:56:29.334Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40agentskit/runtime
原文对照：https://npmcn.com/package/%40agentskit/runtime/?lang=original
项目主页：https://www.agentskit.io/docs/reference/packages/runtime
源码仓库：https://github.com/AgentsKit-io/agentskit

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

- 包体积（解压后）：657 kB，16 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=20\.19
- 运行依赖：2 个
- 首次发布：2026-04-05T21:53:00.500Z
- 最新版本发布：2026-10-24T15:08:28.257Z
- 近 30 天下载量：8711（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：40（近 12 个月 40 个）

## 中文简介

独立代理运行时间 .

## 安装

```sh
npm install @agentskit/runtime
```

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

## README

# @ agentskit/ 运行时间

简介 : `major-package`

![AgentsKit](https://raw.githubusercontent.com/AgentsKit-io/agentskit/main/apps/docs-next/public/brand/logo-wordmark.svg)

运行5行的自发剂——没有UI,没有锅炉板,只有结果.

[![npm version](https://img.shields.io/npm/v/@agentskit/runtime?color=blue)](https://www.npmjs.com/package/@agentskit/runtime) [![npm downloads](https://img.shields.io/npm/dm/@agentskit/runtime)](https://www.npmjs.com/package/@agentskit/runtime) [![bundle size](https://img.shields.io/bundlejs/size/@agentskit/runtime?label=bundle)](https://bundlejs.com/?q=@agentskit/runtime) [![license](https://img.shields.io/badge/license-MIT-blue.svg)](https://npmcn.com/package/LICENSE) [![stability](https://img.shields.io/badge/stability-beta-yellow)](https://npmcn.com/package/docs/STABILITY.md) [![GitHub stars](https://img.shields.io/github/stars/AgentsKit-io/agentskit?style=social)](https://github.com/AgentsKit-io/agentskit)

**标记 :** `ai` • 妇女 `agents` • 妇女 `llm` • 妇女 `agentskit` • 妇女 `openai` • 妇女 `anthropic` • 妇女 `ai-agents` • 妇女 `autonomous-agents` • 妇女 `react-loop` • 妇女 `orchestration` • 妇女 `multi-agent`

## 已核实的证据

-   软件包元数据和测试在 `packages/runtime/`。 。 。 .
-   软件包指南 : [https://www.agentskit.io/docs/reference/packages/runtime (中文(简体) )](https://www.agentskit.io/docs/reference/packages/runtime)
-   稳定地图: [文件/服务.md](https://npmcn.com/package/docs/STABILITY.md)

## 如何适应生态系统

@agentskit/runtime是无头代理引擎:ReAct循环,工具,技能,授权,内存,取消,以及结构化运行结果.

-   **探员Kit**:与本回购中的其他包一起作曲,从可互换的小零件来构建代理.
-   **书记官处**: 查找已使用此图层的即时代理和模板 [登记. agentskit.io](https://registry.agentskit.io/)。 。 。 .
-   **游戏本**: 学习本层背后的生产模式 [游戏本. agentskit.io](https://playbook.agentskit.io/)。 。 。 .

文档 : [软件包指南](https://www.agentskit.io/docs/reference/packages/runtime) • 妇女 [代理交接](https://github.com/AgentsKit-io/agentskit/blob/main/llms.txt)

## 为什么运行时间

-   **为您处理的 ReAct 循环** ——观察,思考,行动,重复:运行时间驱动整个周期,当代理决定完成时停止
-   **结构化、可检查的结果** ——每次运行返回最终内容,步骤计数,所有工具调用,以及总持续时间;没有黑框
-   **生产准备生命周期** - 懒惰工具 `init`编号 :`dispose`, (中文(简体) ), `AbortSignal` 取消、内存持续 `AgentEvent` (b) 监测性排放
-   **多机构代表团** - 通过一个 `planner` 自动使用指定代表的技能和运行时间坐标子代理

## 安装

```bash
npm install @agentskit/runtime @agentskit/adapters
```

## 快速实例

```ts
import { createRuntime } from '@agentskit/runtime'
import { openai } from '@agentskit/adapters'
import { webSearch, filesystem } from '@agentskit/tools'

const runtime = createRuntime({
  adapter: openai({ apiKey: process.env.OPENAI_API_KEY, model: 'gpt-4o' }),
  tools: [webSearch(), ...filesystem({ basePath: './workspace' })],
  systemPrompt: 'You are a helpful research assistant.',
})

const result = await runtime.run('Research the latest advances in quantum computing')
console.log(result.content)
console.log(`Completed in ${result.steps} steps, ${result.durationMs}ms`)
```

## 有技能

```ts
import { createRuntime } from '@agentskit/runtime'
import { anthropic } from '@agentskit/adapters'
import { researcher } from '@agentskit/skills'

const runtime = createRuntime({
  adapter: anthropic({ apiKey: process.env.ANTHROPIC_API_KEY!, model: 'claude-sonnet-4-6' }),
})

const result = await runtime.run('Summarize REST vs GraphQL', { skill: researcher })
console.log(result.content)
```

## 特征

-   `createRuntime` ——无头代理执行的单一切入点.
-   ReAct 循环:观察 ——想 ——行动 ——重复直到完成.
-   回返 `{ content, steps, toolCalls, durationMs }` 完全可以检查.
-   `AbortSignal` 取消支持 .
-   工具 `init` 编号 : `dispose` 寿命轮钩.
-   `AgentEvent` 用于可观察性一体化的排放量.
-   `retriever` 选项.

## 高级原始人

| 初级 | 目的 | 文档 |
| --- | --- | --- |
| `createDurableRunner` + 键 `createFileStepLog` | Timoral 类步骤日志; 崩溃时恢复 | [长期执行](https://www.agentskit.io/docs/reference/recipes/durable-execution) |
| `supervisor` 编号 : `swarm` 编号 : `hierarchical` 编号 : `blackboard` | 现成的多剂地貌 | [地形学](https://www.agentskit.io/docs/reference/recipes/multi-agent-topologies) |
| `speculate` | Fan-out N 适配器, 种族 + 流产失败者 | [投机处决](https://www.agentskit.io/docs/reference/recipes/speculative-execution) |
| `createCronScheduler` + 键 `createWebhookHandler` | 背景代理, cron + webhooks | [背景代理人](https://www.agentskit.io/docs/reference/recipes/background-agents) |

### 地形学取消

`AgentHandle.run(task, context?, signal?)` 接受与调用上下文分开的取消; 现有的双参数控件仍然兼容. `swarm` 除非 `timeoutMs` 设定,必须是有限度的,大于 `0`,且不超过 `2,147,483,647` 毫秒长. 丢弃无效的值 `ConfigError` (单位:千美元)`AK_CONFIG_INVALID`同步 在截止日期前,孩子的信号被中止,并有可选的遗产 `abort` 钩子一次在最优等的基础上被叫来;孩子们必须尊重停止工作的信号. 如果所有成员都失败, `swarm` 掷出 `RuntimeError` (单位:千美元)`AK_RUNTIME_DELEGATE_FAILED`第一种失败是其原因,包括: `NetError` (单位:千美元)`AK_NET_TIMEOUT`期限。 忽略取消的儿童在群起返回后可能会继续.

## 生态系统

| 软件包 | 作用 |
| --- | --- |
| [@ agentskit/ 核心](https://www.npmjs.com/package/@agentskit/core) | `createRuntime` 合同, `Retriever` |
| [@ agentskit/ 适应器](https://www.npmjs.com/package/@agentskit/adapters) | LLM 适配器 |
| [@ agentskit/ 工具](https://www.npmjs.com/package/@agentskit/tools) | 工具模块 |
| [@ agentskit/ 技能](https://www.npmjs.com/package/@agentskit/skills) | 预建技能 |
| [@ agentskit/ 擦伤](https://www.npmjs.com/package/@agentskit/rag) | `retriever` 用于上下文注入 |

## 贡献者

[![AgentsKit contributors](https://contrib.rocks/image?repo=AgentsKit-io/agentskit)](https://github.com/AgentsKit-io/agentskit/graphs/contributors)

## 许可证

麻省理工学院——见 [自由主义](https://npmcn.com/package/LICENSE)。 。 。 .

## 文档

[完整文档](https://www.agentskit.io/) • 妇女 [GitHub 图像](https://github.com/AgentsKit-io/agentskit)

## 成熟性和相容性

-   稳定性: **β 语录** 看到了吗 [文件/服务.md](https://npmcn.com/package/docs/STABILITY.md)
-   **节点.js 20+** 财务报告和审定财务报表 **类型脚本** 严格模式
-   发表于 `@agentskit/runtime`

## 捐款

见 [捐款额](https://npmcn.com/package/CONTRIBUTING.md) 单曲 [自由主义](https://npmcn.com/package/LICENSE)。 。 。 .

## 常见问题

### @agentskit/runtime 是什么？

独立代理运行时间 \.

### 如何安装 @agentskit/runtime？

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

### @agentskit/runtime 支持 TypeScript 吗？

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

### @agentskit/runtime 支持 ESM 还是 CommonJS？

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

### @agentskit/runtime 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20\.19。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @agentskit/runtime 可以商用吗？

@agentskit/runtime 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @agentskit/runtime 的下载量有多少？

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

### @agentskit/runtime 还在维护吗？

最新版本 0\.11\.3 发布于 2026/10/24（12 天前）；至今共发布 40 个版本，其中过去 12 个月发布了 40 个；首次发布于 2026/04/06。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。