Compartilhar e gerenciar agentes

Você pode compartilhar os agentes criados usando o Microsoft 365 Copilot com usuários em sua organização. Os agentes oferecem suporte a vários proprietários, para que você possa compartilhar a propriedade entre sua equipe. Qualquer proprietário pode editar, gerenciar e manter o agente. O compartilhamento de um agente fornece acesso direto a ele para um conjunto especificado de usuários. Embora seja ideal para colaboração em equipe, o compartilhamento de um agente não permite a implantação em toda a organização ou a integração com outros canais.

Este artigo descreve como compartilhar e gerenciar os agentes que você cria usando o recurso Construtor de Agentes no Microsoft 365 Copilot. Para publicar um agente em vários canais, você precisa usar o Copilot Studio. Para obter mais informações, consulte Publicar e implantar seu agente.

Compartilhar um agente

Depois de criar e testar seu agente no Microsoft 365 Copilot, selecione Criar. Depois que seu agente é criado, uma mensagem de confirmação indica que o agente é privado e está disponível apenas para você. Para compartilhar o agente com outras pessoas, selecione Compartilhar para abrir a caixa de diálogo de compartilhamento.

Compartilhar agentes da lista Todos os agentes

A caixa de diálogo de compartilhamento lista todos que têm acesso, suas funções, a alternância de compartilhamento em toda a organização e um link que você pode copiar a qualquer momento.

Observação

Seu administrador pode aplicar uma política que restringe determinadas opções de compartilhamento de agentes. Essa alteração de governança se aplica no momento da implementação e não revoga as permissões de acesso de agente existentes. Se as opções de compartilhamento forem restritas em sua organização, um administrador deverá aprovar e implantar o agente antes que ele esteja disponível para outros usuários na organização. Se as políticas de governança mudarem, atualize as opções de compartilhamento para que seu agente esteja em conformidade antes de fazer atualizações para ele.

Entender as funções

A caixa de diálogo de compartilhamento usa dois níveis de acesso.

Função Descrição Pode conversar Pode editar e gerenciar
Pode editar Proprietário — direitos totais para editar, compartilhar e gerenciar o agente. Sim Sim
Pode conversar Usuário do Chat — pode interagir apenas com o agente. Sim Não

Um proprietário é qualquer pessoa com acesso Pode editar . Todos os proprietários têm direitos iguais, incluindo a capacidade de adicionar ou remover pessoas, alternar funções e ativar o compartilhamento em toda a organização.

Observação

Não é possível adicionar um grupo como proprietário. Quando você adiciona um grupo, ele só pode ser um usuário de chat (pode conversar). Para conceder direitos de proprietário, adicione usuários individuais.

Adicionar proprietários e usuários de chat

  1. Abra o agente que você deseja compartilhar e selecione Compartilhar.
  2. Na caixa de diálogo compartilhar, insira um nome, grupo ou email na caixa Adicionar um nome, grupo ou email .
  3. No painel Adicionar pessoas , defina a função para as pessoas que você está adicionando:
    • Escolha Pode editar para adicioná-los como um proprietário com direitos completos de edição e gerenciamento.
    • Escolha Pode chat para adicioná-los como um usuário de chat que só pode interagir com o agente.
  4. Deixe a caixa de seleção Enviar notificação marcada para enviar um email aos novos usuários para que eles saibam que têm acesso. Desmarque a caixa de seleção se não quiser enviar um email.
  5. Selecione Adicionar.

Adicionar painel de pessoas

Quando o compartilhamento for concluído, você receberá uma confirmação e poderá copiar o link do chat para compartilhá-lo diretamente.

Observação

Os recursos do agente diferem com base na licença do usuário. Os usuários só podem adicionar agentes que são compartilhados com eles quando têm o tipo de licença do Microsoft 365 Copilot necessária para acessar os recursos configurados nesse agente. Se um usuário não tiver a licença apropriada para os recursos de um agente, as tentativas de usar o agente poderão resultar em um erro. Para obter detalhes, consulte Recursos do agente para usuários do Microsoft 365.

Alternar a função de um usuário

Como proprietário, você pode alterar a função de qualquer usuário compartilhado a qualquer momento.

  1. Abrir a caixa de diálogo Compartilhar .
  2. Selecione a lista suspensa de funções ao lado do usuário.
  3. Escolha uma nova opção:
    • Pode editar - promova o usuário a um proprietário com todos os direitos.
    • Can chat - altere o usuário para um usuário de chat.
    • Remover - revoga o acesso do usuário.

As alterações entram em vigor imediatamente.

Adicionar lista suspensa de função

A caixa de diálogo compartilhar exibe links para que você possa compartilhar o acesso sem sair navegando:

  • Link do Chat - para usuários do chat que precisam interagir apenas com o agente.
  • Editar link - para proprietários que precisam criar e gerenciar o agente.

Selecione Copiar link de chat ou selecione Editar link e cole-o em email, chat ou documentação.

Habilitar o compartilhamento em toda a organização

Para disponibilizar um agente para todos em seu locatário, ative o compartilhamento em toda a organização para acesso ao chat.

  1. Abrir a caixa de diálogo Compartilhar .
  2. Ative a alternância de compartilhamento em toda a organização para acesso ao chat .

Quando você ativa a alternância, outros usuários no mesmo locatário podem ver o agente na Loja de agentes, para que possam descobri-lo e começar a conversar.

Controles de governança e administração

Os administradores de locatários podem gerenciar quem pode compartilhar agentes no nível da organização. Esses controles ajudam a manter a conformidade e evitar o compartilhamento excessivo.

Os administradores podem configurar uma das seguintes opções no Centro de administração do Microsoft 365:

  • Todos os usuários (padrão): Todos podem compartilhar agentes com a organização.
  • Usuários ou grupos específicos: Limite as permissões de compartilhamento a usuários ou grupos selecionados.
  • Nenhum usuário: Desabilite completamente o compartilhamento em toda a organização.

Observação

As alterações nos controles de administrador se aplicam somente a novas ações de compartilhamento. Os agentes compartilhados existentes permanecem acessíveis, a menos que você atualize manualmente as configurações de compartilhamento.

Quando o compartilhamento em toda a organização está desativado, o botão de compartilhamento em toda a organização para acesso ao chat aparece esmaecido com uma dica de ferramenta que explica a restrição.

Implantar um agente por meio de um pacote ZIP

O Microsoft 365 Copilot oferece uma opção para baixar um pacote ZIP para implantação manual. Esse pacote ZIP contém os arquivos necessários para fazer o sideload do agente no Microsoft Teams.

Para implantar um agente manualmente:

  1. No Microsoft 365 Copilot, no painel esquerdo, selecione Novo agente.
  2. Na página Novo agente, em Meus agentes, escolha Exibir todos os agentes. Captura de tela da opção Ver todos os agentes na página Novo agente.
  3. Selecione o agente que você deseja baixar e escolha as reticências (...).
  4. Escolha Baixar .zip arquivo. O arquivo .zip inclui o manifesto do agente e o ícone do aplicativo. Captura de tela da opção *Baixar arquivo .zip*
  5. Faça o sideload do seu agente no Microsoft Teams.

Observação

  • O pacote ZIP não pode incluir arquivos incorporados. Remova qualquer conteúdo de arquivo inserido do pacote ZIP.
  • Não há suporte para agentes de sideload no Teams no macOS.

Compartilhar automaticamente arquivos e pastas do SharePoint

Ao compartilhar um agente, os usuários do Copilot podem não ter acesso a todas as fontes de conhecimento subjacentes. Você pode compartilhar fontes de conhecimento do SharePoint com outras pessoas ao adicioná-las como usuários ou proprietários do chat. No entanto, o agente respeita os privilégios de confidencialidade e informações do usuário final. Portanto, se o usuário não tiver acesso a uma fonte de conhecimento, o agente não incluirá o conteúdo que a fonte de conhecimento contém ao gerar uma resposta.

Você pode selecionar quais pastas e arquivos do SharePoint compartilhar. O compartilhamento só funciona quando o proprietário do agente já tem permissões para compartilhar ou atualizar as permissões de compartilhamento. Os rótulos de confidencialidade de arquivo aplicados a arquivos no SharePoint ou no OneDrive são respeitados. Se o compartilhamento de um arquivo ou pasta falhar, o agente ainda será compartilhado com os usuários. O proprietário precisa entrar em contato com os proprietários do arquivo ou com o administrador do site do SharePoint para conceder permissão para o arquivo ou pasta diretamente do SharePoint.

Observação

Somente os arquivos e pastas que você adiciona especificamente ao agente podem ser compartilhados automaticamente. O acesso total aos sites do SharePoint não está disponível automaticamente para as pessoas com quem você compartilha seu agente. Um administrador de site deve conceder permissão aos usuários por meio das configurações do site.

Quando o acesso do usuário ao agente é removido, isso não afeta o acesso aos arquivos ou pastas compartilhados. Gerencie permissões de usuário para acessar arquivos e pastas diretamente por meio do SharePoint.

Atualizar as informações sobre do seu agente

Use a caixa de diálogo Sobre este agente para atualizar os metadados visíveis no Repositório de Agentes e nas informações Sobre do seu agente no Microsoft 365 Copilot. Você pode abrir esta caixa de diálogo para qualquer agente de sua propriedade, seja ele compartilhado ou enviado para o catálogo da sua organização.

Para abrir a caixa de diálogo, selecione as reticências Mais (...) no cabeçalho de criação do agente e selecione Sobre este agente.

Os campos a seguir estão disponíveis.

Campo Obrigatório ou opcional Tamanho máximo Descrição
Descrição curta Obrigatório 80 caracteres Um resumo conciso do que o agente faz. Mostrado na Loja do agente e nas informações Sobre do agente. Padrão: criado usando o Construtor de Agentes do Microsoft 365 Copilot.
Site do criador Opcional 2,048 caracteres Um link para obter mais informações sobre você ou sua equipe, como sua página de perfil, o site do SharePoint da sua equipe ou uma página de suporte interno. Abre quando os usuários selecionam o nome do criador no painel de detalhes do agente. Deve ser uma URL HTTPS válida.
Política de privacidade Opcional 2,048 caracteres Um link para a política de privacidade da sua organização. Deve ser uma URL HTTPS válida.
Termos de uso Opcional 2,048 caracteres Um link para os termos de uso da sua organização. Deve ser uma URL HTTPS válida.

Um URL de espaço reservado padrão é fornecido para o site do criador, a política de privacidade e os termos de uso. Substitua cada espaço reservado por um URL apropriado para seu agente; caso contrário, o Agent Builder exibirá um aviso no campo.

Observação

Os valores salvos em Sobre este agente preenchem previamente os campos correspondentes na caixa de diálogo de envio ao enviar seu agente para o catálogo da sua organização. Para obter mais informações, consulte Política de privacidade e termos de uso.

Enviar um agente ao catálogo da sua organização

A versão compartilhada do seu agente e a versão do Agent Store são gerenciadas separadamente. Você gerencia a versão compartilhada e pode continuar iterando nela, alterando com quem ela é compartilhada ou mantendo-a privada para testes, a qualquer momento. Seu administrador gerencia a versão do Repositório de agentes depois que você envia o agente para revisão.

Para tornar seu agente amplamente detectável em sua organização, envie-o para o catálogo da organização. Um administrador analisa o envio no Centro de administração do Microsoft 365 e, se aprovado, publica o agente na seção Criado pela sua organização do Agent Store.

Para o fluxo de envio, campos obrigatórios, acompanhamento do status de aprovação e atualizações pós-aprovação, consulte Enviar agentes do Agent Builder para o catálogo da sua organização.

Gerenciar agentes

Você pode acessar os recursos de gerenciamento de agentes no Microsoft 365 Copilot:

Para gerenciar um agente que você acessou recentemente, selecione as reticências Mais (...) no painel esquerdo ao lado do nome do agente que você deseja gerenciar.

Para gerenciar um agente que você não acessou recentemente:

  • Selecione Todos os agentes no painel esquerdo.
  • No Repositório de agentes, em Seus agentes, escolha Ver mais e selecione as reticências (...), ao lado do nome do agente que você deseja gerenciar.

Ou:

  • Selecione Novo agente no painel esquerdo e escolha Exibir todos os agentes.
  • Selecione Mais reticências (...) ao lado do nome do agente que você deseja gerenciar.

Observação

No Agent Builder, a lista Meus agentes inclui apenas os agentes que você possui ou os agentes para os quais você tem acesso Pode editar . Os agentes compartilhados com você como usuário do chat não aparecem nesta lista.

Editar um agente

Qualquer proprietário de um agente pode editá-lo se alterações forem necessárias após o compartilhamento.

  • Acesse a lista de seus agentes usando um dos métodos descritos em Gerenciar agentes.
  • Escolha Editar (o ícone de lápis) no menu Mais reticências (...).

A partir daí, você pode usar linguagem natural para descrever suas alterações. Você também pode usar a guia Configurar para um controle mais ajustado sobre a funcionalidade e as fontes de conhecimento do seu agente.

As alterações feitas nos agentes são salvas automaticamente. No entanto, suas alterações não ficarão visíveis para os usuários até que você as disponibilize. Para disponibilizar as alterações em um agente existente, escolha Atualizar no canto superior direito. Suas alterações podem levar vários minutos para ficarem disponíveis para os usuários finais.

Observação

Se você atualizar um agente compartilhado anteriormente que tenha uma fonte de conhecimento de arquivo e pasta do SharePoint, compartilhe-o novamente com os mesmos usuários. Isso compartilha automaticamente os arquivos e pastas com os usuários novamente para garantir uma experiência consistente do agente.

Excluir seu agente

Qualquer proprietário de um agente pode excluí-lo. Depois de excluir um agente, você não poderá usá-lo e ele não estará disponível para outros proprietários ou para os usuários com quem você o compartilhou.

Importante

A exclusão de um agente é permanente e não pode ser revertida.

Para excluir um agente:

  • Acesse a lista de seus agentes usando um dos métodos descritos em Gerenciar agentes.
  • Selecione o menu Mais reticências (...) e escolha Excluir (o ícone da lixeira).

Reatribuir a propriedade de um agente

Você pode compartilhar a propriedade de um agente diretamente adicionando usuários com a função Pode editar na caixa de diálogo de compartilhamento. Todos os proprietários têm direitos iguais para editar, compartilhar e gerenciar o agente. Para obter mais informações, consulte Adicionar proprietários e usuários de chat.

Os administradores também podem atualizar o proprietário de um agente compartilhado dentro da organização. Para obter mais informações, consulte Reatribuir a propriedade de agentes compartilhados.

Para reatribuir a propriedade por meio do PowerShell, consulte Reatribuir o proprietário de um agente com o PowerShell.

Solução de problemas

Ao compartilhar um agente e suas fontes de conhecimento, você pode encontrar os erros listados na tabela a seguir.

Problema Descrição
Ocorreu um problema Ocorreu um erro de serviço interno. Entre em contato com o suporte se esse erro persistir.
Não foi possível compartilhar O usuário não tem privilégios suficientes para atualizar as permissões de compartilhamento em determinados arquivos. O erro lista os arquivos que não puderam ser compartilhados. O proprietário do agente deve entrar no SharePoint para tentar atualizar essas permissões manualmente. Para saber mais, confira:
Falha no compartilhamento do agente, acesso ao conhecimento não concedido Se o compartilhamento do agente falhar, as fontes de conhecimento subjacentes poderão não ser compartilhadas com os usuários ou grupos pretendidos. Como resultado, os usuários sem acesso a esses arquivos não recebem respostas geradas com base neles. Para resolver esse problema, certifique-se de que todos os indivíduos e grupos com os quais você está compartilhando seu agente existam em sua organização e, em seguida, compartilhe novamente as fontes de conhecimento selecionando-as nas configurações de compartilhamento para conceder acesso de usuário a elas.
Não é mais possível atualizar o agente Esse erro ocorre quando as configurações de compartilhamento atuais do agente não estão mais em conformidade com as novas políticas de administrador. Os proprietários do agente devem alterar as configurações de compartilhamento para uma opção compatível antes de atualizar o agente. Uma faixa orienta você a fazer essa alteração.
Não é possível criar este agente devido a um erro. Ocorre quando o sistema está com problemas para publicar um agente. Tente novamente em alguns minutos.
Esse agente inclui pelo menos um arquivo com um rótulo de confidencialidade incompatível. Verifique seus arquivos carregados e remova-os. Ocorre quando você carrega um arquivo com um rótulo de confidencialidade sem suporte. Verifique o ícone de escudo ao lado dos arquivos carregados e remova aqueles que têm um ícone de erro vermelho. Para obter mais informações, consulte Cenários de rótulo de confidencialidade sem suporte.
Seu agente não pode ser atualizado porque pode encorajar ações prejudiciais. Ocorre quando o sistema detecta conteúdo prejudicial. Revise o nome, a descrição e as instruções do seu agente, remova qualquer conteúdo prejudicial e tente atualizá-lo novamente. Para obter mais informações. confira Validação de IA responsável.

Conteúdo relacionado

  • Last updated on