Compartir a través de

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

Copilot Studio proporciona a los administradores herramientas robustas para gestionar la seguridad y el cumplimiento de los agentes, incluyendo acciones de cuarentena para los 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 en conjunto con tu enfoque general de seguridad en Copilot Studio.

Por ejemplo, los agentes que violan políticas de datos o carecen de documentación de cumplimiento pueden ser señalados como parte de auditorías, protección en tiempo de ejecución u otros informes o notificaciones administrativas. 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 y creadores de agentes en Copilot Studio, pero no es posible interactuar ni usar el agente.

Importante

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

Requisitos previos

  • 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.
    • 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.

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 admiten bots de chat clásicos. La API devuelve 405 Method Not Allowed cuando intenta poner en cuarentena o anular la cuarentena 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:

Obtener estado de cuarentena del agente

  • Punto de conexión:GET https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine?api-version=1
  • Propósito: Recuperar el estado actual de cuarentena de un agente
  • Respuesta: Devuelve un 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 a un agente como en cuarentena, restringiendo su disponibilidad e interacciones
  • Respuesta: Confirma actualización sobre el estado de la cuarentena

Más información en Documentación de referencia de 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: Retirar a un agente de la cuarentena tras la evaluación de riesgos y la remediación
  • Respuesta: Confirma actualización sobre el estado de la cuarentena

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

  • Last updated on