Você criou um agente personalizado no Copilot Studio e está pronto para compartilhá-lo com sua equipe. Mas, ao clicar em Publicar e selecionar o canal Teams, a publicação falha sem um erro claro. Isso acontece devido a permissões ausentes, configuração incorreta do canal ou lacunas de licenciamento no seu locatário do Microsoft 365. Este artigo explica as causas raiz e fornece correções passo a passo para publicar seu agente no Microsoft Teams com sucesso.
Principais conclusões: Publicar um agente do Copilot Studio no Teams
- Copilot Studio > Configurações > Canais > Microsoft Teams: O canal Teams deve estar ativado e configurado antes que a publicação seja bem-sucedida.
- Central de administração do Microsoft 365 > Funções > Administrador global ou Administrador do Teams: O usuário que publica precisa da função de Administrador global ou Administrador do Teams para implantar o agente no Teams.
- Copilot Studio > Publicar > Seleção de canal: Após corrigir as permissões, use o botão Publicar e selecione Teams como canal de destino para o agente.
Por que a publicação de um agente do Copilot Studio no Teams falha
A ação de publicar no Copilot Studio envia a configuração do seu agente para o catálogo de aplicativos do Microsoft Teams. Para que funcione, três condições devem ser atendidas. Primeiro, o usuário que publica deve ter a função de Administrador do Teams ou Administrador global na Central de administração do Microsoft 365. Segundo, o canal Teams deve estar ativado nas configurações do agente no Copilot Studio. Terceiro, o agente deve ser atribuído a pelo menos um grupo de segurança ou a todo o locatário na Central de administração do Teams após a publicação. Se alguma dessas condições estiver ausente, a operação de publicação falhará silenciosamente ou retornará um erro genérico.
A causa raiz mais comum é a falta de permissões de administrador. Muitos usuários tentam publicar apenas com a função de Criador do Copilot Studio. Essa função permite criar e testar um agente, mas não concede o direito de implantar aplicativos no Teams. Outra causa frequente é que o canal Teams está desabilitado por padrão em novos agentes. Você precisa ativá-lo explicitamente.
Passos para corrigir problemas de publicação de um agente do Copilot Studio no Teams
Siga estas etapas em ordem. Não pule nenhuma. Cada etapa aborda um dos pontos de falha conhecidos.
- Verifique sua função de administrador do Microsoft 365
Abra a Central de administração do Microsoft 365 em admin.microsoft.com. Vá para Usuários > Usuários ativos. Encontre sua conta. Verifique a coluna Funções. Se você não vir Administrador global ou Administrador do Teams, peça ao administrador de TI para atribuir uma dessas funções à sua conta. Sem uma dessas funções, a publicação no Teams sempre falhará. - Ative o canal Teams no agente
Abra o Copilot Studio. Vá para Agentes e selecione o agente que não pode publicar. Na barra de navegação superior, clique em Configurações. Em seguida, clique em Canais. Encontre Microsoft Teams na lista. Alterne o botão para Ativado. Se o botão estiver esmaecido, sua função de administrador pode não estar totalmente ativa ainda. Aguarde 15 minutos e atualize a página. - Publique o agente novamente
No mesmo agente, clique no botão Publicar na barra de ferramentas superior. Uma caixa de diálogo aparece. Selecione Microsoft Teams como canal de destino. Clique em Publicar. Aguarde a mensagem de confirmação. Se receber um erro, anote o código do erro e prossiga para a próxima etapa. - Verifique a Central de administração do Teams para erros de implantação
Abra a Central de administração do Teams em admin.teams.microsoft.com. Vá para Aplicativos do Teams > Gerenciar aplicativos. Pesquise seu agente pelo nome. Se o agente aparecer com status Bloqueado ou Revisão pendente, clique nele. Em seguida, clique em Publicar. Defina o status como Permitido. Atribua o aplicativo a pelo menos um grupo de segurança ou selecione Locatário inteiro. Clique em Salvar. - Force uma ressincronização do manifesto do agente
No Copilot Studio, abra o agente. Vá para Configurações > Canais > Microsoft Teams. Clique nos três pontos ao lado da entrada do canal Teams. Selecione Cancelar publicação. Em seguida, volte para Publicar e selecione Teams novamente. Isso limpa um manifesto desatualizado que pode bloquear a implantação.
Se a publicação ainda falhar após a correção principal
Copilot Studio mostra código de erro 403
O erro 403 significa que sua conta não tem permissão para gravar no catálogo de aplicativos do Teams. Confirme se sua função de administrador é Administrador do Teams ou Administrador global. Se a função estiver correta, pode ser que ela não tenha sido propagada. Aguarde uma hora e tente novamente. Se o erro persistir, saia de todos os aplicativos do Microsoft 365 e faça login novamente.
Agente publicado, mas não aparece no Teams
O agente pode estar no estado Rascunho na Central de administração do Teams. Abra a Central de administração do Teams em admin.teams.microsoft.com. Vá para Aplicativos do Teams > Gerenciar aplicativos. Encontre seu agente. Se o status for Rascunho, clique nele e depois em Publicar. Após publicar, atribua o aplicativo a usuários ou grupos. Pode levar até 24 horas para o aplicativo aparecer na loja de aplicativos do Teams para os usuários finais.
Botão Publicar está esmaecido
Um botão Publicar esmaecido significa que o agente tem alterações não salvas. Clique em Salvar na barra de ferramentas superior. Em seguida, tente novamente. Se o botão continuar esmaecido, feche o agente e reabra-o. Se o problema persistir, limpe o cache do navegador para o domínio do Copilot Studio.
Publicação de agente do Copilot Studio: Permissões necessárias vs. Funções comuns de usuário
| Item | Função de Criador do Copilot Studio | Função de Administrador do Teams ou Administrador Global |
|---|---|---|
| Criar e editar agentes | Sim | Sim |
| Testar agente no Copilot Studio | Sim | Sim |
| Ativar canal Teams nas configurações do agente | Sim | Sim |
| Publicar agente no catálogo de aplicativos do Teams | Não | Sim |
| Aprovar ou bloquear aplicativos na Central de administração do Teams | Não | Sim |
| Atribuir agente a usuários ou grupos no Teams | Não | Sim |
A tabela mostra que a função de Criador do Copilot Studio é suficiente para criar e testar. Mas publicar no Teams requer a função elevada de Administrador do Teams ou Administrador global. Se você tiver apenas a função de criador, peça ao administrador para atribuir a função de Administrador do Teams à sua conta durante a etapa de publicação.
Agora você pode publicar um agente do Copilot Studio no Teams verificando sua função de administrador, ativando o canal Teams e usando a Central de administração do Teams para aprovação final. Se você publica agentes com frequência, peça ao departamento de TI para criar uma função de administrador personalizada com apenas a permissão de publicação de aplicativos do Teams. Isso reduz o risco de segurança enquanto permite que você implante agentes de forma independente.