Sites autoritativos do SharePoint na Pesquisa do Copilot

Os sites autoritativos ajudam os administradores a identificar fontes oficiais do SharePoint gerenciadas pela organização. Quando você marca um site como autoritativo, as experiências de pesquisa do Copilot reconhecem seu conteúdo como confiável.

Para os usuários, esse reconhecimento melhora a confiança nos resultados da pesquisa. Sinais visuais, como o rótulo Da sua organização , facilitam a identificação de itens confiáveis.

Importante

Na versão atual, configure sites autoritativos por meio do PowerShell e das APIs CSOM. A configuração dá suporte à designação no nível do site, mas não dá suporte a sites pessoais.

Pré-requisitos

Consulte Pré-requisitos para o Gerenciamento Avançado do SharePoint.

Por que usar sites autoritativos

Use sites autoritativos para:

  • Melhore a confiança na Pesquisa do Copilot promovendo fontes organizacionais verificadas.
  • Ajude os usuários a identificar rapidamente o conteúdo oficial.
  • Reduza o tempo gasto validando se o conteúdo é confiável.
  • Mantenha o controle do administrador centralizado sobre a designação da fonte autoritativa.

Configurar sites autoritativos com o Shell de Gerenciamento do SharePoint Online

Use o Shell de Gerenciamento do SharePoint Online quando quiser um fluxo de trabalho de administração simples.

  1. Instale e importe o módulo.
  2. Conecte-se ao Centro de administração do SharePoint.
  3. Marque o site como autoritativo.
Install-Module -Name Microsoft.Online.SharePoint.PowerShell -Force
Import-Module -Name Microsoft.Online.SharePoint.PowerShell

Connect-SPOService -Url "https://<tenant>-admin.sharepoint.com"
Set-SPOSite -Identity "https://<tenant>.sharepoint.com/sites/<siteName>" -IsAuthoritative $true

Configurar sites autoritativos com CSOM (avançado)

Use o CSOM quando precisar de automação ou operações em massa.

Observação

A versão 16.1.26914.12004 ou posterior do CSOM é necessária.

Etapa 1: Instalar o PnP PowerShell

Install-Module PnP.PowerShell -Scope CurrentUser -Force

Etapa 2: registrar um aplicativo do Microsoft Entra ID

Registre um aplicativo para autenticação interativa e copie a ID do cliente da saída.

$tenant = "<TenantName>.onmicrosoft.com"
Register-PnPEntraIDAppForInteractiveLogin -ApplicationName "PnP Interactive (SPO Admin)" -Tenant $tenant -SharePointDelegatePermissions "AllSites.FullControl" -SharePointApplicationPermissions "Sites.FullControl.All" -GraphDelegatePermissions "Sites.FullControl.All" -GraphApplicationPermissions "Sites.FullControl.All" -Interactive
$clientId = "<FROM ABOVE OUTPUT>"

Etapa 3: Instalar o CSOM do SharePoint Online

Install-Package Microsoft.SharePointOnline.CSOM -Source nuget.org -Scope CurrentUser

Etapa 4: Carregar assemblies CSOM

$dllPath = "C:\Users\<USER_NAME>\AppData\Local\PackageManagement\NuGet\Packages\Microsoft.SharePointOnline.CSOM.<VERSION>\lib\netstandard2.0"
Add-Type -Path "$dllPath\Microsoft.SharePoint.Client.dll"
Add-Type -Path "$dllPath\Microsoft.SharePoint.Client.Runtime.dll"
Add-Type -Path "$dllPath\Microsoft.Online.SharePoint.Client.Tenant.dll"

Etapa 5: conectar-se ao SharePoint Online

$tenantDomain = "<TenantName>.onmicrosoft.com"
Connect-PnPOnline -Url "https://<TenantName>-admin.sharepoint.com" -ClientId $clientId -Tenant $tenantDomain -Interactive

Etapa 6: inicializar o objeto locatário e verificar a disponibilidade da API

$ctx = Get-PnPContext
$tenant = New-Object Microsoft.Online.SharePoint.TenantAdministration.Tenant($ctx)
$ctx.ExecuteQuery()

$tenant.GetType().GetMethod("GetAuthoritativeResources")

Operações CSOM

Obter sites confiáveis

$authResources = $tenant.GetAuthoritativeResources()
$ctx.ExecuteQuery()

Marcar um site como autoritativo

$siteId = [Guid]"<SiteId>"
$result = $tenant.SetResourceAsAuthoritative($siteId)
$ctx.ExecuteQuery()
$result.Value

Remover um site de sites autoritativos

$siteId = [Guid]"<SiteId>"
$result = $tenant.RemoveResourceAsAuthoritative($siteId)
$ctx.ExecuteQuery()

Se o site for removido com êxito, a resposta estará vazia. Se a operação falhar, o PowerShell retornará uma exceção.

Marcar sites em massa como autoritativos

[System.Guid[]]$siteIds = @([Guid]"<SiteId1>", [Guid]"<SiteId2>", [Guid]"<SiteId3>")
$results = $tenant.BulkSetResourceAsAuthoritative($siteIds)
$ctx.ExecuteQuery()
$results

Remover sites autoritativos em massa

[System.Guid[]]$siteIds = @([Guid]"<SiteId1>", [Guid]"<SiteId2>", [Guid]"<SiteId3>")
$results = $tenant.BulkRemoveResourceAsAuthoritative($siteIds)
$ctx.Load($results)
$ctx.ExecuteQuery()
$results

Ciclo de vida e manutenção

Mantenha sites autoritativos como um conjunto ativo de fontes confiáveis:

  • Revise a lista regularmente e remova sites desatualizados ou não mais oficiais.
  • Valide o comportamento após a exclusão do site ou eventos de restauração.
  • Planeje o tempo de propagação após as atualizações.

Limitações

  • Você pode marcar até 100 sites como autoritativos.
  • As alterações podem levar até 72 horas para aparecerem em experiências compatíveis.
  • Atualmente, a designação é apenas no nível do site.
  • Os locatários multigeográficos gerenciam dados autoritativos do site por área geográfica.
  • Os sites pessoais não podem ser marcados como autoritativos.

Solução de problemas

Caso as alterações não apareçam conforme o esperado, marque os seguintes itens:

  • Licenciamento: é necessária uma licença do Microsoft Copilot. (Consulte Pré-requisitos para o Gerenciamento Avançado do SharePoint.)
  • Disponibilidade de recursos: verifique se o recurso está habilitado em seu locatário.
  • Qualificação do site: verifique se a URL é válida e faz referência a um site do SharePoint compatível.
  • Tempo: Reserve tempo suficiente para a propagação (até 72 horas).