すべてのページ
このページの内容

エージェントセッション 0.9.7 で追加

エージェントセッションを有効にすると、エージェントは作業の一部を同じリレー上のほかのセッションに任せられます。エージェントはセッションを開始し、それぞれにプロンプトを渡し、完了を待って、その回答を読みます。エージェントが開始したセッションはどれも、一覧に並ぶ通常の会話です。開いて進行を読んだり、質問に回答したり、停止したりできます。

主な使い方:

  • 作業を分割する。 「パッケージごとにセッションを 1 つ開始して依存関係を更新し、テストを実行させて、どれが失敗したか教えて」
  • 別の意見を求める。 「作業を始める前に、別のモデルのセッションにこのプランをレビューさせて」
  • 別のプロバイダーを使う。 「マイグレーションは Cursor のセッションに書かせて、その結果は自分で確認して」
  • 別のフォルダーで作業する。 「docs リポジトリでセッションを開始して、インストールページをそれに合わせて更新させて」

この機能に 2 台目のリレーは必要ありません。別のリレー上のセッションを使うには、リレー同士をペアリングしておく必要があります。リレーの指定を参照してください。

有効にする #

既定ではオフです。

  1. Settings → Relays(設定 → リレー)を開きます。
  2. Agent sessions(エージェントのセッション)で、Agents may start and use sessions on this relay(エージェントがこのリレーでセッションを開始・使用できる)をオンにします。

そのためには、リレーで少なくとも 1 つのプロバイダーが有効になっている必要があります。有効にすると、このリレー上のエージェントは、ここにあるすべてのセッションの一覧表示と読み取り、プロンプトの送信、セッションの開始、完了の待機、質問への回答、ターンの停止、アーカイブができるようになります。スイッチをオフにすると、再びエージェントからは使えなくなります。

すでに開いていた会話

セッションは、エージェントのプロセスが起動したときに使えるツールを把握します。スイッチをオンにする前から動いていた会話では、エージェントが起動し直すまでセッションを開始できないことがあります。会話の ⋯ メニューにある Kill session(セッションを強制終了)で起動し直せます。リレーの再起動でも同じです。

承認カード #

会話の中のエージェントが初めてセッションを開始しようとするときは、あなたに確認する必要があります。その会話に承認カードが表示され、プロバイダー、フォルダーまたはリポジトリ、プロンプトが示されます。

This agent wants to start sessions on this relay (claude, the default folder).
Sessions it starts use this relay's accounts.
選択 結果
Allow(許可) セッションが開始されます。この会話のエージェントは、以降は確認なしでセッションをさらに開始できます。リレーの再起動後も同様です。
Deny(拒否) その 1 回の呼び出しだけが拒否されます。

0.9.16 で追加 エージェントが新しいセッションにセッショングループを指定した場合、カードの詳細行に配置先が表示されます。例:Group: Release 2.4 (grp_…)。グループはカードが表示される前に確認され、存在しないグループを指定した呼び出しはカードを出さずに拒否されます。

承認はリレーではなく会話に属します。別の会話のエージェントは、その会話の分の承認を求めます。

ask と plan のリレーモードでは、確認を求められる回数が増えます。これらのモードでは、何かを変更するアクションはすべて事前に確認されます。セッションの開始、プロンプトの送信、質問への回答、0.9.16 で追加 設定の変更、停止、アーカイブです。

ルール #

ルール
同時に作業できるのは最大 4 つ 1 つの会話のエージェントが開始したセッションのうち、ターンがキューに入っているか実行中でいられるのは同時に 4 つまでです。5 つ目は、どれかが終わるまで拒否されます。
1 階層のみ エージェントが開始したセッションは、自分ではセッションを開始できません。0.9.16 で追加 ただし、そのセッションに対してあなたが許可した場合は別です(下記)。
自分自身は対象外 エージェントは、自分が動いている会話に対して、プロンプトの送信、停止、アーカイブ、完了の待機、質問への回答はできません。0.9.16 で追加 設定の変更もできません。
0.9.16 で追加 設定の変更 エージェントは、自分の会話が開始したセッションの設定を自由に変更できます。それ以外のセッション(あなたのものでも、別のエージェントのものでも)は、会話ごとに一度あなたの Allow が必要です。update_session を参照してください。
30 回のプロンプトで確認 エージェントが、あなたからのメッセージを挟まずにほかのエージェントへ 30 回プロンプトを送ると、次の 1 回はカードであなたに確認を求めます。Allow でカウントがリセットされます。0.9.16 で追加 あなたのメッセージとして数えられるのは、あなたが書いたメッセージだけです。リレーイベント、使用量の上限後のフォローアップ、再起動後のメモではカウントはリセットされません。ほかのセッション宛ての予約プロンプトもカウントされます。
あなたのアカウント エージェントが開始したセッションは、このリレーのプロバイダーアカウントで動作し、その使用状況に計上されます。
自動では片付けられない リレーがこれらのセッションを自動でアーカイブすることはありません。あなたがアーカイブまたは削除するか、エージェントがアーカイブするまで一覧に残ります。

開始されたセッションにセッションの開始を許可する 0.9.16 で追加 #

エージェントが開始したセッションは、自分ではセッションを開始できません。そうしたセッションの 1 つでこの制限を外すには、その 🧠 ダイアログを開き、Agents in this conversation may start sessions (even though an agent started it)(この会話のエージェントにセッションの開始を許可、エージェントが開始した会話でも)をオンにします。このスイッチは、エージェントが開始したセッションにだけ表示されます。

ほかのルールは引き続き適用されます。同時に作業できるのは最大 4 つであること、最初のセッションにはあなたの Allow が必要なこと、そして Agents may start and use sessions on this relay がオンであることです。このスイッチを設定できるのはあなただけです。エージェントが設定しようとすると、このリレーのエージェントでもペアリングしたリレーのエージェントでも拒否されます。エージェントからは、list_sessions と read_session で "mayCreateSessions": true として見えます。

エージェントが開始できるもの #

リレーで有効になっているプロバイダーであれば、どのプロバイダーのセッションでも開始できます。GitHub Copilot、OpenAI、Claude、Claude API、Cursor、Grok、DeepSeek、Claude Cloud です。OpenAI Image のチャットはこの方法では開始できません。

  • フォルダーを指定する。 エージェントは作業フォルダーを指定できます。指定しない場合、セッションにはリレーの既定のフォルダーが使われます。
  • Claude Cloud ではリポジトリを指定する。 クラウドセッションは、フォルダーの代わりに GitHub リポジトリと、必要に応じてブランチを受け取ります。Anthropic のサンドボックス内の新しいクローンで作業するため、エージェントはどのブランチで作業するかと、プッシュすることをセッションに伝える必要があります。

エージェントは、モデル、リレーモード、reasoning effort も選べます。指定しなかった項目は、エージェント自身が動いているセッションの設定に従います。

新しいセッションは、開始元の会話について何も知りません。受け取るのは、エージェントが書いたプロンプトだけです。開始されたセッションにコンテキストが足りないように見える場合は、まずそこを確認してください。セッションを開いて最初のメッセージを読みます。

表示される内容 #

  • 会話リストでは、エージェントが開始したセッションに via agent · "title"(エージェント経由 · 「title」)が表示されます。title の部分には、エージェントが動いている会話のタイトルが入ります。同じ行がヘッダーのセッションタイトルの下にも表示され、クリックするとその会話が開きます。
  • 0.9.11 で追加 グループの中で。 セッションは、開始元の会話の下にインデントされてセッショングループに入ります。グループの見出し行には、実行中のものとあなたの対応を待っているものがまとめて表示されます。0.9.16 で追加 エージェントが既存のグループを指定した場合は、代わりにそのグループに入ります。
  • メッセージでは、エージェントが送ったプロンプトに、同じ目印とエージェントのモデルを示すバッジが付くため、自分のメッセージと見分けられます。
  • エージェントの返信では、それぞれの呼び出しが 🛰️ 付きのアクティビティ行として表示され、アクションと送り先のセッションが示されます。
  • 質問。 開始されたセッションが質問すると、そのカードは通常どおりそのセッションで待機します。開始したエージェントには質問のことが伝えられます。エージェントは、自分で判断するよう指示されていない限り、自分で回答せずにあなたに伝えるよう指示されています。

エージェントの待機時間 #

エージェントはセッションにプロンプトを送ると、しばらく返信を待ち、時間切れになった時点で得られている内容を受け取ります。その後、もう一度待つこともできます。スイッチの下にあるスライダー Longest wait per tool call(ツール呼び出しごとの最長待機時間)で、1 回の待機の最長時間を設定します。既定は 10 分で、2 分から 60 分まで設定できます。

この上限は、このリレーのエージェントがペアリングしたリレー上のセッションを待つ場合にも適用されます。そのため、スライダーはスイッチのオン・オフにかかわらず動かせます。

待機中のターンも、Settings → General(設定 → 一般)の Max turn duration(ターンの最大時間)に計上されます。1 ターンにかけるべき時間より長くかかる作業では、エージェントは代わりにセッションを監視し、完了したときに起こしてもらえます。

プロバイダー別 #

プロバイダー ほかのセッションを開始・使用できる エージェントから開始できる
Claude はい はい
GitHub Copilot と OpenAI(両エンジン) はい はい
Cursor はい はい
Grok はい はい
DeepSeek 0.9.17 で追加 はい はい
Claude Cloud いいえ:リレーのツールはクラウドのサンドボックス内に届きません はい(フォルダーの代わりにリポジトリを指定)
OpenAI Image いいえ いいえ

それ以外の点では、エージェントセッションはどのプロバイダーでも同じように動作します。

うまくいかないとき #

起きること 原因と対処
エージェントが、そのためのツールがないと言う スイッチがオフになっているか、スイッチをオンにする前に会話のエージェントが起動しています。有効にするを参照してください。
エージェントが REMOTE_RELAY_SESSION_LIMIT を報告する エージェントが開始したセッションのうち 4 つがまだ作業中です。どれかが終わるまで待つ必要があります。
エージェントが REMOTE_RELAY_NESTED_SESSION を報告する エージェント自身が、エージェントの開始したセッションで動いています。セッションを開始できるのは、あなた自身の会話のエージェントだけです。
エージェントが REMOTE_RELAY_PROVIDER_UNAVAILABLE を報告する 要求したプロバイダーがこのリレーで有効になっていません。0.9.18 で追加 課金の切り替えでは、Claude API または Claude が設定されていない場合や、今月の上限に達している場合にも報告されます。どれに該当するかは remoteCode で示されます。
待機中にエージェントのターンが終わる 待機が Max turn duration に達しました。待機を短くするか、代わりにセッションを監視するようエージェントに頼んでください。

すべてのコードはエラーに一覧があります。