Poner en cuarentena agentes no conformes con la API de Power Platform

Copilot Studio proporciona a los administradores herramientas sólidas para administrar la seguridad y el cumplimiento de agentes, incluidas las acciones de cuarentena para agentes a través de la API de Power Platform.

La cuarentena de agentes 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, los agentes que infringen las directivas de datos o no tienen la documentación de cumplimiento se pueden marcar como parte de auditorías, protección en tiempo de ejecución u otros informes o notificaciones de administrador. Después, los administradores pueden usar las API de cuarentena para aislar los agentes no conformes al investigar y corregir problemas de seguridad y cumplimiento.

Los agentes que están en cuarentena siguen siendo visibles para los usuarios del agente y los creadores en Copilot Studio+, pero no es posible interactuar ni usar el 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.
    • 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 API para la administración de cuarentena del agente

Copilot Studio admite tres operaciones de API REST clave para administrar la cuarentena del agente, como parte de la API de Power Platform.

Nota

Las API SetAsQuarantined y SetAsUnquarantined no son compatibles con los bots de chat clásicos. La API devuelve 405 Method Not Allowed cuando intentas poner en cuarentena o quitar de cuarentena a 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:

Obtener estado de cuarentena del bot

  • Punto de conexión:: GET https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine?api-version=1
  • Propósito: recuperar el estado de cuarentena actual de un agente
  • Respuesta: devuelve un valor booleano isBotQuarantined y lastUpdateTimeUtc

Obtén más información en la documentación de referencia de la API Get bot Quarantine Status.

Establecer el agente como En cuarentena

  • Punto de conexión:: POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsQuarantined?api-version=1
  • Propósito: marcar un agente como en cuarentena y restringir su disponibilidad e interacciones
  • Respuesta: confirma la actualización del estado de cuarentena

Más información en la documentación de referencia de la API Set bot As Quarantined.

Establecer el agente como No en cuarentena

  • Punto de conexión:: POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsUnquarantined?api-version=1
  • Propósito: quitar un agente de la cuarentena después de la evaluación y corrección de riesgos
  • Respuesta: confirma la actualización del estado de cuarentena

Obtén más información en la documentación de referencia de la API Set Bot As Unquarantined.

  • Last updated on