Colocar em quarentena agentes não conformes com a API do Power Platform

O Microsoft Copilot Studio oferece aos administradores ferramentas robustas para gerir a segurança e a conformidade do agente, incluindo ações de quarentena para agentes através da API do Power Platform.

A colocação em quarentena dos agentes faz parte do quadro de segurança mais amplo do Copilot Studio e funciona em conjunto com a sua abordagem global de segurança no Copilot Studio.

Por exemplo, os agentes que violam políticas de dados ou que não possuem documentação de conformidade podem ser sinalizados como parte de auditorias, proteção do runtime ou outros relatórios ou notificações de administração. Os administradores podem então utilizar as APIs em quarentena para isolar os agentes não conformes, investigando e remediando questões de segurança e conformidade.

Os agentes que foram colocados em quarentena ainda são visíveis para os utilizadores dos agentes e para os criadores no Copilot Studio, mas não podem interagir nem utilizar o agente.

Importante

O espaço de nomes powervirtualgents foi preterido. Use o espaço de nomes copilotstudio nas suas chamadas à API.

Pré-requisitos

  • Tem o ID do Bot e o ID do Ambiente para o agente de destino.
  • Deve obter um token de acesso de utilizador emitido pelo Microsoft Entra ID OAuth2. Para obter um token, consulte Autenticação.
    • O utilizador associado ao token deve ter uma das seguintes funções administrativas:
      • Administrador de inquilinos do Azure
      • Administrador de IA
      • Administrador do Power Platform
    • Tem de adquirir o token de acesso utilizando o ID de cliente de um registo de aplicação ao qual tenha sido concedido o âmbito CopilotStudio.AdminActions.Invoke concedido na API do Power Platform.

Operações API para gestão de quarentena de agentes

O Copilot Studio suporta três operações principais da API REST para a gestão da quarentena de agentes, como parte da API do Power Platform.

Nota

As APIs SetAsQuarantined e SetAsUnquarantined não são compatíveis com chatbots clássicos. A API devolve 405 Method Not Allowed quando tenta colocar em quarentena ou remover da quarentena um chatbot clássico.

Para mais informações sobre como e quando utilizar a API do Power Platform, consulte:

Obter estado de quarentena do agente

  • Ponto final: GET https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine?api-version=1
  • Propósito: obter o estado atual de quarentena de um agente
  • Resposta: devolve um booleano isBotQuarantined e lastUpdateTimeUtc

Saiba mais em Documentação de referência da API Obter Estado de Quarentena do Bot.

Colocar o agente em quarentena

  • Ponto final: POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsQuarantined?api-version=1
  • Propósito: marcar um agente como em quarentena, restringindo a sua disponibilidade e interações
  • Resposta: confirma a atualização do estado de quarentena

Saiba mais na Documentação de referência da API Definir Bot como Em Quarentena.

Definir o agente como não estando em quarentena

  • Ponto final: POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsUnquarantined?api-version=1
  • Propósito: Remover um agente da quarentena após avaliação de risco e remediação
  • Resposta: confirma a atualização do estado de quarentena

Saiba mais na Documentação de referência da API Definir Bot como Removido de Quarentena.

  • Last updated on