Microsoft 365エージェントレジストリ内の接続プラットフォーム

Microsoft 365 管理センター内の「Connected platforms」ページでは、管理者として外部AIエージェント環境を安全に接続し、エージェントをAgent 365エージェントレジストリに同期させて、集中的な可視性とガバナンスを実現できます。

多くの場合、AI エージェントは、Amazon Bedrock、Google Vertex AI、Salesforce、Databricks などの複数の環境にデプロイされます。 一元化されたエージェント レジストリがない場合は、切断されたプラットフォーム間でエージェントを手動で追跡する必要があります。

Connectedプラットフォームを利用することで、以下のことができます:

  • サポートされているサードパーティの AI プラットフォームを接続します。
  • 環境ごとに 1 回認証します。
  • エージェントを外部環境から Microsoft Agent 365 エージェント レジストリに同期します。
  • AI プラットフォーム API でサポートされているエージェント管理アクションを実行します。

外部プラットフォーム接続を管理する

Microsoft 365 管理センターの「Connected platforms」ページから外部プラットフォーム接続を作成・管理できます。

Microsoft 365 管理センターの「Connected platforms」ページのスクリーンショットで、Google Cloudの接続詳細パネルに同期状況と同期されたエージェントが表示されます。

このページでは、次のことができます。

  • 新しいプラットフォーム接続を作成します。
  • 接続同期の状態を表示します。
  • 最後の同期アクティビティを監視します。
  • 同期の試行に関連するエラーを確認します。
  • 既存の接続を削除します。

プラットフォーム接続を作成する

外部プラットフォームからエージェントを同期するには、次の手順に従います。

  1. ブラウザーでMicrosoft 365 管理センターを開きます。
  2. ナビゲーション ウィンドウで[エージェント]>[すべてのエージェント]を選択して、エージェント レジストリを表示します。
  3. 接続プラットフォームのウェブパートで「管理」を選択してください。 接続プラットフォームページが表示されます。
  4. [+ プラットフォームの接続]を選択します。
  5. 外部環境の接続名を入力し、説明を入力します。
  6. 外部プラットフォームを選択します。
  7. リージョンを選択します。
  8. エージェントを自動的にインポートするかどうかを指定します。
  9. 必要な認証資格情報を入力します。
  10. 資格情報を検証します。
  11. 接続を保存します。

検証とセットアップが成功した後:

  • Microsoft 365管理者は、Sync エージェント ボタンを使用して同期をトリガーできます。
  • 接続された環境のエージェントは、エージェント レジストリに同期されます。
  • 将来のリリースで、スケジュールに基づいて実行されるように将来の同期を構成できます。

同期後に詳細を表示する

既存の接続を選択して同期の詳細を表示し、同期の状態を監視します。

接続の詳細は次のとおりです。

  • プラットフォーム プロバイダー
  • Regions
  • 前回実行日
  • 最終同期の状態
  • 同期されたエージェントの合計数
  • 同期の結果

サポートされているプラットフォーム

以下のプラットフォームからエージェントを同期するためにConnected Platformsを使用します:

  • アマゾン・ベッドロック
  • Google Vertex AI
  • Salesforceエージェントフォース
  • Databricks Genie
  • Anthropic Claude 管理エージェント
  • オラクル生成AIエージェント

Note

Microsoft製品チームは、より多くのプラットフォームへのサポートの拡大に積極的に取り組んでいます。 新しいプラットフォーム統合については、頻繁に確認してください。

認証の要件

このセクションでは、接続プラットフォームにおける接続のためのプラットフォーム固有の認証要件と設定手順を提供します。

アマゾン・ベッドロック

Connected PlatformsでAmazon Bedrock環境への接続を設定するには、許可、コンテキスト、以下のAmazon Bedrock認証情報を持っているか確認してください:

  • AWS リージョン: エージェントがデプロイされているアマゾン ウェブ サービス リージョンに関する知識
  • Amazon Bedrock アクセス キー ID
  • Amazon Bedrock シークレット アクセス キー アクセス キー ID とシークレット アクセス キーを生成するには:
    • エージェントリソースに対する次のアクセス許可を持つ新規または既存の IAM ユーザーを作成します。

      • bedrock:ListAgents
      • bedrock:GetAgent
      • bedrock:ListAgentAliases
      • bedrock:GetAgentAlias
      • bedrock:ListAgentVersions
      • bedrock:GetAgentVersion
      • bedrock:InvokeModel
      • bedrock:InvokeAgent
      • bedrock:InvokeInlineAgent
      • bedrock:DeleteAgent
    • Bedrock AgentCoreのハーネスとランタイムを同期させるには、以下の権限を追加してください:

      • bedrock-agentcore:ListHarnesses
      • bedrock-agentcore:ListAgentRuntimes
      • bedrock-agentcore:ListGateways
      • bedrock-agentcore:ListGatewayTargets
      • bedrock-agentcore:GetHarness
      • bedrock-agentcore:GetAgentRuntime
      • bedrock-agentcore:GetGateway
      • bedrock-agentcore:GetGatewayTarget
      • bedrock-agentcore:GetMemory
      • bedrock-agentcore:DeleteHarness
      • bedrock-agentcore:DeleteAgentRuntime
      • bedrock-agentcore:DeleteGateway
      • bedrock-agentcore:DeleteGatewayTarget
      • bedrock-agentcore:DeleteMemory
    • 新しいアクセス キーを作成します。

アクセスキーと秘密鍵の作成の詳細については、 Amazon BedrockAmazon Web Services のドキュメントを参照してください。 Amazon Bedrock と Microsoft Entra エージェント ID の詳細については、「 Microsoft Entra エージェント IDを参照してください。

Google Vertex AI

Google Cloud 環境に関連付けられている資格情報を入力して、エージェントの認証と同期を行います。

Connected platformsでGoogle Vertex AI環境への接続を設定するには、権限、コンテキスト、以下のGoogle Vertex AI認証情報を持っているか確認してください:

  • Google クラウド リージョン: エージェントがデプロイされている頂点リージョンに関する知識。
  • Google Vertex AI プロジェクト ID: Google Vertex AI プロジェクトの ID。
  • Google Vertex AI 資格情報: シークレット アクセス キー
    • プロジェクト リソースへの次のアクセス権を持つ新しいサービス アカウントを作成するか、既存のサービス アカウントを使用します。
      • Vertex AI 管理者ロールまたは権限付きのカスタムロール:
        • aiplatform.reasoningEngines.list
        • aiplatform.reasoningEngines.get
        • aiplatform.reasoningEngines.delete
    • 新しい秘密鍵を生成する

サービス アカウント キーの作成の詳細については、 Google Cloud Vertex AIGoogle Cloud のドキュメントを参照してください

Salesforceエージェントフォース

Connected PlatformsでSalesforceエージェントフォース環境に接続を設定するには、適切な権限、ドメインURL、コンシューマーキー、コンシューマーシークレットを持つSalesforceアカウントを持っていることを確認してください。

SalesforceでOAuthを設定するには接続アプリを設定しMy Domain URLを取得しコンシューマーキーとシークレットを取得します。

接続されているアプリを設定する

  1. [セットアップ]> [Search App Manager] に移動します。
  2. [外部クライアント アプリ マネージャー] を選択します。
  3. [新しい外部クライアント アプリ] を選択し、詳細を入力します。
  4. [OAuth を有効にする] をオンにします
  5. コールバック URL を設定します。
    • テストの場合: https://login.salesforce.com/services/oauth2/success
  6. 次のスコープを [使用可能] から [選択済み] に移動します。
    • チャットボット サービスへのアクセス (chatbot_api)
    • Salesforce API プラットフォームへのアクセス (sfap_api)
    • API を使用してユーザー データを管理する (api)
    • いつでも要求を実行する (refresh_tokenoffline_access)
  7. クライアント資格情報フローを有効にします。
  8. 保存を選びます。
  9. ポリシー>OAuth ポリシーに移動します。
  10. クライアント資格情報フローを有効にし、API アクセス権を持つユーザーに実行を設定します (たとえば、usernamd1.eb52cfb153dc@agentforce.com)。

マイ ドメインの URL を取得する

  1. セットアップ>に移動し、My Domainを検索します。
  2. 現在の マイ ドメイン URL をコピーします

コンシューマー キーとシークレットを取得する

  1. 接続されているアプリを保存した後、 外部クライアント アプリ マネージャーに戻ります。
  2. アプリを見つける
  3. [設定][OAuth 設定] を選択します。
  4. コンシューマー キーとシークレットを選択すると、次の情報が表示されます。
    • コンシューマー キー
    • コンシューマー シークレット ( [クリックして表示] を選択)

Salesforce で OAuth を設定し、コンシューマー キーとコンシューマー シークレットを取得する方法の詳細については、 Salesforce Agentforce のドキュメントを参照してください

Databricks Genie

Connected PlatformsでDatabricksへの接続を設定するには、Databricksアカウント内にワークスペースで管理者権限を持つサービスプリンシパルが必要です。

有効な接続を作成するには、次のものが必要です。

  • ワークスペースURL:DatabricksポータルURL
  • クライアント ID: サービス プリンシパル クライアント/アプリケーション ID
  • クライアント シークレット: サービス プリンシパル クライアント シークレット

サービス プリンシパルの作成の詳細については、 Databricks のパブリック ドキュメントを参照してください

Anthropic Claude 管理エージェント

Connected PlatformsでAnthropic Claudeへの接続を設定するには、Anthropic Claudeアカウント内にワークスペースと、そのワークスペースにアクセスできるワークスペーススコープ付きのAPIキーが必要です。

Note

デフォルトのワークスペースではなく、Connected Platformsで使う新しいワークスペースを作成しましょう。 デフォルトのワークスペースでは、接続を作成する際に使えるワークスペースIDは公開されません。

Important

Anthropic ClaudeのマネージドエージェントAPIは現在ベータ版です。 その結果、ConnectedプラットフォームにおけるAnthropic Claude接続は現在プレビュー機能として利用可能です。

有効な接続を作成するには、次のものが必要です。

  • ワークスペースID:同期するエージェントを含むAnthropic Claudeワークスペースの一意ID。
  • APIキー:選択したワークスペース用のワークスペーススコープを持つAnthropic APIキーです。

オラクル生成AIエージェント

Connected platformsでOracle Cloud Infrastructure Generative AIエージェント環境への接続を設定するには、サービスアカウントを作成し必要な権限を付与します。

ステップ1:グループ作成

  1. cloud.oracle.com に行ってサインインしてください。
  2. メニューアイコンを選択し、「 Identity & Security>Domains」を選択してください。
  3. デフォルトドメイン、またはアクティブなドメインを選択してください。
  4. ユーザー管理タブを選択し、次にグループ>グループ作成を選択します
  5. 次の情報を入力します。
    • 名前: 3P-Portal-Agents
    • 説明: 3P portal access to list, read, and delete GenAI Agents
  6. を選択してを作成します。

ステップ2:サービスユーザーを作成する

  1. 同じアイデンティティドメイン内の 「ユーザー管理 」タブで「 ユーザー>作成」を選択します。

  2. 次の情報を入力してください。

    • First Name:SVC
    • Last Name:3P Portal Agents
    • ユーザー名: svc-3p-portal-agents
    • メール:共有郵便受け(例えばsvc-genai@yourcompany.com)を入力してください
  3. 表示されている場合は メールアドレスをユーザー名として使用 してください。

  4. を選択してを作成します。

  5. ユーザーページで「グループ」>「グループに割り当て」を選択し、その後「3P-Portal-Agents」を選択してください。

    Note

    このユーザーのコンソールパスワードは設定しないでください。 API専用であるべきです。

ステップ3:サービスユーザーのためのAPIキーを生成する

  1. サービスユーザーのページで、 APIキーのページに移動します。

  2. [Add API Key](API キーの追加) を選択します。

  3. APIキーペアを生成する」を選択します。

  4. 「プライベートキーをダウンロード」を選択し、ファイルをoci_api_key.pemとして保存してください。

  5. [] を選択し、[] を追加します。

  6. 設定ファイルのプレビューをコピーしてください。 次の例のようになります。

    [DEFAULT]
    user=ocid1.user.oc1..aaaaaa...
    fingerprint=ab:cd:ef:12:...
    tenancy=ocid1.tenancy.oc1..aaaaaa...
    region=us-chicago-1
    key_file=<path to private key>
    
  7. を選択してを閉じます。

ステップ4:IAMポリシーを作成する

サードパーティアプリは、エージェント、エンドポイント、ナレッジベースを読み取る権限や、エージェントやエンドポイントを削除する権限を必要とします。

  1. メニューアイコンを選択し、次に 「Identity & Security>Policies」を選択します。
  2. ルートコンパートメント、またはエージェントが住んでいるコンパートメントを選びましょう。
  3. [ポリシーを作成する] を選択します。
  4. 次の情報を入力します。
    • 名前: 3P-Portal-GenAI-Agents
    • 説明: 3P portal: read + delete GenAI Agents
  5. オプションAまたはオプションBのポリシーステートメントを追加してください。<YourCompartment>を自分の区画名に置き換えてください。 すべての区画をカバーするには、compartment <YourCompartment>ではなく「tenancy」を使いましょう。
  6. を選択してを作成します。

オプションA:完全管理

以下のポリシーは、作成、読み取り、更新、削除操作を含む完全な管理権限を付与します。

Allow group 3P-Portal-Agents to manage generative-ai-agent-family in compartment <YourCompartment>

このオプションはポリシー文の使用数が少なくなりますが、作成や更新操作も可能で、アプリが要求するよりは寛容です。

以下のポリシーは、すべてのエージェントリソースをリストとアクセス権付与し、管理側の削除操作へのアクセスを制限します。

Allow group 3P-Portal-Agents to read generative-ai-agent-family in compartment <YourCompartment>
Allow group 3P-Portal-Agents to manage genai-agent in compartment <YourCompartment> where request.permission = 'GENAI_AGENT_DELETE'
Allow group 3P-Portal-Agents to manage genai-agent-endpoint in compartment <YourCompartment> where request.permission = 'GENAI_AGENT_ENDPOINT_DELETE'

エンドポイントを持つエージェントを削除するのも、エンドポイントの削除権限が必要です。 したがって、両方の削除ポリシー文が必要です。

ステップ5:コンパートメントのOCIDを取得します

アプリは区画内のエージェントを一覧にします。 エージェントがいる区画に入りましょう。 ルートテナンシー区画を使って、サブツリー検索で子区画をカバーします。

  1. メニューアイコンを選択し、次に 「Identity & Security>Compartments」を選択します。
  2. コンパートメントのOCIDをコピーしてください。 ルート区画については、テナンシーのOCIDを使います。

ステップ6:接続情報を提供する

OCI生成AIエージェントを接続するには、以下の情報を提供します。

Item Example 用途
秘密キー ファイル oci_api_key.pem APIリクエストの署名
ユーザーOCID ocid1.user.oc1..aaaaaa... サービス利用者識別
テナント OCID ocid1.tenancy.oc1..aaaaaa... テナンシーまたはルート区画
指紋 ab:cd:ef:12:34:... APIキーフィンガープリント
Region us-chicago-1 エージェントが活動する地域
コンパートメント OCID ocid1.tenancy.oc1..aaaaaa... またはチャイルドコンパートメントのOCID エージェントがリストまたは削除される場所

アクセスを取り消す

  • 即時:Identity & Security>Domains>Default>User Management>>svc-3p-portal-agents>API Keys>Delete)からサービスユーザーからAPIキーを削除します。
  • 恒久的:サービスユーザーを削除します。
  • 一時的:ユーザーを 3P-Portal-Agents グループから削除します。 この方針はもはや適用されません。
  • 範囲を縮小する:オプションBの2つの manage 削除文を削除し、アカウントを読み取り専用にします。

Note

同期されているのはアクティブなOCI生成AIエージェントのみです。