Agentes no SharePoint: quem pode criá-los e a que eles podem acessar
By Mirko Peters · · Updated
O acesso dos agentes do SharePoint segue as permissões de arquivo: quem pode criar arquivos pode criar um agente, e as respostas dependem do acesso de cada usuário. Veja os controles.
Automatically translated with AI from the original post. Read the English original
Os agentes do SharePoint seguem as permissões de arquivo: qualquer pessoa que possa criar arquivos em um site pode criar um agente nele, e o que um agente responde depende do que cada usuário já consegue abrir. Esse é o cerne do acesso dos agentes do SharePoint, e é mais simples do que parece à primeira vista. Este artigo é para administradores do SharePoint que precisam definir quem pode criar agentes, quem pode usá-los e a que eles podem acessar. Você vai conhecer as regras, os controles que a Microsoft indica, os pontos de atenção e um exemplo prático com números fictícios.
Pontos-chave
- Os agentes do SharePoint são arquivos .agent, e somente usuários que podem criar ou acessar arquivos em um site podem criar ou acessar agentes nele.
- As respostas dependem do acesso de cada usuário às fontes de dados, então um usuário sem acesso a um site referenciado recebe respostas sem esse conteúdo.
- Usuários com licença do Copilot podem usar agentes do SharePoint, e a cobrança pay-as-you-go pode cobrir usuários sem licença por meio de um grupo de segurança.
- O controle de acesso restrito, a descoberta de conteúdo restrita e o DLP do Purview com rótulos de confidencialidade limitam o que os agentes podem usar, cada um de uma forma diferente.
- Administradores podem revisar e bloquear agentes no Centro de administração do Microsoft 365, mas a Microsoft observa que o bloqueio atualmente afeta somente o Copilot Chat.
O que é um agente do SharePoint e o que ele pode fazer?
Um agente do SharePoint é um assistente de IA que funciona dentro de um site do SharePoint. A página da Microsoft sobre gerenciamento do acesso a agentes no SharePoint afirma que os agentes no SharePoint ajudam os usuários a encontrar rapidamente informações e insights em sites, páginas e bibliotecas de documentos do SharePoint. Eles não precisam de ativação. Um agente do SharePoint acessa os dados da sua organização da mesma forma que o Copilot nos outros aplicativos do Microsoft 365, e responde com base nas permissões de acesso de cada usuário.
Dois pontos práticos decorrem disso. Um novo agente não aparece automaticamente em nenhuma lista ou local publicado, então os autores precisam compartilhá-lo de forma intencional. E o proprietário do site pode escolher um agente principal para o site, que é aberto quando os usuários selecionam o ícone do Agente no cabeçalho global. Trate esse agente principal como uma porta de entrada: defina quais conteúdos do site ele usa e revise-o com base nas permissões do site.
Quem pode criar agentes do SharePoint?
A página da Microsoft sobre gerenciamento do acesso a agentes no SharePoint afirma que os agentes são arquivos .agent. Somente usuários que podem criar ou acessar arquivos em um site do SharePoint podem criar ou acessar agentes nele.
Portanto, o direito de criação não é uma configuração separada. Ele segue as permissões de arquivo do site. Uma pessoa que é membro de um site com permissões de Edição pode criar um arquivo de agente em uma biblioteca, e uma pessoa com permissões de Leitura não pode. Por isso, os agentes do SharePoint devem fazer parte da sua revisão de permissões: cada membro com nível de Edição é um possível autor de agentes.
A página também diz que as permissões no arquivo .agent determinam quem pode acessar ou editar o agente. Essa é uma segunda camada. Você pode ter acesso ao site e, ainda assim, não ser autorizado a abrir um arquivo de agente específico.
Quem pode usar e quem paga?
Usar um agente exige uma licença ou uma configuração de faturamento. De acordo com a mesma página, usuários com licença do Microsoft Copilot podem usar agentes. Para cada usuário, os administradores podem ativar ou desativar o Microsoft Copilot para SharePoint na página de detalhes da licença.
Para usuários sem licença do Copilot, os administradores podem usar o faturamento por consumo (pay-as-you-go) atribuído a um grupo de segurança. Planeje esse grupo como qualquer outro grupo de acesso: defina um proprietário e revise os membros.
O guia de administração de agentes da Microsoft acrescenta que os agentes do SharePoint exigem o pay-as-you-go habilitado para o SharePoint ou uma licença do Microsoft 365 Copilot. Ele também lista as funções administrativas para gerenciar agentes: AI Admin, Global Admin ou Global Reader para acesso somente leitura, com a recomendação de usar a função com menor privilégio.
O que inclui o acesso dos agentes do SharePoint?
Os agentes usam sites, páginas e bibliotecas de documentos do SharePoint como fontes de conhecimento. A página não trata de restringir o escopo a pastas ou arquivos individuais, então não prometa isso aos seus usuários.
A regra principal para o alcance é esta: as respostas do agente dependem das permissões de cada usuário nas fontes de dados. Um usuário que tem acesso ao agente, mas não a um site ou biblioteca referenciada, recebe respostas que excluem esse conteúdo. Portanto, um agente não amplia o acesso. Ele se restringe ao que o usuário que faz a pergunta já consegue abrir.
Isso é uma boa notícia para a governança, mas tem um limite. Se uma biblioteca estiver aberta para toda a empresa, o agente construído sobre ela também estará aberto para toda a empresa, no que se refere às respostas. O agente não vai esconder o problema. Ele vai tornar o conteúdo mais fácil de consultar, da mesma forma que o Copilot faz.
O guia de administração da Microsoft acrescenta um ponto sobre compartilhamento. Agentes declarativos do SharePoint podem ser compartilhados do SharePoint para o Teams, com base nas permissões existentes. Eles não podem ser publicados no catálogo da organização.
Quais controles limitam o que os agentes podem usar?
A página da Microsoft cita quatro controles no nível do site:
- Controles de acesso ao site. Os agentes só podem acessar o que as pessoas que fazem a pergunta já conseguem abrir, por isso as permissões do site e a associação a grupos vêm em primeiro lugar. Verifique primeiro suas permissões do SharePoint, porque os outros controles se apoiam nelas.
- Controle de acesso restrito. Ele limita todo o acesso a um site ou OneDrive ao grupo indicado na política. Somente esse grupo vê o conteúdo no Microsoft Copilot.
- Descoberta de conteúdo restrita. Ele oculta o ícone do agente em um site, para que os usuários não possam usar o agente pronto do site, criar agentes ou adicionar o conteúdo do site a outros agentes. O acesso ao site não muda, mas o conteúdo do site não aparece no Microsoft Copilot nem na pesquisa de toda a organização.
- Microsoft Purview DLP. Você pode criar uma política personalizada com uma condição baseada em rótulos de confidencialidade. Itens com rótulo são excluídos do processamento.
A página aponta uma lacuna: ainda não é possível aplicar um rótulo de confidencialidade diretamente a um arquivo .agent, então a abordagem por rótulos protege o conteúdo que os agentes leem, e não os próprios arquivos de agente.
Use esses controles em combinação. O controle de acesso restrito fecha um site. A descoberta de conteúdo restrita o oculta dos agentes. O DLP mantém arquivos rotulados fora das respostas. Cada um resolve um problema diferente, e nenhum substitui um modelo de permissões bem definido. Registrar por escrito essas escolhas faz parte da governança do Copilot.
Como os administradores veem e bloqueiam agentes?
Administradores de locatário e administradores de IA podem visualizar, bloquear e desbloquear agentes no Centro de administração do Microsoft 365, em Agentes no Copilot Control System. A página diz que o bloqueio atualmente afeta somente o Copilot Chat. Ele ainda não se aplica ao OneDrive, ao SharePoint ou ao Teams. Por isso, o bloqueio não é uma forma de interromper agentes do SharePoint hoje.
O guia do administrador descreve um inventário de agentes com um filtro Missing an owner para agentes sem proprietário. Ele também recomenda etapas de governança: revisar os recursos, as fontes de conhecimento e as ações de cada agente antes de atribuí-lo ou implantá-lo, evitar o compartilhamento excessivo atribuindo agentes apenas a usuários que precisam deles, seguir uma implantação em etapas e remover ou reatribuir agentes que não têm proprietário.
Observe que o inventário descreve agentes gerenciados pelo centro de administração, enquanto os agentes do SharePoint são arquivos .agent armazenados em bibliotecas de sites. Um proprietário do site também pode designar um agente principal para o site. Por isso, talvez você precise de uma verificação no nível do site, além do inventário, e é exatamente aí que está o cerne do agent sprawl no SharePoint.
Com base nas recomendações da Microsoft, é possível montar uma rotina curta de revisão. Antes de atribuir um agente, revise seus recursos, fontes de conhecimento e ações. Conceda acesso apenas aos usuários que precisam dele, o que reduz o compartilhamento excessivo. Implante os agentes em etapas, começando com um grupo piloto. Quando um agente não tiver proprietário, reatribua-o ou remova-o. Bloqueie os agentes de que sua organização não precisa. Escreva essas cinco regras em uma página e entregue a todos os proprietários de sites, porque as pessoas que criam os arquivos de agente são membros dos sites, não administradores.
Trate a página como um documento vivo. A Microsoft indica que alguns recursos de agentes ainda estão em desenvolvimento, e o limite de bloqueio mencionado acima é um exemplo disso. Por isso, revise as duas páginas do Learn a cada trimestre e atualize suas regras quando o comportamento mudar.
Exemplo: 150 sites, três tipos de risco
Os números são fictícios e servem para mostrar o método. Uma empresa tem 150 sites e 400 usuários com licença do Copilot. O administrador do SharePoint executa uma verificação de prontidão para agentes.
- Autores. Cerca de 900 usuários têm permissão de Edição em pelo menos um site, ou seja, cerca de 900 poderiam criar arquivos de agente, embora apenas 400 tenham licença. O administrador considera isso aceitável, porque somente usuários licenciados podem usar agentes, mas registra o ponto para revisão.
- Sites sensíveis. 12 sites armazenam conteúdo confidencial. Em 5 deles, o administrador usa controle de acesso restrito com um grupo nomeado. Em 4, usa a descoberta de conteúdo restrita enquanto os proprietários corrigem as permissões. Em 3, adiciona uma política de DLP para o rótulo de confidencialidade.
- Agentes sem proprietário. O administrador encontra 30 arquivos de agente com proprietários não claros em 10 sites antigos de projetos. Os proprietários são solicitados a confirmar ou excluir esses arquivos.
Veja o efeito. Dos 12 sites sensíveis, todos estão cobertos por algum controle, e a equipe tem uma lista de 30 arquivos de agente cujos proprietários precisam ser confirmados. O administrador também acrescenta uma frase ao guia do proprietário do site: os agentes veem o que o usuário que faz a solicitação pode ver, por isso as permissões precisam estar limpas antes de tudo.
Erros comuns
- Presumir que os agentes têm permissões próprias. Eles seguem o acesso do usuário que faz a solicitação aos dados.
- Esquecer as permissões do próprio arquivo de agente. Elas determinam quem pode abrir ou editar o agente.
- Depender do bloqueio. A Microsoft informa que o bloqueio atualmente afeta somente o Copilot Chat.
- Ignorar sites sensíveis. Use controle de acesso restrito, descoberta de conteúdo restrita ou DLP para eles.
- Ignorar agentes sem proprietário. Arquivos sem proprietário nunca são revisados.
- Falta de orientação para os proprietários de sites. Os proprietários precisam saber o que um arquivo de agente significa em seu site.
Como o software pode ajudar
Comece pelo centro de administração do SharePoint, pelo inventário de agentes do centro de administração do Microsoft 365 e pelo log de auditoria do Purview. Em muitos sites, um script ou uma ferramenta de relatórios pode listar os arquivos .agent por site, proprietário e última alteração, e compará-los com as permissões do site. Antes de tudo, compare a saída de qualquer ferramenta com o centro de administração em alguns sites e verifique quais dados a ferramenta lê e onde ela os armazena.
Próximo passo
Liste os sites que armazenam seu conteúdo mais sensível e verifique qual controle os protege contra agentes: controle de acesso restrito, descoberta de conteúdo restrita ou DLP. Depois, acrescente uma linha sobre o acesso dos agentes do SharePoint ao guia do proprietário do seu site.