Siti autorevoli di SharePoint nella ricerca Copilot

I siti autorevoli consentono agli amministratori di identificare le origini di SharePoint ufficiali gestite dall'organizzazione. Quando un sito è contrassegnato come autorevole, il relativo contenuto viene riconosciuto come attendibile nelle esperienze di ricerca Copilot.

Per gli utenti, questo migliora la fiducia nei risultati della ricerca. Gli elementi attendibili sono più facili da identificare tramite segnali visivi, ad esempio l'etichetta Dall'organizzazione .

Importante

Nella versione corrente i siti autorevoli vengono configurati tramite PowerShell e le API CSOM. La designazione a livello di sito è supportata; i siti personali non sono supportati.

Prerequisiti

  • È necessario assegnare il ruolo Amministratore di SharePoint o Amministratore globale.
  • L'account amministratore deve avere una licenza di Microsoft 365 Copilot per contrassegnare un sito come autorevole.
  • È necessario accedere a SharePoint Online Management Shell.

Perché usare siti autorevoli

  • Migliorare l'attendibilità in Ricerca Copilot promuovendo le origini aziendali verificate.
  • Aiutare gli utenti a identificare rapidamente i contenuti ufficiali.
  • Ridurre il tempo impiegato per verificare se il contenuto è affidabile.
  • Mantenere il controllo centralizzato dell'amministratore sulla designazione autorevole del codice sorgente.

Configurare siti autorevoli con SharePoint Online Management Shell

Usare SharePoint Online Management Shell quando si vuole un flusso di lavoro amministratore semplice.

  1. Installare e importare il modulo.
  2. Connettersi all'interfaccia di amministrazione di SharePoint.
  3. Contrassegnare il sito come autorevole.
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

Configurare siti autorevoli con CSOM (avanzate)

Usare CSOM quando sono necessarie operazioni di automazione o bulk.

Nota

È necessaria la versione 16.1.26914.12004 o successiva di CSOM.

Passaggio 1: Installare PowerShell PnP

Install-Module PnP.PowerShell -Scope CurrentUser -Force

Passaggio 2: Registrare un'app Entra ID

Registrare un'app per l'autenticazione interattiva e copiare l'ID client dall'output.

$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>"

Passaggio 3: Installare CSOM di SharePoint Online

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

Passaggio 4: Caricare assembly 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"

Passaggio 5: Connettersi a SharePoint Online

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

Passaggio 6: Inizializzare l'oggetto tenant e verificare la disponibilità dell'API

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

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

Operazioni CSOM

Ottenere siti autorevoli

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

Contrassegnare un sito come autorevole

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

Rimuovere un sito da siti autorevoli

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

Se il sito viene rimosso correttamente, la risposta è vuota. Se l'operazione non riesce, PowerShell restituisce un'eccezione.

Contrassegnare in blocco i siti come autorevoli

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

Rimuovere in blocco i siti autorevoli

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

Ciclo di vita e manutenzione

Gestire siti autorevoli come set di origini attendibili:

  • Esaminare regolarmente l'elenco e rimuovere i siti obsoleti o non più ufficiali.
  • Convalidare il comportamento dopo l'eliminazione del sito o gli eventi di ripristino.
  • Pianificare il tempo di propagazione dopo gli aggiornamenti.

Limitazioni

  • È possibile contrassegnare fino a 100 siti come autorevoli.
  • La visualizzazione delle modifiche nelle esperienze supportate può richiedere fino a 72 ore.
  • La designazione è attualmente solo a livello di sito.
  • I tenant multi-geo gestiscono i dati autorevoli del sito per area geografica.
  • I siti personali non possono essere contrassegnati come autorevoli.

Risoluzione dei problemi

Se le modifiche non vengono visualizzate come previsto, controllare quanto segue:

  • Licenze: l'account amministratore ha una licenza di Microsoft 365 Copilot.
  • Disponibilità delle funzionalità: la funzionalità è abilitata nel tenant.
  • Idoneità del sito: l'URL è valido e fa riferimento a un sito di SharePoint supportato.
  • Intervallo: tempo di propagazione sufficiente (fino a 72 ore) trascorso.