Compartilhar via

Crie e compartilhe coleções de componentes reutilizáveis

Coleções de componentes permitem que os criadores criem e compartilhem componentes reutilizáveis entre os agentes.

Ao usar coleções, você pode:

  • Gerencie, busque e crie coleções de componentes a partir da barra lateral do Copilot Studio, sem precisar abrir um agente, facilitando a busca e reutilização dos blocos compartilhados.
  • Use a exportação com um clique e a importação simplificada. O Copilot Studio empacota coleções em soluções gerenciadas versionadas e permite importar diretamente das configurações do agente, simplificando a experiência do maker.
  • Compartilhe coleções com colegas de equipe enquanto controla o acesso de 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 cocopilotes 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 desacoplar ativos e oferecer suporte a ciclos de lançamento independentes entre equipes.

Os componentes do agente incluem:

  • topics
  • conhecimento
  • Ferramentas
  • agentes filhos
  • Protocolos de contexto de modelo
  • connectors
  • flows
  • entities

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. Depois que uma coleção de componentes estiver disponível para um agente, todos os autores de agente poderão ver e usar a coleção, mas nã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 com base em um agente

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

  2. Acesse 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 componente.

  5. Selecione Avançar

  6. 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. 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ê só poderá excluir dependências se tiver definido um agente primário para a coleção de componentes.

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

    Dica

    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.

  7. Selecione Avançar

  8. Revise 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 nova e, depois, Coleção de componente.

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

  4. Selecione Concluir.

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

  6. Adicione componentes pelo 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 eventuais componentes dos agentes conectados à 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

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

  2. Selecione a coleção em que 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 conectou nenhum agente à coleção de componentes, a opção de adicionar componentes de um agente não estará disponível.

  5. Selecione o agente deseja e escolha Avançar.

  6. Selecione os componentes que você 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 Avançar

  8. Revise 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 primário 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 seção Agentes conectados , selecione os três pontos (...) ao lado do agente e então selecione Definir agente primário.

    Captura de tela mostrando a opção de definir o agente principal.

    Importante

    Se sua coleção tiver vários agentes conectados, a opção de 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 primário:

  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 você deseja adicionar à coleção de componentes. Desmarque Incluir dependências do componente.

  4. Selecione Avançar

  5. Revise 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 é iniciada 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:

    Captura de tela mostrando o seletor de ambiente no Copilot Studio, com uma marca de seleção ao lado de um ambiente que corresponde ao ambiente na parte superior da página.

  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 .

    Dica

    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 Avançar O painel de importação se fecha 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 uma operadora para os componentes. Você pode exportar e importar vários componentes de 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. Acesse a página Soluções.

  2. Selecione Nova solução.

  3. 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 com base no 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.

  4. Selecione Criar.

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

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

  2. Selecione Adicionar existente, aponte para Agente e escolha 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 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.

  1. Acesse a página Soluções.

  2. Selecione os três pontos (⋮) da solução que contém as coleções de componentes que você deseja exportar e então selecione Exportar solução.

  3. Entre 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 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.

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

  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. Acesse a página Soluções.

  2. Selecione o ambiente para o qual você deseja importar a coleção de componentes.

  3. Selecione Importar solução.

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

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

  6. 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ê poderá usá-la nos agentes.

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

  2. Acesse 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.

    Uma mensagem será exibida solicitando sua confirmação.

  4. Selecione Adicionar ao agente.

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

  5. Analise 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 faça referência 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 você deseja 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 agora aparecem.

Abrir o gerenciador de soluções

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

A página Soluções é aberta em uma nova guia do navegador.

  • Last updated on