Power Platform API による孤児エージェントの所有権の再割り当て

Copilot Studio は、Power Platform API を通じて孤立したエージェントの所有権を再割り当てする機能など、エージェントのセキュリティとコンプライアンスを管理するための堅牢なツールを管理者に提供します。

孤立したエージェントの所有権の再割り当ては、Copilot Studio の広範なセキュリティ フレームワークの一部であり、Copilot Studio の全体的なセキュリティ アプローチと連携して機能します。

例えば、エージェントの元の所有者が組織を離れたりロールを変更したりすると、管理されなくなった孤児エージェントが発生することがあります。 この状況では、エージェントの設定やコンプライアンス要件を管理する責任者が不在となり、ビジネスプロセスの混乱やセキュリティリスクの発生につながる可能性があります。 管理者は、Reassign API を使用してこれらの孤児エージェントの所有権を再割り当てし、適切にマネージドされた状態とコンプライアンスの確保を行うことができます。

Copilot Studio のエージェント ユーザーや作成者は、再割り当てされたエージェントを見ることができます。 新しい所有者はエージェントの環境に対して環境作成者の権限を取得します。 元の所有者は再割り当て後、エージェントへのアクセスを失います。 エージェントの所有権が再割り当てされた後、新しい所有者が トランスクリプトを読む 権限を持っている場合、エージェントの既存のすべてのトランスクリプトにアクセスできます。

重要

powervirtualgents 名前空間は非推奨です。 API 呼び出しでは、copilotstudio 名前空間を使用してください。

必要条件

  • ターゲット エージェントのボット ID と環境 ID があります。
  • Microsoft Entra ID OAuth2 によって発行されたユーザー アクセストークンを取得する必要があります。 トークンの取得については、認証を参照してください。
    • Copilot Studioで作成されたエージェントの所有者を再割り当てするには、トークンに関連付けられたユーザーが次のいずれかの管理者ロールを持っている必要があります。
      • グローバル テナント管理者
      • AI 管理者
      • Power Platform 管理者
      • 環境管理者
    • エージェント ビルダーで作成されたエージェントの所有者を再割り当てするには、トークンに関連付けられたユーザーが以下のいずれかの管理者ロールを持っている必要があります。
      • グローバル テナント管理者
      • AI 管理者
      • Power Platform 管理者
    • Power Platform API で付与された CopilotStudio.AdminActions.Invoke スコープを持つアプリ登録のクライアント ID を使用して、アクセス トークンを取得する必要があります。
  • エージェントの所有権を再割り当てする必要がある新しい所有者の Entra ユーザー ID をお持ちです。
  • 新しい所有者はテナントに所属している必要があります。

エージェント所有権の再割り当てのための API 操作

Copilot Studio は、Power Platform API の一部として、孤立したエージェントを新しい所有者に再割り当てするための REST API reassign 操作をサポートしています。

紙幣

Reassign API はクラシックチャットボットをサポートしていません。 API は、クラシックチャットボットの所有権の再割り当てを試みると 405 Method Not Allowed を返します。

Power Platform API の使用方法と使用タイミングの詳細については、以下を参照してください:

エージェント所有権を新しい所有者に再割り当てする

  • エンドポイント: POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botAdminOperations/reassign?api-version=1

  • 本文: {"NewOwnerAadUserId": "EntraUserId"}

    EntraUserId を新しい所有者の Entra ユーザー ID に置き換えてください。

  • 目的: エージェントの所有者を変更する

  • 応答: コンテンツなし

  • Last updated on