# @agent-assistant/coordination 中文文档

规范地址：https://npmcn.com/package/%40agent-assistant/coordination/

版本：0\.4\.37
npm 元数据更新时间：2026-10-04T06:39:04.293Z
中文译文更新时间：2026-11-05T19:30:17.400Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：59.7 kB，18 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：2 个
- 首次发布：2026-04-13T20:26:02.348Z
- 最新版本发布：2026-10-04T06:39:03.945Z
- 近 30 天下载量：36542（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：59（近 12 个月 59 个）

## 中文简介

代理助理SDK的最小协调员、专家登记、授权和综合运行时间

## 安装

```sh
npm install @agent-assistant/coordination
```

也可以使用：`pnpm add @agent-assistant/coordination`、`yarn add @agent-assistant/coordination`、`bun add @agent-assistant/coordination`

## README

# `@agent-assistant/coordination`

`@agent-assistant/coordination` 执行代理助理SDK的限值 v1 多个代理- 1 助理运行时间。 它提供专家登记册、代表团计划审定、依次协调执行、综合帮助和与 `@agent-assistant/connectivity` 交易、冲突和升级.

## 范围

此软件包拥有 :

-   专家登记和查询
-   a. 代表团计划的审定和有限度的执行
-   一个记忆协调回合的协调员生命周期
-   将多种专家产出综合为一个辅助成果
-   在授权期间使用互联互通信号而不自行接管互联互通

此软件包不拥有 :

-   路线政策或模式选择
-   内存检索或持久性
-   表面格式化或交付
-   运输、中继广播、队列或跨进程管弦
-   特定产品专家分类或调度热量

## 安装形状

软件包为 TypeScript- first 并建为 `dist/`。 。 。 .

```ts
import {
  createCoordinator,
  createDelegationPlan,
  createSpecialistRegistry,
  createSynthesizer,
  validateDelegationPlan,
} from '@agent-assistant/coordination';
```

## 核心概念

### 专家登记册

产品登记自己的专家。 软件包只执行独有性和取景.

```ts
const registry = createSpecialistRegistry();

registry.register({
  name: 'researcher',
  description: 'Collects relevant evidence',
  capabilities: ['research'],
  handler: {
    async execute(instruction, context) {
      return {
        specialistName: 'researcher',
        output: `Evidence for: ${instruction}`,
        status: 'complete',
      };
    },
  },
});
```

### 代表团计划

五一计划按顺序下达.

`createDelegationPlan()` 是一个验证厂: 如果结构无效, 它会丢弃 或如果任何步骤提到一位身份不明的注册专家。 如果产品需要 在登记人口之前构建一个计划,它可以构建原始的 `DelegationPlan` 对象和呼叫 `validateDelegationPlan()` 等会.

```ts
const plan = createDelegationPlan(
  {
    intent: 'produce one coherent answer',
    steps: [
      { specialistName: 'researcher', instruction: 'gather evidence' },
      { specialistName: 'writer', instruction: 'write final answer' },
    ],
  },
  registry,
);
```

### 协调员

协调员验证计划,按顺序执行每个步骤,在转向线上观察连接信号,并合成一个最终输出.

```ts
import { createConnectivityLayer } from '@agent-assistant/connectivity';

const connectivity = createConnectivityLayer();

const coordinator = createCoordinator({
  registry,
  connectivity,
  synthesis: { strategy: 'last-wins' },
});

const turn = await coordinator.execute(plan);
console.log(turn.output.text);
```

## 连接边界

协调取决于 `@agent-assistant/connectivity` 仅作为信号底物.

协调与连通性有何关系:

-   将连接层传送到每个专家背景
-   向计划参与者逐一登记选定的观众解析器
-   观测到倒转信号,例如: `handoff.ready`, (中文(简体) ), `confidence.blocker`, (中文(简体) ), `conflict.active`,以及 `escalation.interrupt`
-   在合成或协调动作后解决消耗性信号
-   曝光返回协调回合上观察到的信号集

协调不起作用的是:

-   选择路由模式
-   导入或调用路由软件包
-   自动传送信号
-   消费者提供的记忆层外的持续信号历史

## 例行整合

协调可以通过 `createCoordinator({ router, ... })`。 。 。 .

当路由器存在时 :

-   每个专家步骤都收到 `context.routingDecision`
-   返回的转弯可能包括 `turn.routingDecisions`
-   专家报告 `metadata.cost` 每个线程记录到路由器

当前 v1 限制 :

-   协调尚未通过 `activeEscalations` 输入 `router.decide()`因此,升级路径仍然是有文件记载的v1缺口,而不是完全的端到端流

## 综述

v1包括三种合成模式:

-   `concatenate`
-   `last-wins`
-   `custom`

`custom` 需要一个函数,并保持产品特定产出在软件包核心外的形状.

## 失败模式

v1 执行故意简单:

-   步骤依次运行
-   可选步骤失败被跳过并降低输出质量而不是中止整个转弯
-   `confidence.blocker` 财务报告和审定财务报表 `escalation.interrupt` 停止转弯
-   未解决的冲突会降低合成质量,但不引入路径或政策所有权

## 发展

走进去 `packages/coordination`数字 :

```sh
npm install
npm test
npm run build
```

测试套间包括45个测试,分为五组:

-   专家登记册(7个测试):重复拒绝、防御性副本、空名或白名、未登记/格特边缘案件
-   授权计划验证(7个测试):空心、步骤、指示和专家名称处理;多高度积累; `maxSteps`; 复制隔离
-   综合战略(8个测试):结对、最后赢取、习惯、质量下降和失败排除
-   协调器生命周期和信号处理(13个测试):顺序交接、可选和要求步骤故障、阻断器停止、冲突跟踪、, `turnId` 前缀, `offSignal` 清理, `advanceStep`,选择的观众解析器
-   路由集成(10个测试):每步模式选择,成本积累,天花板执行,以及无路由器回落

协调 包接 已模拟

## 常见问题

### @agent-assistant/coordination 是什么？

代理助理SDK的最小协调员、专家登记、授权和综合运行时间

### 如何安装 @agent-assistant/coordination？

在项目目录运行 npm install @agent-assistant/coordination，或使用 pnpm add / yarn add / bun add。

### @agent-assistant/coordination 支持 TypeScript 吗？

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

### @agent-assistant/coordination 支持 ESM 还是 CommonJS？

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

### @agent-assistant/coordination 可以商用吗？

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

### @agent-assistant/coordination 的下载量有多少？

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

### @agent-assistant/coordination 还在维护吗？

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