初めてのエージェントをディスパッチする
作るもの
「作るもの」というセクションこのチュートリアルを終えると、次のものが揃っています:
- 自分で作成して設定したエージェント
- あなたとそのエージェントが会話するスペース
- 完了した 1 回の実行 — 分離されたワークツリーにコミットされた作業と、エージェントの実行ログの 1 行
前提条件: 初めてのワークスペースを完了していること。これにより、このワークスペースにはリポジトリが登録され、少なくとも 1 つのモデルプロバイダーが接続された状態になります。
ステップ 1: エージェントを作成する
「ステップ 1: エージェントを作成する」というセクション- 設定 → ワークスペース → エージェントを開きます
- 新しいエージェントをクリックします。「名前なしエージェント」というエージェントがすぐに作成され、名簿内で選択されます — 作成ダイアログはなく、確認するものもありません。設定はその場で行います。
- 設定タブで次を入力します:
- 名前:
aliceのような、短くて覚えやすいもの。@の後に入力する名前です。 - タイトル: そのエージェントの役割。例: 「バックエンドエンジニア」
- アダプター:
Control Center (built-in)。これは意図的に選んでください — 実行中に軌道修正でき、ターン境界で一時停止できるのは内蔵ハーネスだけであり、サーバーホストに CLI をインストールする必要もありません。 - モデル: 接続済みプロバイダーが提供する一覧から選びます
- スキル: 適したものを付けます。例:
testingやarchitecture
- 名前:
- 変更を保存を押します
チェックポイント。 名簿の行に、エージェントの名前と中空のステータスリングが表示されます。
ステップ 2: スペースを開始する
「ステップ 2: スペースを開始する」というセクション- サイドバーでスペースセクションを見つけ、+ ボタンをクリックします
- スペースに名前を付けます
- エージェントを追加で、作成したばかりのエージェントを選択します
- ワークスペースにリポジトリがある場合は、このスペースで作業するものを選びます
- 作成をクリックします
スペースが開きます。バックグラウンドで Control Center が、この会話のために選択したリポジトリのコピーオンライトのワークツリーを、それぞれ独自のブランチでプロビジョニングします。ソースのチェックアウトが変更されることはありません。
ステップ 3: タスクを送信する
「ステップ 3: タスクを送信する」というセクション登録したリポジトリに対して、具体的で小さなタスクを 1 つ入力します。結果を確認できるものが最適です — テストを追加する、lint を修正する、シンボルの名前を変更するなどです。
Enter を押します。誰かを @ でメンションする必要はありません。スペースにエージェントが 1 体だけなら、通常のメッセージでそのエージェントが動き出します。エージェントが複数いるスペースでは、@name で 1 体を選びます。
Control Center は、エージェントの指示、ペルソナ、スキル、スペースのコンテキストからプロンプトを組み立ててから、実行をディスパッチします。
チェックポイント。 コンポーザーの送信ボタンが停止ボタンに変わります — この会話でエージェントが作業している証拠です — そしてテキストが届き始めます。
ステップ 4: 実行の様子を見る
「ステップ 4: 実行の様子を見る」というセクション会話は、実行の進行に合わせてそれを描画します:
- 推論 — エージェントの思考に合わせてインラインで表示されます
- ツール呼び出し: ファイルの読み取りと書き込み、検索、シェルコマンド。それぞれに結果が付きます
- テキスト: 要約、説明、あなたへの質問
エージェントが何かを尋ねてきたら、会話の中で答えれば再開します。
実行自体のメトリクスと、その一時停止・再開・停止のコントロールについては、スペースの一般パネルのエージェントセクションで実行中のエージェントを見つけ、アクティビティを開くを選びます。
アクティビティペインでは、ステータスバッジは実行中と表示され、実行が終わると成功になります。停止またはループしている実行はブロック中、エラーになった実行は失敗と表示されます。エージェントレジストリでは、名簿のリングは最初の実行前は中空で、エージェントが再びアイドルになると塗りつぶされます。
実行を制約するもの: それ自身のコピーオンライトのワークツリー、起動時にブローカー経由で発行され、終了時に取り消される資格情報、サニタイズされた環境、そのモードが許可するツールサーフェス、そしてアクションガードレールです。ブランチのプッシュやプルリクエストの作成といったエフェクトは別途ゲートされます — ガードレールを参照してください。
ステップ 5: 結果を確認する
「ステップ 5: 結果を確認する」というセクション- 設定 → ワークスペース → エージェントを開き、自分のエージェントを選択します
- ログタブを開きます
チェックポイント。 実行の行が 1 つあり、そのステータス、所要時間、開始時刻と終了時刻、実行に使われたアダプターが表示されます。
エージェントの変更は、会話のブランチ上、そのワークツリー内にコミットされます。コミットの作者はエージェントで、あなたは Co-Authored-By: トレーラーにクレジットされます。
プルリクエストを開く
「プルリクエストを開く」というセクションプルリクエストを勝手に開くものはありません。開きたい場合は、同じ会話の中で依頼します:
このブランチをプッシュし、デフォルトブランチに対するプルリクエストを開いてください。
プッシュ（gitPush）と PR の作成（prCreate）はいずれも既定で承認を求めるため、それぞれの前に確認が入ります。プロンプトが発火した時点で承認者が接続されていなければ、アクションは許可されるのではなく拒否されます — ガードレールはフェイルクローズします。
PR は、その実行が使用したトークンの GitHub アイデンティティ（個人トークンを保存していればあなた）の下で開かれ、エージェントの名前で開かれることはありません。エージェントが作者であることはコミットに現れます。
自分で開くこともできます。スペースのソース管理パネルにはプルリクエストを作成ボタンがあり、会話のブランチを作成画面に引き継ぎます。また、プルリクエスト → 新しい PR は同じ画面を空の状態で開きます。次のチュートリアルはここから続きます。
エージェントを作成し、そのアダプターとモデルを設定し、スペースとタスクを与え、チェックアウトに触れることなく、実際の実行が分離されたワークツリー内で完了するのを見ました。
次: 初めてのプルリクエストをレビューで、レビューワークフローを学びます。
エージェントについて詳しくは: エージェントモデル。ディスパッチの詳細については: エージェントのディスパッチライフサイクル。