Power Platform API を使用して非準拠エージェントを検査する

Microsoft Copilot Studio は、Power Platform API を介したエージェントの検査アクションなど エージェントのセキュリティとコンプライアンスを管理するための信頼性の高いツール を管理者に提供します。

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

例えば、データ ポリシーに違反 しているエージェントや コンプライアンス ドキュメントがない エージェントは、監査、ランタイム保護、またはその他の管理者レポートまたは通知の一部としてフラグを設定できます。 その後、管理者は検査 API を使用して、セキュリティとコンプライアンスの問題を調査および修復しながら、非準拠エージェントを隔離できます。

検査されたエージェントは、エージェント ユーザーおよび Copilot Studio の作成者には引き続き表示されますが、エージェントと対話したり使用したりすることはできません。

重要

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

必要条件

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

エージェント検査管理の API 操作

Copilot Studio では、Power Platform API の一部として、エージェント検査を管理するための 3 つの主要な REST API 操作がサポートされています。

紙幣

SetAsQuarantined および SetAsUnquarantined API は、クラシック チャットボットには対応していません。 クラシック チャットボットを隔離または解除しようとすると、API は 405 Method Not Allowed を返します。

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

エージェントの検査状態を取得する

  • エンドポイント: GET https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine?api-version=1
  • 目的: エージェントの現在の検査状態を取得します
  • 応答: ブール値の isBotQuarantined と lastUpdateTimeUtc を返します

詳細については、「ボットの検査の状態を取得する」API リファレンスドキュメントをご覧ください。

エージェントを検査済みとして設定する

  • エンドポイント: POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsQuarantined?api-version=1
  • 目的: エージェントを検査済みとしてマークし、その利用可能性と対話を制限します
  • 応答: 検査状態の更新を確認します

詳細については、「ボットを隔離済みとして設定する」API リファレンス ドキュメントをご参照ください。

エージェントを未検査として設定する

  • エンドポイント: POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsUnquarantined?api-version=1
  • 目的: 危険評価と対策の後にエージェントを検査から削除します
  • 応答: 検査状態の更新を確認します

詳細については、「ボットを未隔離として設定する」API リファレンス ドキュメントをご参照ください。

  • Last updated on