# @backendkit-labs/orchestrator-agent 中文文档

规范地址：https://npmcn.com/package/%40backendkit-labs/orchestrator-agent/

版本：0\.7\.2
npm 元数据更新时间：2026-10-27T10:48:30.172Z
中文译文更新时间：2026-11-07T21:04:37.546Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40backendkit-labs/orchestrator-agent
原文对照：https://npmcn.com/package/%40backendkit-labs/orchestrator-agent/?lang=original
项目主页：https://github.com/BackendKit-labs/backendkit-agent-framework#readme
源码仓库：https://github.com/BackendKit-labs/backendkit-agent-framework

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

- 包体积（解压后）：345 kB，97 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=20\.0\.0
- 运行依赖：9 个
- 首次发布：2026-06-13T18:54:30.543Z
- 最新版本发布：2026-10-27T10:48:28.863Z
- 近 30 天下载量：2560（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：25（近 12 个月 25 个）

## 中文简介

由配置驱动的管弦乐器——通过共享金库和可配置的LLM提供者来分解任务和协调专家代理.

## 安装

```sh
npm install @backendkit-labs/orchestrator-agent
```

也可以使用：`pnpm add @backendkit-labs/orchestrator-agent`、`yarn add @backendkit-labs/orchestrator-agent`、`bun add @backendkit-labs/orchestrator-agent`

## README

# @ backendkit-labs/ orchestrator- 代理服务器

为企业工作流程配置驱动多代理管弦. 将自然语言任务分解为分任务,通过共享知识库协调专家代理,并强制实施人大审批门——有完整的审计线索.

## 它会做什么

-   **计划**: 将任务分解成依赖排序计划(静流或LLM生成)
-   **执行**:在依附关系允许时,平行运行步骤,每个步骤委托给专家代理
-   **盖茨**:在关键步骤上,通过配置或积极的政策规则,暂停人力审批
-   **持久性**: 每一次运行被保存到磁盘( 或 Redis) —— 幸存重启, 门批准后恢复运行
-   **学习**:企业反思监测闸门结果并促使一再失败模式成为决定性政策规则
-   **记得**:完成的运行被自动拖入知识库;专家人员从过去成功完成的类似任务中获得零星背景

## 安装

```bash
npm install -g @backendkit-labs/orchestrator-agent
# or as a local dep in a monorepo
npm install @backendkit-labs/orchestrator-agent
```

## 快速启动( 5分钟)

**1\. 创建 `orchestrator.yaml`**

```yaml
version: 1

orchestrator:
  name: "My Orchestrator"
  provider: deepseek

providers:
  deepseek:
    api_key: ${DEEPSEEK_API_KEY}
    base_url: https://api.deepseek.com/v1
    model: deepseek-chat

agents:
  - id: analyst
    name: Data Analyst
    description: Analyzes data and produces reports
    capabilities: [analysis, reporting, metrics]
    provider: deepseek

  - id: writer
    name: Technical Writer
    description: Writes documents and summaries
    capabilities: [writing, documentation, summaries]
    provider: deepseek
```

**2\. 创建 `.env`**

```
DEEPSEEK_API_KEY=sk-...
```

**3\. 连接克洛德桌面** (单位:千美元)`claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "orchestrator": {
      "command": "npx",
      "args": ["-y", "@backendkit-labs/orchestrator-agent"],
      "env": {
        "DEEPSEEK_API_KEY": "sk-..."
      }
    }
  }
}
```

**4\. 执行任务** (克劳德桌面):

```
orchestrator_run
  config_path: /path/to/orchestrator.yaml
  task: "Analyze Q1 sales data and write an executive summary"
```

## 特征概述

| 特性 | 说明 |
| --- | --- |
| **动态规划** | LLM 将任何任务分解为依附计划 |
| **静态流动** | 通过regex或 `flow_id` |
| **并行执行** | 独立步骤同时运行`Promise.all`(中文(简体) ) |
| **人间大门** | 暂停审批的步骤——可配置的每名代理人或每分步骤 |
| **政策规则(电话2)** | 活动规则自动闸口匹配步骤——不涉及LLM |
| **兰斯DB RAG** | 以 ANN 搜索进行递增金库索引, 速度快 |
| **红色 + 公牛MQ** | 生产过程的分工 |
| **HTTP 触发器** | N8n/外部系统集成的 REST 端点 |
| **企业反思** | MAPE-K:监测结果 · 促进模式 · 执行规则 |
| **运行合并** | 完成的运行 由 LLM 自动拖入金库 —— 偶发 —— 语义循环 |
| **交叉运行的瞬间记忆** | 代理人在类似情况下获得以往的成功产出 |
| **忘记曲线** | 按关联性( recency × reception 频率), 而不仅仅是年龄来表示记忆回流 |

## MCP 工具

| 工具 | 说明 |
| --- | --- |
| `orchestrator_run` | 开始任务——返回 `runId` 马上 |
| `orchestrator_status` | 投票情况 `runId` |
| `orchestrator_approve` | 批准或拒绝等待门 |
| `orchestrator_list_runs` | 列出所有持续运行 |
| `orchestrator_list_agents` | 显示配置的代理 |
| `orchestrator_reflect` | 查看待晋升、现行规则、降级候选人 |
| `orchestrator_reflect_promote` | 核准或拒绝促进政策规则的模式 |
| `orchestrator_reflect_demote` | 废除有审计线索的政策规则 |

## 文档

-   [配置参考](https://npmcn.com/package/%40backendkit-labs/orchestrator-agent/docs/config-reference.md) ——满 `orchestrator.yaml` 计划
-   [MCP工具](https://npmcn.com/package/%40backendkit-labs/orchestrator-agent/docs/mcp-tools.md) - 所有8个工具的参数、实例和答复
-   [静态流动](https://npmcn.com/package/%40backendkit-labs/orchestrator-agent/docs/static-flows.md) ——YAML流量格式,有效载荷内插,自动检测
-   [门户和政策](https://npmcn.com/package/%40backendkit-labs/orchestrator-agent/docs/gates-and-policies.md) - 人类批准,2号线自动闸门
-   [HTTP 触发器](https://npmcn.com/package/%40backendkit-labs/orchestrator-agent/docs/http-trigger.md) 用于n8n和外部系统的REST API
-   [Redis + 工人数](https://npmcn.com/package/%40backendkit-labs/orchestrator-agent/docs/redis-workers.md) - 与BullMQ一起进行分布式处决
-   [RAG 保险库](https://npmcn.com/package/%40backendkit-labs/orchestrator-agent/docs/rag-vault.md) ——兰斯DB指数化,运行整合,交叉运行的中枢注射
-   [企业反思](https://npmcn.com/package/%40backendkit-labs/orchestrator-agent/docs/reflection.md) ——MAPE-K循环,晋级,降级
-   [内存系统](https://npmcn.com/package/%40backendkit-labs/orchestrator-agent/docs/memory-system.md) ——全结构:平面,语义,程序,遗忘曲线

## 数据目录

默认情况下, 运行状态和 RAG 索引会存在 `.orchestrator/` 邻接您的 `orchestrator.yaml`数字 :

```
.orchestrator/
  runs/           ← JSON run files (one per run)
  rag-lance/      ← LanceDB vector index
```

覆盖 `ORCHESTRATOR_DATA_DIR` 环境 var 或 `data_dir` 在YAML中.

## 许可证

麻省理工学院

## 常见问题

### @backendkit-labs/orchestrator-agent 是什么？

由配置驱动的管弦乐器——通过共享金库和可配置的LLM提供者来分解任务和协调专家代理\.

### 如何安装 @backendkit-labs/orchestrator-agent？

在项目目录运行 npm install @backendkit-labs/orchestrator-agent，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 orchestrator-agent、orchestrator-worker，可以用 npx orchestrator-agent 直接运行。

### @backendkit-labs/orchestrator-agent 支持 TypeScript 吗？

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

### @backendkit-labs/orchestrator-agent 支持 ESM 还是 CommonJS？

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

### @backendkit-labs/orchestrator-agent 需要什么版本的 Node\.js？

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

### @backendkit-labs/orchestrator-agent 可以商用吗？

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

### @backendkit-labs/orchestrator-agent 的下载量有多少？

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

### @backendkit-labs/orchestrator-agent 还在维护吗？

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