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 seu 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 ou 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 gerenciador de soluções em Copilot Studio.

Observação

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

Pré-requisitos

• Você deve ter pelo menos a função de segurança Personalizador de Sistema para usar esse recurso. 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 em 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 da solução, a menos que você também tenha removido o agente da solução.

  Você só deve fazer alterações em tópicos como parte do processo de criação padrão na interface do Copilot Studio. Remover ou alterar componentes do agente diretamente da solução fará com que a exportação e a importação falhem.

• Você não pode exportar soluções gerenciadas. Quando você cria uma solução, ela não é gerenciada por padrão. Se você mudar para uma solução gerenciada, não poderá exportá-la. Você precisará 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 seu agente

1. Siga os passos em Criar e gerenciar soluções no Copilot Studio para criar uma nova solução.

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

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

4. Na lista Adicionar copilotos existentes, selecione o(s) agente(s) que você deseja exportar e selecione Adicionar.

Observação

Para um chatbot Clássico:

Caso você esteja usando habilidades, remova a variável de ambiente da habilidade Valor Atual selecionando Remover desta solução.

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

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

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

1. Abra a solução que contém o agente.
2. No painel Objetos, localize seu agente em Agentes.
3. Selecione Comandos (⋮), selecione Avançado e, em seguida, escolha Adicionar objetos obrigató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 agente exportando e importando as soluções que os contêm de um ambiente para outro.

Siga as instruções e os requisitos na documentação do Power Apps para exportar soluções.

Importante

Se o seu agente tiver um grande número de componentes (por exemplo, mais de 250 tópicos ou mais de 100 entidades), ver Exportar usando a experiência clássica.

Importar a solução com seu agente

Siga as instruções e os requisitos na documentação do Power Apps para importar soluções.

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. Configurar autenticação de usuário final novamente.

2. No painel Objetos, selecione Agentes. Em seguida, selecione o nome do agente para abri-lo.

Importante

• Você deve publicar seu agente recém-importado antes que ele possa ser compartilhado.
• Pode levar até 24 horas para que o ícone do seu agente apareça em todos os lugares.

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 você exportar um agente de trabalho de uma equipe do Teams (equipe A) e importá-lo para a equipe B, não será necessário criá-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 Dataverse for Teams.

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