Supprimer des agents par programmation à l’aide de l’API Power Platform

Copilot Studio fournit aux administrateurs des outils robust pour gérer la sécurité et la conformité des agents, notamment la possibilité de supprimer des agents via l’API Power Platform.

La suppression d'agents fait partie du cadre de sécurité plus large de Copilot Studio et fonctionne en tandem avec votre approche globale de sécurité dans Copilot Studio.

Par exemple, les audits, la protection du runtime et d’autres rapports ou notifications d’administrateur peuvent marquer des agents qui violent les exigences organisationnelles en matière de sécurité et d’authentification. Les administrateurs peuvent utiliser l’opération delete pour supprimer des agents non conformes lors de l’examen et de la correction des problèmes de sécurité et de conformité.

Lorsque vous supprimez des agents, vous les supprimez de votre environnement. Les créateurs et les anciens utilisateurs ne peuvent plus les voir.

Lorsque vous supprimez un agent doté d’un Identifiant d’assistant Microsoft Entra, l’ID d’agent associé (ou l’inscription d’application pour les agents hérités) est également supprimé de Microsoft Entra ID. Pour plus d’informations, consultez Automatically create Microsoft Entra agent identities.

Important

L'espace de noms powervirtualgents est obsolète. Utilisez l’espace copilotstudio de noms dans vos appels API.

Prerequisites

  • Vous disposez de l’ID de bot et de l’ID d’environnement de l’agent cible.
  • Vous devez obtenir un jeton d’accès utilisateur émis par Microsoft Entra ID OAuth2. Pour obtenir un jeton, consultez Authentification.
    • L’utilisateur associé au jeton doit avoir l’un des rôles administrateur suivants :
      • Administrateur de locataires général
      • Administrateur IA
      • Administrateur Power Platform
    • Vous devez acquérir le jeton d'accès en utilisant l'ID client d'une inscription d'application dont l'étendue CopilotStudio.AdminActions.Invoke est accordée via l’API Power Platform.

Opérations d’API de suppression d’assistant

Copilot Studio, dans le cadre de l’API Power Platform, prend en charge l’opération delete de l’API REST pour la suppression d’agents.

Pour plus d’informations sur la façon et le moment d’utiliser l’API Power Platform, consultez :

Supprimer l’assistant

  • Point de terminaison :DELETE https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botAdminOperations?api-version=1
  • Objectif : Supprimer définitivement un agent
  • Réponse : Retour 204 OK si l’agent a été supprimé avec succès

Pour en savoir plus, consultez la documentation de référence de l’API 'Delete Copilot Agent'.

  • Last updated on