For the complete documentation index, see llms.txt. Markdown versions of all docs pages are available by appending .md to any docs URL.

Solo Enterprise for agentregistry を Microsoft Copilot Studio に接続します。

このガイドでは、Solo Enterprise for agentregistry を Microsoft Copilot Studio に接続し、デプロイ済みのエージェントを検出して、レジストリ UI の Instances ビューにインスタンスとして追加する方法を説明します。

始める前に

1. OIDC プロバイダーをセットアップします。このガイドでは、Keycloak をインストール済みであることを前提とします。General setup タブに従って、必要なレルム設定、クライアント、シークレットとともに Keycloak をインストールしてください。
2. Solo Enterprise for agentregistry をインストールする。
3. Dataverse が有効な Power Platform 環境 にアクセスできること、および Entra アプリを登録して環境を管理できる十分な権限があることを確認します。

ステップ 1: Entra アプリ登録を作成する

Entra アプリ登録は、Solo Enterprise for agentregistry が Microsoft で認証するために使用するサービス ID です。Power Platform 環境からエージェントをレジストリが同期するとき、レジストリはアプリ登録のクライアント ID とシークレットを使用して Microsoft Entra にトークンを要求します。次に、そのトークンを使用して Dataverse Web API を呼び出し、Copilot Studio のエージェントを検出します。

このステップでは、Entra アプリ登録を作成し、クライアントシークレットを生成します。

1. Azure portal にログインし、Microsoft Entra ID → +Add → App registrations に移動します。

2. アプリ登録を作成します。

   • agentregistry-copilot などのアプリ名を入力します。

• アプリにアクセスできるアカウントの種類を選択します。
  • リダイレクト URI は空のままにします。次に、Register をクリックします。

3. Entra アプリの概要ページで Application (client) ID と Directory (tenant) ID を取得し、環境変数として保存します。

   export AZURE_TENANT_ID=<directory-tenant-ID>
   export AZURE_CLIENT_ID=<application-client-ID>

4. Manage → Certificates & secrets → + New client secret に移動します。証明書の有効期限を設定し、Add をクリックします。

5. シークレットの Value は一度しか表示されないため、すぐにコピーして環境変数に保存します。

   export AZURE_CLIENT_SECRET=<client-secret-value>

6. クライアントシークレットの値を Solo Enterprise for agentregistry の Secret に保存します。これにより、値はサーバー側のシークレットバックエンドに書き込まれ、ランタイムに平文で保存されることはありません。

   arctl apply -f - <<EOF
   apiVersion: ar.dev/v1alpha1
   kind: Secret
   metadata:
     name: microsoft-copilot-creds
   spec:
     type: Opaque
     stringData:
       clientSecret: "${AZURE_CLIENT_SECRET}"
   EOF

   出力例:

   ✓ Secret/microsoft-copilot-creds created
   

7. Secret が作成されたことを確認します。

   arctl get secret microsoft-copilot-creds

   出力例:

   NAME                      TYPE     DATA
   microsoft-copilot-creds   Opaque   1
   

ステップ 2: Power Platform 環境の詳細を確認する

Copilot Studio のエージェントは、すべて Power Platform 環境の中に存在します。環境は、チームや事業部門ごとにアプリ、フロー、データをまとめる分離されたコンテナーで、独自の Dataverse データベースインスタンスに支えられています。このデータベースには、Copilot Studio のエージェント定義が bot レコードとして保存されます。Solo Enterprise for agentregistry が Copilot Studio ランタイムを同期するとき、その特定の環境の Dataverse Web API に問い合わせて bot レコードの一覧を取得し、レジストリ UI にインスタンスとして表示します。

Copilot の bot レコードを同期するには、エージェントがデプロイされている環境 ID (GUID) と、この環境が接続されている Dataverse Web API の URL が Solo Enterprise for agentregistry に必要です。

1. Open the Power Platform admin center at admin.powerplatform.microsoft.com。

2. Manage → Environments に移動し、Copilot Studio エージェントが含まれる環境を開きます。環境がない場合は New をクリックし、環境の種類、リージョン、名前を選択してから Save をクリックします。

3. 環境の詳細ページで Environment ID と Environment URL をコピーし、環境変数として保存します。環境を初めて作成した場合は、続行する前にその環境の Dataverse バックエンドをプロビジョニングする必要がある場合があります。

   export POWER_PLATFORM_ENVIRONMENT_ID=<environment-id>
   export DATAVERSE_ENDPOINT=https://<org>.crm.dynamics.com

ステップ 3: アプリを Dataverse アプリケーションユーザーとして登録する

Solo Enterprise for agentregistry が Copilot Studio ランタイムからエージェントを同期するとき、Dataverse Web API を呼び出して Bot テーブルから bot レコードの一覧を取得します。bot レコードは、Copilot Studio のエージェント定義を表します。Dataverse には Azure RBAC とは別の独自の権限モデルがあります。デフォルトでは、Microsoft Entra のアプリは Dataverse API にアクセスできません。アクセスを許可するには、Entra アプリを Dataverse の ID に紐付ける Dataverse アプリケーションユーザーを作成し、その ID に Bot テーブルのレコードの読み取りを許可するセキュリティロールを割り当てます。

1. admin.powerplatform.microsoft.com の Power Platform 管理センター で Manage を選択し、先ほど作成または選択した環境を開きます。
2. Click Settings → Users + permissions → Application ユーザーs → + New app ユーザー。
3. + Add an app をクリックし、作成した Entra アプリ登録を検索して選択し、Add を選択します。
4. Set your Business unit。
5. Security roles の下にある編集アイコンをクリックし、Bot テーブルへの読み取りアクセスを許可するロールを割り当てます。テスト目的であれば、System Administrator を使用します。最小権限にするには、代わりに Bot テーブルの読み取り権限を持つカスタムロールを作成してください。その後、Save をクリックします。

ステップ 4: MicrosoftCopilotStudio ランタイムを登録する

Power Platform 環境を、Solo Enterprise for agentregistry の検出ランタイムとして登録します。このランタイムは Entra のクライアント認証情報フローを使用して Dataverse Web API を呼び出し、Copilot Studio のエージェントをデプロイ済みインスタンスとしてレジストリ UI に同期します。

1. MicrosoftCopilotStudio ランタイムを作成します。

   arctl apply -f - <<EOF
   apiVersion: ar.dev/v1alpha1
   kind: Runtime
   metadata:
     name: copilot-studio
   spec:
     type: MicrosoftCopilotStudio
     config:
       environmentId: "${POWER_PLATFORM_ENVIRONMENT_ID}"
       dataEndpoint: "${DATAVERSE_ENDPOINT}"
       auth:
         oidc:
           issuer: "https://login.microsoftonline.com/${AZURE_TENANT_ID}/v2.0"
           clientId: "${AZURE_CLIENT_ID}"
           clientSecretRef:
             name: microsoft-copilot-creds
             key: clientSecret
   EOF

   Field	Description
   type	Copilot Studio の検出プロバイダーを有効にするには MicrosoftCopilotStudio に設定します。
   config.environmentId	The Power Platform 環境 GUID から Step 2。
   config.dataEndpoint	環境の Dataverse Web API URL です (https://<org>.crm.dynamics.com)。
   config.auth.oidc.issuer	テナントの Microsoft Entra OIDC 発行者 URL です。https://login.microsoftonline.com/<directory-tenant-id>/v2.0 の形式に従います。
   config.auth.oidc.clientId	Entra アプリ登録の Application (client) ID です。
   config.auth.oidc.clientSecretRef	Entra のクライアントシークレットの値を保持する Solo Enterprise for agentregistry の Secret への参照です。

   出力例:

   ✓ Runtime/copilot-studio created
   

2. ランタイムの詳細を取得し、設定した Power Platform 環境との同期が成功していることを確認します。同期中に問題が発生した場合は、ランタイムのステータスにエラーが表示されます。

   arctl get runtime copilot-studio -o yaml

   出力例:

   status:
    conditions:
     - lastTransitionTime: "2026-07-01T13:27:21.915068044Z"
       reason: SyncOK
       status: "True"
       type: Synced
    details:
       runtimeSync:
         lastSyncStatus: ok
         lastSyncedAt: "2026-07-01T13:40:43Z"
   

これで完了です。Solo Enterprise for agentregistry のセットアップと、Microsoft Copilot Studio 環境への接続が完了しました。Copilot Studio のエージェントが検出可能になり、レジストリ UI に表示されるようになりました。

次のステップ