エージェントとチャット

このガイドでは、スペース内でエージェントと協働する方法を説明します。

スペースを作成

サイドバーの スペース に移動します
「スペース」見出しの横にある + ボタンをクリックします
名前を入力します — これは必須です。空の名前は拒否され、ダイアログは開いたままになります
任意で、ワークスペースからエージェントを追加します
ワークスペースにリポジトリが 1 つでもある場合は、リポジトリ選択ツールが表示されます。最初はすべてのリポジトリが選択されています。このスペースがワークツリーをプロビジョニングする対象を絞り込みます（リポジトリを 1 つだけ外すことも含みます）
確定します

Control Center はスペースを開き、選択された各リポジトリに対してコピーオンライトのワークツリーのプロビジョニングをバックグラウンドで開始します。

最初のメッセージを送信

コンポーザーにメッセージを入力して Enter を押します。エージェントがディスパッチされ、応答のストリーミングが始まります。

スペースがまだプロビジョニング中の場合、メッセージは失われず保留されます — コンポーザーがそれを保持し、ワークツリーの準備が整い次第自動的に送信します。

エージェントが作業する間、そのターンがストリーミングされる様子がわかります。推論セグメント、ツール呼び出し（ファイルの読み取り、書き込み、シェルコマンド）、回答テキストが、すべて 1 つのエージェントターンのメッセージ内に表示されます。

実行中のエージェントを軌道修正する

エージェントが作業している間、通常の会話テキストは新しいターンをキューに入れません。それはコンポーザーの上にあるストリップ内の、キューに入った軌道修正カードとなり、次のターン境界で稼働中の実行に注入されます。トーストは表示されません — カード自体がフィードバックです。

この動作を変えるのは次の 3 つです:

@メンション を含むメッセージは常にメッセージとして送信され、軌道修正として扱われることはありません
スラッシュコマンド で始まるメッセージは常にそのコマンドとして処理されます
添付ファイル を含むメッセージは常にメッセージとして送信されます — 軌道修正キューはテキストのみです
稼働中の実行がすべてすでに終了している場合、テキストはそのまま通り抜けて通常のメッセージとして送信されます

ブロックされた操作を承認する

エージェントがガードレールでゲートされる操作 — 破壊的なコマンド、特権ツール — に達すると、サーバーは実行をブロックし、接続中のすべてのクライアントに承認リクエストを発行します。その会話を開いていれば、リクエストはコンポーザーの上の チャット内に、ask_user で使われるのと同じ番号付きオプションのカードとして表示されます（拒否、承認、および任意で 8 時間の承認）。スキップはありません。ブロックされたエージェントは判断を待っています。

アプリ内の別の場所にいる場合でも、シェルの常に最前面に表示されるパネルに待機中のものが一覧表示されるので、スペースを探し回らなくてもエージェントのブロックを解除できます。オーバーレイは、そのスペースの会話が画面に表示された瞬間にリクエストを非表示にするので、同じプロンプトに二度答えることはありません。

タイムアウトはありません。ブロックされたエージェントは誰かが判断するまで待ちます。同じリクエストは受信トレイの要対応ストリップとスマートフォンクライアントにも表示されます。

エージェントの質問に答える

好み、不足している要件、または真の分岐が必要なエージェントは、必ず ask_user を呼び出します。質問をチャットメッセージとして書くとターンが終了し、再度プロンプトを出す必要があります。このツールは会話内に番号付きのカードを表示し（オプション、任意の自由テキスト、またはその両方）、実行はあなたの回答を待ちます。

単一のオプションをタップすると送信されます（末尾の番号はホバー時に矢印になります）。複数選択とテキスト入力の回答では続行（⌘↵ / Ctrl↵）を使います。 スキップ は、エージェントに妥当なデフォルトを選ばせ、再度質問しないよう指示します。

これは上記の承認カードとは別の仕組みです。承認は「これをやってもよいか?」であり、質問は「どれのことか?」です。質問は内蔵ハーネスのすべてのモード（何も変更しないため、読み取り専用のものを含みます）で利用でき、意図的に承認プロンプトでラップされていません — ダイアログの前にダイアログがあると、承認者が接続されていない状態でフェイルクローズしてしまうからです。表示先の会話がない実行では、このツールは単に提供されません。

エージェントを停止する

実行が稼働中の間、コンポーザーの送信ボタンは停止ボタンになります。コンポーザーを空にして押すと、その会話で実行中のすべてのエージェントが停止します。

スペースのヘッダーには停止コントロールはなく、そのためのキーボードショートカットもありません。複数が稼働中に 1 つの実行だけを停止するには、その実行のアクティビティタブを開きます — そのヘッダーには実行単位の一時停止/再開と停止があります（停止は確認を求めます）。オブザーバビリティ → ライブ には、ワークスペース内のすべての実行中エージェントが同じコントロールとともに一覧表示されます。

停止した実行は停止済みとしてマークされます。再度ディスパッチするには新しいメッセージを送信します。

スラッシュコマンドを使う

コンポーザーで / を入力するとコマンド一覧が表示されます。会話の動作を変えるものは次のとおりです:

コマンド	動作
`/plan`	スペースをプランモードに切り替えます。`/plan` だけの場合はモードを待機させるだけです。`/plan <request>` はモードを待機させ、残りをあなたのメッセージとして送信します
`/goal <text>`	会話の作業目標を記録します
`/loop <text>`	タスクが完了するまで反復します
`/compact`	古い履歴をアンカー付きの要約に畳み込み、圧縮されたコンテキストで続行します
`/todo …`	この会話の永続化された ToDo リストを表示および編集します

スキルは同じ一覧に独自の skill: 名前空間で表示されるため、上記のコマンドと衝突しません — plan や compact という名前のスキルも引き続き利用できます:

コマンド	実行内容
`/skill:<name>`	ワークスペースにインストールされたスキル、またはエージェントに添付されたスキル
`/skill:<repo>:<name>`	このスペースにチェックアウトされたリポジトリのいずれかが提供するスキル

リポジトリのスキルには、それが由来するリポジトリのバッジが付きます。名前だけではどのサービスの規約をエンコードしているかがわからず、2 つのリポジトリがそれぞれ testing を提供している可能性があるからです。スキルを見つけるのにプレフィックスを入力する必要はありません。スキル名だけを入力しても、名前空間付きのエントリに一致します。

エージェントは、現在作業しているリポジトリのスキルだけを常に保持します — リポジトリ単位のスキルを参照してください。コンポーザーはそのようにスコープされていません。任意のリポジトリのスキルを名前で指定して呼び出せます。

/compact と /todo はクライアントによってインターセプトされ、メッセージとして永続化されることはありません — トランスクリプト内の /compact 行は、次の圧縮のカット位置を 1 ターン分後ろにずらしてしまうからです。/plan はテキストとして送られるのではなく、スペースの保存されたモードを切り替えます。したがってこの 3 つはいずれも「エージェントに送るメッセージ」ではありません。履歴に表示されることは期待しないでください。

まずプランを依頼する

複雑な変更の前に、/plan、コンポーザーツールバーのモードドロップダウン、または Shift+Tab でスペースをプランモードに切り替えます。するとエージェントは読み取り専用で調査し、作業が始まる前にあなたが承認する型付きのプランを提示します。プランモードを使うを参照してください。

専用のスペースなしでエージェントに到達する

エージェントごとにスペースを用意する必要はありません。どのスペースでも次のように入力します:

@alice can you look at the failing tests in src/auth_test.dart?

メンションされたエージェントはスペースに追加され、そのスペースのコンテキストでディスパッチされます。名前の照合方法についてはエージェントを @メンションを参照してください。