Condividi tramite


Introduzione a Knowledge Agent (anteprima)

Nota

Questo articolo si applica alla versione di anteprima di Knowledge Agent in SharePoint.

Knowledge Agent non è attualmente supportato negli ambienti cloud di Microsoft 365 Government - GCC, GCC High, DoD o Office 365 air-gapped.

Knowledge Agent è una funzionalità predefinita di SharePoint progettata per aiutare l'organizzazione a preparare il contenuto per l'intelligenza artificiale. Arricchisce, organizza e mantiene il contenuto di SharePoint in un formato strutturato e autorevole, ottimizzato per gli agenti Microsoft 365 Copilot.

Per i tenant idonei, nell'angolo inferiore destro delle superfici di SharePoint viene visualizzato un nuovo pulsante dell'agente, che consente agli utenti idonei di accedere alle funzionalità di intelligenza artificiale avanzate. Questi includono l'arricchimento automatico del contenuto, l'ottimizzazione dei metadati e il riepilogo intelligente delle pagine.

Prerequisiti

Definizioni di ruolo per l'accesso al sito

  • Proprietario del sito: utente con autorizzazioni complete per il proprietario del sito.
  • Content Manager: utente con autorizzazioni di lettura, scrittura ed elenco.
  • Creatore di contenuto: utente con autorizzazioni di lettura e scrittura per il contenuto del sito o almeno l'accesso al gruppo Membri del sito.
  • Consumer di contenuto: qualsiasi utente con almeno autorizzazioni di lettura per il contenuto del sito o almeno l'accesso al gruppo Visitatori del sito.

Abilitare Knowledge Agent

Per l'anteprima, è possibile configurare la disponibilità usando PowerShell. Usare i KnowledgeAgent parametri in Set-SPOTenant per abilitare Knowledge Agent in tutti i siti, includere in modo selettivo i siti o escludere selettivamente i siti.

Per i tenant multi-geo, lo script di PowerShell deve essere eseguito in ogni area geografica per abilitare Knowledge Agent in tale area.

Il processo di abilitazione cambierà per la disponibilità generale.

Usare la versione SharePoint Online Management Shell 16.0.26615.12013 o successiva per gestire l'accesso all'anteprima di Knowledge Agent per gli utenti con licenze Copilot. Per istruzioni di configurazione, vedere Introduzione a SharePoint Online Management Shell.

Se il SharePoint Online Management Shell è già installato, assicurarsi di eseguire la versione più recente eseguendo il comando seguente in modalità amministrativa: Update-Module -Name Microsoft.Online.SharePoint.PowerShell.

Per risolvere gli errori di controllo delle versioni

Se viene visualizzato l'errore seguente, potrebbe indicare che sono installate più versioni o in conflitto del SharePoint Online Management Shell:

Set-SPOTenant : A parameter cannot be found that matches parameter name 'KnowledgeAgentScope'

Per risolvere il problema, attenersi alla seguente procedura:

  1. Rimuovere i moduli di SharePoint in conflitto aprendo Aggiungi o rimuovi programmi e cercando SharePoint. Disinstallare tutti i moduli di amministrazione di SharePoint trovati.

  2. Controllare i moduli installati eseguendo il comando seguente:

    Get-Module -Name *SharePoint* -ListAvailable

    Se sono elencate più versioni, rimuoverle usando:

    Uninstall-Module -Name <ModuleName>

  3. Eliminare manualmente i moduli rimanenti. Se si verificano eccezioni durante la disinstallazione, usare questo comando per individuare il percorso del modulo:

    (Get-Module -Name *SharePoint* -ListAvailable).Path

    Passare alla cartella padre ed eliminarla manualmente.

  4. Riavviare PowerShell. Chiudere il terminale e riaprirlo per cancellare tutti i moduli caricati in memoria.

  5. Ripetere la pulizia. Ripetere i passaggi 2 e 3 fino a quando non rimangono moduli di PowerShell di SharePoint Online.

  6. Per installare il modulo PowerShell di SharePoint Online più recente, eseguire:

    Install-Module -Name Microsoft.Online.SharePoint.PowerShell

    Nota

    Per verificare la versione installata, usare il comando seguente:

    (Get-Module -Name Microsoft.Online.SharePoint.PowerShell -ListAvailable).Version

    Se vengono visualizzate più versioni, ripetere i passaggi di pulizia precedenti.

KnowledgeAgentScope

  • Descrizione: consente agli amministratori di controllare i siti di SharePoint in cui è disponibile la funzionalità knowledge agent.

  • Valori validi:

    • AllSites: Knowledge Agent è disponibile in tutti i siti.

    • IncludeSelectedSites: Knowledge Agent è disponibile solo nei siti specificati in KnowledgeAgentSelectedSitesList

    • ExcludeSelectedSites: Knowledge Agent è disponibile in tutti i siti, ad eccezione di quelli specificati in KnowledgeAgentSelectedSitesList.

    • NoSites: Knowledge Agent non è disponibile in alcun sito. Questo è il valore predefinito.

  • Nota: richiede Microsoft 365 Copilot licenza.

KnowledgeAgentSelectedSitesList

  • Descrizione: consente agli amministratori di passare un elenco di URL del sito di SharePoint da includere o escludere dalla funzionalità Agente conoscenze.

  • Quando KnowledgeAgentScope = ExcludeSelectedSites: l'elenco viene considerato come siti da ESCLUDERE (elenco di rifiuto esplicito del sito).

    • Quando KnowledgeAgentScope = IncludeSelectedSites: l'elenco viene considerato come siti da INCLUDERE (elenco di consenso esplicito del sito).
  • Per impostazione predefinita, questo sovrascrive qualsiasi elenco esistente con l'elenco specificato.

  • Questo parametro può essere chiamato solo quando KnowledgeAgentScope è impostato su IncludeSelectedSites o ExcludeSelectedSites.

  • L'elenco degli URL del sito non può superare i 100 elementi.

  • Nota: richiede Microsoft 365 Copilot licenza.

KnowledgeAgentSelectedSitesListOperation

  • Descrizione: specifica l'operazione da eseguire nell'elenco dei siti correnti della funzionalità knowledge agent.

  • Valori validi:

    • Overwrite: sovrascrivere l'elenco di siti esistente (impostazione predefinita).

    • Append: aggiungere l'elenco di input dei siti all'elenco dei siti esistenti.

    • Remove: rimuovere l'elenco di input dei siti dall'elenco dei siti esistenti.

  • Nota: la chiamata di questo parametro senza KnowledgeAgentSelectedSitesList non ha alcun effetto.

Utilizzo di esempio

Abilitare Knowledge Agent in tutti i siti

# Connect to SharePoint Online admin center
Connect-SPOService https://yourtenant-admin.sharepoint.com

# Enable Knowledge Agent for all sites in the tenant
Set-SPOTenant -KnowledgeAgentScope AllSites

# Verify the configuration
Get-SPOTenant | Select-Object KnowledgeAgentScope

Abilitare Knowledge Agent nei siti specificati

# Connect to SharePoint Online admin center 
Connect-SPOService https://yourtenant-admin.sharepoint.com 

# Set Knowledge Agent to be available only on the included sites 
Set-SPOTenant -KnowledgeAgentScope IncludeSelectedSites 

# Specify sites to enable Knowledge Agent (initial inclusion list) 
Set-SPOTenant -KnowledgeAgentSelectedSitesList @("https://yourtenant.sharepoint.com/sites/site5", "https://yourtenant.sharepoint.com/sites/site7") 

# Add additional sites to the existing inclusion list (if needed) 
Set-SPOTenant -KnowledgeAgentSelectedSitesList @("https://yourtenant.sharepoint.com/sites/site3") -KnowledgeAgentSelectedSitesListOperation Append 

# Verify the inclusion configuration 
Get-SPOTenant | Select-Object KnowledgeAgentScope, KnowledgeAgentSelectedSitesList 

Abilitare Knowledge Agent in tutti i siti tranne i siti specificati

# Connect to SharePoint Online admin center
Connect-SPOService https://yourtenant-admin.sharepoint.com

# Set Knowledge Agent to be available on all sites except selected sites
Set-SPOTenant -KnowledgeAgentScope ExcludeSelectedSites

# Specify sites to exclude from Knowledge Agent (initial exclusion list)
Set-SPOTenant -KnowledgeAgentSelectedSitesList @("https://yourtenant.sharepoint.com/sites/site1", "https://yourtenant.sharepoint.com/sites/site2")

# Add additional sites to the existing exclusion list (if needed)
Set-SPOTenant -KnowledgeAgentSelectedSitesList @("https://yourtenant.sharepoint.com/sites/site3") -KnowledgeAgentSelectedSitesListOperation Append

# Verify the exclusion configuration
Get-SPOTenant | Select-Object KnowledgeAgentScope, KnowledgeAgentSelectedSitesList

Disabilitare Knowledge Agent

# Connect to SharePoint Online admin center
Connect-SPOService https://yourtenant-admin.sharepoint.com

# Disable Knowledge Agent for all sites in the tenant
Set-SPOTenant -KnowledgeAgentScope NoSites

# Verify Knowledge Agent is disabled
Get-SPOTenant | Select-Object KnowledgeAgentScope