Exportar e importar agentes usando soluções

Você pode exportar e importar agentes usando soluções para que você possa mover seus agentes por vários ambientes.

Primeiro, você cria uma solução personalizada e adiciona o agente a ela. Então você exporta a solução com o seu agente e o importa para outro ambiente. Você também pode atualizar uma solução com um agente e remover uma camada não gerenciada de um agente gerenciado.

Para obter mais informações sobre o gerenciador de soluções no Copilot Studio, consulte View e gerencie soluções no Copilot Studio.

Pré-requisitos

• Você deve ter pelo menos o papel de segurança Personalizador de Sistema para usar esta função. Saiba mais sobre como configurar a segurança do usuário em um ambiente.
• Você deve estar familiarizado com os conceitos de solução, conforme descrito em Conceitos de solução e Criar e gerenciar soluções no Copilot Studio.

O que você deve saber...

• Não é possível exportar comentários no nível do tópico ou no nível do nó ao exportar um agente.

• Remover um agente de uma solução não remove seus componentes da solução. Você deve remover os componentes separadamente.

  Aviso

  Não remova componentes de agentes não gerenciados, como tópicos de agente, diretamente na solução, a menos que você também remova o agente da solução.

  Você só deve fazer alterações nos tópicos como parte do processo de criação padrão na interface do usuário do Copilot Studio. A remoção ou alteração direta dos componentes de um agente da solução resulta em falha na exportação e importação.

• Você não pode exportar soluções gerenciadas. Quando você cria uma solução, ela não é gerenciada por padrão. Se alterá-lo para uma solução gerenciada, você não poderá exportá-lo. Você precisa criar uma nova solução.

• Não é possível exportar uma solução que contenha um agente com pontos (.) no nome de qualquer um de seus tópicos.

Criar uma solução personalizada e adicionar o agente

1. Para criar uma nova solução no gerenciador de soluções do Copilot Studio, siga as etapas em Criar e gerenciar soluções no Copilot Studio.

2. A solução criada deve ser aberta automaticamente. Do contrário, selecione-o na lista de soluções.

3. Selecione Adicionar existente e, depois, Agente e Agente de novo.

4. Na lista Adicionar agentes existentes, selecione o agente ou os agentes que você deseja exportar e selecione Adicionar.

Adicionar componentes a um agente em uma solução personalizada

Se você adicionar componentes, como tópicos ou fluxos, ao agente no Copilot Studio, também deverá adicioná-los ao agente em sua solução não gerenciada antes de exportar.

1. Abra o Explorador de Soluções no Copilot Studio.

2. Selecione a solução que contém seu agente.

3. No painel Objetos, localize seu agente em Agentes.

4. Selecione os três pontos (⋮), selecione Avançado e depois selecione Adicionar objetos necessários.

Você também deve examinar as instruções e os requisitos na documentação do Power Apps para adicionar um componente existente a uma solução.

Adicione conectores personalizados à sua solução

Se seu agente usa conectores personalizados, siga os passos em Criar conectores personalizados em soluções e aprenda sobre as limitações conhecidas.

Adicionar fluxos de Power Automate

Ao usar fluxos e variáveis de ambiente, adicione os objetos necessários para fluxos e variáveis de ambiente.

1. Abra o Explorador de Soluções no Copilot Studio.

2. Selecione a solução que contém seu agente.

3. No painel de Objetos , localize seus fluxos de trabalho.

4. Selecione os três pontos (⋮), selecione Avançado e depois selecione Adicionar objetos necessários.

Adicionar variáveis de ambiente

Para adicionar variáveis de ambiente, siga estes passos:

1. Abra o Explorador de Soluções no Copilot Studio.

2. Selecione a solução que contém seu agente.

3. Se variáveis de ambiente não existirem na solução, selecione Adicionar existente, selecione Mais e então selecione variável de ambiente.

   1. Selecione as variáveis de ambiente necessárias.

   2. Selecione Próximo e depois selecione Adicionar.

4. Se todas as variáveis de ambiente existirem na solução, selecione os três pontos (⋮), selecione Avançado e depois selecione Adicionar objetos necessários para garantir que todas as dependências sejam adicionadas à solução.

Personalize componentes para soluções gerenciadas

Para tornar os componentes personalizáveis em soluções gerenciadas, veja Visualizar e editar propriedades gerenciadas de tabelas.

Garanta que seu ambiente permita personalização antes de importar soluções gerenciadas. Verifique se seu ambiente não bloqueia customizações ou soluções não gerenciadas. Saiba mais em Personalizações não gerenciadas bloqueadas no Dataverse.

Exportar a solução com seu agente

Você exporta e importa agentes exportando e importando as soluções que os contêm de um ambiente para outro.

Para exportar a solução com o agente, siga estas etapas:

1. Abra o Explorador de Soluções no Copilot Studio.

2. Na lista de soluções não gerenciadas, selecione a solução que contém o agente.

3. Selecione Exportar solução. Assim como na experiência de exportar soluções do Power Apps, o painel direito Antes de exportar aparece.

4. O restante das etapas são as mesmas para exportar soluções em Power Apps. Para concluir exportando a solução, siga as instruções e os requisitos na documentação do Power Apps.

Importar a solução com seu agente

Para importar a solução com o agente em outro ambiente, siga estas etapas:

1. No ambiente de destino, abra o gerenciador de soluções no Copilot Studio.

2. Selecione Importar solução. Assim como na experiência de importação de soluções no Power Apps import solutions, o painel direito Importar uma solução aparece.

3. O restante das etapas são as mesmas para importar soluções em Power Apps. Para concluir importando a solução, siga as instruções e os requisitos na documentação do Power Apps.

Se a importação não for bem-sucedida, selecione Baixar arquivo de log para baixar um arquivo XML que contém detalhes sobre o que causou a falha na importação. O motivo mais comum para uma falha na importação é que a solução não contém alguns dos componentes exigidos.

1. No explorador de soluções, selecione a nova solução importada da lista.

2. No painel Objetos, selecione Agentes. Em seguida, selecione o nome do agente para abrir o agente no Copilot Studio em uma nova aba.

3. Configure novamente a autenticação do usuário para o agente.

Exportar e importar agentes no Teams

Em Microsoft Teams, você pode exportar e importar agentes entre equipes individuais usando o aplicativo Power Apps Teams.

Por exemplo, se você exportar um agente da equipe A no Teams e importá-lo para a equipe B, não será necessário recriá-lo do zero para a equipe B.

Siga as instruções em Exportar personalizações do Dataverse for Teams.

Ao selecionar as personalizações para exportar, selecione o agente que deseja exportar. Você pode usar o filtro no painel lateral para mostrar apenas os agentes para uma equipe específica.

O agente é salvo na pasta Downloads no computador.

Para importar no Teams, siga as instruções em Importar personalizações para o Dataverse for Teams.

Seu agente aparece no aplicativo Copilot Studio no Teams, na equipe para a qual você o importou.