Talvez você precise mover um agente do Copilot Studio de um ambiente de desenvolvimento para um de teste ou produção. O processo de exportação e importação transfere a definição do agente, tópicos, entidades e configurações sem recriar o agente manualmente. Este artigo explica as etapas exatas para exportar um agente do Copilot Studio e importá-lo em um ambiente de destino. Também aborda erros comuns e limitações que você encontrará durante a transferência.
Principais pontos: Exportar e Importar um Agente do Copilot Studio
- Copilot Studio > Configurações > Exportar agente: Exporta o agente como um arquivo .zip contendo a definição do agente, tópicos, entidades e variáveis de ambiente.
- Copilot Studio > Configurações > Importar agente: Importa o arquivo .zip para o ambiente de destino e cria uma cópia do agente.
- Valores das variáveis de ambiente do Microsoft Dataverse: Precisam ser reconfigurados manualmente após a importação, pois segredos e referências de conexão não são transferidos.
O que o Processo de Exportação e Importação Abrange
Os agentes do Copilot Studio são armazenados em ambientes do Microsoft Dataverse. Cada ambiente é um banco de dados isolado. Mover um agente entre ambientes requer exportar a solução do agente do ambiente de origem e importá-la no ambiente de destino. A exportação captura a definição do agente, todos os tópicos, entidades, placeholders de variáveis de ambiente e configurações do sistema. A importação cria um novo agente no ambiente de destino com a mesma estrutura lógica.
A exportação não transfere os valores reais das variáveis de ambiente que contêm segredos, como chaves de API ou strings de conexão. Você deve inserir manualmente esses valores no ambiente de destino após a importação. O agente não funcionará corretamente até que as variáveis de ambiente sejam preenchidas com valores válidos. Além disso, referências de conectores que apontam para serviços externos precisarão ser reconfiguradas no ambiente de destino.
Antes de começar, confirme que você tem a função de Personalizador do Sistema ou Administrador do Sistema nos ambientes de origem e destino. Você também precisa ter acesso ao aplicativo Copilot Studio em ambos os ambientes. As operações de exportação e importação são realizadas na interface do Copilot Studio, não no centro de administração do Power Platform.
Etapas para Exportar um Agente do Copilot Studio do Ambiente de Origem
- Abra o agente no Copilot Studio
Entre no Copilot Studio em copilotstudio.microsoft.com. Alterne para o ambiente de origem usando o seletor de ambiente no canto superior direito. Abra o agente que deseja mover. - Acesse o menu Configurações
Na barra de navegação superior, clique no ícone de engrenagem chamado Configurações. Não clique no menu de reticências ao lado do nome do agente. - Selecione Exportar agente
No painel Configurações, role até a seção Exportar. Clique em Exportar agente. O Copilot Studio prepara um pacote de solução que contém o agente. Esse processo pode levar alguns segundos. - Baixe o arquivo .zip
Quando a exportação for concluída, o navegador baixa um arquivo .zip. O nome do arquivo segue o padrão AgentName_DateTime.zip. Não renomeie nem modifique o conteúdo do arquivo .zip. Mantenha o arquivo em um local seguro.
Etapas para Importar o Agente do Copilot Studio no Ambiente de Destino
- Alterne para o ambiente de destino
No Copilot Studio, use o seletor de ambiente para alternar para o ambiente de destino. Confirme que o ambiente de destino é um ambiente Dataverse com a licença do Copilot Studio aplicada. - Abra o menu Configurações
Clique no ícone de engrenagem na barra de navegação superior. O painel Configurações é aberto. - Selecione Importar agente
No painel Configurações, role até a seção Importar. Clique em Importar agente. Uma caixa de diálogo de seleção de arquivo é aberta. - Carregue o arquivo .zip exportado
Selecione o arquivo .zip que você baixou na etapa de exportação. Clique em Abrir. O Copilot Studio valida o pacote e inicia a importação. O processo de importação pode levar vários minutos, dependendo da complexidade do agente. - Configure as variáveis de ambiente
Após a importação ser concluída, o agente aparece no ambiente de destino. O agente mostrará um ícone de aviso se os valores das variáveis de ambiente estiverem ausentes. Abra o agente e vá para Configurações > Variáveis de ambiente. Insira os valores necessários para cada variável. Para segredos, use referências do Azure Key Vault, se disponível. - Publique o agente importado
Após configurar as variáveis de ambiente, publique o agente. Clique em Publicar na barra de navegação superior. O agente fica disponível nos canais configurados no ambiente de destino.
Problemas Comuns ao Mover um Agente do Copilot Studio
A importação falha com erro de validação sobre dependências ausentes
Esse erro ocorre quando o agente faz referência a conectores personalizados, fluxos do Power Automate ou tabelas do Dataverse que não existem no ambiente de destino. Antes de importar, garanta que todos os componentes dependentes estejam presentes no ambiente de destino. Exporte e importe as soluções dependentes primeiro ou recrie os componentes ausentes no ambiente de destino.
O agente aparece, mas não responde aos tópicos após a importação
O agente pode estar em estado de rascunho ou os valores das variáveis de ambiente podem estar vazios. Abra o agente e verifique se as variáveis de ambiente estão preenchidas. Em seguida, publique o agente. Se o agente ainda não responder, verifique os diagnósticos do agente no Copilot Studio para erros específicos.
Referências de conexão quebram após a importação
Referências de conexão armazenam detalhes de autenticação para serviços externos. Essas referências não são transferidas durante a exportação. Após a importação, abra cada tópico que usa uma referência de conexão e reconfigure a conexão. Use o mesmo tipo de conector e método de autenticação do ambiente de origem.
O agente usa um idioma ou localidade diferente após a importação
As configurações de idioma e localidade fazem parte da definição do agente e são transferidas durante a exportação. Se o ambiente de destino tiver configurações de idioma padrão diferentes, o agente mantém seu idioma original. Para alterar o idioma, edite as configurações do agente após a importação.
| Item | Comportamento na Exportação/Importação | Reconfiguração Manual Necessária |
|---|---|---|
| Definição do agente e tópicos | Transferidos completamente | Não |
| Placeholders de variáveis de ambiente | Transferidos como placeholders vazios | Sim — insira valores reais |
| Segredos de variáveis de ambiente | Não transferidos | Sim — insira novos segredos |
| Referências de conexão | Transferidas, mas não autenticadas | Sim — reconfigure cada conexão |
| Conectores personalizados | Não transferidos | Sim — exporte e importe separadamente |
| Fluxos do Power Automate | Não transferidos | Sim — exporte e importe separadamente |
| Personalizações de tabelas do Dataverse | Não transferidas | Sim — exporte e importe separadamente |
O processo de exportação e importação move a lógica do agente, mas as dependências externas permanecem no ambiente de origem. Planeje sua migração de ambiente exportando todas as soluções dependentes antes de mover o agente. Após a importação, sempre teste o agente no ambiente de destino antes de direcionar tráfego real de usuários para ele.
Agora você pode mover um agente do Copilot Studio entre ambientes usando as funções internas de exportação e importação. Em seguida, revise os valores das variáveis de ambiente e as referências de conexão para garantir que o agente funcione corretamente no ambiente de destino. Para cenários avançados, considere usar pipelines do Azure DevOps para automatizar o processo de exportação e importação para integração e implantação contínuas.