run-ai-employee

AI 従業員を実行する

既存の AI 従業員の作業を開始します。作業はクラウドで実行され、数分かかるため、このスキルは開始して引き継ぐ方式です。作業を開始し、タスク ID を人間に伝えたら、あとは人間が確認するのを待ちます。ポーリングループで待ち続けてはいけません。

前提条件：まず operate-ai-employees を読み込んでください。これにより、dozaldevs CLI とキーが設定されます。また、従業員の slug（role_name とは異なる安定した識別子。role_name は表示名のみ）が必要です。slug がわからない場合は、先に従業員を見つけてください（manage-ai-employees）。実行するには、キーに Member レベル以上の権限が必要です。

正確なリクエスト本文と回答については、dozaldevs run-dozal --help と ../operate-ai-employees/references/customer-api.md を参照してください。

実行条件

従業員が入力を必要としない場合は、データは不要です。空の本文が送信されます。

dozaldevs run-dozal "$SLUG"

入力が必要な場合は、値の代わりにシェル変数を使い、キーを指定して渡します。

dozaldevs run-dozal "$SLUG" --data inputs.topic="$TOPIC"

• 202 が返された場合は、task_id と status_url が含まれています。task_id を保存してください。
• deduped: true を含む 200 は、同じトリガーをすでに受信しており、新しい処理は開始されなかったことを意味します。
• 必須入力が不足している場合は、不足している項目の一覧を missing に含む 422 MISSING_REQUIRED_INPUTS が返されます。人間にそれらの値を尋ねてから、再試行してください。
• 400 MISSING_CONNECTION は、従業員が必要とするアプリが接続されていないことを意味します。402 PAYMENT_REQUIRED は、現在アカウントで作業を実行できないことを意味します。人間に伝えてください。どちらも人間が解決します。

ドライランで事前に確認する

--dry_run true を指定すると、何も開始せずにトリガーを確認できます。必須入力を把握するとき（422 に一覧が表示されます）や、リストから何件の実行が開始されるかを確認するときに使います。

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

1 行につき 1 回実行

入力を 1 つのリストとして受け取り、各行について実行を開始する従業員もいます。その場合の 202 には、行ごとに 1 つの task_id を含む runs リストと、開始されなかった行を示す failures リストが含まれます。各実行と各失敗を人間に報告してください。上限を超えるリストは事前に 422 TOO_MANY_ITEMS で拒否され、ドライランでは run_count が返されるので、先に確認できます。従業員をこのように設定する方法については、../operate-ai-employees/references/customer-api.md の「1 行につき 1 回実行」セクションを参照してください。

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

人間への伝え方（開始して引き継ぐ）

完了を待たず、すぐに返信してください。

「開始しました！Weekly Recap Writer が作業中です（タスク a1b2c3d4）。通常、数分で完了します。いつでも『要約はできた？』と聞いてください。確認します。」

その後は停止してください。確認するタイミングは人間が決めます。

後から確認する

人間から完了したか聞かれたら、monitor-and-review-ai-employee-work を読み込み、task_id を使ってステータスを 1 回確認してください。完了まで待ちたい場合の方法も、そのスキルで説明しています。

入力

キーは従業員によって定義されています。人間の依頼から入力がわかる場合（「先週分の要約を実行して」など）は、その値を渡してください：--data inputs.report_date="$REPORT_DATE"。どの入力があるかわからない場合は、先にドライランを実行してください。