次の方法で共有

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

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 操作がサポートされています。

注

隔離および解除APIはClassic Chatbot(v1)とは互換性がありません。 APIはクラシックチャットボットを隔離または解除したときに 200 OK 戻りますが、ブロックしてもクラシックチャットボットは引き続き利用可能です。

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

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

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

詳細は Get Bot Quarantine Status APIの参照ドキュメントをご覧ください。

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

  • エンドポイント:POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsQuarantined?api-version=1
  • 目的:エージェントを隔離対象とマークし、その利用可能性とやり取りを制限する
  • 回答:隔離状況更新確認

詳しくは 「Set Bot As Quarantined APIの参考ドキュメント」をご覧ください。

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

  • エンドポイント:POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsUnquarantined?api-version=1
  • 目的:リスク評価および対策の後、検疫からエージェントを除去すること
  • 回答:隔離状況更新確認

詳細は 「Set Bot As Unquarantined APIの参考ドキュメント」をご覧ください。

  • Last updated on