スーパーバイザーエージェントを使用して、協調的なマルチエージェントシステムを作成します。
このページでは、Supervisor Agent を使用して、AI エージェントとツールを連携させて複雑なタスクに取り組むマルチエージェント監視システムを作成する方法について説明します。専門家からの自然言語によるフィードバックに基づいて、彼らの連携を向上させることができます。
スーパーバイザーエージェントとは何ですか?
Supervisor Agent を使用すると、Genie Spaces、エージェントエンドポイント、Unity Catalog 機能、および MCP サーバーを連携させて、さまざまな専門分野にわたる複雑なタスクを完了させるスーパーバイザーシステムを構築できます。Supervisor Agent は、高度なAIオーケストレーション パターンを使用して、エージェントの対話、タスクの委任、結果の合成を管理し、包括的なソリューションを提供します。
スーパーバイザーエージェントは、システムを構築し、人間のフィードバックに基づいて時間をかけて改善していくことを可能にします。以下のユースケースをサポートするのに最適です。
- 調査レポートと利用データを検索することにより、市場分析と知見を提供します。
- 内部プロセスに関する質問に答え、そのチケットバックログを自動化します。
- ポリシー、FAQ、アカウント、その他の質問に答えることで、顧客サービスをスピードアップします。
スーパーバイザー エージェントを使用すると、スーパーバイザーの調整品質を向上させ、専門家からの自然言語によるフィードバックに基づいてエージェントの動作を調整できます。システムのパフォーマンスを最適化するための例とガイドラインを提供します。
スーパーバイザー エージェントは、アプリケーションのダウンストリームで使用できる包括的なエンドポイントを作成します。たとえば、Playground でプロンプトを送信してエンドポイントと対話したり、 Databricks Appsを使用してチャット アプリケーションを構築したりできます。 スーパーバイザにはアクセス制御があり、エンド ユーザーはアクセス権を持つサブエージェントとデータにのみアクセスできます。
スーパーバイザーエージェントは、デフォルトのストレージを使用して、一時的なデータ変換、モデルのチェックポイント、および各エージェントを動作させるための内部メタデータを保存します。エージェントを削除すると、エージェントに関連付けられたすべてのデータがデフォルトのストレージから削除されます。
必要条件
-
次のものを含むワークスペース。
- サーバレスコンピュート利用可能(ワークスペースでUnity Catalog使用することで有効になります)。
- Unity Catalog が有効になっている。「Unity Catalog のワークスペースを有効にする」を参照してください。
- Mosaic AI Model Servingへのアクセス。
- 非ゼロの 予算を持つサーバレス 予算ポリシー へのアクセス。
- MLflow (ベータ版) の本番運用モニタリングが有効になりました。 トレースが機能するにはこれが必要です。トレースが必要ない場合は、このプレビューを有効にする必要はありません。「Databricks プレビューの管理」を参照してください。
-
サポートされているリージョンのいずれかにあるワークスペース。
-
コンプライアンス セキュリティ プロファイルが有効で、HIPPA コントロールが選択されているワークスペースの場合、スーパーバイザ エージェント プレビューを有効にする必要があります。 「Databricks プレビューの管理」を参照してください。
-
databricks-gte-large-en埋め込みモデル エンドポイントでは、AI ガードレールとレート制限を無効にする必要があります。モデルサービング エンドポイントでのAIゲートウェイの構成を参照してください。 -
使用できるエージェントまたはツールを用意しておく必要があります。少なくとも次のいずれかを提供する必要があります。
- 既存のナレッジアシスタントエージェントエンドポイント。
- 既存のGenieスペース。 Genieスペースを設定するには、 Genieスペースの設定と管理」を参照してください。
- Unity Catalog機能として作成されたAIエージェントツール。 「Unity Catalog 関数を使用して AI エージェント ツールを作成する」を参照してください。
- Unity Catalog接続が構成された外部 MCP サーバー。 Databricks Marketplace から MCP サーバーをインストールするか、外部の MCP サーバーを使用することができます。接続には、ベアラー トークン認証または OAuth マシン間認証を使用する必要があります。外部サービスの認証方法を参照してください。
-
スーパーバイザー エージェントのエンド ユーザーは、各サブエージェントと対話するための明示的なアクセス権が必要です。
- エージェントエンドポイントの場合、エンドユーザーには
CAN QUERY権限が必要です。 - Genieスペースの場合、エンドユーザーはGenieスペースへのアクセスと、その基になるUnity Catalogオブジェクトへのデータアクセスの両方が必要です。Genieスペースの共有を参照してください。
- Unity Catalog関数の場合、エンドユーザーには関数に対する
EXECUTE権限が必要です。 - 外部 MCP サーバーの場合、エンドユーザーにはUnity Catalog接続に対する
USE CONNECTION権限が必要です。
- エージェントエンドポイントの場合、エンドユーザーには
-
(オプション) MLflow (ベータ) の本番運用モニタリングが有効になります。 これは追跡調査を機能させるために必要です。Databricksのプレビューを管理するを参照してください。
マルチエージェントスーパーバイザーシステムの作成
へ移動ワークスペースの左側のナビゲーション ペインにある エージェント 。 スーパーバイザー エージェント タイルから、 [ビルド] をクリックします。
ステップ 1: サブエージェントを作成し、権限を付与する
エージェント ツールで任意のコードを実行すると、エージェントがアクセスできる機密情報や個人情報が公開される可能性があります。顧客は信頼できるコードのみを実行し、データへの意図しないアクセスを防ぐためのガードレールと適切な権限を実装する責任があります。
Supervisor Agentは、サブエージェントが連携して複雑なタスクを完了するように調整するスーパーバイザーシステムを作成するため、まず調整対象となるサブエージェントを提供する必要があります。これらのサブエージェントは、Genie Spaces、Knowledge Assistantエージェントエンドポイント、Unity Catalog関数、またはMCPサーバーである可能性があります。スーパーバイザーが各サブエージェントから有用な応答を返すためには、エンドユーザーに各サブエージェントへの明示的なアクセス権限を付与する必要もあります。
- Genie space
- Agent endpoint
- Unity Catalog function
- External MCP server
- Genieスペースを作成するには、 Genieスペースのセットアップと管理」のステップに従います。
- エンドユーザーに、 Genieスペースとその基礎となる Unity Catalog オブジェクトの両方へのアクセス権を付与します。 Genieスペースを共有する手順に従います。
- ナレッジアシスタントエージェントを作成するには、 「ナレッジアシスタントを使用してドキュメント上で高品質のチャットボットを作成する」の手順に従ってください。
- エンドユーザーに、Knowledge Assistant エージェントエンドポイントに対する
CAN QUERY権限を付与します。
- Unity Catalog関数をAIエージェント ツールとして作成するには、 「 Unity Catalog関数を使用してAIエージェント ツールを作成する」の手順に従ってください。
- エンドユーザーにUnity Catalog機能に対する
EXECUTE権限を付与します。
- Databricks Marketplace から MCP サーバーをインストールするには、 「外部 MCP サーバーへのアクセスの取得」を参照してください。外部 MCP サーバーをセットアップするには、「外部 MCP サーバーを使用する」のステップに従います。 接続には、ベアラー トークン認証または OAuth マシン間認証を使用する必要があります。外部サービスの認証方法を参照してください。
- エンドユーザーにUnity Catalog接続の
USE CONNECTION権限を付与します。
ステップ 2: スーパーバイザーを設定する
[ビルド] タブで、スーパーバイザを構成し、調整するエージェントを追加します。
スーパーバイザにはアクセス制御があり、エンド ユーザーはアクセス権を持つサブエージェントとデータにのみアクセスできます。
- エージェント エンドポイントの場合、エンドユーザーにはエンドポイントに対する
CAN QUERY権限が必要です。 - Genieスペースの場合、エンド ユーザーはGenieスペースへのアクセスと、その基盤となるUnity Catalogオブジェクトへのデータ アクセスの両方を必要とします。 Genieスペースを共有するを参照してください。
- Unity Catalog関数の場合、エンドユーザーには関数に対する
EXECUTE権限が必要です。 - 外部 MCP サーバーの場合、エンドユーザーにはUnity Catalog接続に対する
USE CONNECTION権限が必要です。
エンド ユーザーがどのサブエージェントにもアクセスできない場合は、スーパーバイザが会話を終了します。エンド ユーザーがすべてのサブエージェントではなく一部のサブエージェントにアクセスできる場合、スーパーバイザはユーザーがアクセスできないサブエージェントから会話をリダイレクトします。
-
名前 フィールドに、スーパーバイザ エージェントの名前を入力します。
-
説明 フィールドに、スーパーバイザー・システムで何ができるかを説明します。
-
[エージェントの構成] で、最大 20 個のエージェントおよび/またはツールを選択します。
- Genie space
- Agent endpoint
- Unity Catalog function
- External MCP server
Genieスペースを提供するには:
-
[タイプ ] フィールドで、[ Genie Space ] を選択します。
-
Genieスペース ドロップダウンメニューからGenieスペースを選択します。
-
エージェント名 フィールドと コンテンツの説明 フィールドは、可能な場合は自動的に入力されます。必要に応じて、名前と説明を編集できます。
スーパーバイザーは、説明の情報を使用してエージェントを調整します。タスクの委任を改善するために、できるだけ多くの詳細を提供します。
Genie spacesの詳細については、 「 Genieスペースとは」を参照してください。 Genieスペースを設定するには、 Genieスペースの設定と管理」を参照してください。
エージェントエンドポイントを指定するには:
- タイプ フィールドで、 エージェントエンドポイント を選択します。
- エージェントエンドポイントの ドロップダウンメニューからエンドポイントを選択してください。Knowledge Assistantを通じて作成されたエージェントエンドポイントのみがサポートされます。
- エージェント名 フィールドは自動的に入力されます。これは必要に応じて編集できます。
- [コンテンツの説明] で、スーパーバイザーがこのエージェントにタスクを委任するタイミングを理解できるようにするために、このエージェントができることを説明します。
Unity Catalog関数を提供するには:
- タイプ フィールドで、 Unity Catalog関数 を選択します。
- Unity Catalog関数 ドロップダウン メニューから関数を選択します。
- 「エージェント名」 フィールドに、このツールの名前を入力します。
- 「コンテンツの説明」 で、この機能が何を行うのか、いつ使用する必要があるのかを説明します。これにより、監督者はこのツールをいつ使用すべきかを理解できるようになります。
Unity Catalog関数をエージェント ツールとして作成する方法の詳細については、 「 Unity Catalog関数を使用してAIエージェント ツールを作成する」を参照してください。
外部 MCP サーバーを提供するには:
- 「タイプ」 フィールドで、 「外部 MCP サーバー」 を選択します。
- Unity Catalog接続 ドロップダウン メニューから接続を選択します。
- 「エージェント名」 フィールドに、この MCP サーバーの名前を入力します。
- 「コンテンツの説明」 で、この MCP サーバーが提供する内容と、いつ使用すべきかを説明します。これにより、スーパーバイザーはいつこのサーバーに委任するかを理解できるようになります。
外部 MCP サーバーの詳細については、 「外部 MCP サーバーの使用」を参照してください。
-
(オプション) エージェントを追加するには、 [+ 追加] をクリックします。最大 20 のエージェントを提供できます。
-
(オプション) [ 指示] フィールドで、スーパーバイザーがどのように応答すべきかのガイドラインを指定します。
-
エージェントの作成 をクリックします。
構成 タブにリダイレクトされます。マルチエージェントシステムとスーパーバイザーエージェントを作成するには、数分から数時間かかる場合があります。
ステップ 3: スーパーバイザー エージェントをテストする
スーパーバイザーが構築を完了したら、スーパーバイザーが複数のエージェントをどれだけうまく調整して複雑なタスクを処理できるかをテストします。右側のペインの 「エージェントのテスト」 で、エージェントとチャットして応答を評価します。
- (オプション) AI Playgroundでエージェントをテストすることもできます。 「Playgroundで開く」 をクリックします。これにより、スーパーバイザーのエンドポイントが接続された AI Playground が開きます。AI 支援機能が有効になっている場合は、 AI ジャッジ と 合成タスク生成を 有効にして、上司の評価に役立てることができます。
- Test your Agent または AI Playgroundで、スーパーバイザーの複雑なタスクを入力します。
- その応答を評価します。スーパーバイザーが適切なエージェントにタスクを正常に委任していることを確認します。
- エージェントの応答に基づいて、左側のパネルの [説明] フィールドと [指示] フィールドを調整し、構成を改善します。
- エージェントの更新 をクリックします。
スーパーバイザーのパフォーマンスに満足している場合は、スーパーバイザーをそのまま使用してください。
ステップ 4: スーパーバイザーを改善する
スーパーバイザーエージェントは、自然言語によるフィードバックに基づいてスーパーバイザーの行動を調整できます。設定ページを通じて専門家からフィードバックを収集し、上司の調整能力を向上させましょう。上司のためにラベル付きデータを収集することは、上司のパフォーマンス向上につながります。スーパーバイザーエージェントは、新しいデータに基づいてスーパーバイザーを再学習し、最適化します。
[例] タブで、スーパーバイザー向けの質問とタスク シナリオを追加します。
-
ラベルに質問を追加します:
- 質問を追加するには、 「+ 追加」 をクリックします。
- 「質問を追加」 モーダルに質問を入力します。
- 追加 をクリックします。質問がUIに表示されます。
- 評価したい質問をすべて追加するまで繰り返します。
- 質問を削除するには、ケバブメニューをクリックし、[ 削除 ]をクリックします。
-
質問の追加が完了したら、エージェントを他のユーザーと共有してレビューを依頼し、高品質なラベル付きデータセットの構築に役立てることができます。専門家からのフィードバックを収集するために、スーパーバイザーエージェントの設定ページへのリンクを共有してください。
-
エキスパートがスーパーバイザー エージェントと適切なサブエージェントにアクセスできることを確認します。
- 右上隅のケバブメニューをクリックします
権限を管理します。エキスパートに CAN_MANAGE 権限を付与して、エージェントにアクセスし、フィードバックを提供できるようにします。
- 専門家が適切なサブエージェントにアクセスできることを確認します。
- Genieスペースごとに、スペースを操作するためのすべての適切な権限を専門家に付与します。Genieスペースの共有を参照してください。
- エージェントエンドポイントごとに、専門家に
CAN QUERY権限を付与します。 - Unity Catalog関数ごとに、その関数に対する
EXECUTE権限を専門家に付与します。 - 外部 MCP サーバーごとに、専門家にUnity Catalog接続の
USE CONNECTION権限を付与します。
専門家がサブエージェントにアクセスできない場合、スーパーバイザーは会話を終了します。 エンド ユーザーがすべてのサブエージェントではなく一部のサブエージェントにアクセスできる場合、スーパーバイザは、ユーザーがアクセスできないサブエージェントから会話をリダイレクトします。
- 右上隅のケバブメニューをクリックします
-
データにラベルを付けるには、質問をクリックし、表示されるパネルに ガイドライン を追加します。ガイドラインは保存後すぐに適用されます。
-
構成ページまたはAI Playgroundでエージェントを再度テストし、パフォーマンスの向上を確認します。 必要に応じて、質問やガイドラインを追加して、行動の改善を続けます。
ステップ 5: 権限を管理する
デフォルトでは、エージェントの作成者とワークスペース管理者のみがエージェントへのアクセス権限を持っています。他のユーザーがエージェントを編集したり照会したりできるようにするには、明示的に権限を付与する必要があります。
エージェントの権限を管理するには:
-
エージェント ページで、担当エージェントを開いてください。
-
上部の
ケバブメニュー。
-
[権限の管理] をクリックします。
-
[権限設定] ウィンドウで、ユーザー、グループ、またはサービスプリンシパルを選択します。
-
付与する権限を選択してください:
- 管理可能 :エージェントの管理が可能で、権限の設定、エージェント構成の編集、品質の向上などを行うことができます。
- クエリ可能 : AI Playgroundおよび API を介してエージェントエンドポイントにクエリを実行できます。この権限しか持たないユーザーは、エージェントページでエージェントを表示または編集することはできません。
-
[ 追加 ] をクリックします。
-
保存 をクリックします。
2025 年 9 月 16 日より前に 作成されたエージェント エンドポイントの場合は、 [サービス エンドポイント] ページからエンドポイントに クエリ可能 権限を付与できます。
ステップ 6: エージェントのエンドポイントをクエリする
エージェントページで、 右上のエージェント ステータスを参照して、デプロイされたエージェント エンドポイントを取得し、エンドポイントの詳細を確認します。
作成されたスーパーバイザー エンドポイントをクエリする方法は複数あります。AI Playground で提供されているコード例を開始点として使用します。
- [ビルド] タブで、[プレイ グラウンドで開く] をクリックします。
- Playground から [ コードを取得] をクリックします。
- エンドポイントの使用方法を選択します。
- curl を使用してエンドポイントをクエリするコード例として、 Curl API を選択します。
- Python を使用してエンドポイントと対話するためのコード例として、 Python API を選択します。
制限
- 英語のみがサポートされています。
- Knowledge Assistantを通じて作成されたエージェントエンドポイントのみがサポートされます。
databricks-gte-large-enモデル エンドポイントでは AI ガードレールとレート制限を無効にする必要があります。モデルサービング エンドポイントでのAIゲートウェイの構成を参照してください。- 1 つのスーパーバイザー システムで 20 を超えるエージェントを使用することはできません。
- セキュリティとコンプライアンスの強化が有効になっているワークスペースはサポートされていません。
- トレースを機能させるには、 MLflow (ベータ) の本番運用モニタリングを有効にする必要があります。 トレースが必要ない場合は、このプレビューを有効にする必要はありません。「Databricks プレビューの管理」を参照してください。