Agentes de exportação e importação usando soluções
Você pode exportar e importar agentes usando soluções para poder mover seus agentes entre vários ambientes.
Primeiro, você cria uma solução personalizada e adiciona seu agente a ela. Depois, exporte a solução com seu agente e importe-a para outro ambiente. Você também pode atualizar ou atualizar uma solução com um agente e remover um camada não gerenciada de um agente gerenciado.
Consulte o artigo Visualizar e gerenciar soluções em Copilot Studio para obter mais detalhes sobre o explorador de soluções em Copilot Studio.
Observação
Você não pode exportar comentários em nível de tópico ou de nó ao exportar um agente.
Pré-requisitos
- Você deve ter pelo menos personalizador de sistema direito de acesso para usar este 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
Você não pode 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 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 usuário. Copilot Studio Remover ou alterar os componentes de um 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ê alterá-lo para solução gerenciada, não poderá exportá-lo. 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 dos seus tópicos.
Crie uma solução personalizada e adicione seu agente
Siga as etapas em Criar e gerenciar soluções em Copilot Studio para criar uma nova solução.
A solução que você criou deve abrir automaticamente. Caso contrário, Select coloque-o na lista de soluções.
Select Adicione o existente, depois Select agente e depois agente novamente.
Na lista Adicionar copilotos existentes , Select o agente ou agentes que você deseja exportar e, em seguida, Select 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 componentes, como tópicos ou fluxos, ao seu agente em Copilot Studio, você também deverá adicioná-los ao agente na sua solução não gerenciada antes de exportar.
- Abra a solução que contém seu agente.
- No painel Objetos , localize seu agente em Agentes.
- Select Commands (⋮), Select Avançado e depois Select Adicionar objetos necessários.
Você também deve revisar as instruções e os requisitos na Power Apps documentação para adicionar um componente existente a uma solução.
Exporte 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 Power Apps documentação para exportar soluções.
Importante
Se seu agente tiver um grande número de componentes (por exemplo, mais de 250 tópicos ou mais de 100 entidades), consulte Exportar usando a experiência clássica.
Importe a solução com seu agente
Siga as instruções e os requisitos na Power Apps documentação para importar soluções.
Se a importação não for bem-sucedida, Select 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 falha de uma importação é que a solução não contém alguns componentes necessários.
Configure a autenticação do usuário novamente.
No painel Objetos , Select Agentes. Então digite Select o nome do agente para abrir o agente.
Importante
- Você deve publicar seu agente 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.
Agentes de exportação e importação no Teams
Em Microsoft Teams, você pode exportar e importar agentes entre equipes individuais usando o Power Apps aplicativo Teams.
Por exemplo, se você exportar um agente ativo de uma equipe do Teams (equipe A) e depois 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 a serem exportadas, Select o agente que você deseja exportar. Você pode usar o filtro no painel lateral para mostrar apenas agentes de uma equipe específica.
O agente é salvo na pasta Downloads do seu computador.
Para importar no Teams, siga as instruções em Importar personalizações para Dataverse for Teams.
Seu agente aparece no Copilot Studio aplicativo no Teams, na equipe para a qual você o importou.