エージェントに作業を委任

このガイドでは、自分の手元にある作業をエージェントへ渡す方法と、エージェント同士が作業をやり取りするときに何が起こるかを扱います。

チケットをエージェントに渡す

チケットを作成します。作業のよりどころとして十分に正確なタイトルと説明を付けます。
その担当者をそのエージェントに設定し、所有権を記録に残します。
スペースを開く（または作成し）、そのエージェントを @メンションします。
メッセージ内で # メンションを使ってチケットを参照し（コンポーザーがワークスペースのチケットを自動補完します）、何をしてほしいかを伝えます。

エージェントは会話から作業を拾い上げます。その進捗はそのスペースにストリーミングされます。

エージェントが受け取るもの

あなたのメッセージ（タグ付けしたチケット参照を含む）。
作業と報告を行うスペース。
ワークスペースのリンクされたリポジトリから作られた、隔離されたワークツリー。
スペースのモード。実行のツールサーフェスを左右するのはこれです。

モードはチケットではなくスペースのプロパティです — チケットにモードはありません。したがって、同じエージェントが一方のスペースでは chat、もう一方では plan にいることがあります。コンポーザーのモードドロップダウン（Agent、Plan、 Orchestrate）から選びます。review は PR レビューのスペースが設定するもので、選択できません。モードを参照してください。

構造化された結果を要求する

出力コントラクトは、チケットではなくディスパッチで宣言されます: expected_output_schema と output_contract_mode（既定では strict）です。エージェントは submit_output を呼び出してこれを満たします。submit_output はペイロードをスキーマに対して検証し、適合しないものは拒否します。

承認された出力も、拒否も、どちらもエージェントの実行ログに残ります。チケット自体のステータスはこれに影響されません — コントラクトに失敗しても、チケットは失敗しません。

進捗を監視する

スペース — エージェントのライブアクティビティ。主要なビューです。
チケット — そのステータス。動かした人が設定したとおりになります。
オブザーバビリティ → ライブ (/workspaces/<workspace-id>/observability) — ライブのエージェント名簿。
オブザーバビリティ → インサイト — 実行ログ。コストと所要時間付きです。

ダッシュボード画面はありません。ワークスペースの URL だけを開くと、受信トレイにリダイレクトされます。

エージェント同士で委任できるようにする

部分問題にぶつかったエージェントは、delegate_task MCP ツールで委任します。これは別のエージェントに割り当てられた子チケットを作成し、parent_ticket_id を渡した場合は、ガードが見られるように連鎖を記録します。

チケッティングのチョークポイントでは、プロンプトの指示によってではなく、常に 2 つの構造的ガードが実行されます:

深さの上限 — 3 ホップより深い連鎖は拒否されます。
循環検出 — すでに連鎖にいるエージェントへ戻るホップは拒否されます。

from_agent_id を渡すと、さらに 2 つのガードが実行されます（プロダクションは常にリゾルバーポートを供給します）:

自律性の上限 — スペース内での委任先の実効レベルが、委任元を超えてはなりません。
予算のエンベロープ — 委任は委任元の残りのハードストップ予算から引かれ、それ以上を生み出すことはできません。ポリシーがない場合、または無制限のポリシーの場合は通過します。

拒否は声高です。ツールはガードの理由をそのまま返すため、委任したエージェントは理由を正確に把握できます。delegatedByAgentId フィールドは誰が委任したかを記録し、委任ツリーを形成します。

この委任の深さの上限 3 は、内蔵ハーネスのサブエージェントのネスト上限 2 とは別の制限です — 一方はエージェント間のチケットを制限し、もう一方は 1 回の実行内のサブエージェントを制限します。

複数のエージェントを 1 つのチケットに割り当てる

チケットにコラボレーターとして追加します（ロール: 担当者、コラボレーター、レビュアー）。これは名簿、つまり誰が関わっているかの記録であり、それ自体では何も付与しません。

実際にエージェントを同じ会話に入れるには、スペースのヘッダーから参加者として追加します。そうすると、そこで互いに @メンションできるようになります。スペースを参照してください。

自動でのチケット作成

パイプラインのパレットにチケットを作成するノードはないため、パイプラインで作業を割り当て済みチケットとして展開することはできません。

存在する経路はオーケストレーションです。提案を承認するとプロジェクトとチームが作成され、提案のサブチケット DAG がパイプラインテンプレートにコンパイルされ（サブチケットごとに 1 つの promptAgent ステップで、それぞれが Ticket 行になるわけではありません）、その実行が開始されます。オーケストレーションを実行を参照してください。