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

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

Colocar em quarentena agentes faz parte do quadro de segurança mais amplo da Copilot Studio e funciona em harmonia com a sua abordagem global de segurança no Copilot Studio.

Por exemplo, agentes que violem 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 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 estão em quarentena continuam visíveis para os utilizadores e criadores de agentes no Copilot Studio, mas não é possível interagir ou usar o agente.

Importante

O espaço de nomes powervirtualgents foi preterido. Use o copilotstudio namespace nas suas chamadas de 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 um dos seguintes papéis administrativos:
      • Administrador global de inquilinos
      • 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 na API do Power Platform.

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

O Copilot Studio suporta três operações-chave da API REST para gerir a quarentena dos agentes, como parte da API Power Platform.

Observação

As APIs SetAsQuarantined e SetAsUnquarantined não suportam 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: Recuperar o estado atual de quarentena de um agente
  • Resposta: Devolve um booleano isBotQuarantined e lastUpdateTimeUtc

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

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 atualização do estado da quarentena

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

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
  • Objetivo: Remover um agente da quarentena após avaliação de risco e remediação
  • Resposta: Confirma atualização do estado da quarentena

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

  • Last updated on