Eliminar agentes programaticamente usando a API do Power Platform

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

Eliminar agentes faz parte do quadro de segurança mais amplo da Copilot Studio e funciona em conjunto com a sua abordagem global de segurança em Copilot Studio.

Por exemplo, auditorias, proteção em tempo de execução e outros relatórios ou notificações administrativas podem sinalizar agentes que violem os requisitos organizacionais de segurança e autenticação. Os administradores podem usar a delete operação para remover agentes não conformes enquanto investigam e corrigem questões de segurança e conformidade.

Quando elimina agentes, remove-os do seu ambiente. Os criadores e utilizadores anteriores já não os conseguem ver.

Quando elimina um agente que tem um ID do Agente Microsoft Entra, o ID do Agente associado (ou registo de aplicação para agentes legados) também é removido do Microsoft Entra ID. Para mais informações, consulte Criar automaticamente Microsoft Entra identidades de agentes.

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
  • Deve adquirir o token de acesso utilizando o ID do cliente de um registo de aplicação que possua o âmbito CopilotStudio.AdminActions.Invoke concedido pela API da Power Platform.

Operações de API para eliminação de agentes

Copilot Studio, como parte da API Power Platform, suporta a operação REST API delete para remover agentes.

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

• API e SDKs do Power Platform: de UX primeiro para API primeiro (Blogue) (Blogue para Programadores do Power Platform)
• Descrição geral da programabilidade e extensibilidade (documentação do Power Platform)
• Comece a usar a API do Power Platform (documentação do Power Platform)
• Documentação de referência das operações da API Power Platform

Eliminar agente

• Ponto final:DELETE https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botAdminOperations?api-version=1
• Propósito: Eliminar permanentemente um agente
• Resposta: Devolve 204 OK se o agente foi eliminado com sucesso

Saiba mais em Delete Copilot Agent API reference documentation.