Reasignar la propiedad de los agentes huérfanos con la API de Power Platform

Copilot Studio proporciona a los administradores herramientas sólidas para administrar la seguridad y el cumplimiento de agentes, incluida la capacidad de reasignar la propiedad de agentes huérfanos a través de la API de Power Platform.

Reasignar la propiedad de agentes huérfanos forma parte del marco de seguridad más amplio de Copilot Studio y funciona junto con su enfoque general de seguridad en Copilot Studio.

Por ejemplo, cuando el propietario original de un agente abandona la organización o cambia de rol, esto puede dar lugar a agentes huérfanos que carecen de una gestión adecuada. Esta situación puede alterar los procesos empresariales y crear riesgos de seguridad, ya que podría no haber una persona responsable para gestionar la configuración y los requisitos de cumplimiento del agente. Los administradores pueden usar la API de Reasignar para reasignar la propiedad de estos agentes huérfanos y garantizar que se mantengan correctamente gestionados y en cumplimiento.

Los usuarios y creadores de agentes en Copilot Studio pueden ver los agentes que se han reasignado. El nuevo propietario obtiene permisos de creador de entorno en el entorno del agente. El antiguo propietario pierde el acceso al agente tras la reasignación. Una vez reasignada la propiedad de un agente, si el nuevo propietario cuenta con el privilegio Leer transcripción, puede acceder a todas las transcripciones existentes del agente.

Importante

El espacio de nombres powervirtualgents está en desuso. Utiliza el copilotstudio namespace en tus llamadas a la API.

Requisitos previos

  • Tiene el id. de bot y el id. de entorno para el agente de destino.
  • Debe obtener un token de acceso de usuario emitido por OAuth2 de Microsoft Entra ID. Para obtener un token, consulte Autenticación.
    • Para reasignar el propietario de un agente creado en Copilot Studio, el usuario asociado al token debe tener uno de los siguientes roles de administrador:
      • Administrador de inquilinos global
      • Administrador de IA
      • Administrador de Power Platform
      • Administrador de entorno
    • Para reasignar el propietario de un agente creado en el Generador de agente, el usuario asociado con el token debe tener uno de los siguientes roles de administrador:
      • Administrador de inquilinos global
      • Administrador de IA
      • Administrador de Power Platform
    • Debe adquirir el token de acceso con el id. de cliente de un registro de aplicación que tenga el ámbito de CopilotStudio.AdminActions.Invoke concedido bajo la API de Power Platform.
  • Debe contar con el id. de usuario de Entra del nuevo propietario al que se debe reasignar la propiedad del agente.
  • El nuevo propietario debe pertenecer al inquilino.

Operaciones de la API para reasignar la propiedad de agentes

Copilot Studio admite la operación de API REST reassign para reasignar agentes huérfanos a nuevos propietarios, como parte de la API de Power Platform.

Nota

La API de Reasignar no admite bots clásicos. La API devuelve 405 Method Not Allowed cuando intentas reasignar la propiedad de un bot de chat clásico.

Para obtener más información sobre cómo y cuándo utilizar la API de Power Platform, consulte:

Reasignar una propiedad de agente a un nuevo propietario

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

  • Cuerpo:: {"NewOwnerAadUserId": "EntraUserId"}

    Reemplace EntraUserId por el id. de usuario de Entra del nuevo propietario.

  • Propósito: cambiar el propietario del agente

  • Respuesta: sin contenido

  • Last updated on