Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Você pode compartilhar os agentes criados no Agent Builder 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ê constrói no Agent Builder. 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.
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. Essas alterações não revogam automaticamente as permissões de acesso existentes do agente. Desabilitar o compartilhamento em toda a organização não impede o compartilhamento direto com indivíduos específicos. A publicação no catálogo da sua organização requer aprovação do administrador. Se as políticas de governança mudarem, atualize as opções de compartilhamento do seu agente para conformidade antes de atualizar o agente.
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
- Abra o agente que você deseja compartilhar e selecione Compartilhar.
- Na caixa de diálogo compartilhar, insira um nome, grupo ou email na caixa Adicionar um nome, grupo ou email .
- 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.
- 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.
- Selecione Adicionar.
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.
- Abrir a caixa de diálogo Compartilhar .
- Selecione a lista suspensa de funções ao lado do usuário.
- 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.
Copiar, editar e conversar links
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.
- Abrir a caixa de diálogo Compartilhar .
- Ative a alternância de compartilhamento em toda a organização para acesso ao chat .
Para publicação revisada pelo administrador no Repositório de agentes, envie seu agente para o catálogo da organização. O compartilhamento e o envio de catálogo são caminhos separados.
Controles de governança e administração
Criar agentes no Agent Builder é um recurso essencial do Copilot quando os agentes estão habilitados. Os administradores não podem desabilitar a criação de agentes no Agent Builder separadamente enquanto mantêm os agentes ativados.
Um agente integrado ao Agent Builder personaliza o Copilot com instruções e fontes de conhecimento selecionadas para uma tarefa específica. Ele não apresenta novos recursos de plataforma além do Copilot. A criação de um agente não concede permissões de dados adicionais. No entanto, os proprietários ainda precisam revisar o que compartilham, incluindo qualquer conhecimento carregado.
Os administradores podem controlar o acesso aos agentes, o compartilhamento em toda a organização e a aprovação para publicação do catálogo:
- Acesso do agente: No Centro de administração do Microsoft 365, acesseConfigurações> de Agentes>Acesso do usuário. Escolha Todos os usuários, Nenhum usuário ou Usuários ou grupos específicos para controlar quem pode acessar e instalar agentes e plug-ins. Essa configuração controla o acesso ao agente e ao plug-in, não a criação do Agent Builder de forma independente. Para obter detalhes, consulte Acesso do usuário.
- Compartilhamento em toda a organização: No Compartilhamentode configurações>deagentes>, controle quem pode compartilhar agentes integrados no Agent Builder com a organização.
- Publicação de catálogo: Os novos agentes são privados para seus criadores até serem compartilhados ou publicados. A publicação de um agente no catálogo da sua organização requer revisão e aprovação do administrador. Para obter detalhes, consulte Enviar um agente para o catálogo da sua organização.
Para compartilhamento em toda a organização, os administradores podem configurar uma das seguintes opções:
- 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 em toda a organização aos usuários ou grupos selecionados.
- Nenhum usuário: Desabilite o compartilhamento em toda a organização. Os usuários ainda podem compartilhar diretamente com indivíduos específicos.
Observação
As alterações na configuração de compartilhamento se aplicam somente a novas ações de compartilhamento. Os agentes compartilhados existentes permanecem acessíveis, a menos que você atualize manualmente suas 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. Para obter detalhes, consulte Configurações de compartilhamento. Essa configuração se aplica somente aos agentes criados no Agent Builder.
O acesso a um agente e o acesso às suas fontes de conhecimento são distintos:
- Fontes do SharePoint e do OneDrive: Permissões de arquivo e rótulos de confidencialidade existentes se aplicam. Compartilhar o agente por si só não concede acesso a todo o seu conteúdo de origem. Os proprietários podem compartilhar separadamente arquivos e pastas selecionados do SharePoint se tiverem permissão para fazê-lo. Para obter detalhes, consulte Compartilhar arquivos e pastas do SharePoint automaticamente.
- Arquivos carregados: Os arquivos carregados de um dispositivo tornam-se conhecimento incorporado. Qualquer pessoa que possa acessar o agente pode receber respostas fundamentadas nesse conteúdo, sujeitas às permissões de rótulo de confidencialidade do conteúdo incorporado. Revise o conteúdo carregado antes de compartilhar o agente. Para obter detalhes, consulte Conteúdo de arquivo inserido.
Baixe um pacote ZIP para fazer o sideload do seu agente
O Microsoft 365 Copilot fornece uma opção para baixar um pacote ZIP para sideload manual. Esse pacote ZIP contém os arquivos necessários para fazer o sideload do agente no Microsoft Teams.
Para baixar o pacote ZIP e fazer o sideload do agente manualmente:
- No Microsoft 365 Copilot, no painel esquerdo, selecione Novo agente.
- Na página Novo agente, em Meus agentes, escolha Exibir todos os agentes.
- Selecione o agente que você deseja baixar e escolha as reticências (...).
- Escolha Baixar .zip arquivo. O arquivo .zip inclui o manifesto do agente e o ícone do aplicativo.
- 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 arquivos e pastas do SharePoint automaticamente
Quando você compartilha 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 em 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 de um usuário ao agente é removido, isso não afeta o acesso dele ao arquivo 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 publicado no 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 | Comprimento máximo | Descrição |
|---|---|---|---|
| Descrição breve | 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: Compilado 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 Enviar para o catálogo da organização ao enviar o agente para o catálogo da organização. Para obter mais informações, consulte Política de privacidade e termos de uso para agentes no Agent Builder.
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ê publica o agente.
Para tornar seu agente amplamente detectável em sua organização, publique-o no catálogo da organização. Um administrador revisa o agente no centro de administração do Microsoft 365 e, se aprovado, implanta o agente na seção Criado pela sua organização do Agent Store.
Para as etapas de envio, campos obrigatórios, rastreamento de 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 Construtor de Agentes, a lista Meus agentes inclui apenas os agentes que você possui ou os agentes para os quais você tem acesso de edição . Os agentes partilhados consigo enquanto utilizador de chat não aparecem nesta lista.
Editar um agente
Qualquer proprietário de um agente pode editá-lo se forem necessárias alterações após a partilha.
- Acesse a lista de seus agentes usando um dos métodos descritos em Gerenciar agentes.
- Escolha Editar (o ícone do lápis) no menu Mais reticências (...).
A partir daí, pode utilizar uma linguagem natural para descrever as alterações. Você também pode usar a guia Configurar para um controle mais refinado sobre a funcionalidade e as fontes de conhecimento do seu agente.
As alterações feitas nos agentes são salvas automaticamente. No entanto, as alterações só serão visíveis para os utilizadores depois de as disponibilizar. Para disponibilizar alterações em um agente existente, escolha Atualizar no canto superior direito. As suas alterações poderão demorar vários minutos até ficarem disponíveis para os utilizadores finais.
Observação
Se atualizar um agente anteriormente partilhado que tenha uma origem de conhecimento de ficheiros e pastas do SharePoint, volte a partilhá-la com os mesmos utilizadores. Ao fazê-lo, volta a partilhar automaticamente os ficheiros e pastas com os utilizadores para garantir uma experiência de agente consistente.
Eliminar o agente
Qualquer proprietário de um agente pode eliminá-lo. Depois de eliminar um agente, não o pode utilizar e este não está disponível para outros proprietários ou para os utilizadores com quem o partilhou.
Importante
A exclusão de um agente é permanente e não pode ser revertida.
Para eliminar um agente:
- Acesse a lista de seus agentes usando um dos métodos descritos em Gerenciar agentes.
- Selecione o menu Mais reticências (...) e, em seguida, selecione Eliminar (o ícone de caixote do lixo).
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, partilhar e gerir o agente. Para obter mais informações, consulte Adicionar proprietários e usuários de bate-papo.
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.
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 erro | Ocorreu um erro interno do serviço. Se este erro persistir, contacte o suporte. |
| 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 mais informações, confira:
|
| A partilha do agente falhou, o acesso ao conhecimento não foi concedido | Se a partilha do agente 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 recebem respostas geradas com base nos mesmos. Para resolve este problema, certifique-se de que todos os indivíduos e grupos com os quais está a partilhar o seu agente existem na sua organização e, em seguida, volte a partilhar as fontes de conhecimento ao selecioná-las nas definições de partilha para conceder acesso aos mesmos aos utilizadores. |
| Não é mais possível atualizar o agente | Este erro ocorre quando as definições de partilha atuais do seu agente já não estão em conformidade com as novas políticas administrativas. Os proprietários do agente devem alterar as configurações de compartilhamento para uma opção compatível antes de atualizar ainda mais o agente. Uma faixa orienta você a fazer essa alteração. |
| Não conseguimos criar este agente devido a um erro. | Ocorre quando o sistema tem problemas ao criar o agente. Tente novamente dentro de alguns minutos. |
| Este agente inclui pelo menos um ficheiro com uma etiqueta de confidencialidade não suportada. Verifique 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, consulte Cenários de etiqueta de confidencialidade não suportada. |
| O seu agente não pode ser atualizado porque pode incentivar ações prejudiciais. | Ocorre quando o sistema deteta conteúdos prejudiciais. Reveja o nome, a descrição e as instruções do agente, remova qualquer conteúdo prejudicial e tente atualizar novamente o agente. Para mais informações. consulte Validação de IA responsável. |
Conteúdo relacionado
- Envie agentes do Agent Builder para o catálogo da sua organização
- Declaração de privacidade e termos de utilização para agentes no Agent Builder
- Partilhar um plug-in ou agente para testes
- Gerencie solicitações de agente no Centro de administração do Microsoft 365
- Publique e implante seu agente
- Carregar para o Microsoft Teams