Criar e partilhar coleções de componentes reutilizáveis

As coleções de componentes permitem aos criadores criar e partilhar componentes reutilizáveis entre agentes.

Ao usar coleções, você pode:

• Pode gerir, pesquisar e criar coleções de componentes a partir da barra lateral no Copilot Studio, sem precisar de abrir um agente, tornando os blocos de construção partilhados mais fáceis de encontrar e reutilizar.
• Use a exportação com um clique e a importação simplificada. O Copilot Studio empacota coleções em soluções geridas versionadas e permite-lhe importar diretamente das definições do agente, simplificando a experiência do maker.
• Partilhe coleções com colegas de equipa enquanto controla o acesso à edição, permitindo uma colaboração segura e protegendo os principais ativos.
• Restrinja uma coleção para que ela possa ser usada apenas por seu agente pretendido (o agente principal), ajudando as equipes a modularizar copilots grandes ou confidenciais sem reutilização não intencional.
• Teste como uma coleção se comporta em diferentes agentes diretamente do espaço de trabalho Coleções de componentes, acelerando a iteração e garantindo resultados consistentes.
• Colete e compartilhe tipos de conectores mais recentes, incluindo agentes filho, protocolos de contexto de modelo, conectores e fluxos.
• Remova ou ajuste dependências para separar ativos e oferecer suporte a ciclos de lançamento independentes entre equipes.

Os componentes do agente incluem:

• topics
• conhecimento
• Ferramentas
• agentes infantis
• protocolos de contexto de modelo
• connectors
• flows
• entidades

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 de sistema ou administrador do sistema. Quando 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ê cria coleções de componentes diretamente da página Configurações de um agente ou da página Coleções de componentes . Quando você adiciona componentes de um agente a uma coleção, os componentes são movidos para a coleção e o agente faz referência aos componentes dentro da coleção.

Você pode compartilhar a coleção com outros agentes em seu ambiente ou exportá-la para importá-la para outros ambientes.

Criar uma coleção de componentes a partir de um agente

1. Abra o agente que contém os componentes que você deseja disponibilizar como uma coleção de componentes.

2. Vá para Configurações e selecione Coleções de componentes.

3. Se você estiver prestes a criar a primeira coleção de componentes em seu ambiente, selecione Criar. Caso contrário, selecione Novo.

4. Insira um nome e uma descrição para sua coleção de componentes.

5. Selecione Seguinte.

6. Selecione os componentes que deseja adicionar à coleção de componentes. Você pode usar as categorias e o campo Pesquisar para restringir a lista de componentes. Você pode conectar agentes filhos ao revisar a coleção.

   Todas as dependências de componentes são selecionadas automaticamente e adicionadas à coleção. Você pode excluir dependências somente se tiver definido um agente primário para a coleção de componentes.

   O agente primário é o agente que possui os componentes da coleção. Se você não definir um agente primário, a coleção de componentes será de propriedade do ambiente e, portanto, deverá ter acesso às dependências.

   Sugestão

   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 seu agente de origem.

7. Selecione Seguinte.

8. Reveja o conteúdo da sua coleção e selecione Criar.

Criar uma coleção de componentes no nível do ambiente

1. Na barra lateral, selecione os três pontos (...), depois selecione Coleções de Componentes.

2. Selecione Adicionar novo e, em seguida, selecione Coleção de componentes.

3. Insira um nome e uma descrição para sua coleção de componentes.

4. Selecione Concluir.

5. Conecte o agente que contém os componentes que você deseja compartilhar à sua nova coleção de componentes.

6. Adicione componentes do agente selecionado à coleção.

Conectar um agente a uma coleção de componentes

1. Na barra lateral, selecione os três pontos (...), depois selecione Coleções de Componentes.

2. Selecione a coleção que você deseja conectar a um agente.

3. Na seção Agentes conectados , selecione Adicionar agente. Selecione o agente que você deseja conectar e, em seguida, Adicionar.

   Você pode adicionar quaisquer componentes dos agentes conectados à sua coleção de componentes. Todos os agentes conectados também podem usar quaisquer componentes dessa coleção.

Adicionar componentes de um agente a uma coleção

1. Na barra lateral, selecione os três pontos (...), depois selecione Coleções de Componentes.

2. Selecione a coleção onde deseja adicionar componentes.

3. Conecte o agente que contém os componentes que você deseja reutilizar na coleção, se ainda não estiver.

4. Na seção Adicionar componentes , selecione Adicionar de um agente.

   Observação

   Se você não tiver conectado nenhum agente à coleção de componentes, a opção de adicionar componentes de um agente não estará disponível.

5. Selecione o agente desejado e selecione Avançar.

6. Selecione os componentes que deseja adicionar à coleção de componentes. Você pode usar os rótulos de categoria e o campo Pesquisar componentes para restringir a lista de componentes.

7. Selecione Seguinte.

8. Reveja o conteúdo da sua coleção e selecione Adicionar à coleção.

Definir um agente primário para uma coleção de componentes e excluir dependências

Você pode definir um único agente como o agente principal para uma coleção de componentes. Os criadores têm a opção de selecionar um agente primário se quiserem que apenas um agente específico use a coleção de componentes.

Se sua coleção tiver vários agentes conectados, você não poderá definir um agente principal. Você deve desconectar todos os outros agentes primeiro.

Ao definir um agente primário, você também pode excluir dependências ao adicionar componentes desse agente. Isso permite que você crie coleções de componentes menores que não incluem todas as dependências, o que pode ser útil quando você deseja compartilhar apenas componentes específicos.

1. Na barra lateral, selecione os três pontos (...), depois selecione Coleções de Componentes.

2. Selecione a coleção para a qual você deseja definir um agente principal.

3. Na secção Agentes Conectados , selecione os três pontos (...) ao lado do agente e depois selecione Definir agente primário.

   

   Importante

   Se sua coleção tiver vários agentes conectados, a opção para definir um agente principal não estará disponível. Para cada agente diferente daquele que você deseja definir como principal, selecione Desconectar do agente.

Para excluir dependências ao adicionar componentes do agente principal:

1. Selecione Adicionar de um agente na coleção de componentes.

2. Selecione o agente principal e selecione Avançar.

3. Selecione os componentes que deseja adicionar à coleção de componentes. Desmarque Incluir dependências de componentes.

4. Selecione Seguinte.

5. Reveja o conteúdo da sua coleção e selecione Adicionar à coleção.

Compartilhar uma coleção de componentes

Você pode compartilhar uma coleção de componentes com outros usuários em sua organização e especificar se eles têm permissões de Visualizador ou Editor . Para obter mais informações sobre funções de permissão para usuários do Copilot Studio, consulte Controlar como os agentes são compartilhados.

1. Na barra lateral, selecione os três pontos (...), depois selecione Coleções de Componentes.

2. Selecione a coleção que deseja compartilhar.

3. Na barra de menu superior, selecione Compartilhar.

4. No painel de compartilhamento, insira os nomes ou endereços de e-mail de outras pessoas com quem você deseja compartilhar a coleção de componentes. Para cada usuário, especifique as funções de permissão (Visualizador ou Editor).

Importar e exportar coleções

Você pode exportar coleções para importá-las para outros ambientes. Quando você exporta uma coleção, ela se torna gerenciada. Para exportar uma coleção sem que ela seja gerenciada, consulte Usar soluções para coleções complexas.

Para exportar uma coleção:

1. Na barra lateral, selecione os três pontos (...), depois selecione Coleções de Componentes.

2. Abra a coleção que deseja exportar.

3. Na barra de menu superior, selecione Exportar.

A exportação começa e uma barra de notificação é exibida. Quando a exportação estiver pronta, a notificação será alterada para incluir um link para baixar a coleção como um arquivo .zip.

Para importar uma coleção:

1. No Copilot Studio, verifique se o ambiente para o qual você deseja importar sua coleção está selecionado:

   

2. Abra o agente que você deseja conectar à coleção e selecione Configurações na barra superior.

3. Selecione Coleções de componentes no menu lateral e, em seguida, selecione Importar solução.

4. No painel exibido, selecione Procurar arquivos e escolha a coleção exportada.

5. Os detalhes da coleção são mostrados. Você pode excluir etapas e fluxos de plug-in na seção Configurações avançadas .

   Sugestão

   Se você tentar importar uma coleção para o mesmo ambiente de onde a exportou, verá uma mensagem de erro. Confirme se você está no ambiente de destino que não contém a coleção.

6. Selecione Seguinte. O painel de importação fecha-se e uma mensagem mostra que a coleção foi importada com sucesso.

Use soluções para coleções complexas

Você também pode usar soluções para exportar componentes do agente de um ambiente e importá-los para outro. A solução atua como um transportador para os componentes. Você pode exportar e importar vários componentes do agente em uma solução.

Geralmente, use soluções para coleções de componentes complexos. Por exemplo, se sua coleção tiver conectores ou variáveis de ambiente.

Criar uma solução

1. Vá para a página Soluções .

2. Selecione Nova solução.

3. Insira as seguintes informações para a nova solução:

   • Nome para exibição: o nome a ser exibido na lista de soluções. Você pode alterá-lo mais tarde.
   • Nome: O nome exclusivo da solução, gerado a partir do Nome para exibição. Você só pode alterá-lo antes de salvar a solução.
   • Publicador: selecione o editor padrão ou crie um novo. Considere a criação de um único editor e use-o de forma consistente em todos os ambientes para sua solução. Saiba mais sobre editores de soluções.
   • Versão: introduza um número da versão da solução. O número de versão é incluído no nome de ficheiro quando exportar a solução.

4. Selecione Criar.

Adicionar coleções de componentes a uma solução

1. Vá para a página Soluções e abra a solução desejada, se ainda não estiver.

2. Selecione Adicionar existente, aponte para Agente e selecione Coleção de componentes.

   Um painel é exibido, mostrando todas as coleções de componentes disponíveis.

3. Selecione as coleções de componentes que deseja exportar e, em seguida, 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 componentes exportando e importando as soluções que as contêm de um ambiente para outro.

1. Vá para a página Soluções .

2. Seleciona os três pontos (⋮) da solução que contém as coleções de componentes que queres exportar e depois seleciona Exportar solução.

3. Insira ou selecione as seguintes opções:

   • Número da versão: o Copilot Studio incrementa automaticamente a versão da solução. Você pode aceitar o padrão ou inserir o seu próprio.
   • Exportar como: Selecione o tipo de pacote, como Gerido ou Não gerido. Saiba mais sobre soluções gerenciadas e não gerenciadas.

4. Selecione Exportar. A exportação pode levar vários minutos para ser concluída. Assista à mensagem de status na parte superior da página Soluções .

5. 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

1. Vá para a página Soluções .

2. Selecione o ambiente para o qual deseja importar sua coleção de componentes.

3. Selecione Importar solução.

4. No painel Importar , selecione Procurar, selecione o arquivo de .zip que contém a solução com sua coleção de componentes e selecione Avançar.

5. Selecione Importar. A importação pode levar vários minutos para ser concluída. Assista à mensagem de status na parte superior da página Soluções .

6. Aguarde alguns instantes 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 contenha detalhes sobre o que causou a falha na importação. A razão mais comum pela qual uma importação falha é que a solução não contém alguns componentes necessários.

Adicionar coleções de componentes importados ao seu agente

Depois de importar uma coleção de componentes, você pode usá-la em seus agentes.

1. Abra o agente onde você deseja usar a coleção de componentes.

2. Vá para a página Configurações e selecione Coleções de componentes.

3. Ao lado da coleção de componentes importados, selecione os três pontos (...) e selecione Adicionar ao agente.

   Será exibida uma mensagem solicitando a confirmação.

4. Selecione Adicionar ao agente.

   O nome do seu agente aparece em Ativo para esta coleção de componentes.

5. Reveja os componentes da coleção importada e publique o agente para disponibilizar as alterações aos seus clientes.

Adicionar componentes a uma coleção de componentes em uma solução personalizada

Se você adicionar novos componentes de agente a uma coleção de componentes no Copilot Studio, também deverá adicioná-los a qualquer solução não gerenciada que se refira a essa coleção de componentes.

1. 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.

2. No painel Objetos , selecione Coleções de componentes do agente.

3. Selecione os três pontos (⋮) da coleção que quer atualizar, aponte para Avançado e selecione Adicionar objetos necessários.

4. Selecione OK.

   No painel Objetos , você pode selecionar Componentes do agente para verificar se os componentes esperados aparecem agora.

Abra o explorador de soluções

No Copilot Studio, selecione os três pontos (...) na barra lateral e depois selecione Soluções.

A página Soluções abre-se num novo separador do navegador.