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.

Consulte o artigo Exibir e gerenciar soluções no Copilot Studio para obter mais detalhes sobre o explorador de soluções no Copilot Studio.

Pré-requisitos

• Você deve ter pelo menos o direito de acesso Personalizador de Sistema para usar esse recurso. Saiba mais sobre como configurar a segurança do usuário em um ambiente.
• Você deve ter familiaridade com 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 em nível de tópico ou de 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 a alteração direta de componentes de um agente da solução causa falha na exportação e na 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. Siga as etapas em Criar e gerenciar soluções no Copilot Studio para criar uma nova solução no explorador de soluções do 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 adicionar componentes, como tópicos ou fluxos, ao agente no Copilot Studio, você também deverá adicioná-los ao agente na solução não gerenciada antes de exportar.

1. Abra o gerenciador de soluções no Copilot Studio.

2. Selecione a solução que contém o 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 revisar as instruções e os requisitos na documentação do Power Apps para adicionar um componente existente a uma solução.

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 gerenciador 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 acontece na experiência das soluções de exportação do Power Apps, o painel direito Antes de exportar.

4. O restante das etapas é igual às soluções de exportação no Power Apps. Siga as instruções e os requisitos na documentação do Power Apps para concluir a exportação da solução.

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 explorador de soluções no Copilot Studio.

2. Selecione Importar solução. Assim como acontece na experiência das soluções de importação do Power Apps, o painel direito Importar uma solução é exibido.

3. O restante das etapas é igual às soluções de importação no Power Apps. Siga as instruções e os requisitos na documentação do Power Apps para concluir a importação da solução.

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 abri-lo no Copilot Studio em uma nova guia.

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

Exportar e importar agentes no Teams

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

Por exemplo, se exportar um agente de trabalho de uma equipe do Teams (equipe A) e importá-lo para a equipe B, você não precisará compilá-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.

O agente é exibido no aplicativo do Copilot Studio no Teams, na equipe para a qual você o importou.