Réaffectation de la propriété des agents orphelins via l’API Power Platform

Copilot Studio offre aux administrateurs des outils robustes pour gérer la sécurité et la conformité des bots, y compris la possibilité de réaffecter la propriété d’agents orphelins via l’API Power Platform.

La réaffectation de la propriété des agents orphelins 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, lorsque le propriétaire initial d’un agent quitte l’organisation ou change de rôle, cela peut entraîner des agents orphelins qui manquent de gestion adéquate. Cette situation peut perturber les processus métier et créer des risques de sécurité, car il peut ne pas y avoir de partie responsable pour gérer les paramètres et les exigences de conformité de l’agent. Les administrateurs peuvent utiliser l’API Reassign pour réattribuer la propriété de ces agents orphelins afin de s’assurer qu’ils restent correctement gérés et conformes.

Les utilisateurs et créateurs d’agents dans Copilot Studio peuvent voir les agents qui sont réaffectés. Le nouveau propriétaire obtient les permissions du créateur d’environnement sur l’environnement du bot. Le précédent propriétaire perd accès à l’agent après la réaffectation.

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.
    • Pour réaffecter le propriétaire d’un agent créé dans Copilot Studio, l’utilisateur associé au jeton doit avoir l’un des rôles d’administrateur suivants :
      • Administrateur de locataires général
      • Administrateur IA
      • Administrateur Power Platform
      • Administrateur de l’environnement
    • Pour réattribuer le propriétaire d’un agent créé dans Agent Builder, l’utilisateur associé au jeton doit avoir l’un des rôles d’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.
  • Vous avez l’identifiant utilisateur Entra du nouveau propriétaire à qui la propriété de l’agent doit être réattribuée.
  • Le nouveau propriétaire doit appartenir au locataire.

Opérations API pour réaffecter la responsabilité des agents

Copilot Studio prend en charge l’opération d’API REST reassign pour réaffecter des agents orphelins aux nouveaux propriétaires, dans le cadre de l’API Power Platform.

Note

L’API Reassign ne prend pas en charge les chatbots classiques. L’API retourne 405 Method Not Allowed lorsque vous essayez de réaffecter la propriété d’un chatbot classique.

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

Réattribuer la propriété d’un agent à un nouveau propriétaire

  • Point de terminaison :POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botAdminOperations/reassign?api-version=1

  • Corps : {"NewOwnerAadUserId": "EntraUserId"}

    Remplacez-le EntraUserId par l’identifiant utilisateur Entra du nouveau propriétaire.

  • Objectif : Changer le propriétaire de l’agent

  • Réponse : Aucun contenu

  • Last updated on