Eliminación de agentes mediante programación mediante Power Platform API

Copilot Studio proporciona a los administradores herramientas robustas para administrar la seguridad y el cumplimiento del agente, incluida la capacidad de eliminar agentes a través de la Power Platform API.

La eliminación de agentes forma parte del marco de seguridad más amplio de Copilot Studio y funciona en conjunto con el enfoque general de seguridad en Copilot Studio.

Por ejemplo, las auditorías, la protección en tiempo de ejecución y otros informes o notificaciones de administrador pueden marcar a los agentes que infringen los requisitos de la organización para la seguridad y la autenticación. Los administradores pueden usar la delete operación para quitar agentes no conformes al investigar y corregir problemas de seguridad y cumplimiento.

Al eliminar agentes, los quita del entorno. Los creadores y usuarios anteriores ya no pueden verlos.

Al eliminar un agente que tiene un Microsoft Entra Agent ID, el identificador de agente asociado (o el registro de aplicaciones para agentes heredados) también se quita de Microsoft Entra ID. Para obtener más información, consulte Creación automática de identidades de agente de Microsoft Entra.

Importante

El powervirtualgents espacio de nombres está obsoleto. Usa el copilotstudio espacio de nombres en tus llamadas 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 Microsoft Entra ID OAuth2. Para obtener un token, consulte Autenticación.
    • 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
    • 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.

Operaciones de la API para la eliminación del agente

Copilot Studio, como parte de Power Platform API, admite la operación API REST delete para quitar agentes.

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

Eliminar agente

  • Punto de conexión:DELETE https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botAdminOperations?api-version=1
  • Propósito: Eliminar permanentemente un agente
  • Respuesta: Retorna 204 OK si el agente fue eliminado con éxito

Obtenga más información en documentación de referencia de la API del agente de Delete Copilot.

  • Last updated on