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" } } です。一覧には1ページ分が表示されます。すべての項目を取得するには --all を追加してください。便利なフィールドは次のとおりです。

• role_name：表示名（変更可能）。
• slug：run-ai-employee に必要な固定識別子です。名前を変更しても変わりません。
• status：active（稼働中）、paused（稼働していたが一時停止中）、draft（保存済みだが未稼働）、superseded（置き換え済み）。
• identity、overview：その従業員が何をするのかを平易な言葉で示します。

生の JSON ではなく、親しみやすい一覧として提示してください。「従業員が2人います：Weekly Recap Writer（稼働中、金曜日に実行）と Guest Responder（稼働中）。」

一時停止、再開、名前変更、編集

update-dozal には、一覧から取得したアーキタイプ 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

順に、接続済みのもの、修正が必要なもの、各アプリとその状態が表示されます。

接続は2段階で行い、2段階目は人間が操作します。まず接続を開始すると 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 は1件の実行の費用を、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 のエンベロープを返します。1件の実行の出力やログを確認するには、その id を使って monitor-and-review-ai-employee-work を使用してください。

従業員の削除

delete-dozal は復元可能な論理削除です。実行する前に、必ず人間に確認してください。通常は、まず一時停止するほうが適切です。

dozaldevs delete-dozal "$DOZAL"