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

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

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

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

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

Microsoft Entra Agent IDを持つエージェントを削除すると、関連付けられているエージェント ID (またはレガシ エージェントのアプリの登録) もMicrosoft Entra IDから削除されます。 詳細については、「エージェント ID を自動的に作成するMicrosoft Entraを参照してください。

重要

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