Agente do Copilot Studio Publica, Mas Versão Antiga Ainda Responde: Correção

Você atualizou seu agente no Copilot Studio, clicou em Publicar e a confirmação apareceu. Mas, ao testar o agente no Teams, Microsoft 365 Copilot ou em um canal personalizado, ele ainda usa a versão antiga. Os novos tópicos, respostas alteradas ou fontes de conhecimento atualizadas não aparecem. Esse problema ocorre porque a versão publicada não é aplicada imediatamente a todos os ambientes de execução. Este artigo explica por que a versão antiga persiste e fornece as etapas exatas para forçar a nova versão a responder.

Por que o Copilot Studio Continua Servindo uma Versão Antiga do Agente

Ao publicar um agente no Copilot Studio, o sistema cria uma nova entrada de versão no ambiente Microsoft Dataverse. No entanto, os endpoints de runtime que servem o agente aos usuários não recarregam automaticamente essa versão em todos os cenários. O runtime armazena em cache a configuração do agente por questões de desempenho. Esse cache pode persistir por vários minutos ou até mais se o canal usar cache agressivo. Além disso, certos canais, como Microsoft Teams e sites personalizados, podem armazenar em cache os metadados do agente no lado do cliente. O resultado é que os usuários veem o comportamento antigo, mesmo que a interface do Copilot Studio mostre a nova versão como Publicada. A causa raiz é uma combinação de atraso na atualização da versão no servidor e cache no lado do cliente.

Etapas para Forçar a Última Versão Publicada do Agente a Responder

Siga as etapas abaixo em ordem. Após cada etapa, teste o agente no canal onde a versão antiga aparece. Passe para a próxima etapa apenas se a versão antiga ainda responder.

1. Verifique o número da versão publicada no Copilot Studio
   Abra o Copilot Studio. Vá para Agentes e selecione o agente que não está atualizando. Na barra de ferramentas superior, clique em Configurações e depois em Geral. Procure por Versão. Anote o número da versão exibido. Agora volte para a página de visão geral do agente. O botão Publicar deve mostrar a versão atual e a data da última publicação. Se a versão mostrada não for a mais recente que você esperava, clique em Publicar novamente. Aguarde 30 segundos e atualize a página. Confirme que o número da versão corresponde à sua alteração mais recente.
2. Publique o agente uma segunda vez
   Mesmo que a primeira publicação tenha parecido bem-sucedida, uma segunda publicação pode forçar o runtime a reconhecer a atualização. Clique no botão Publicar na barra de ferramentas superior. Na caixa de diálogo Publicar, revise as alterações listadas. Clique em Publicar novamente. Aguarde 2 minutos. Essa técnica de publicação dupla geralmente resolve casos em que a publicação inicial não foi totalmente propagada.
3. Limpe o cache do agente no Microsoft Teams
   Se o agente estiver implantado no Microsoft Teams, o cliente do Teams armazena em cache as respostas do agente. Saia do Teams completamente. Feche o aplicativo do Teams. Limpe o cache do Teams excluindo o conteúdo da pasta %appdata%\Microsoft\Teams no Windows. Não exclua a pasta em si. Reinicie o Teams e faça login novamente. Abra um chat com o agente e envie uma mensagem de teste. O agente deve agora responder com a versão mais recente.
4. Use o painel Testar agente no Copilot Studio para confirmar a versão mais recente
   No Copilot Studio, abra o agente e clique no botão Testar no canto superior direito. O painel de teste usa a versão publicada mais recente diretamente do ambiente Dataverse, ignorando a maioria dos caches. Envie uma mensagem de teste que acione o tópico ou a resposta alterada. Se o painel de teste mostrar o novo comportamento, mas o canal ainda mostrar o antigo, o problema é definitivamente o cache do canal. Se o painel de teste também mostrar o comportamento antigo, a publicação não foi aplicada corretamente. Nesse caso, volte ao agente, verifique se há erros de validação e publique novamente.
5. Desabilite e reabilite o agente no canal de destino
   Para canais como Microsoft 365 Copilot ou um site personalizado, remova o agente do canal e adicione-o novamente. No Copilot Studio, vá para Canais. Selecione o canal onde a versão antiga aparece. Clique em Remover ou Desabilitar. Confirme a remoção. Aguarde 1 minuto. Clique em Adicionar canal e selecione o mesmo canal novamente. Configure as configurações do canal conforme necessário. Essa ação força o canal a buscar uma cópia nova da configuração do agente.
6. Aguarde 15 minutos e teste novamente
   O Microsoft 365 Copilot e alguns canais personalizados têm um cache no lado do servidor que expira após 10 a 15 minutos. Se nenhuma das etapas acima funcionar, aguarde 15 minutos e teste o agente novamente. Durante esse período, o runtime deve automaticamente pegar a versão publicada mais recente. Se a versão antiga ainda responder após 15 minutos, entre em contato com o Suporte da Microsoft informando os números das versões do agente e o canal onde o problema ocorre.

Se o Agente Ainda Usar a Versão Antiga Após Todas as Etapas

Copilot Studio mostra um erro de validação após a publicação

Se você vir uma faixa vermelha no Copilot Studio após publicar, a publicação não foi bem-sucedida. Erros de validação comuns incluem frases de gatilho ausentes em um tópico, uma conexão de fluxo do Power Automate quebrada ou um conector não suportado. Abra o agente e vá para Tópicos. Procure por qualquer tópico marcado com um ícone de aviso. Corrija o problema de validação adicionando as frases de gatilho necessárias ou reconectando o fluxo. Publique novamente. O erro de validação deve ser resolvido antes que a nova versão se torne ativa.

Usuário vê versão antiga em um canal, mas nova em outro

Isso indica que o canal com a versão antiga tem um cache persistente. Para Microsoft Teams, limpe o cache do Teams conforme descrito na etapa 3. Para um site personalizado, peça ao usuário para limpar o cache e os cookies do navegador. Para um aplicativo móvel, force o fechamento do aplicativo e reabra-o. Se o problema persistir, a configuração do canal pode apontar para um endpoint de agente mais antigo. Remova e adicione novamente o canal conforme descrito na etapa 5.

Agente responde de forma diferente para diferentes usuários

Isso pode acontecer quando o agente usa autenticação e o contexto do usuário altera o comportamento. Se você atualizou um tópico que depende da autenticação do usuário, teste o agente enquanto estiver conectado como um usuário que tenha as permissões corretas. Verifique também se o agente tem várias versões implantadas para diferentes públicos. No Copilot Studio, vá para Configurações > Segurança > Autenticação. Certifique-se de que as configurações de autenticação correspondam aos usuários que estão vendo a versão antiga.

Publicação no Copilot Studio vs. Atualização Manual de Versão: Principais Diferenças

Item	Botão Publicar	Atualização Manual de Cache
Descrição	Cria uma nova versão no Dataverse e a marca como ativa para o runtime	Limpa os caches do lado do cliente e do canal para forçar o runtime a buscar a versão ativa
Quando usar	Após cada alteração em tópicos, conhecimento ou configurações	Quando a versão publicada não aparece em um canal específico
Efeito em todos os canais	Disponibiliza a versão para todos os canais, mas não limpa os caches imediatamente	Afeta apenas o canal onde o cache é limpo
Tempo para fazer efeito	Até 15 minutos para propagação completa	Imediato após limpeza do cache
Requer direitos de administrador	Sim, o usuário deve ser proprietário ou colaborador do agente	Não, qualquer usuário pode limpar o cache local do navegador ou aplicativo

Agora você pode forçar seu agente do Copilot Studio a usar a versão publicada mais recente combinando uma publicação dupla com a limpeza de cache específica do canal. Comece usando o painel Testar agente para confirmar que a versão está correta no nível do servidor. Em seguida, limpe o cache no canal onde os usuários estão vendo a versão antiga. Se você encontrar esse atraso com frequência, considere adicionar uma nota ao seu processo de gerenciamento de mudanças para aguardar 15 minutos após a publicação antes de anunciar a atualização aos usuários.