Mettre en quarantaine des assistants non conformes avec l’API Power Platform

Copilot Studio offre aux administrateurs des outils robustes pour gérer la sécurité et la conformité des agents, y compris les actions de quarantaine des agents via l’API Power Platform.

La mise en quarantaine des 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 agents qui enfreignent les politiques de données ou ne possèdent pas de documentation de conformité peuvent être signalés dans le cadre d’audits, de protections à l’exécution ou d’autres rapports ou notifications d’administration. Les administrateurs peuvent ensuite utiliser les API de quarantaine pour isoler les agents non conformes lors de l’examen et de la correction des problèmes de sécurité et de conformité.

Les agents en quarantaine restent visibles pour les utilisateurs et créateurs d’agents dans Copilot Studio, mais il n’est pas possible d’interagir avec ou d’utiliser l’agent.

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’identifiant client d’une application enregistrée qui possède le champ d’application CopilotStudio.AdminActions.Invoke accordé par l’API Power Platform.

API de gestion de la mise en quarantaine des agents

Copilot Studio prend en charge trois opérations d’API REST clés pour la gestion de la quarantaine de l’agent, dans le cadre de l’API Power Platform.

Note

Les API SetAsQuarantined et SetAsUnquarantined ne prennent pas en charge les chatbots classiques. L’API retourne 405 Method Not Allowed lorsque vous essayez de mettre en quarantaine ou de retirer de la quarantaine un chatbot classique.

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

Obtenir l’état de mise en quarantaine de l’assistant

  • Point de terminaison :GET https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine?api-version=1
  • Objectif : Récupérer le statut actuel de quarantaine d’un agent
  • Réponse : Retourne un booléen isBotQuarantined et lastUpdateTimeUtc

En savoir plus dans la documentation de référence de l’API Get Bot Quarantine Status.

Définir un assistant comme mis en quarantaine

  • Point de terminaison :POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsQuarantined?api-version=1
  • Objectif : Marquer un agent comme en quarantaine, limitant ainsi sa disponibilité et ses interactions
  • Réponse : Confirmation de la mise à jour du statut de la quarantaine

En savoir plus dans la documentation de référence de l'API Définir le Bot comme Mis en Quarantaine.

Définir l’agent comme hors de quarantaine

  • Point de terminaison :POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsUnquarantined?api-version=1
  • Objectif : Retirer un agent de la quarantaine après évaluation des risques et remédiation
  • Réponse : Confirmation de la mise à jour du statut de la quarantaine

Pour en savoir plus, consultez la documentation de référence API Set Bot As Unquarantined.

  • Last updated on