Compartilhe agentes com outros usuários e fabricantes

Note

Os recursos deste artigo são usados por agentes ou fluxos de trabalho alimentados pelo GitHub Copilot.

A cobrança por uso se aplica ao uso, criação, teste e avaliação de agentes. Essas ações podem consumir Créditos do Copilot. Saiba mais em Gerenciar os custos de agentes viabilizados pelo GitHub Copilot harness.

Você pode compartilhar seus agentes com outras pessoas da sua organização para que possam ver, testar e usar seus agentes. Para cada agente, você pode compartilhar com:

  • Usuários individuais com seus emails ou nomes de usuário
  • Todos os membros nos grupos de segurança que você especificar
  • Toda a sua organização

Caution

Este tópico descreve como compartilhar agentes que você cria usando a experiência do novo agente. Se você está usando a experiência clássica de agentes, veja Compartilhar agentes com outros fabricantes. Quando você usa a nova experiência de compartilhamento, só pode conceder direitos de visualização aos agentes que compartilha. Para conceder direitos de edição:

  1. Desative Usar a nova experiência na página inicial do Copilot Studio para permitir a edição ao compartilhar.
  2. Adicione usuários ao ambiente do agente e, em seguida, atribua direitos de edição aos usuários por meio dos papéis de segurança do ambiente. Saiba mais em Controle como os agentes são compartilhados e Atribua funções de segurança aos usuários.

Pré-requisitos

  • A autenticação do usuário para o agente está configurada para Autenticar com a Microsoft.
  • Usuários com quem você compartilha possuem uma licença do Microsoft Copilot Studio por usuário. Usuários que não possuem licença podem se inscrever para uma versão de teste.
  • Os agentes que você deseja compartilhar são publicados no Teams + Microsoft 365, com o Make agent disponível no Microsoft 365 Copilot ativado. Se o seu agente não estiver publicado, você será solicitado a salvá-lo e publicá-lo antes de compartilhá-lo.

Compartilhar um agente para visualização e testes

Note

Ao compartilhar um agente para visualização e teste, você não pode compartilhá-lo com grupos do Microsoft 365 com SecurityEnabled definido como falso. Para alterar essa configuração, veja Compartilhar um aplicativo com grupos do Microsoft 365 na documentação do Power Apps.

Importante

Compartilhar agentes do Copilot Studio que têm conexões com serviços externos, como Azure Databricks Genie, pode ser desafiador porque as conexões estão vinculadas à identidade de cada usuário de agente individual. Isso significa que um agente pode funcionar para você, mas não para outros usuários.

Para lidar com esse comportamento, use uma das seguintes abordagens:

  • Use um princípio de serviço para autenticação, se for suportado.
  • Configure conexões em nível de ambiente para que o agente funcione usando uma identidade compartilhada e não específica para o usuário.
  • Exigir que os usuários se autentiquem individualmente quando a autenticação baseada em OAuth for necessária.

Para compartilhar um agente:

  1. Abra o agente na página Agentes.
  2. Na barra de menu superior, selecione o ícone Compartilhar próximo a Publicar.

    Note

    Se você ainda não publicou seu agente, será convidado a fazer isso antes de continuar.

  3. No painel Compartilhar que aparece, insira o nome de usuário, endereços de e-mail de usuários individuais ou grupos de segurança com quem você deseja compartilhar o agente.
    • Usuários e grupos aparecem no campo Pessoas que podem usar o agente à medida que você os seleciona, com o status Pendente.
  4. Selecione Compartilhar para compartilhar o agente.

Usuários com acesso de visualização podem ver o agente em sua lista de agentes, abri-lo para visualizar detalhes e testá-lo, mas não podem editar o agente ou seu conteúdo.

Para permitir que outros editem o agente, você pode desativar o uso do GitHub Copilot na página inicial do Copilot Studio para permitir a edição ao compartilhar, ou atribuir funções de editor aos usuários do ambiente.

Se você só quiser compartilhar o agente para outras pessoas usarem, sem ver ou testar, na seção Organização, abra o menu suspenso e selecione Acesso do usuário final. Essa ação permite que qualquer pessoa da sua organização encontre e use o agente, mas não pode ver os dados ou editá-los.

Mude a configuração para Sem permissões, a menos que seja especificado para interromper o compartilhamento do agente com todos na sua organização. Usuários e membros de grupos com quem você compartilhou o agente ainda terão acesso ao agente.

Interromper o compartilhamento de um agente

Você pode interromper o compartilhamento do agente com usuários individuais, um grupo de segurança ou com todos em sua organização.

Para interromper o compartilhamento de um agente:

  1. Abra o agente na página Agentes.
  2. Na barra de menu superior, selecione o ícone Compartilhar próximo a Publicar.
  3. No painel de Compartilhamento , em Pessoas que podem usar o agente, selecione o ícone de excluir ("X") ao lado de cada grupo ou usuário. Você pode desfazer a exclusão se necessário.
  4. Para parar de compartilhar com todos na sua organização, em Todos na organização selecione Sem permissões, a menos que especificado. Usuários e membros dos grupos com quem você compartilhou o agente individualmente ainda têm acesso ao agente.
  5. Selecione Compartilhar para parar de compartilhar com sua organização ou com os usuários ou grupos removidos.

Próximas etapas após compartilhar um agente

Além de compartilhar seu agente, também é possível:

  • Last updated on