Réattribuez la propriété des assistants orphelins via l’API Power Platform

Microsoft Copilot Studio fournit aux administrateurs des outils robustes pour gérer la sécurité et la conformité de la conversation instantanée, notamment la capacité de supprimer les assistants via l’API Power Platform.

Réattribuer la propriété des assistants orphelins fait partie du cadre de sécurité plus large de Copilot Studio et s’intègre à votre approche globale de la sécurité dans Copilot Studio.

Par exemple, lorsque le propriétaire initial d’un assistant quitte l’organisation ou change de rôle, cela peut entraîner des assistants orphelins qui ne sont plus correctement gérés. Cette situation peut perturber les processus métier et créer des risques de sécurité, car il se peut qu’il n’y ait pas de personne responsable pour gérer les paramètres et les exigences de conformité de l’assistant. Les administrateurs peuvent utiliser l’API Réaffecter pour réattribuer la propriété de ces assistants orphelins afin de s’assurer qu’ils restent correctement gérés et conformes.

Les utilisateurs et les concepteurs d’assistants dans Copilot Studio peuvent voir les assistants qui ont été réattribués. Le nouveau propriétaire obtient des autorisations de créateur d’environnement sur l’environnement de l’assistant. L’ancien propriétaire perd l’accès à l’assistant après la réaffectation. Après la réaffectation de la propriété d’un assistant, si le nouveau propriétaire possède le privilège Lire la transcription, il peut accéder à toutes les transcriptions existantes de l’assistant.

Important

L’espace de noms powervirtualgents est déconseillé. Utilisez l’espace de noms copilotstudio dans vos appels API.

Configuration requise

  • Vous disposez de l’ID de bot et de l’ID d’environnement de l’assistant cible.
  • Vous devez obtenir un jeton d’accès utilisateur émis par Microsoft Entra ID OAuth2. Pour obtenir un jeton, consultez Authentification.
    • Pour réattribuer le propriétaire d’un assistant 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 assistant 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 à l’aide de l’ID client d’un enregistrement d’application qui a l’étendue CopilotStudio.AdminActions.Invoke accordée sous l’API Power Platform.
  • Vous avez l’identifiant utilisateur Entra du nouveau propriétaire à qui la propriété de l’assistant doit être réattribuée.
  • Le nouveau propriétaire doit appartenir au locataire.

Opérations d’API pour réaffecter la propriété des assistants

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

Note

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

Pour savoir de quelle manière et dans quels cas utiliser l’API Power Platform, consultez :

Réaffecter la propriété d’un assistant à 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 EntraUserId par l’identifiant utilisateur Entra du nouveau propriétaire.

  • Objectif : changer le propriétaire de l’assistant

  • Réponse : aucun contenu

  • Last updated on