Partilhar via

Partilhar e gerir agentes

Pode partilhar os agentes que criar com Microsoft 365 Copilot com os utilizadores na sua organização. A partilha de um agente fornece acesso direto limitado ao mesmo para um conjunto especificado de utilizadores. Embora seja ideal para a colaboração em equipa, partilhar um agente não permite a implementação na organização nem a integração com outros canais.

Este artigo descreve como partilhar e gerir os agentes que cria com a funcionalidade Agent Builder no Microsoft 365 Copilot. Para publicar um agente em vários canais, tem de utilizar Copilot Studio. Para obter mais informações, veja Publicar e implementar o agente.

Diferenças entre partilhar e publicar agentes

A partilha de um agente destina-se a um acesso direto e limitado ao mesmo. Esta abordagem é ideal para colaborar ou obter feedback à medida que cria o agente, mas não pode ser utilizada para implementação ou integração formal.

A tabela seguinte realça as principais diferenças entre publicar e partilhar os agentes declarativos.

Compartilhamento Publicação
Objetivo Colaboração, feedback, testes ou acesso limitado para indivíduos ou grupos específicos. Implementação formal para utilização abrangente, integração, dimensionada em canais especificados (por exemplo, Teams, Copilot) ou em toda a organização.
Mecanismo Os proprietários/coproprietários utilizam a opção Gerir Partilha para especificar até 98 utilizadores por nome ou e-mail. Os utilizadores especificados recebem acesso direto, mas o agente permanece privado e não é amplamente detetável. Proprietário/coproprietários selecione Publicar no Copilot Studio, selecione o canal de destino (Teams, Copilot e muito mais) e conclua todos os fluxos de aprovação necessários. O agente torna-se detetável e acessível para o público pretendido.
Espectadores Até 98 utilizadores nomeados (indivíduos ou grupos). Em toda a organização ou em canal específico.
Capacidade de deteção Privado; apenas visível para destinatários especificados. Público (dentro do âmbito escolhido); aparece no Arquivo de Agentes e canais especificados.
Governança Governação mínima; sem fluxos de aprovação. Pode exigir fluxos de aprovação, controlo de versões e gestão do ciclo de vida.
Permissões Os utilizadores especificados podem interagir com o agente, mas não podem gerir ou publicar. Os proprietários/coproprietários gerem a publicação, as atualizações e o ciclo de vida.
Integração Não integrado; A partilha só está disponível através de acesso direto. Pode ser integrado no Teams, Copilot ou noutras superfícies do Microsoft 365.

Partilhar um agente

Para partilhar o seu agente, depois de o criar e testar no Microsoft 365 Copilot, selecione Criar. Depois de criar o agente, será apresentada uma mensagem de confirmação a indicar que o agente é privado e só está disponível para si. Para partilhar o agente com outras pessoas, selecione o botão Partilhar e escolha quem deve ter acesso.

Origens de conhecimento de partilha automática

Observação

O seu administrador pode aplicar uma política que restringe determinadas opções de partilha de agentes. Esta alteração de governação aplica-se no momento da implementação e não revoga as permissões de acesso do agente existente. Se as políticas de governação forem alteradas, certifique-se de que atualiza as opções de partilha para que o agente esteja em conformidade antes de efetuar atualizações ao agente.

A tabela seguinte descreve as opções de partilha disponíveis.

Opção de compartilhamento Descrição
Qualquer pessoa na sua organização Qualquer pessoa no seu locatário pode usar o link de compartilhamento para usar o agente.
Utilizadores específicos na sua organização Utilizadores ou grupos específicos podem utilizar a ligação de partilha para aceder e interagir com o agente. Tem de especificar os nomes ou e-mails de indivíduos, grupos de segurança ou grupos do Microsoft 365com capacidade de segurança no diretório microsoft do seu inquilino.
Só tu Somente o autor do agente pode usá-lo. Ninguém mais pode usar o link de compartilhamento. Essa opção de compartilhamento está selecionada por padrão.

Quando os utilizadores abrem a ligação para um agente que partilhou com eles, o agente é aberto numa janela do browser e está pronto para ser utilizado.

Observação

As capacidades do agente diferem com base na licença de um utilizador. Os utilizadores só podem adicionar agentes que tenham sido partilhados com eles quando tiverem o tipo de licença de Microsoft 365 Copilot necessária para aceder às capacidades configuradas nesse agente. Se um utilizador não tiver a licença adequada para as capacidades de um agente, as tentativas de utilização do agente poderão resultar num erro. Para obter detalhes, veja Capacidades do agente para utilizadores do Microsoft 365.

Governação e controlos de administrador

Os administradores de inquilinos podem gerir quem pode partilhar agentes ao nível da organização. Estes controlos ajudam a manter a conformidade e a impedir a partilha excessiva.

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

  • Todos os utilizadores (predefinição): Todos podem partilhar agentes com a organização.
  • Utilizadores ou grupos específicos: Limitar as permissões de partilha a utilizadores ou grupos selecionados.
  • Sem utilizadores: Desative completamente a partilha em toda a organização.

Observação

As alterações aos controlos de administrador aplicam-se apenas a novas ações de partilha. Os agentes partilhados existentes permanecem acessíveis, a menos que atualize manualmente a opção de partilha.

Quando a partilha ao nível da organização está desativada, a opção Qualquer pessoa na sua organização aparece desativada com uma descrição que explica a restrição.

Implementar um agente através do pacote ZIP

Microsoft 365 Copilot fornece uma opção para transferir um pacote ZIP para implementação manual. Este pacote ZIP contém os ficheiros de que precisa para colocar o seu agente em sideload no Microsoft Teams.

Para implementar um agente manualmente:

  1. No Microsoft 365 Copilot, abra o painel de navegação esquerdo e selecione Novo agente.
  2. Na parte superior do painel central, selecione Copilot Studio e, em seguida, selecione Ver os meus agentes. Captura de ecrã da opção *Os meus agentes*
  3. Realce o agente que pretende transferir e selecione as reticências. Captura de ecrã a mostrar as reticências *Mais opções* do agente realçado.
  4. Selecione Transferir .zip ficheiro. O ficheiro .zip inclui o manifesto do agente e o ícone da aplicação. Captura de ecrã a mostrar a opção *Transferir .zip ficheiro*
  5. Coloque o seu agente em sideload no Microsoft Teams.

Observação

  • O pacote ZIP não pode incluir ficheiros incorporados. Remova qualquer conteúdo de ficheiro incorporado do pacote ZIP.
  • Os agentes de sideload no Teams não são suportados 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. Pode partilhar origens de conhecimento do SharePoint com outras pessoas quando a opção Partilhar estiver definida para Utilizadores específicos na sua organização. No entanto, o agente respeita as informações e os privilégios de confidencialidade do utilizador final. Por isso, se o utilizador não tiver acesso a uma origem de conhecimento, o agente não inclui o conteúdo que a origem de conhecimento contém ao gerar uma resposta.

Pode selecionar as pastas e ficheiros do SharePoint a partilhar. A partilha só funciona quando o autor do agente já tem permissões para partilhar ou atualizar as permissões de partilha. As etiquetas de confidencialidade de ficheiros aplicadas a ficheiros no SharePoint ou no OneDrive são respeitadas. Se o compartilhamento de um arquivo ou pasta falhar, o agente ainda será compartilhado com os usuários. O autor precisa entrar em contato com os proprietários dos arquivos ou com o administrador do site do SharePoint para conceder permissão ao arquivo ou pasta diretamente no SharePoint.

Observação

Apenas os ficheiros e pastas que adicionar especificamente ao agente podem ser partilhados automaticamente. O acesso total aos sites do SharePoint não está automaticamente disponível para as pessoas com quem partilha o seu agente. Um administrador do site tem de conceder permissão aos utilizadores através das definições do site.

Quando o acesso do usuário ao agente é removido, isso não afeta o acesso aos arquivos ou pastas compartilhados. Gerir permissões de utilizador para aceder a ficheiros e pastas diretamente através do SharePoint.

Gerir agentes

Pode aceder às funcionalidades de gestão de agentes no Microsoft 365 Copilot:

  1. Expanda o painel de navegação esquerdo e selecione Todos os agentes.
  2. Paire o cursor sobre o agente que pretende gerir e clique com o botão direito do rato nas reticências de Mais opções (...). Se não vir o agente que pretende atualizar, selecione Ver mais para expandir a lista.
  3. Selecione a opção adequada no menu de contexto. Captura de ecrã do menu de contexto de gestão de agentes

Observação

Apenas os agentes que criou são apresentados na lista Os meus agentes . Os agentes partilhados de outros utilizadores não estão listados.

Editar um agente

Pode editar os seus agentes se descobrir que as alterações são necessárias depois de a partilhar.

Para editar um agente:

  • Aceda à lista dos seus agentes, conforme descrito em Gerir agentes.
  • Selecione Editar no menu Mais opções.

A partir daí, pode utilizar o separador Descrever para introduzir as alterações que pretende efetuar com linguagem natural ou utilizar o separador Configurar para um controlo mais ajustado na edição das funcionalidades e origens de conhecimento do agente.

As alterações efetuadas aos agentes são guardadas automaticamente. No entanto, as suas alterações só serão visíveis para os utilizadores quando as disponibilizar. Para efetuar alterações a um agente existente disponíveis, selecione Atualizar no canto superior direito. As alterações podem demorar vários minutos a ficar disponíveis para os utilizadores finais.

Observação

Se atualizar um agente partilhado anteriormente com uma origem de conhecimento de ficheiros e pastas do SharePoint, volte a partilhá-lo com os mesmos utilizadores. Ao fazê-lo, partilha automaticamente os ficheiros e pastas com os utilizadores novamente para garantir uma experiência de agente consistente.

Eliminar o agente

Os agentes podem ser eliminados, mesmo depois de terem sido partilhados. No entanto, apenas o utilizador que criou um agente pode eliminá-lo.

Importante

A exclusão de um agente é permanente e não pode ser revertida. Depois de eliminar um agente, não poderá utilizá-lo e este não estará disponível para os utilizadores com os quais o partilhou.

Para eliminar um agente:

  • Aceda à lista dos seus agentes, conforme descrito em Gerir agentes.
  • Selecione o menu Mais opções no canto superior direito e, em seguida, selecione Eliminar no menu de contexto. Captura de ecrã a mostrar a opção Eliminar agente.

Reatribuir a propriedade de um agente

Microsoft 365 Copilot não suporta a transferência da propriedade de agentes declarativos para outro utilizador. Para obter informações sobre como transferir a propriedade, veja Reatribuir o proprietário de um agente ao PowerShell.

Solução de problemas

Ao partilhar um agente e as respetivas origens de conhecimento, poderá encontrar os erros listados na tabela seguinte.

Problema Descrição
Ocorreu um problema Ocorreu um erro de serviço interno. Contacte o suporte se este erro continuar a ocorrer.
Não foi possível partilhar O utilizador não tem privilégios suficientes para atualizar as permissões de partilha em determinados ficheiros. O erro lista os ficheiros que não puderam ser partilhados. O proprietário do agente deve aceder ao SharePoint para tentar atualizar estas permissões manualmente. Para saber mais, confira:
Falha na partilha do agente, acesso ao conhecimento não concedido Se a partilha de agentes falhar, as origens de conhecimento subjacentes poderão não ser partilhadas com os utilizadores ou grupos pretendidos. Como resultado, os utilizadores sem acesso a esses ficheiros não receberão respostas geradas com base nos mesmos. Para resolve isto, certifique-se de que todos os indivíduos e grupos com os quais está a partilhar o agente existem na sua organização e, em seguida, volte a partilhar as origens de conhecimento ao selecioná-las nas definições de partilha para conceder acesso de utilizador às mesmas.
Já não é possível atualizar o agente Isto ocorre quando a opção de partilha atual do agente já não está em conformidade com as novas políticas de administração. Os proprietários do agente têm de alterar a definição de partilha para uma opção compatível antes de atualizarem ainda mais o agente. Uma faixa orienta-o para efetuar esta alteração.
Não conseguimos criar este agente devido a um erro. Ocorre quando o sistema está a ter problemas ao publicar um agente. Tente novamente em alguns minutos.
Este agente inclui, pelo menos, um ficheiro com uma etiqueta de confidencialidade não suportada. Marcar os ficheiros carregados e remova-os. Ocorre quando carrega um ficheiro com uma etiqueta de confidencialidade que não é suportada. Verifique o ícone de escudo junto aos ficheiros carregados e remova os que têm um ícone de erro vermelho. Para obter mais informações, veja Cenários de etiquetas de confidencialidade não suportados.
O agente não pode ser atualizado porque pode incentivar ações prejudiciais. Ocorre quando o sistema deteta conteúdo prejudicial. Reveja o nome, descrição e instruções do agente, remova qualquer conteúdo prejudicial e tente atualizar o agente novamente. Para obter mais informações. veja Validação de IA responsável.

Conteúdo relacionado

  • Last updated on