Você está tentando excluir um agente do Copilot Studio de um ambiente Microsoft 365, mas a opção de exclusão está desativada ou falha com um erro. Isso geralmente acontece porque o agente ainda está publicado, tem dependências ativas ou o usuário não tem as permissões necessárias. O sistema impede a exclusão para evitar a quebra de fluxos de trabalho conectados ou perda de dados. Este artigo explica as causas raiz e fornece uma correção passo a passo para remover o agente com sucesso.
Principais conclusões: Excluir um agente do Copilot Studio travado
- Copilot Studio > Agentes > Detalhes do agente > Status > Parar: Você deve primeiro parar um agente publicado antes que a exclusão seja permitida.
- Copilot Studio > Configurações > Geral > Excluir: O botão de exclusão só aparece depois que você para o agente e remove todas as conexões de canal.
- Central de administração do Power Platform > Ambientes > Nome do ambiente > Recursos > Agentes do Copilot: Um administrador pode forçar a remoção de agentes que permanecem travados devido a bloqueios de recursos.
Por que os agentes do Copilot Studio não podem ser excluídos
Os agentes do Copilot Studio não são arquivos independentes. Eles são recursos de nuvem que podem ser publicados, compartilhados e conectados a vários canais, como Microsoft Teams, Dynamics 365 ou sites personalizados. O sistema impede a exclusão nestas condições:
- O status do agente está definido como Publicado e ativamente atendendo usuários.
- O agente tem conexões de canal ativas, como Teams, Slack ou um site personalizado.
- O agente faz parte de uma solução no Power Platform, criando uma cadeia de dependências.
- O usuário não tem a função de Administrador do Ambiente ou Personalizador do Sistema no ambiente de destino.
- O próprio ambiente tem uma política de recursos que bloqueia a exclusão de agentes do Copilot.
Quando qualquer uma dessas condições existe, a opção de exclusão no Copilot Studio fica desabilitada. O sistema mostra uma dica de ferramenta como “Não é possível excluir enquanto publicado” ou “Exclusão indisponível devido a dependências.” Entender esses bloqueios é o primeiro passo para resolver o problema.
Bloqueio de status publicado
Um agente publicado está ativo e processando solicitações. Excluí-lo deixaria órfãs quaisquer sessões ativas ou serviços conectados. O Copilot Studio impõe um processo de duas etapas: parar o agente e depois excluí-lo. Isso é uma medida de segurança, não um bug.
Dependências de solução
Se o agente foi adicionado a uma solução do Power Platform, ele se torna um componente gerenciado. Excluí-lo apenas do Copilot Studio deixa a solução em um estado inconsistente. Você deve remover o agente da solução primeiro ou excluir a solução inteira.
Passos para excluir um agente do Copilot Studio travado
Siga estes passos em ordem. Não pule nenhum passo. Cada passo remove um bloqueio específico que impede a exclusão.
- Parar o agente
Abra o Copilot Studio em copilotstudio.microsoft.com. Vá para Agentes e selecione o agente que deseja excluir. Na página de detalhes do agente, encontre a alternância de Status. Se mostrar Publicado, clique na alternância para definir como Parado. Confirme a ação de parar. Aguarde 30 segundos para o status ser atualizado. - Remover todas as conexões de canal
Na mesma página de detalhes do agente, clique na guia Canais. Você verá uma lista de canais conectados, como Teams, Slack ou Web. Clique em cada canal e selecione Remover conexão. Confirme cada remoção. Não deixe nenhum canal ativo. - Verificar associação à solução
Vá para Configurações > Geral e procure o campo Solução. Se o agente pertencer a uma solução, anote o nome da solução. Abra a Central de administração do Power Platform em admin.powerplatform.microsoft.com. Navegue até Ambientes, selecione seu ambiente e vá para Recursos > Soluções. Encontre a solução listada no Copilot Studio. Abra-a, localize o componente do agente e selecione Remover. Isso remove a dependência. - Excluir o agente do Copilot Studio
Volte ao Copilot Studio. Vá para Agentes e selecione o agente novamente. Na página de detalhes do agente, clique em Configurações > Geral. Role até o final e clique em Excluir. Confirme a exclusão digitando o nome do agente, se solicitado. O agente agora foi removido do ambiente. - Forçar exclusão da Central de administração do Power Platform se travado
Se o botão de exclusão ainda estiver desativado ou aparecer um erro, um administrador pode substituir. Vá para a Central de administração do Power Platform. Navegue até Ambientes > selecione seu ambiente > Recursos > Agentes do Copilot. Encontre o agente travado, clique nos três pontos (mais ações) e selecione Excluir. Isso ignora as restrições do Copilot Studio e remove o agente diretamente da lista de recursos do ambiente.
Se o agente do Copilot Studio ainda não puder ser excluído
Mesmo após seguir os passos principais, alguns agentes resistem à exclusão. Aqui estão os problemas restantes mais comuns e como resolvê-los.
Opção de exclusão desativada após parar o agente
Isso geralmente significa que uma conexão de canal ainda está ativa. Volte para a guia Canais e verifique se cada entrada foi removida. Alguns canais como Site personalizado não mostram um botão de remover diretamente. Clique no nome do canal e procure uma opção Desconectar no painel de configurações do canal. Após desconectar, atualize a página e tente a exclusão novamente.
Erro: “O agente faz parte de uma solução gerenciada”
Uma solução gerenciada não pode ser editada ou excluída componente por componente. Você deve excluir a solução inteira da Central de administração do Power Platform. Vá para Soluções, selecione a solução e clique em Excluir. Isso remove a solução e todos os seus componentes, incluindo o agente. Exporte a solução primeiro se precisar de um backup.
Erro: “Você não tem permissão para excluir este agente”
A conta de usuário precisa da função de Administrador do Ambiente ou Personalizador do Sistema no ambiente. Vá para a Central de administração do Power Platform. Navegue até Ambientes > selecione seu ambiente > Acesso > Usuários. Encontre seu usuário e verifique as funções atribuídas. Se você não tiver a função necessária, peça a um administrador global para atribuí-la. Após a atribuição da função, saia do Copilot Studio e faça login novamente para atualizar as permissões.
Agente reaparece após exclusão
Isso acontece quando o agente é sincronizado de uma solução do Dataverse que não foi totalmente removida. Verifique na Central de administração do Power Platform se há alguma solução restante que contenha o agente. Exclua a solução e verifique se o agente desapareceu da lista de recursos Agentes do Copilot. Se ainda reaparecer, um trabalho de sincronização em segundo plano pode estar em execução. Aguarde 24 horas e verifique novamente. Se persistir, entre em contato com o Suporte Microsoft fornecendo o ID do ambiente e o nome do agente.
Central de administração do Power Platform vs Copilot Studio: Métodos de exclusão
| Item | Interface do Copilot Studio | Central de administração do Power Platform |
|---|---|---|
| Caminho de acesso | copilotstudio.microsoft.com > Agentes > Agente > Configurações > Excluir | admin.powerplatform.microsoft.com > Ambientes > Recursos > Agentes do Copilot > Excluir |
| Função necessária | Administrador do Ambiente ou proprietário do agente | Administrador do Ambiente ou administrador do Power Platform |
| Pré-verificações aplicadas | Agente deve estar parado, sem canais ativos, sem dependência de solução | Nenhuma pré-verificação; a exclusão é forçada |
| Melhor para | Exclusão padrão de um único agente | Agentes travados, componentes de solução gerenciada, remoção em massa |
Use a interface do Copilot Studio para o gerenciamento diário de agentes. Mude para a Central de administração do Power Platform apenas quando o caminho de exclusão padrão falhar. O método da central de administração ignora as verificações de segurança, portanto, use-o apenas quando tiver certeza de que o agente não é mais necessário.
Agora você pode excluir qualquer agente do Copilot Studio do seu ambiente, mesmo quando o botão de exclusão padrão está desabilitado. Comece parando o agente e removendo todas as conexões de canal. Se o agente fizer parte de uma solução gerenciada, exclua a solução inteira da Central de administração do Power Platform. Como dica avançada, crie um backup da definição do agente exportando-o como uma solução antes da exclusão. Isso permite restaurar o agente posteriormente, se necessário.