Criar coleções de componentes reutilizáveis (versão preliminar)
Uma coleção de componentes é uma coleção de componentes de agente reutilizáveis. Os componentes do Copilot incluem tópicos, conhecimentos, ações e entidades. Você pode compartilhar coleções de componentes entre vários agentes em seu ambiente. Você também pode usar uma solução para exportar e importar coleções de componentes para mover seu conteúdo entre vários ambientes para atender aos cenários de gerenciamento do ciclo de vida do aplicativo (ALM).
Para editar uma coleção de componentes ou adicionar uma coleção de componentes a um agente, você deve ser a pessoa que criou a coleção ou um usuário com a função de personalizador do sistema ou administrador do sistema. Depois que uma coleção de componentes estiver disponível para um agente, todos os autores do agente poderão ver e usar a coleção, mas não poderão alterar os componentes dentro da coleção. Saiba mais sobre como configurar a segurança do usuário em um ambiente.
Criar coleções de componentes
Você pode criar coleções de componentes diretamente da página Configurações de um agente. Você também pode criá-los na página Biblioteca. Quando você adiciona componentes de agente a uma coleção, essa operação move os componentes selecionados para a coleção. O agente de origem agora contém referências a esses componentes dentro da coleção. Agora você pode compartilhar a coleção com outros agentes em seu ambiente ou empacotá-la em uma solução a ser importada para outros ambientes.
Criar uma coleção de componentes de um agente
Abra o agente que contém os componentes que você deseja disponibilizar como uma coleção de componentes.
Acesse Configurações e selecione Coleções de componentes.
Se você estiver prestes a criar a primeira coleção de componentes em seu ambiente, selecione Criar. Caso contrário, selecione Novo.
Insira um nome e uma descrição para sua coleção de componente.
Selecione Avançar.
Selecione os componentes que você deseja adicionar à coleção de componentes. Você pode usar as categorias e o campo Pesquisar para restringir a lista de componentes.
Selecione Avançar.
Revise o conteúdo da sua coleção e selecione Criar.
Criar uma coleção de componentes a partir da biblioteca
Na navegação lateral, selecione Biblioteca.
Selecione Adicionar nova e, depois, Coleção de componente.
Insira um nome e uma descrição para sua coleção de componente.
Selecione Concluir.
Conecte o agente que contém os componentes que você deseja compartilhar à sua nova coleção de componentes.
Adicione componentes do agente selecionado à coleção.
Conectar um agente a uma coleção de componentes
Vá para a biblioteca e selecione a coleção de componentes desejada. Você pode selecionar a categoria Coleção de componentes e o campo Pesquisar para restringir a lista de coleções de componentes.
Na área Instalado em , selecione Adicionar agente.
Selecione o agente no qual você deseja usar a coleção de componentes e selecione Adicionar.
Você pode adicionar quaisquer componentes dos agentes conectados à sua coleção de componentes. Todos os agentes conectados também podem usar qualquer componente dessa coleção.
Adicionar componentes de um agente a uma coleção
Vá para a biblioteca e selecione a coleção de componentes desejada. Você pode selecionar a categoria Coleção de componentes e o campo Pesquisar para restringir a lista de coleções de componentes.
[Conecte o agente](#connect-an agent-to-a-component-collection) que você deseja adicionar à coleção de componentes, se ele ainda não estiver listado na área Instalado em.
Selecione Adicionar e, em seguida, selecione Adicionar de um agente.
Selecione o agente deseja e escolha Avançar.
Selecione os componentes que você deseja adicionar à coleção de componentes. Você pode usar as categorias e o campo Pesquisar para restringir a lista de componentes.
Selecione Avançar.
Revise o conteúdo da sua coleção e selecione Adicionar à coleção.
Criar uma solução para exportar e importar coleções do componente
Você usa soluções para exportar componentes do agente de um ambiente e importá-los para outro. A solução atua como uma operadora para os componentes. Você pode exportar e importar vários componentes do agente em uma solução.
Acesse a página Soluções.
Selecione Nova solução.
Digite as seguintes informações para a nova solução:
- Nome de exibição: o nome a ser mostrado na lista de soluções. Você pode alterar isso mais tarde.
- Nome: o nome exclusivo da solução, gerado a partir do Nome de exibição. Você só poderá alterá-lo antes de salvar a solução.
- Editor: selecione o editor padrão ou crie um novo. Pense em criar um único editor e usá-lo de forma consistente em todos os ambientes para sua solução. Saiba mais sobre editores de soluções.
- Versão: insira um número da versão da solução. O número da versão será incluído no nome do arquivo ao exportar a solução.
Selecione Criar.
Adicionar coleções de componentes a uma solução
Acesse a página Soluções e abra a solução desejada, se ainda não estiver aberta.
Selecione Adicionar existente, aponte para Agente e escolha Coleção de componentes.
Um painel é exibido, mostrando todas as coleções de componentes disponíveis.
Selecione as coleções de componentes que deseja exportar e selecione Adicionar na parte inferior do painel.
Exportar uma solução para compartilhar coleções de componentes em outros ambientes
Você exporta e importa coleções de componente exportando e importando as soluções que os contêm de um ambiente para outro.
Acesse a página Soluções.
Selecione o ícone Comandos (⋮) para a solução que contém as coleções de componentes que você deseja exportar e selecione Exportar solução.
Entre ou selecione as seguintes opções:
- Número da versão: o Copilot Studio incrementa automaticamente a versão da sua solução. Você pode aceitar a versão padrão ou inserir a sua.
- Exportar como: selecione o tipo de pacote, Gerenciado ou Não gerenciado. Saiba mais sobre soluções gerenciadas e não gerenciadas.
Selecione Exportar. A exportação pode levar alguns minutos para ser concluída. Veja a mensagem de status no topo da página Soluções.
Quando a exportação estiver concluída, selecione o botão Download para baixar um arquivo .zip.
O nome do arquivo tem este formato: SolutionName_Version_SolutionType.zip — por exemplo, ContosoSolution_1_0_0_1_managed.zip.
Importar uma solução para adicionar coleções de componentes a um ambiente
Acesse a página Soluções.
Selecione o ambiente para o qual você deseja importar sua coleção de componentes.
Selecione Importar solução.
No painel Importar, selecione Procurar, selecione o arquivo .zip que contém a solução com sua coleção de componentes e selecione Avançar.
Selecione Importar. A importação pode levar alguns minutos para ser concluída. Veja a mensagem de status no topo da página Soluções.
Aguarde alguns momentos enquanto a importação é concluída.
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.
Adicionar coleções de componentes importados ao agente
Depois de importar uma coleção de componentes, você pode usá-la em seus agentes.
Abra o agente no qual você deseja usar a coleção de componentes.
Acesse a página Configurações e selecione Coleções de componentes.
Ao lado da coleção de componentes importados, selecione os três pontos (…) e selecione Adicionar ao agente.
Uma mensagem será exibida solicitando que você confirme.
Selecione Adicionar ao agente.
O nome do agente aparece em Ativo para esta coleção de componentes.
Revise os componentes da coleção importada e publique o agente para disponibilizar as alterações aos clientes.
Adicionar componentes a uma coleção de componentes em uma solução personalizada
Se adicionar novos componentes de agente a uma coleção de componentes no Copilot Studio, você também deverá adicioná-los a qualquer solução não gerenciada que se refira a essa coleção de componentes.
Vá para a página Soluções e abra a solução não gerenciada que contém a coleção de componentes a ser atualizada.
No painel Objetos, selecione Coleções de componentes do agente.
Selecione o ícone Comandos (⋮) da coleção que deseja atualizar, aponte para Avançado e selecione Adicionar objetos necessários.
Selecione OK.
No painel Objetos, você pode selecionar Componentes do agente para verificar se os componentes esperados agora aparecem.
Abrir o gerenciador de soluções
No Copilot Studio, selecione os três pontos (...) na navegação lateral e selecione Soluções.
A página Soluções é aberta em uma nova guia do navegador.
Problema conhecido
Se você carregou arquivos como fontes de conhecimento para um agente, adicionar esses arquivos a uma coleção de componentes os removerá do agente de origem. Como solução alternativa, você pode mover esses arquivos da coleção de componentes de volta para o agente de origem.