Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Microsoft Copilot Studio fournit aux administrateurs des outils robustes pour gérer la sécurité et la conformité des bots, notamment des actions de mise en quarantaine pour les assistants via l’API Power Platform.
La mise en quarantaine des assistants fait partie du cadre de sécurité plus large de Copilot Studio et fonctionne de pair avec votre approche globale de la sécurité dans Copilot Studio.
Par exemple, les bots qui enfreignent les stratégies de prévention de la perte de données (DLP) ou qui ne disposent pas de documentation de conformité peuvent être signalés dans le cadre d’audits, de la protection à l’exécution ou d’autres rapports ou notifications administratifs. Les administrateurs peuvent ensuite utiliser les API de mise en quarantaine pour isoler les assistants non conformes pendant l’enquête et la résolution des problèmes de sécurité et de conformité.
Les assistants mis en quarantaine resteront visibles pour les utilisateurs de l’assistant (et pour les créateurs d’assistants dans Copilot Studio), mais ils ne pourront ni interagir avec l’assistant ni l’utiliser.
Important
L’espace de noms plus ancien powervirtualgents est obsolète et sera supprimé d’ici la fin 2025.
Utilisez l’espace de noms copilotstudio dans vos appels d’API, comme indiqué dans cet article.
Configuration requise
- Vous devez être un administrateur de locataire Power Platform ou un administrateur Power Platform ou un administrateur Dynamics 365 Service.
- Vous disposez de l’ID de bot et de l’ID d’environnement de l’assistant cible.
- Vous disposez de jetons d’authentification pour le service ou l’utilisateur utilisant l’API.
- Vous êtes authentifié via Microsoft Entra ID OAuth2, en utilisant le flux implicite dans l’URL d’autorisation :
https://login.microsoftonline.com/common/oauth2/authorize?resource=https://api.powerplatform.com.
API de gestion de la mise en quarantaine des assistants
Copilot Studio prend en charge trois opérations d’API REST clés pour gérer la mise en quarantaine des assistants, dans le cadre de l’API Power Platform.
Pour savoir de quelle manière et dans quels cas utiliser l’API Power Platform, consultez :
- API Power Platform et SDK : De l’approche centrée sur l’UX à l’approche centrée sur l’API (blog) (blog du développeur Power Platform)
- Vue d’ensemble de la programmabilité et de l’extensibilité (documentation Power Platform)
- Prise en main de l’API Power Platform (version préliminaire) (documentation Power Platform)
Cet article décrit les opérations disponibles, qui sont également définies dans la documentation de référence de l’API Power Platform.
Important
L’espace de noms copilotstudio doit être utilisé pour les opérations d’API associées à Copilot Studio.
L’espace de noms plus ancien powervirtualgents est obsolète et sera supprimé d’ici la fin 2025.
Si vous avez déjà utilisé l’espace de noms powervirtualagents, mettez à jour vos appels d’API pour utiliser l’espace de noms copilotstudio afin de garantir une fonctionnalité continue.
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/GetBotQuarantineStatus?api-version=1. - Objectif : Récupérer l’état de mise quarantaine actuel d’un assistant.
- Réponse : retourne une valeur booléenne
isBotQuarantinedetlastUpdateTimeUtc.
Consultez la documentation de référence de l’API sur l’état de mise en quarantaine pour connaître les exigences des paramètres et les codes de réponse.
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 assistant comme mis en quarantaine, afin d’en restreindre la disponibilité et les interactions.
- Réponse : confirme la mise à jour de l’état de mise en quarantaine.
Consultez la documentation de référence de l’API sur la mise en quarantaine des assistants pour connaître les exigences des paramètres et les codes de réponse.
Retirer l’assistant de la quarantaine
- Point de terminaison :
POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsUnquarantined?api-version=1. - Objectif : retirer un assistant de la quarantaine après évaluation et atténuation des risques.
- Réponse : confirme la mise à jour de l’état de mise en quarantaine.
Consultez la documentation de référence de l’API sur le retrait des assistants de la quarantaine pour connaître les exigences des paramètres et les codes de réponse.