Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Microsoft Copilot Studio proporciona a los administradores herramientas sólidas para administrar la seguridad y el cumplimiento de bots, 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 bots que infringen las directivas de prevención de pérdida de datos (DLP) 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 se han puesto en cuarentena seguirán siendo visibles para los usuarios del agente (y los creadores de agentes en Copilot Studio), pero no podrán interactuar ni usar el agente.
Importante
El espacio de nombres anterior powervirtualgents está en desuso y se quitará a finales de 2025.
Use el copilotstudio espacio de nombres en las llamadas API, como se muestra en este artículo.
Requisitos previos
- Debe ser un administrador de inquilinos de Power Platform o un administrador de Power Platform o un administrador del servicio de Dynamics 365.
- Tiene el id. de bot y el id. de entorno para el agente de destino.
- Tiene tokens de autenticación para el servicio o el usuario mediante la API.
- Se autentica a través del identificador OAuth2 de Microsoft Entra, mediante el flujo implícito en la dirección URL de autorización:
https://login.microsoftonline.com/common/oauth2/authorize?resource=https://api.powerplatform.com.
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.
Para obtener más información sobre cómo y cuándo utilizar la API de Power Platform, consulte:
- API y los SDK de Power Platform: del enfoque en la experiencia de usuario al enfoque en la API (Blog) (Blog para desarrolladores de Power Platform)
- Información general sobre la programación y la extensibilidad (documentación de Power Platform)
- Introducción a Power Platform API (versión preliminar) (documentación de Power Platform)
En este artículo se describen las operaciones disponibles, que también se definen en la documentación de referencia de la API de Power Platform.
Importante
El espacio de nombres copilotstudio debe usarse para las operaciones de API relacionadas con Copilot Studio.
El espacio de nombres anterior powervirtualgents está en desuso y se quitará a finales de 2025.
Si ha usado anteriormente el espacio de nombres powervirtualagents, actualice las llamadas API para que usen el espacio de nombres copilotstudio para garantizar la funcionalidad continua.
Obtener estado de cuarentena del bot
- Punto de conexión:
GET https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/GetBotQuarantineStatus?api-version=1. - Propósito: recuperar el estado de cuarentena actual de un agente.
- Respuesta: devuelve un valor booleano
isBotQuarantinedylastUpdateTimeUtc.
Consulte la documentación de referencia de la API para el estado de cuarentena para conocer los requisitos de parámetros y los códigos de respuesta.
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.
Consulte la documentación de referencia de la API poner en cuarentena agentes para conocer los requisitos de parámetros y los códigos de respuesta.
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.
Consulte la documentación de referencia de la API para quitar de la cuarentena agentes para conocer los requisitos de parámetros y los códigos de respuesta.