次の方法で共有

Power Platform API を使用してプログラムによりエージェントを削除する

Copilot Studio では、Power Platform API を使用してエージェントを削除する機能など、エージェントのセキュリティとコンプライアンス<>を管理するための robust ツールが管理者に提供されます。

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

例えば、組織のセキュリティや認証要件に違反するエージェントは、監査、ランタイム保護、その他の管理レポートや通知の一部としてフラグを立てることができます。 管理者は delete 操作を使って非準拠エージェントを削除しつつ、セキュリティおよびコンプライアンスの問題を調査・修正できます。

削除されたエージェントは環境から削除されます。 制作者や過去のユーザーはもはやそれらを見ることができません。

重要

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 の一部として、エージェントを削除または削除するための REST API delete 操作がサポートされています。

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

エージェントを削除する

  • エンドポイント:DELETE https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botAdminOperations?api-version=1
  • 目的:エージェントを永久に削除する
  • 回答:エージェントが正常に削除された場合 204 OK 返します

詳細については、Delete Copilot Agent API リファレンス ドキュメントを参照してください。

  • Last updated on