Você tem um bot funcional criado no Power Virtual Agents e precisa movê-lo para o Microsoft Copilot Studio. As duas plataformas compartilham uma base de código comum, mas o processo de migração não é automático. Sem as etapas corretas, você corre o risco de perder a lógica dos tópicos, frases de gatilho ou configurações de autenticação. Este artigo explica o processo exato de migração, incluindo os pré-requisitos, as etapas de exportação e importação, e o que verificar após a migração.
Principais Pontos: Migração do Power Virtual Agents para o Copilot Studio
- Central de administração do Power Platform > Ambientes > Exportar bot: Exporta o bot como uma solução gerenciada que contém tópicos, entidades e fluxos.
- Copilot Studio > Criar bot > Importar solução: Importa a solução exportada para um ambiente novo ou existente do Copilot Studio.
- Verificação manual pós-migração: Você deve reatribuir a autenticação, testar novamente as frases de gatilho e republicar o bot para colocá-lo em produção.
O que Envolve Migrar um Bot do Power Virtual Agents para o Copilot Studio
O Power Virtual Agents é a plataforma antiga de criação de bots que fazia parte do Microsoft Power Platform. O Microsoft Copilot Studio é a plataforma mais recente que combina as capacidades do Power Virtual Agents com IA generativa e recursos do Copilot. As duas plataformas compartilham a mesma infraestrutura subjacente do Power Platform. Isso significa que você pode migrar um bot exportando-o como uma solução gerenciada de um ambiente e importando-o para outro ambiente que use o Copilot Studio.
A migração não copia o bot exatamente. Algumas configurações, como detalhes de autenticação, configurações de canais e variáveis específicas do ambiente, não são incluídas na exportação. Você deve configurar esses itens manualmente após a importação. Os tópicos do bot, frases de gatilho, entidades e fluxos do Power Automate são preservados.
Você precisa dos seguintes pré-requisitos antes de começar:
- Um bot do Power Virtual Agents em um ambiente do Power Platform onde você tenha permissões de Administrador do Sistema ou Personalizador do Sistema.
- Um ambiente de destino no Copilot Studio onde você tenha as mesmas permissões.
- Acesso à central de administração do Power Platform.
Etapas para Exportar um Bot do Power Virtual Agents e Importá-lo no Copilot Studio
Siga estas etapas em ordem. Não pule as etapas de configuração manual após a importação.
Etapa 1: Exportar o Bot como uma Solução Gerenciada do Power Virtual Agents
- Abra a central de administração do Power Platform
Acesse https://admin.powerplatform.microsoft.com. Faça login com sua conta corporativa ou de estudante que tenha permissões de Administrador do Sistema. - Selecione o ambiente que contém seu bot
No menu de navegação à esquerda, selecione Ambientes. Encontre o ambiente que contém seu bot do Power Virtual Agents. Clique no nome do ambiente para abrir seus detalhes. - Abra a área de Soluções
Na página de detalhes do ambiente, selecione Soluções no menu superior. Você verá uma lista de todas as soluções nesse ambiente. - Localize a solução do bot
Encontre a solução nomeada de acordo com seu bot. A convenção de nomenclatura geralmente é “NomeDoBot” com um tipo de solução “Gerenciada”. Se você não a encontrar, use a caixa de pesquisa para filtrar pelo nome do seu bot. - Exporte a solução
Selecione a solução do bot marcando a caixa de seleção ao lado dela. Em seguida, clique em Exportar na barra de ferramentas superior. No painel Exportar, selecione Gerenciada como o tipo de pacote. Clique em Exportar. O processo de exportação é iniciado e pode levar alguns minutos. Quando terminar, você receberá um link de download para um arquivo .zip. - Baixe a solução exportada
Clique no link de download para salvar o arquivo .zip em sua máquina local. Mantenha este arquivo seguro. Você o usará na etapa de importação.
Etapa 2: Importar a Solução no Copilot Studio
- Abra o Copilot Studio
Acesse https://copilotstudio.microsoft.com. Faça login com a mesma conta que tem permissões no ambiente de destino. - Selecione o ambiente de destino
No canto superior direito, clique no seletor de ambiente. Escolha o ambiente onde deseja importar o bot. Se você não vir o ambiente correto, talvez seja necessário trocar de locatário ou solicitar acesso. - Abra a área de Soluções no Copilot Studio
No menu de navegação à esquerda, selecione Soluções. Se você não vir esta opção, clique no menu de três pontos e selecione Soluções. - Importe a solução
Clique em Importar na barra de ferramentas superior. No painel Importar, clique em Escolher Arquivo e selecione o arquivo .zip que você baixou anteriormente. Clique em Avançar. O processo de importação valida a solução. Se não houver erros, clique em Importar. A importação pode levar vários minutos. Uma mensagem verde de sucesso aparecerá quando terminar. - Verifique o bot importado
Após a importação ser concluída, volte ao painel principal do Copilot Studio. Seu bot deve aparecer na lista de bots. Clique no nome do bot para abri-lo. Verifique se os tópicos, entidades e fluxos estão presentes.
Etapa 3: Reconfigurar Autenticação e Canais
- Configure a autenticação
No Copilot Studio, abra seu bot importado. Vá para Configurações > Autenticação. Escolha o método de autenticação que você usou no Power Virtual Agents. Para autenticação do Microsoft Entra ID, reinsira os detalhes do registro do aplicativo. Para autenticação manual, reinsira o endpoint do token e as credenciais do cliente. - Reconfigure os canais
Vá para Configurações > Canais. Cada canal que você usou antes, como Microsoft Teams ou um site personalizado, deve ser reconfigurado. Clique no nome do canal e siga as etapas de configuração. Talvez seja necessário gerar novas credenciais específicas do canal. - Atualize as variáveis de ambiente
Se seu bot usa variáveis de ambiente para endpoints de API ou outros valores dinâmicos, vá para Configurações > Variáveis de Ambiente. Verifique se cada variável tem o valor correto para o novo ambiente. Atualize-as se necessário.
Etapa 4: Testar e Publicar o Bot
- Teste tópicos e frases de gatilho
No Copilot Studio, abra a guia Tópicos. Selecione um tópico e teste-o usando o painel Testar bot. Digite frases de gatilho e verifique se o tópico correto responde. Repita isso para todos os tópicos principais. - Teste os fluxos do Power Automate
Se seu bot usa fluxos do Power Automate, vá para Configurações > Fluxos. Verifique se cada fluxo está habilitado e conectado aos conectores corretos. Execute um teste a partir do bot para confirmar se o fluxo é executado. - Publique o bot
Assim que os testes passarem, clique em Publicar no canto superior direito. Escolha os canais onde deseja que o bot fique ativo. Confirme a ação de publicação. O bot agora está disponível nos canais configurados.
Problemas Comuns Após a Migração e Como Corrigi-los
Os Tópicos do Bot Aparecem, mas Não Respondem às Frases de Gatilho
Isso acontece quando a solução importada não inclui os mapeamentos de frases de gatilho em um formato que o Copilot Studio reconhece. Para corrigir, abra cada tópico afetado, vá para a seção Gatilho e reinsira as frases de gatilho. Em seguida, salve e teste novamente.
Os Fluxos do Power Automate Apresentam Erros ou Estão Ausentes
A solução exportada inclui a definição do fluxo, mas as conexões no fluxo podem apontar para o ambiente antigo. Abra cada fluxo no Power Automate, edite as conexões e reautentique-as. Em seguida, salve e reative o fluxo.
O Bot Não Aparece no Copilot Studio Após a Importação
A importação pode ter sido bem-sucedida, mas o bot pode estar oculto porque foi importado como uma solução gerenciada. Vá para Soluções, encontre a solução importada e abra-a. Procure pelo componente Bot. Se existir, clique nele para abrir o bot no Copilot Studio. Se o bot ainda não aparecer, talvez seja necessário criar um novo bot e importar a solução para esse contêiner de bot.
Power Virtual Agents vs Copilot Studio: Principais Diferenças Após a Migração
| Item | Power Virtual Agents | Microsoft Copilot Studio |
|---|---|---|
| Interface de criação de bots | Aplicativo web independente ou dentro do Power Platform | Portal do Copilot Studio com copiloto de criação por IA |
| Criação de tópicos | Apenas criação manual de tópicos | Manual mais sugestões de tópicos por IA generativa |
| Exportação de autenticação | Não incluída na exportação da solução | Não incluída na importação da solução |
| Configuração de canais | Configurada por bot no Power Virtual Agents | Configurada por bot no Copilot Studio |
| Integração com Power Automate | Fluxos são incluídos na exportação da solução | Fluxos são importados, mas as conexões precisam ser reautenticadas |
Após a migração, você pode usar os recursos de IA generativa do Copilot Studio para aprimorar seu bot. Por exemplo, você pode ativar a opção “Impulsionar conversas” para permitir que o bot responda a perguntas de suas bases de conhecimento sem escrever tópicos personalizados. Você também pode usar o painel de criação do Copilot para criar novos tópicos mais rapidamente.
Para evitar perda de dados, sempre exporte uma cópia de backup do seu bot antes de iniciar a migração. Mantenha o ambiente original intacto até que o bot importado passe em todos os testes. Se você encontrar erros durante a importação, verifique o histórico de soluções da central de administração do Power Platform para obter mensagens de erro detalhadas. Essas mensagens geralmente apontam para dependências ausentes ou problemas de permissão.