Você criou um agente no Copilot Studio e o publicou, mas ele não aparece na loja de aplicativos do Microsoft Teams. Isso impede que sua equipe instale e use o agente em chats e canais do Teams. O problema geralmente vem de etapas de implantação ausentes, permissões incorretas ou um manifesto de aplicativo mal configurado. Este artigo explica as causas raiz e fornece uma correção passo a passo para tornar seu agente visível na loja de aplicativos do Teams.
Principais Conclusões: Tornando um Agente do Copilot Studio Visível no Teams
- Copilot Studio > Publicar > Canais > Microsoft Teams: Você deve ativar explicitamente o canal do Teams antes que o agente apareça na loja de aplicativos.
- Centro de administração do Teams > Gerenciar aplicativos > Permitir: Um administrador de nível de locatário deve permitir o agente para todos os usuários ou grupos específicos.
- Manifesto do aplicativo > ícone e descrição: Ícones e descrições ausentes ou malformados impedem que o agente apareça nos resultados de pesquisa.
Por que o Agente do Copilot Studio Está Ausente da Loja de Aplicativos do Teams
Quando você publica um agente do Copilot Studio, ele não fica automaticamente disponível na loja de aplicativos do Teams. O agente deve ser implantado em um canal específico, e o Teams é um dos vários canais possíveis. Se você não selecionou o canal do Teams durante a publicação, o agente permanece invisível para os usuários do Teams. Além disso, o agente precisa ser aprovado por um administrador do Teams. Mesmo que o canal esteja ativado, o aplicativo pode estar bloqueado por padrão no centro de administração do Teams. Uma terceira causa comum é um manifesto de aplicativo incompleto. O Copilot Studio gera um manifesto para o Teams, mas se as imagens do ícone excederem os limites de tamanho ou a descrição contiver caracteres inválidos, o Teams rejeita a submissão e o agente nunca aparece.
Configuração do Canal
No Copilot Studio, cada agente pode ser publicado em vários canais: um site de demonstração, Microsoft Teams, Microsoft Copilot e outros. O canal do Teams não está selecionado por padrão. Você precisa ativá-lo manualmente. Se você pular esta etapa, o agente é publicado, mas não registrado no Teams.
Aprovação do Administrador
O Teams possui um sistema de governança de aplicativos integrado. Novos aplicativos, incluindo agentes do Copilot, são bloqueados por padrão, a menos que um administrador os permita explicitamente. O aplicativo aparece no centro de administração do Teams em Gerenciar aplicativos, mas mostra um status de Bloqueado. Até que um administrador altere o status para Permitido, o agente não aparece na loja de aplicativos de nenhum usuário.
Validação do Manifesto
O manifesto é um arquivo JSON que informa ao Teams como exibir e executar o agente. O Copilot Studio gera este arquivo automaticamente, mas se você o modificou manualmente ou se o agente usa ícones personalizados, o manifesto pode falhar na validação. O Teams exige ícones no formato PNG, 192×192 pixels para o ícone completo e 32×32 para o ícone de contorno. Se os ícones estiverem ausentes, muito grandes ou no formato errado, o manifesto é rejeitado silenciosamente e o agente nunca aparece.
Passos para Corrigir o Agente do Copilot Studio Ausente no Teams
Siga estes passos em ordem. Após cada etapa, verifique a loja de aplicativos do Teams para ver se o agente aparece. Pode ser necessário aguardar até 24 horas para que as alterações sejam propagadas.
- Ativar o canal do Teams no Copilot Studio
Vá para o Copilot Studio e abra seu agente. Selecione Publicar na navegação à esquerda. Clique em Canais. Encontre Microsoft Teams na lista. Ative o botão para Ligado. Clique em Salvar e depois em Publicar. Isso registra o agente na plataforma do Teams. - Verificar o agente no centro de administração do Teams
Entre no centro de administração do Microsoft 365. Vá para Centro de administração do Teams > Aplicativos do Teams > Gerenciar aplicativos. Pesquise pelo nome do seu agente. Se ele aparecer com status Bloqueado, prossiga para a próxima etapa. Se não aparecer, aguarde 30 minutos e atualize a página. Se ainda não aparecer, publique novamente o agente a partir do Copilot Studio. - Permitir o agente para sua organização
Na página Gerenciar aplicativos, clique no nome do agente. Clique no botão Permitir. Opcionalmente, selecione usuários ou grupos específicos em Atribuir a. Clique em Salvar. O status do agente muda para Permitido. Os usuários agora podem ver o agente na loja de aplicativos. - Verificar se há erros no manifesto do aplicativo
No Copilot Studio, vá para Publicar > Canais > Microsoft Teams. Clique em Baixar manifesto. Abra o arquivo ZIP e extraia o arquivo manifest.json. Abra-o em um editor de texto. Verifique se a seção de ícones aponta para arquivos PNG válidos. Confira se a descrição tem menos de 128 caracteres e não contém caracteres especiais como aspas ou barras invertidas. Se encontrar erros, corrija-os no Copilot Studio editando os detalhes do agente e publique novamente. - Limpar o cache do cliente do Teams
Na máquina do usuário, feche o Teams completamente. Abra o Explorador de Arquivos e vá para %appdata%\Microsoft\Teams. Exclua todos os arquivos nesta pasta. Reinicie o Teams. Isso força o Teams a recarregar o manifesto do aplicativo do servidor. O agente agora deve aparecer na loja de aplicativos.
Se o Agente do Copilot Studio Ainda Não Aparecer
Se o agente permanecer invisível após concluir as etapas principais, verifique estes fatores adicionais.
Agente Publicado no Ambiente Errado
Os agentes do Copilot Studio têm escopo de ambiente. Se você publicou o agente em um ambiente de desenvolvimento, mas os usuários estão em um ambiente de produção, o agente não aparece. Vá para o Copilot Studio e verifique o seletor de ambiente no canto superior direito. Mude para o ambiente correto e publique novamente.
Política de Configuração de Aplicativos do Teams Bloqueia o Agente
Mesmo que o aplicativo esteja Permitido, uma política de configuração de aplicativos pode impedir que usuários específicos o vejam. No centro de administração do Teams, vá para Aplicativos do Teams > Políticas de configuração. Verifique a política aplicada aos seus usuários. Certifique-se de que o agente não esteja listado em Aplicativos bloqueados. Se estiver, remova-o da lista bloqueada e salve a política.
Agente do Copilot Studio Excede os Limites de Tamanho de Aplicativos do Teams
A loja de aplicativos do Teams tem um limite de tamanho de 50 MB para todo o pacote do aplicativo. Se o seu agente incluir arquivos grandes, como imagens personalizadas ou áudio, o pacote pode exceder esse limite. No Copilot Studio, reduza o tamanho de quaisquer arquivos enviados. Publique o agente novamente.
Visibilidade do Agente do Copilot Studio no Teams: Antes e Depois da Correção
| Item | Antes da Correção | Depois da Correção |
|---|---|---|
| Canal do Teams ativado | Não | Sim |
| Status de aprovação do administrador | Bloqueado | Permitido |
| Ícone do manifesto | Ausente ou muito grande | 192×192 PNG, 32×32 PNG |
| Visibilidade na loja de aplicativos | Não listado | Listado nos resultados de pesquisa |
Após aplicar as etapas acima, seu agente do Copilot Studio deve aparecer na loja de aplicativos do Teams. Teste pesquisando pelo nome do agente na seção Aplicativos do Teams. Se o agente ainda não aparecer, verifique se todos os usuários têm a política de configuração de aplicativos correta e se o agente foi publicado no ambiente de produção. Para cenários avançados, use o log de auditoria do centro de administração do Teams para verificar quando o aplicativo foi permitido e por qual administrador.