mcpField
R
run-ai-employee

run-ai-employee

github.com/dozaldevsAgent 工作流012 次安装今天更新
代码仓库

关于 run-ai-employee

通过 `dozaldevs` 命令行启动现有 AI Employee 的技能，适用于需要传入任务信息或检查运行条件的操作者。员工在云端执行，技能会返回任务 ID，由操作者稍后查询。

主要功能

  1. 01使用员工 slug 启动任务
  2. 02为运行传入输入
  3. 03通过试运行检查要求
  4. 04处理逐行运行及失败项
  5. 05返回任务 ID 而不等待完成

适用场景

  1. 01使用提供的任务详情运行员工
  2. 02启动前检查必需输入
  3. 03根据列表项目分别启动运行

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/dozaldevs/dozaldevs-skills --skill run-ai-employee

安装后在 Claude Code 中输入/run-ai-employee确认已加载。

详细介绍

运行 AI 员工

这会让一个现有的 AI 员工开始工作。工作在云端运行，需要几分钟，因此此技能采用启动后交由用户处理的方式：启动任务，把任务 ID 告知用户，然后让用户之后再来查看。你绝不要陷入轮询循环。

前提：先加载 operate-ai-employees。它会设置 dozaldevs CLI 和密钥。你还需要员工的 slug（稳定标识符，与仅用作显示名称的 role_name 不同）。如果不知道 slug，先查找该员工（manage-ai-employees）。密钥需要达到 Member 级别或更高才能运行员工。

请求正文和答复的确切内容：dozaldevs run-dozal --help 和 ../operate-ai-employees/references/customer-api.md。

触发

不需要输入的员工无需数据；系统会为你发送空正文：

dozaldevs run-dozal "$SLUG"

需要输入时，按键传入，并用 shell 变量代替具体值：

dozaldevs run-dozal "$SLUG" --data inputs.topic="$TOPIC"
  • 202 会返回 task_id 和 status_url。保留 task_id。
  • 200 且 deduped: true 表示已收到相同的触发请求，因此没有启动新的任务。
  • 缺少必填输入时，会返回 422 MISSING_REQUIRED_INPUTS，并在 missing 中列出缺少的输入。向用户询问这些值，然后重试。
  • 400 MISSING_CONNECTION 表示员工需要的某个应用尚未连接。402 PAYMENT_REQUIRED 表示账户目前无法运行任务。告知用户；这两种情况都需要由人工处理。

先进行试运行

--dry_run true 会检查触发请求，但不会启动任何任务。用它来了解哪些输入是必填的（422 会列出这些输入），或一份列表会启动多少次运行：

dozaldevs run-dozal "$SLUG" --dry_run true

每行运行一次

有些员工会将列表作为一个输入，并为每一行启动一次运行。此类请求的 202 会包含一个 runs 列表（每行对应一个 task_id）以及一个 failures 列表，列出未能启动的行。向用户报告每次运行和每项失败。超过限制的列表会直接被拒绝，并返回 422 TOO_MANY_ITEMS；试运行则会返回 run_count，供你预先检查。有关如何将员工设置为这种模式，请参阅 ../operate-ai-employees/references/customer-api.md 中的“One run per line”一节。

dozaldevs run-dozal "$SLUG" --data inputs.addresses="$ADDRESSES"

告知用户的内容（启动后交由用户处理）

立即回复，绝不要等待任务完成：

“已启动！你的 Weekly Recap Writer 正在处理（任务 a1b2c3d4）。通常需要几分钟。随时可以问我‘总结写好了吗？’，我会检查。”

然后停止。由用户决定何时查看。

稍后检查

用户询问任务是否完成时，加载 monitor-and-review-ai-employee-work，并使用 task_id 调用一次状态查询。如果用户希望等待完成，该技能会说明具体方法。

输入

这些键由员工定义。如果用户的请求隐含了某个输入（例如“运行上周的总结”），就传入该输入：--data inputs.report_date="$REPORT_DATE"。不确定有哪些输入？先进行试运行。

评论

支持 Markdown