コンテンツにスキップ
Documentation

サブエージェント、バックグラウンドタスク、およびループ

エージェントは、大規模なリクエストを複数の部分に分割し、それらを並列で実行して、 ユーザーが作業を続ける間もバックグラウンドで処理を継続させることができます。ここで説明している すべての処理は、ターミナルセッション内で実行され、セッションが終了すると停止します。

サブエージェントとは、独自の新しいコンテキスト、指示、および ツールリストを持つ独立したエージェントのことです。 Eveは、タスクが並列処理の恩恵を受ける場合、例えば 大規模なコードベースの複数のモジュールを検索する場合、ベンチマークを実行する場合、または 独立したリファクタリングを並行して実行する場合などに、サブエージェントを起動します。サブエージェントの最終的な回答のみが メインの会話に戻されるため、プライマリコンテキストウィンドウはコンパクトに保たれます。

  • サブエージェントは並列で実行され、デフォルトでは一度に最大32個まで実行可能です。Eveは、 1ターンで並列タスクのバッチを起動し、スループットを最大化することができます。
  • サブエージェントは、最大2階層まで、独自のサブエージェントを起動することができます。
  • サブエージェントが、ユーザーのセッション以上の権限を取得することは決してありません。サブエージェントの 権限確認プロンプトは、サブエージェントの名前がラベルとして付いた状態で、1つずつ ターミナルに表示されます。
  • 数時間にわたるワークフローや複雑なターンの一時停止が、最大 2,000 ターンサイクルまでサポートされています。
  • 各サブエージェントのターンは通常のエージェントのターンとして扱われ、制限回数にカウントされます。

エージェントツールご利用方法
generalセッションが持つすべてのローカルおよびツールCHAMPREPはより大きなタスクを構成する、独立した単位です。
explore読み取り専用のローカルツール結論を返す、高速なコードベース検索機能です。
plan読み取り専用段階的な実装計画です。
review読み取り専用、および読み取り専用 gitdiff、ブランチ、またはマージリクエストのレビュー。
platformCHAMPREP ツールのみ対応。ローカルファイルやコマンドは使用できません。Work サービスCHAMPREP全体を横断して。

エージェントを自分で実行する

Section titled “エージェントを自分で実行する”
/agents
/agents run explore where is the invoice total calculated?
@explore where is the invoice total calculated?

@agent-name prompt は、エージェントをバックグラウンドタスクとして起動し、 完了時にその応答を報告します。以下の方法で独自のエージェントを作成できます。 /agents create NAME; 参照 カスタムエージェント.

複数ステップにわたるリクエストの場合、Eveは保留中、進行中、 および完了済みの項目を含むリアルタイムのタスクリストを保持します。 Ctrl+T 表示または非表示にするには、または実行するには /todos.

バックグラウンドのシェルとプロセス

Section titled “バックグラウンドのシェルとプロセス”

Eveは、開発サーバー、ファイル ウォッチャー、コンパイラ、あるいは長時間のテストスイートなど、長時間実行されるコマンドをバックグラウンドシェルで起動し、作業を継続することができます。 出力を非同期で監視し、次のようなパターンを待機することができます。 server listening または FAIL 続行する前に。

  • 最大 64 個のバックグラウンドシェルを同時に実行できます。
  • ステータスラインでは、バックグラウンドでのリアルタイムなアクティビティが追跡されます(例: 🐚 2 shells) を実行し、ステータス概要を (⚡ 2 shell(s), 3 agent(s) active).
  • 使用方法 /shells または /procs PID、コマンドライン、終了コード、および出力の末尾を表示する専用のシェルインスペクタを開きます。

現在のセッションでプロンプトを繰り返し表示します:

/loop 5m check whether the deploy finished and summarise any errors
/loop --max 10 30m run the test suite and fix new failures
/loop keep improving test coverage for src/billing
/loop stop
  • 間隔を空けて実行すると 30s および 24hと表示された場合、プロンプトはそのスケジュール通りに実行されます。
  • 間隔を指定しない場合、ループはエージェントが独自にペースを決定します。エージェントが 次に実行するタイミングを、1分後から1時間後の間で決定します。
  • ループはデフォルトで50回の実行後に停止します。これを変更するには、 --max N。また、 以下の状態で終了します。 /loop stop [id] 、または終了した際。

各実行は通常のターンとなります。他のターンと同様に、 設定された制限が適用され、許可を求めるメッセージが表示されます。

/tasks バックグラウンドで実行中のすべて(サブエージェント、バックグラウンド シェル、ループ)を、経過時間とともに一覧表示します。 /shells (または /procs) は、特にアクティブなシェルプロセスと完了したシェルプロセスに焦点を当てています。

/tasks
/tasks tail ID
/tasks attach ID
/tasks stop ID
/tasks stop all
/shells
/procs

ステータス行には、アクティブなタスクとシェルの数が表示されます。 /exit バックグラウンドプロセスやタスクがまだ実行中の状態で 終了しようとすると、警告が表示されます。

バックグラウンドタスク、サブエージェント、および並列サブエージェントの数は、プランの 機能です。詳しくは プランと制限.

gitワークツリーにより、セッションごとに独自のチェックアウトが割り当てられるため、並列セッションや サブエージェントが同じファイルを編集することは決してありません。

Terminal window
champrep ai --worktree
champrep ai --worktree fix-rounding
/worktree fix-rounding
/worktree exit

ワークツリーは以下の下に作成されます .champrep/worktrees/NAME 新しいブランチ上 ai/NAME。終了すると、変更のないワークツリーは削除され、 変更のあるワークツリーは保持され、コミットまたは破棄できるよう報告されます。カスタムエージェント では、以下を設定することも可能です。 isolation: worktree 常に独自のワークツリーで動作するようにします。

/review
/review main
/review !42
/security-review
  • 引数がない場合、 /review 未コミットおよびステージング済みの変更内容を確認します。
  • ブランチまたはリファレンスを指定すると、そのブランチを現在のブランチと比較して確認します。 HEAD.
  • で !NUMBER またはマージリクエストのURLが表示された場合、お使いのツールCHAMPREPを通じてコードCHAMPREPのマージ リクエストを確認します。

/security-review インジェクション、 認証の不備、漏洩した機密情報、パストラバーサルなど、悪用可能な問題を検出します。どちらのコマンドも 読み取り専用 review エージェントを実行し、重大度別に、ファイル名と 行番号を添えて検出結果を報告します。