manage-ai-employees

管理 AI 员工

此处列出并管理人类现有的 AI 员工及相关账户。

前提：先加载 operate-ai-employees。它会设置 dozaldevs CLI 和密钥，并说明级别、分页和错误。

CLI 会为每次调用填入组织信息。要查看命令的参数和请求正文，请运行 dozaldevs <command> --help。错误代码和概念见：../operate-ai-employees/references/customer-api.md。此文件仅介绍无法从规范中直接读出的行为。

列出员工

dozaldevs list-dozals

响应为 { "items": [...], "page": { "next_cursor", "limit", "has_more" } }。列表只显示一页；添加 --all 可获取所有项目。常用字段：

• role_name：显示名称（可重命名）。
• slug：run-ai-employee 所需的稳定标识符。即使重命名，它也不会改变。
• status：active（正在运行）、paused（曾运行，暂时停用）、draft（已保存，从未启用）、superseded（已被替代）。
• identity、overview：以通俗语言说明它是什么。

请用友好的方式展示员工列表，而不是原始 JSON：“你有 2 名员工：Weekly Recap Writer（active，每周五运行）和 Guest Responder（active）。”

暂停、重新启用、重命名、编辑

update-dozal 使用列表中的 archetype UUID（而非名称），并需要 Admin 权限。暂停会保留其“曾运行”的身份；暂停的员工不会运行，即使到了计划时间也不会运行。对于正在运行的员工，请使用 paused，不要使用 draft。

dozaldevs update-dozal "$DOZAL" --data status=paused

使用 --data status=active 重新启用；此操作会重新检查连接。

每次内容编辑都会增加 Dozal 的 version，且必须传入当前版本作为 base_version（否则返回 400 BASE_VERSION_REQUIRED）：

dozaldevs list-dozals --id "$DOZAL" --field items[0].version
dozaldevs update-dozal "$DOZAL" --data role_name="$NEW_NAME" --data base_version:="$VERSION"

如果期间有人修改过，返回 409 VERSION_CONFLICT：重新读取并重做你的修改。恢复更改和更新模板也需要 base_version；仅更新状态则不需要。批准或拒绝建议的清理操作不需要版本；409 SUGGESTION_OUT_OF_DATE 表示该建议已撤回：重新读取，不要重试。

每次保存都会返回 changes，说明实际发生了哪些更改；请以此为准，而不要重新读取。先测试更新：--validate_only true。关于 update-dozal 能更改的字段、查看已告知的内容以及撤销操作，请参见 references/checking-and-undoing.md。

要更改员工实际执行的工作（“让摘要更短”“也发布到 Slack”），请使用 hire-ai-employee 中介绍的 Hiring Dozal 编辑聊天：

dozaldevs start-hiring-chat --data kind=edit --data archetype_id="$DOZAL"

聊天显示更改已完成（presented 为 true，open_questions 为空）后，向人类说明将要更改的内容；对方表示“是”后，使用聊天当前的 turn_seq 保存更改。在此之前，正在运行的员工不会发生任何变化。

dozaldevs apply-hiring-chat "$CHAT" --data turn_seq:="$TURN_SEQ"

应用时出现 409 VERSION_CONFLICT 表示它在其他地方发生了更改：运行 restart-hiring-chat 以获取最新内容。

连接

dozaldevs list-integrations
dozaldevs list-integrations-needing-attention
dozaldevs list-app-connections

依次显示：已连接的项目、需要修复的项目，以及各应用及其健康状态。

连接分两步，第二步需要由真人完成。先启动连接，这会返回一个 url。将其提供给人类，由对方打开并批准。然后运行 list-integrations 查看连接状态。确认连接成功后，才能声称操作已完成。

dozaldevs start-app-connection --toolkit "$APP" --field url
dozaldevs start-slack-install
dozaldevs start-github-install

GitHub 的“关联已有安装”需要由真人操作（403 PERSON_ONLY）。断开任何连接前都要先确认，因为使用该连接的员工会停止工作。

计划安排

dozaldevs list-schedules
dozaldevs get-dozal-schedule "$DOZAL"

依次显示：已安排的员工及其下一次运行时间，以及某名员工的下一次和上一次运行时间。要更改时间安排，请按上述说明编辑员工。run-schedule-now（接收员工的 $SLUG）会立即启动下一次计划运行；resume-dozal-schedule 会在计划员工因多次失败而暂停后重新启用。请先查明失败原因（monitor-and-review-ai-employee-work）。

dozaldevs run-schedule-now "$SLUG"
dozaldevs resume-dozal-schedule "$DOZAL"

交接

交接会让一名员工在完成工作后启动另一名员工。get-handoff-graph 显示整个工作流，list-dozal-handoffs 显示某名员工的交接。请明确说明由哪名员工启动哪名员工。

dozaldevs get-handoff-graph
dozaldevs list-dozal-handoffs "$DOZAL"
dozaldevs create-handoff --data upstream_archetype_id="$UPSTREAM" --data downstream_archetype_id="$DOWNSTREAM"
dozaldevs update-handoff "$HANDOFF" --data status=inactive
dozaldevs delete-handoff "$HANDOFF"

update-handoff 可将一项交接设为 active 或 inactive；delete-handoff 会将其删除。

成员和邀请

dozaldevs list-members
dozaldevs list-invitations
dozaldevs revoke-invitation "$INVITATION"

revoke-invitation 会取消待处理的邀请。密钥无法邀请任何人，也无法更改或移除成员（403 API_KEY_NOT_ALLOWED）：请告知相关人员在控制面板中操作。

使用量和账单

仅供读取。get-cost 显示组织在日期范围内被收取的费用（--from ... --to ...）；list-run-costs 显示各次运行及其费用；get-run-cost 显示单次运行的费用；get-billing 显示余额和状态。按原样报告数值。付款、购买额度、管理账单账户以及在账户间转移组织，必须由人员操作（PERSON_ONLY 或 API_KEY_NOT_ALLOWED）。

dozaldevs get-cost --from "$FROM" --to "$TO"
dozaldevs list-run-costs --from "$FROM" --to "$TO"
dozaldevs get-run-cost "$TASK"
dozaldevs get-billing

查看近期运行

dozaldevs list-tasks --limit 10

它会返回相同的 items 和 page 信封。若要查看某次运行的输出或日志，请使用 monitor-and-review-ai-employee-work 并提供其 id。

移除员工

delete-dozal 是可恢复的软删除。请先征得相关人员同意。通常，暂停是更好的第一步。

dozaldevs delete-dozal "$DOZAL"