@agent-assistant/coordination
@agent-assistant/coordination 执行代理助理SDK的限值 v1 多个代理- 1 助理运行时间。 它提供专家登记册、代表团计划审定、依次协调执行、综合帮助和与 @agent-assistant/connectivity 交易、冲突和升级.
范围
此软件包拥有 :
- 专家登记和查询
- a. 代表团计划的审定和有限度的执行
- 一个记忆协调回合的协调员生命周期
- 将多种专家产出综合为一个辅助成果
- 在授权期间使用互联互通信号而不自行接管互联互通
此软件包不拥有 :
- 路线政策或模式选择
- 内存检索或持久性
- 表面格式化或交付
- 运输、中继广播、队列或跨进程管弦
- 特定产品专家分类或调度热量
安装形状
软件包为 TypeScript- first 并建为 dist/。 。 。 .
import {
createCoordinator,
createDelegationPlan,
createSpecialistRegistry,
createSynthesizer,
validateDelegationPlan,
} from '@agent-assistant/coordination';
核心概念
专家登记册
产品登记自己的专家。 软件包只执行独有性和取景.
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() 等会.
const plan = createDelegationPlan(
{
intent: 'produce one coherent answer',
steps: [
{ specialistName: 'researcher', instruction: 'gather evidence' },
{ specialistName: 'writer', instruction: 'write final answer' },
],
},
registry,
);
协调员
协调员验证计划,按顺序执行每个步骤,在转向线上观察连接信号,并合成一个最终输出.
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包括三种合成模式:
concatenatelast-winscustom
custom 需要一个函数,并保持产品特定产出在软件包核心外的形状.
失败模式
v1 执行故意简单:
- 步骤依次运行
- 可选步骤失败被跳过并降低输出质量而不是中止整个转弯
confidence.blocker财务报告和审定财务报表escalation.interrupt停止转弯- 未解决的冲突会降低合成质量,但不引入路径或政策所有权
发展
走进去 packages/coordination数字 :
npm install
npm test
npm run build
测试套间包括45个测试,分为五组:
- 专家登记册(7个测试):重复拒绝、防御性副本、空名或白名、未登记/格特边缘案件
- 授权计划验证(7个测试):空心、步骤、指示和专家名称处理;多高度积累;
maxSteps; 复制隔离 - 综合战略(8个测试):结对、最后赢取、习惯、质量下降和失败排除
- 协调器生命周期和信号处理(13个测试):顺序交接、可选和要求步骤故障、阻断器停止、冲突跟踪、,
turnId前缀,offSignal清理,advanceStep,选择的观众解析器 - 路由集成(10个测试):每步模式选择,成本积累,天花板执行,以及无路由器回落
协调 包接 已模拟