派遣 / タスクAgent

複雑なマルチステップタスクを自律サブAgentにバックグラウンドで委託できます。タスク実行中もチャットを続けられます。

仕組み

タスクAgentは ReActループ を使用します — 考え、ツールを選び、結果を観察し、繰り返す。タスクが完了またはエラーになるまで続きます。利用可能なツール：

• file_read / file_write / file_list — ローカルファイルの読み書き
• shell_exec — シェルコマンド実行（厳格モードではホワイトリスト制限あり）
• grep — コードやファイル内容の検索
• ask_user — タスク途中で一時停止してあなたに質問

2ステップフロー

タスクは常に プレビュー → 確認 → 実行 の流れで進みます：

Step 1 — プレビュー

チャットで以下のトリガーワードを含めると派遣モードが起動します：

言語	トリガーワード
日本語	派遣モード、派遣して、派遣タスク、派遣に
中国語	外包模式、外包任务、帮我外包、外包给你
英語	outsource mode、outsource this、delegate to agent、run as task、use task agent

例：

"派遣して：プロジェクト構造をスキャンしてREADMEを生成して"

Agentが dispatch_task（action=preview）を呼び出し、ステップごとの実行計画を生成してあなたに確認を求めます。

Step 2 — 確認

「はい」「開始」などと返信します。Agentが action=start を呼び出し、バックグラウンドで実行が始まります。

実行中も引き続きチャットできます。

進捗の確認

Webダッシュボードで /outsource を開くと以下が確認できます：

• 全タスクのステータス（実行中・完了・失敗・キャンセル）
• リアルタイムのステップバイステップ実行ログ
• 各ステップで使用したツールのパラメータ（折りたたみ表示）
• 最終結果と変更されたファイルの一覧

ステータスバーのタスクトレイでアクティブなタスク数が常時確認できます。

タスク途中の質問

サブAgentが確認が必要な場合、ask_user ツールで実行を一時停止し、チャットに質問を送ります。チャット画面でそのまま返信するとAgentが自動的に実行を再開します。

厳格モード vs 寛容モード

モード	許可される操作
厳格（デフォルト）	ファイル読み込み、検索、構文チェック、テスト実行。パッケージのインストールは ask_user で明示的な許可が必要。
寛容	上記すべてに加え、pip install、npm install、ホワイトリスト内の任意コマンド。

settings.yaml で設定：

tools:
  dispatch_task:
    enabled: true
    strict_mode: true   # false にすると寛容モード
    max_steps: 20
    max_tokens: 8192

キャンセルと削除

• キャンセル — /outsource ページで実行中のタスクを停止。ステータスは cancelled に設定されます。
• 削除 — ソフトデリート（履歴は保持）。過去の実行ログのデバッグに役立ちます。

一時ファイル

サブAgentはタスク中に作成する一時スクリプトを専用ディレクトリ（/tmp/jkriver_tasks/{task_id}/）に配置するよう指示されています。タスク終了後に自動クリーンアップされます。