Agentty/ドキュメント

オーケストレーション

エージェントがサブエージェントに仕事を分けてウェーブで進める様子を見て、セッションを連携させてコンテキストを共有する。

⇧⌘F でオーケストレーションを開きます。(ファイルエディタでは ⇧⌘F はプロジェクトのファイル検索です。オーケストレーションは 表示 メニューからも開けます。)タブは二つあります。ワークフロー はセッションの仕事がどう分かれてどこまで進んだかを見せ、セッション連携 はセッション同士をつないでコンテキストを共有します。

オーケストレーションを始める#

目標を書くと、オーケストレーターのエージェントが残りを行います。目標に合うチームを組んで計画を見せ、ウェーブで実行し、最後に結果をレビューさせます。

ホーム画面の オーケストレーション、タブの右クリックメニューの 新しいオーケストレーションタブ、新しいワークスペースの開始画面、またはこの画面右上の 新しいオーケストレーション から始めます。ダイアログでは:

  • 目標 — チームにしてほしいこと。
  • 資料 — チームが参照する、目標の中のリンクと添付ファイル。リンクは目標の下に、どう読むかと一緒に表示されます。Jira の課題と Confluence のページは 設定 → ボード の Jira 接続で(トークンはそのサイトにだけ送ります)、誰でも読めるサイトなら接続なしでも、GitHub のファイル・Issue・プルリクエスト・リポジトリはこの Mac でログイン済みの gh で、リンクを知っている全員に共有された Google ドキュメント・スプレッドシート・プレゼンテーションはエクスポートで、その他のページはテキストと元の HTML、スクリーンショットで取り込みます。スクリーンショットは Chrome、Edge、Brave、Chromium のうちインストール済みのものを空のプロファイルで起動して撮るため、ログイン情報は渡りません。ファイルを添付(またはダイアログへのドロップ)で文書を追加できます。PDF と画像はそのまま、Word・Excel・PowerPoint・OpenDocument・RTF はテキストのコピーと一緒に置きます。開始すると Agentty がすべて読み込んでフォルダの .agentty-orchestration/ に置きます(git には含まれません)。オーケストレーターはまずそれを読み、読めなかったものは自分で試し、計画の前に作業項目(WORK_ITEMS.md)にまとめます。見た目を真似る目標なら、結果を元のページや画像とブラウザで並べて比べます。
  • モデル — バランス・最高品質・節約のいずれかをチームの全エージェントに適用します。カードにはオンにしたエージェントごとの中身が出ます: Claude Code は Sonnet・Opus・Haiku、Codex はいつものモデルで推論 medium・high・low、Gemini CLI は Flash・Pro・Flash-Lite、Antigravity CLI はその水準の Gemini Flash。レビューは一段上で動き、計画にはエージェントごとのモデルが書かれます。
  • フォルダ — チームが作業する場所。手前のペインのプロジェクト、なければ前回のオーケストレーションのフォルダ、それもなければ ~/AgenttyWorkspace/orchestration(なければ作ります)。
  • チームで使う AI — この Mac に入っているエージェント(Claude Code、Codex、Gemini CLI、Antigravity CLI)をそれぞれオン・オフできます。Claude Code がオンなら Claude Code が、そうでなければ Codex がリードを務めます。どちらもオフならオーケストレーションは始められません。計画は仕事ごとに得意なエージェントへ割り振り(精密なコード修正とレビューは Codex、巨大な入力は Gemini)、そのエージェントの権限確認は切りません。

Codex のリードにはサブエージェントがありません。ウェーブの各エージェントをエージェント CLI のプロセスとして動かし、開始と終了を Agentty に知らせます(agentty plan --start / --done)。この画面は Claude Code がリードのときと同じように進み具合を追います。Codex はこれらのコマンドをサンドボックスの外で実行する前に承認を求めます。

新しいワークスペースは最初に作られる オーケストレーション グループに入り、好きなグループへ移せます。始めるとこの画面にワークフローが表示されます。計画ができるとバーが出ます。計画を見る はオーケストレーターのペインを開き、修正を頼む はメッセージを送り、開始 で実行します。専用のブランチが要る作業は並列セッション(agentty tasks)に回り、最後にレビュー担当が結果を目標と照らし合わせ、オーケストレーターが報告で締めくくります。

追う・再開する・止める#

オーケストレーターのペインの上端には、この画面と同じ言葉で状態を示すバーがあります: 計画中、計画完成(開始)、実行中(作業中のエージェント数と完了数)、完了、中断、停止。ワークフローを見る でこの画面に来ます。サイドバーとメニューバーでは、そのワークスペースがオーケストレーションのアイコンで、状態の色で示されます。 × でバーを閉じられます。アプリを再起動しても閉じたままで、エージェントが追加されたときや、オーケストレーションがあなたを待っているとき(承認する計画、再開する作業)にだけ再び表示されます。

オーケストレーションは再起動しても残ります。実行中に Agentty が終了(または強制終了)すると、エージェントも一緒に止まります。するとバーとこの画面に 中断 と出て、再開 を押すと必要ならセッションを開き直し、済んだ仕事はそのままに残りだけを実行します。すべて停止(確認のあと)はオーケストレーターの作業と、まだ動いているすべてのエージェントを止めます。あとで 再開 で続けられます。削除 は一覧から消し、ターミナルも閉じます。ほかに何もないワークスペースならワークスペースも消えます。作ったファイルは残ります。そのワークスペースを削除してもオーケストレーションが一緒に消えます。

設定は 設定 → AI 設定 → オーケストレーション にあります: 使うかどうか、新しいものの既定モデル、既定で使う他の AI、計画のあと 開始 を待つか、新しいワークスペースとタブのどちらで開くか。

ワークフロー#

左はスレッドの一覧です。Agentty で動いているエージェントのセッションが状態の色の点とともに並び、エージェントが agentty tasks で始めた並列タスクもあります。一つ選ぶとそのワークフローが表示されます。

  • 一番上: 最後に頼んだこと($ …)とセッション名。
  • オーケストレーターの行: メインエージェントの状態、ウェーブ数、終わったサブエージェントの数、使っているモデルの数。開く はそのペインへ移り、メッセージ はそこに入力したように一行を送り、中断 は今のターンを止めます(ペインで Esc を押すのと同じ)。
  • グラフ: オーケストレーターの後にサブエージェントがウェーブごとに一列ずつ並びます。オーケストレーションのウェーブは計画から決まります。計画ができた時点で全エージェントがグラフに載り、まだ始まっていないものは待機として表示され、それぞれが待つエージェントから線がつながるので、仕事がウェーブからウェーブへ渡る様子が見えます。ほかのセッションでは同じ時間に動いたサブエージェントが一つのウェーブです。作業中のウェーブには下線が引かれます。各カードに実行中・完了・待機とかかった時間、エージェントの種類とモデル、今のステップか最後のひとことが出ます。実行中のウェーブへの線は動きます。カードを押すとそのサブエージェントの記録が開きます。
  • 一番下: サブエージェントの最新のステップがリアルタイムで流れます。スクロールすると前のステップを見られ(右下の矢印で最新に戻ります)、上の端をドラッグすると高さを変えられ、左の一覧は右の端をドラッグして幅を変えられます。

並列タスクはタスクが一つのウェーブとして並び、それぞれのブランチ(またはフォルダ)とペインの状態を示します。押すとそのペインへ移ります。

グラフの空いた所をドラッグするかホイールで動かします。⌘ または Ctrl とホイール、または右下のボタンで拡大・縮小し、全体を表示 で全体を見られます。

セッション連携#

あるセッションから別のセッションへ線を引くと、受け取る側が送り元のコンテキスト — 何に取り組み、何を決め、どこまで進んだか — を受け取ります。Claude Code と Codex の間でも動きます。

Claude Code のセッション同士は、ここで線を引いても、ターミナルのリンクボタンでペインを選んでも、直接つながります。セッション同士がメッセージをやり取りします。線を引き始めたセッションは、相手のプロジェクトの作業を自分でせずに相手へ任せるよう指示され、相手は終わったら結果を報告します。起動直後や再開中のセッションは数秒待ちます。それでもメッセージを送り合えない場合は、会話の内容だけを一方向に渡し、そう知らせます。

セッションが多いときは表示を動かして見ます。スクロールするか空いた所をドラッグすると表示が動き、⌘ + スクロールでポインターを中心に拡大・縮小します。右下のボタンで縮小・拡大、100% に戻す、すべてのセッションが収まるように合わせる、ができます。

リンクの種類#

種類挙動
一度だけ線を引いた時点のコンテキストを渡す
ライブ送り元に新しいターンが生まれるたび、受け取る側へ転送
双方向互いに転送する — コンテキストのトンネル

ライブなら、何もコピーせずに 2 つ目のエージェントを追随させられます。双方向なら、2 つのエージェントが同じ問題を分担しながら、相手が今やったことを把握できます。

何が送られるか#

会話の要約です。~/.agentty/handoffs/ にファイルとして書かれ、受け取る側のエージェントに渡されます。プロンプトと応答をターン単位で再生するわけではありません。

使い分け#

  • 一度だけ — 関連する作業に 2 つ目のエージェントを立ち上げ、文脈を知った状態で始めさせたいとき。
  • ライブ — 一方が実装し、もう一方がレビュー、ドキュメント作成、テストの監視をするとき。
  • 双方向 — 2 つのエージェントが機能を分担していて、互いにずれてはいけないとき。

リンクを切ると転送が止まります。すでに渡った内容は受け取った側の会話に残ります。