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

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

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

Por ejemplo, cuando el propietario original de un agente abandona la organización o cambia de rol, puede derivar en 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 puede que no haya una parte responsable que gestione la configuración y los requisitos de cumplimiento del agente. Los administradores pueden utilizar la API de Reasignación para reasignar la propiedad de estos agentes huérfanos y así garantizar que se mantengan correctamente gestionados y cumplidores.

Los usuarios y desarrolladores de agentes en Copilot Studio pueden ver agentes que han sido reasignados. El nuevo propietario obtiene permisos de creador de entorno en el entorno del bot. El antiguo propietario pierde el acceso al agente tras la reasignación.

Importante

El powervirtualgents espacio de nombres está obsoleto. Usa el copilotstudio espacio de nombres en tus llamadas API.

Prerrequisitos

  • Dispone del ID de Bot y del ID de Entorno para el agente de destino.
  • Debes obtener un token de acceso de usuario emitido por Microsoft Entra ID OAuth2. 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 del entorno
    • Para reasignar al propietario de un agente creado en Agent Builder, 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
    • Debes adquirir el token de acceso usando el ID de cliente de un registro de aplicación que tenga el alcance CopilotStudio.AdminActions.Invoke concedido bajo la API de Power Platform.
  • Tienes el ID de usuario Entra del nuevo propietario para quien debe reasignarse la titularidad del agente.
  • El nuevo propietario debe pertenecer al arrendatario.

Operaciones de la API para reasignar la titularidad de los agentes

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

Nota:

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

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

Reasignar la propiedad de un 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"}

    Sustituye EntraUserId por el ID de usuario de Entra del nuevo propietario.

  • Propósito: Cambiar de propietario del agente

  • Respuesta: Sin contenido

  • Last updated on