Compartilhar via

Colocar agentes não compatíveis em quarentena com a API do Power Platform

Copilot Studio fornece aos administradores ferramentas robust para gerenciar a segurança e a conformidade do agente, incluindo ações de quarentena para agentes por meio da API Power Platform.

Agentes em quarentena fazem parte da estrutura de segurança mais ampla do Copilot Studio e trabalha em conjunto com sua abordagem de segurança geral no Copilot Studio.

Por exemplo, agentes que violam políticas de dados ou não possuem documentação de conformidade podem ser sinalizados como parte de auditorias, proteção em tempo de execução ou outros relatórios ou notificações administrativas. Os administradores podem acabar usando APIs em quarentena para isolar os agentes sem conformidade, ao mesmo tempo em que investigam e corrigem problemas de segurança e conformidade.

Os agentes que estão em quarentena ainda são visíveis para usuários e fabricantes de agentes no Copilot Studio, mas não é possível interagir ou usar o agente.

Importante

O powervirtualgents namespace está obsoleto. Use o copilotstudio namespace nas suas chamadas de API.

Pré-requisitos

  • Você tem a ID do bot e a ID do ambiente para o agente de destino.
  • Você deve obter um token de acesso do usuário emitido pelo Microsoft Entra ID OAuth2. Para obter um token, consulte Autenticação.
    • O usuário associado ao token deve ter uma das seguintes funções administrativas:
      • Administrador global de locatários
      • Administrador de IA
      • Administrador do Power Platform
    • Você deve adquirir o token de acesso usando o ID do cliente de um registro de aplicativo que tenha o escopo CopilotStudio.AdminActions.Invoke concedido pela API do Power Platform.

Operações de API para gerenciamento de quarentena do agente

Copilot Studio dá suporte a três operações principais da API REST para gerenciar a quarentena do agente, como parte da API do Power Platform.

Observação

As APIs SetAsQuarantined e SetAsUnquarantined não dão suporte a chatbots clássicos. A API retorna 405 Method Not Allowed quando você tenta colocar em quarentena ou desquarantizar um chatbot clássico.

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

Obter status de quarentena do agente

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

Saiba mais na documentação de referência da API Get Bot Quarantine Status.

Definir agente como colocado em quarentena

  • Ponto de extremidade: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 sua disponibilidade e interações
  • Resposta: Confirma atualização do status da quarentena

Saiba mais na documentação de referência da API Set Bot As Quarantined.

Definir agente como fora da quarentena

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

Saiba mais na documentação de referência da API Set Bot As Unquarantined.

  • Last updated on