hire-ai-employee について
プラットフォームの Hiring Dozal との対話で AI 従業員を設定するスキルです。要件や選択肢を確認し、草稿を提示して人の確認後に従業員を登録します。
主な機能
- 01設定チャットの開始
- 02要件と選択肢の収集
- 03完成した従業員草稿の提示
- 04人の確認後に登録
- 05設定チャットの再開または破棄
活用シーン
- 01新しい AI 従業員の設定
- 02実行時間と結果の送信先の指定
- 03実行時に承認を求めるか選択
- 04未完了の設定の再開または破棄
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/hire-ai-employeeを入力して読み込まれたか確認します。
詳細
AI 従業員を雇用する
プラットフォーム独自のセットアップアシスタントであるHiring Dozalとチャットして、新しい AI 従業員（Dozal）をセットアップします。質問をしたり、情報を調べたり（どのアプリが接続されているか、どの Slack チャンネルを指しているかなど）、完成した Dozal を表示したりして、最後に雇用します。
前提条件：まず
operate-ai-employeesを読み込んでください。dozaldevsCLI がインストールされ、キーについて説明されています。チャットには Admin 以上のレベルのキーが必要です。下位のキーでは403 FORBIDDENが返されます。
概念とレスポンス形式については、../operate-ai-employees/references/customer-api.md を参照してください。各コマンドの引数を確認するには、dozaldevs <command> --help を実行してください。このスキルでは、チャットの動作のみを説明します。
チャットの仕組み
チャットはサーバー上で動作します。一度開いたら、1 回に 1 つのメッセージを送信します。送信するとすぐに 202 が返され、返信は後から書き込まれます（最初のマシンを起動する必要がある場合は、最大で約 1 分半かかります）。つまり、各ターンでは、送信して、待って、読みます。
- 開く。 チャット ID を保持します。
CHAT=$(dozaldevs start-hiring-chat --data kind=create --field conversation.id)
- 送信する。 現在の
turn_seqを先に読み取り、メッセージとともに送り返します。
SEQ=$(dozaldevs get-hiring-chat "$CHAT" --field turn_seq)
dozaldevs send-hiring-message "$CHAT" --data message="$MESSAGE" --data turn_seq:="$SEQ"
- 待つ。 これを実行し、
trueが表示されている間は繰り返し実行します。ターンが終了するとすぐに、または 80 秒後に停止します。turn_seqが 1 増えていればターンは成功です。そうでない場合は、最後のmessagesエントリにあるerror:trueが理由を示しています。
dozaldevs get-hiring-chat "$CHAT" --while turn_in_progress=true --every 3 --timeout 80 --field turn_in_progress
- 読む。
dozaldevs get-hiring-chat "$CHAT"を実行します。messagesにある新しいアシスタントのエントリと、open_questionsのすべてのエントリを人間に見せます。 - 回答する。 現在の
turn_seqを指定して、次のメッセージを送信します。ボタンの選択は、質問のidをキーにしてanswersに入れます。例：--data answers.q1.option=approval_on、または入力が許可されている場合は--data answers.q2.text="..."。ボタンだけを押す場合は、messageを空にしてもかまいません。
dozaldevs send-hiring-message "$CHAT" --data message="" --data turn_seq:="$SEQ" --data answers.q1.option="$OPTION"
- 準備ができたら停止する：
presentedがtrueで、open_questionsが空であり、draftが設定されている状態です。
実行時期、生成するもの、結果の保存先、使用するアプリを含む、具体的で詳しい最初のメッセージを送ると、通常はすぐに完成した Dozal が提示されます。「ボットを作って」とだけ伝えると、必ず質問されます。準備ができるまで続けてください。最初の質問の後に停止してしまうのが、最もよくある間違いです。
プラットフォームが自ら確認する 3 つの質問
これらには protocol フィールドがあり、ボタンで回答する必要があります。テキストを入力しても回答は変わりません。
protocol | 質問内容 | 選択肢の値 |
|---|---|---|
approval | 「各結果を送信前に表示しますか。それとも、そのまま送信しますか？」 | approval_on（先に見せる）、approval_off（そのまま送信） |
schedule | アプリは新しい項目を一度に通知できないため、Dozal は 15 分ごとに確認します。 | schedule_ok、schedule_talk |
changes_each_run | この値は実行するたびに人間が指定しますか。それとも常に同じ値にしますか？ | each_time、always_same |
それぞれの質問を平易な言葉で伝え、人間自身に選んでもらった選択肢を送信してください。早く終わらせるためであっても、本人に代わって「そのまま送信する」を選んではいけません。
送信が拒否された場合
| コード | 対応 |
|---|---|
409 TURN_IN_PROGRESS | ターンが終わるまで待ってから、送信してください。 |
409 DRAFT_CONTINUED_ELSEWHERE | 誰かがチャットを先に進めています。内容を読み返し、変更点を示してから、メッセージがまだ適切であれば新しい turn_seq で一度だけ再送してください。 |
503 HIRING_BUSY | まだセットアップ用のマシンがありません。1 分待ってから再送してください。 |
409 CONTEXT_FULL | チャットが長くなりすぎています。同じドラフトで新しいチャットを始めるため、下記の手順で再開してください。 |
409 CONVERSATION_CLOSED | チャットはすでに終了しています（details.closed_reason）。新しいチャットを開始してください。 |
503 HIRING_UNAVAILABLE | 現在、チャットによるセットアップは利用できません。人に伝えて、後でもう一度試してください。 |
dozaldevs restart-hiring-chat "$CHAT"
Dozal の採用
draft の内容（名前、何をするか、実行タイミング、結果の保存先、送信前に確認するかどうか）を平易な英語で人に説明し、確認を取ってください。「はい」と答えたら、チャットの現在の turn_seq を送信してください（ステップ 2 の手順で読み取ります）。
dozaldevs hire-from-hiring-chat "$CHAT" --data turn_seq:="$SEQ"
200 は設定が完了し、チャットが終了したことを意味します。拒否された場合は、平易な言葉で理由が返されます（たとえば、アプリを接続する必要がある場合は 400 MISSING_CONNECTION）。人に必要な対応を伝えてから、チャットを続けるか、再度採用してください。不足しているものが接続の場合、開始すると人だけが開けるリンクが返されます（operate-ai-employees を参照）。
セットアップを破棄するには：
dozaldevs discard-hiring-chat "$CHAT"
採用された Dozal の ID は、チャット上の archetype_id です。そのスラッグは、実行時に使う固定の名前です。
DOZAL=$(dozaldevs get-hiring-chat "$CHAT" --field archetype_id)
dozaldevs list-dozals --id "$DOZAL" --field items[0].slug
採用後
稼働中であることを人に伝え、実行するかどうかを尋ねてください。「セットアップが完了しました！どのような動きをするか確認できるよう、今すぐ実行してみますか？」その後、run-ai-employee を読み込んでください。