Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
O Microsoft Copilot Studio oferece a administradores ferramentas robustas para gerenciar a segurança e a conformidade do bot, inclusive ações de quarentena para agentes por meio da API do Power Platform.
A colocação em quarentena de agentes faz parte do framework de segurança mais abrangente do Copilot Studio e funciona com a abordagem de segurança geral no Copilot Studio.
Por exemplo, bots que violem políticas da Prevenção contra Perda de Dados (DLP) ou não tenham documentação de conformidade podem ser sinalizados como parte de auditorias, proteção de runtime ou outros relatórios ou notificações de administrador. 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 tiverem sido colocados em quarentena continuarão visíveis para usuários de agente (e criadores de agente no Copilot Studio), mas eles não poderão interagir nem usar o agente.
Importante
O namespace anterior powervirtualgents foi preterido e será removido ao final de 2025.
Use o namespace copilotstudio nas chamadas de API, conforme listado neste artigo.
Pré-requisitos
- Você precisa ser um administrador de locatário do Power Platform ou um administrador do Power Platform ou Administrador de serviços do Dynamics 365.
- Você tem a ID do bot e a ID do ambiente para o agente de destino.
- Você tem tokens de autenticação para o serviço ou o usuário que usa a API.
- Você é autenticado por meio de OAuth2 do Microsoft Entra ID, usando o fluxo implícito na URL de autorização:
https://login.microsoftonline.com/common/oauth2/authorize?resource=https://api.powerplatform.com.
Operações de API para gerenciamento de quarentena do agente
O Copilot Studio dá suporte a três operações-chave da API REST para gerenciar a quarentena do agente, como parte da API do Power Platform.
Para obter mais informações sobre como e quando usar a API do Power Platform, consulte:
- API e SDKs do Power Platform: Do UX-first para o API-first (Blog) (Blog de desenvolvedor do Power Platform)
- Visão geral de programabilidade e extensibilidade (documentação do Power Platform)
- Introdução à API do Power Platform (versão preliminar) (documentação do Power Platform)
Este artigo descreve as operações disponíveis, que também estão definidas na documentação de referência da API do Power Platform.
Importante
O namespace copilotstudio deve ser usado para operações de API relacionadas ao Copilot Studio.
O namespace anterior powervirtualgents foi preterido e será removido ao final de 2025.
Se você já tiver usado o powervirtualagents namespace anteriormente, atualize as chamadas de API para usar o namespace copilotstudio e garantir a funcionalidade continuada.
Obter status de quarentena do agente
- Ponto de Extremidade:
GET https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/GetBotQuarantineStatus?api-version=1. - Finalidade: recuperar o status atual de quarentena de um agente.
- Resposta: retorna um booliano
isBotQuarantinedelastUpdateTimeUtc.
Consulte a documentação de referência da API para o status da quarentena para requisitos de parâmetro e códigos de resposta.
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. - Finalidade: marcar um agente como colocado em quarentena, restringindo a disponibilidade e as interações.
- Resposta: confirma a atualização de status da quarentena.
Consulte a documentação de referência da API para colocar em quarentena agentes para requisitos de parâmetro e códigos de resposta.
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. - Finalidade: remover um agente da quarentena depois da avaliação de risco e correção.
- Resposta: confirma a atualização de status da quarentena.
Consulte a documentação de referência da API para cancelar a quarentena de agentes para requisitos de parâmetro e códigos de resposta.