Compartilhar via

Excluir agentes programaticamente usando a API do Power Platform

Copilot Studio fornece aos administradores ferramentas robustas para gerenciar a segurança e a conformidade dos agentes, incluindo a capacidade de excluir agentes por meio da API Power Platform.

A exclusão de agentes faz parte da estrutura de segurança mais ampla da Copilot Studio e trabalha em conjunto com sua abordagem de segurança geral em Copilot Studio.

Por exemplo, auditorias, proteção de runtime e outros relatórios ou notificações de administrador podem sinalizar agentes que violam os requisitos organizacionais de segurança e autenticação. Os administradores podem usar a delete operação para remover agentes não compatíveis ao investigar e corrigir problemas de segurança e conformidade.

Ao excluir agentes, você os remove do seu ambiente. Criadores e usuários anteriores não conseguem mais vê-las.

Quando você exclui um agente que tem um ID do agente Microsoft Entra, o ID de Agente associado (ou o registro de aplicativo para agentes legados) também é removido do Microsoft Entra ID. Para obter mais informações, consulte Automaticamente criar identidades de agente Microsoft Entra.

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 a ID do cliente de um registro de aplicativo que tenha o escopo CopilotStudio.AdminActions.Invoke concedido na API do Power Platform.

Operações de API para exclusão de agente

Copilot Studio, como parte da API do Power Platform, dá suporte à operação de API REST delete para remover agentes.

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

Excluir agente

  • Ponto de extremidade:DELETE https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botAdminOperations?api-version=1
  • Propósito: Excluir permanentemente um agente
  • Resposta: Retorna 204 OK se o agente foi excluído com sucesso

Saiba mais em A documentação de referência da API do Agente Copilot.

  • Last updated on