@ agentworkforce/ workload- routter (英语)

安排和介绍劳动力代理工作量的公用事业.

安装

npm install @agentworkforce/workload-router

使用量

usePersona(intent, options?)

虽然 use* 前缀, 这不是一个反应钩. 这是一个平地 同步工厂:叫它,拿回来 PersonaContext 捆绑 已解决的人a 并分组安装元数据。 没有安装, 产出,或写入磁盘——运行 install.commandString 自己何时 你准备实现人的技能.

usePersona 只解决内部内置目录( e)persona-maker 编号 : persona-authoring) (中文(简体) ). 可选个人,例如: code-reviewer 财务报告和审定财务报表 frontend-implementer 通过可安装人a包和 应通过CLI/源级联装入,然后传递到 useSelection 或者说 materializeSkillsFor。 。 。 .

import { usePersona } from '@agentworkforce/workload-router';

返回形状

const { selection, install } = usePersona('persona-authoring');

• selection: 给定的意向/特征的解析对象。 包括 personaId, (中文(简体) ), tier, (中文(简体) ), runtime, (中文(简体) ), skills, (中文(简体) ), inputs, (中文(简体) ), mount,以及 rationale。 。 。 .
• install: 分组安装元数据.
• install.plan(笑声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) 当您读到此内容时, 没有进程运行 .
• install.command: 完全安装命令作为 argv 阵列用于 spawn编号 :execFile。 。 。 .
• install.commandString: 与外壳逃避字符串相同的完整安装命令.
• install.cleanupCommand 编号 : install.cleanupCommandString(单位:千美元) rm -rf 提供商在安装时散开(提供商的锁被故意保存), 对于空的图案,这是空壳 :) (中文(简体) ). 等经纪人消耗了这些技能后再运行.

示例

import { spawnSync } from 'node:child_process';
import { usePersona } from '@agentworkforce/workload-router';

const { selection, install } = usePersona('persona-authoring');

spawnSync(install.commandString, { shell: true, stdio: 'inherit' });
// hand `selection` to your harness launcher of choice.

人物形状

个人可以声明快速可见的运行时间输入 :

{
  "id": "release-checker",
  "intent": "release-check",
  "tags": ["release"],
  "description": "Checks release readiness.",
  "skills": [],
  "inputs": {
    "PACKAGE_NAME": {
      "description": "Package or workspace to inspect.",
      "env": "PACKAGE_NAME",
      "default": "."
    },
    "REPORT_PATH": "release-report.md"
  },
  "mount": {
    "readonlyPatterns": ["*", "!docs/**"]
  },
  "tiers": {
    "best": {
      "harness": "codex",
      "model": "openai-codex/gpt-5.3-codex",
      "systemPrompt": "Check $PACKAGE_NAME and write ${REPORT_PATH}.",
      "harnessSettings": {
        "reasoning": "high",
        "timeoutSeconds": 1200,
        "sandboxMode": "workspace-write",
        "workspaceWriteNetworkAccess": true
      }
    }
    // best-value and minimum omitted in this fragment
  }
}

输入键必须是env风格的大写名. 路由器验证并携带 b. 通过《公约》作出的声明 PersonaSpec 财务报告和审定财务报表 PersonaSelection; 发射器决定 如何解决和制造它们。 标准人物 kit 政策是明确的 值, env var, 默认, 然后失败 .

代码运行时间也可能设置 harnessSettings.sandboxMode, (中文(简体) ), harnessSettings.approvalPolicy, (中文(简体) ), harnessSettings.workspaceWriteNetworkAccess,以及 harnessSettings.webSearch;人物-kit 将那些地图映射到 Codex 发射旗上.

发展

pnpm --filter @agentworkforce/workload-router build
pnpm --filter @agentworkforce/workload-router test