Aggiungere SharePoint come fonte di conoscenza

SharePoint come fonte di conoscenza funziona abbinando il tuo agente a un URL SharePoint o a liste SharePoint. Questo articolo copre l'intera funzionalità di integrazione di SharePoint fornita selezionando l'opzione SharePoint nella finestra di dialogo Aggiungi conoscenza .

Nota

• Nella finestra di dialogo Aggiungi Knowledge Base sono disponibili due opzioni di SharePoint. L'opzione SharePoint nella sezione caricamento file viene usata per caricare singoli file o cartelle di SharePoint e abilita le funzionalità di sincronizzazione file. Questo articolo tratta l'opzione SharePoint che offre il pieno supporto di SharePoint in Copilot Studio.

• Per un elenco dei limiti e delle funzionalità di SharePoint supportate, vedi Limiti di SharePoint per l'app Web di Copilot Studio.

• Per aggiungere singoli file o cartelle di SharePoint, vedi Aggiungere file e cartelle di SharePoint.

• Le risposte degli agenti che utilizzano SharePoint come origine di conoscenza non sono incluse nelle trascrizioni delle conversazioni.

• Per gli agenti basati su fonti di conoscenza SharePoint, attivare la grounding dei grafi tenant con la ricerca semantica offre una migliore qualità nel recupero della conoscenza e nella risposta. Questa caratteristica utilizza strumenti interni all'avanguardia, che permettono all'agente di ottenere un volume maggiore di contesto con maggiore precisione. Tuttavia, a causa della maggiore complessità del sistema, alcuni utenti e query potrebbero sperimentare un leggero aumento della latenza.

Quando pubblichi l'agente, le chiamate che utilizzano risposte generative vengono effettuate per conto dell'utente che chatta con l'agente, utilizzando le impostazioni di autenticazione configurate nell'agente. Per impostazione predefinita, gli agenti creati in Copilot Studio e in Microsoft Teams sono configurati con l'opzione di autenticazione Autentica con Microsoft, che funziona in ambienti quali Microsoft Teams, Power Apps e Microsoft 365 Copilot.

Nota

È possibile utilizzare risposte generative con dati SharePoint nelle chat di Microsoft Teams, senza richiedere l'autenticazione manuale. Per utilizzare questo metodo per un agente pubblicato in precedenza, riconfigura l'agente per utilizzare Autentica con Microsoft e quindi pubblicalo nuovamente in Microsoft Teams. Potrebbero volerci alcune ore prima che questa modifica abbia effetto. Se un utente si trova nel mezzo di una conversazione e la modifica non sembra essere stata applicata, può digitare "ricomincia" nella chat per forzare la ripresa della conversazione con la versione più recente dell'agente. Queste modifiche sono ora disponibili per le chat 1:1 di Teams tra l'utente e l'agente. Non sono ancora disponibili per le chat di gruppo o i messaggi dei canali.

Se desideri usare l'autenticazione manuale per l'agente, vedi Scenari di autenticazione avanzata.

Aggiungere siti SharePoint come fonte di conoscenza

Quando un agente pone una domanda e l'agente non ha un argomento definito da utilizzare per la risposta, cerca l'URL e tutti i percorsi secondari. Ad esempio, un URL come contoso.sharepoint.com/sites include anche percorsi secondari come contoso.sharepoint.com/sites/policies. Le risposte generative riassumono questo contenuto in una risposta mirata.

Per aggiungere un sito SharePoint come fonte di conoscenza, esegui i passaggi seguenti:

1. Apri l'agente.

2. Seleziona Aggiungi conoscenza dalla pagina Panoramica o Conoscenza oppure dalle Proprietà di un nodo di risposte generative.

3. Nella sezione In primo piano, seleziona SharePoint.

   

4. Specifica l'URL SharePoint. Separa più URL con interruzioni di riga manuali (usa MAIUSC + Invio).

5. Aggiungere un nome e una descrizione. La descrizione deve essere il più dettagliata possibile, soprattutto se IA generativa è abilitato, in quanto favorisce l'orchestrazione generativa.

6. Seleziona Aggiungi per completare l'aggiunta della fonte di conoscenza.

Aggiungere elenchi di SharePoint come fonte della conoscenza

Gli elenchi di SharePoint sono un modo comune per archiviare i dati tabulari e fornire un accesso rapido e semplice alle informazioni. L'agente può usare questi elenchi come fonte di conoscenza. Aggiungendo un elenco SharePoint come fonte di conoscenza, si crea una connessione in tempo reale alla fonte, quindi i dati più aggiornati vengono usati per le domande e il ragionamento. Gli utenti vengono autenticati usando le credenziali di SharePoint, assicurandosi di disporre dell'autorizzazione per accedere ai dati prima che l'agente fornisca una risposta.

1. Apri l'agente.

2. Seleziona Aggiungi conoscenza dalla pagina Panoramica o Conoscenza oppure dalle Proprietà di un nodo di risposte generative.

3. Nella sezione In primo piano, seleziona SharePoint.

4. Seleziona Sfoglia elementi per trovare l'elenco desiderato oppure immettere l'URL di un elenco di SharePoint specifico.

   

5. Quando si seleziona Sfoglia elementi, la finestra di dialogo viene popolata automaticamente con Elenchi personali ed Elenchi recenti. Elenchi personali visualizza solo gli elenchi creati nell'app Elenchi di SharePoint. Tutti gli altri elenchi vengono visualizzati in Elenchi recenti. Se non viene visualizzato un elenco necessario, apri SharePoint e accedi all'elenco; l'elenco viene visualizzato in Elenchi recenti.

   

   Puoi selezionare fino a 15 elenchi alla volta. Ogni elenco viene aggiunto alle fonti di conoscenza dell'agente come singolo elemento. Per aggiungere altri elenchi all'agente, usa di nuovo questi passaggi e seleziona altri elenchi.

   Nota

   Se vuoi usare una lista SharePoint con accesso condiviso ma non viene mostrata nelle Liste Recenti, incolla l'URL della lista nella selezione URL.

6. Dopo aver selezionato gli elenchi desiderati, seleziona Conferma selezione.

7. Aggiungere un nome e una descrizione. La descrizione deve essere il più dettagliata possibile, soprattutto se IA generativa è abilitato, in quanto favorisce l'orchestrazione generativa.

8. Seleziona Aggiungi per completare l'aggiunta della fonte di conoscenza.

Scenari di autenticazione avanzati

Per impostazione predefinita, Copilot Studio preconfigura gli agenti per autenticare gli utenti usando l'autenticazione Microsoft per accedere alle origini SharePoint quando ci si connette a un agente tramite Microsoft Teams, Power Apps o Microsoft 365 Copilot. Tuttavia, se è necessario configurare manualmente l'autenticazione, sono necessari i seguenti passaggi affinché le risposte generative funzionino con le origini dati SharePoint.

Importante

Se Ricerca SharePoint limitata è abilitata, l'uso di SharePoint è bloccato.

• Le risposte generative dalle origini di SharePoint non sono disponibili per gli utenti guest nelle app abilitate per l'accesso Single Sign-On.

• Per autenticare l'agente, vedi Autenticazione.

• Per istruzioni su come creare la registrazione dell'applicazione Microsoft Entra ID necessaria, vedi Configurare l'autenticazione utente con Microsoft Entra ID. Quando crei questa registrazione, tu o l'amministratore dovete specificare gli ambiti Sites.Read.All e Files.Read.All nella registrazione dell'app Microsoft Entra ID.

• Selezionando Nessuna autenticazione si indica che l'agente non recupera informazioni da SharePoint.

• Quando si configura l'autenticazione, gli ambiti controllano l'accesso degli utenti. Specifica Sites.Read.All e Files.Read.All nel campo ambiti accanto ai valori esistenti profile e openid in Copilot Studio. Tali ambiti non offrono agli utenti autorizzazioni ottimizzate quando si usa un agente ma consentono loro contenuto ammissibile dal sito SharePoint come configurato per le risposte generative.

• SharePoint supporta l'impostazione Autenticazione manuale con i seguenti provider del servizio di autenticazione:

  • Microsoft Entra ID
  • Microsoft Entra ID V2 con credenziali federate
  • Microsoft Entra ID V2 con certificati
  • Microsoft Entra ID V2 con segreti del cliente

• SharePoint non supporta l'autenticazione manuale tramite OAuth generico.

• Questa configurazione si applica solo alle risposte generative e non ai connettori di Power Platform.

Filtra la tua sorgente SharePoint

Gli autori possono migliorare le prestazioni dell'origine della Knowledge Base di SharePoint dell'agente specificando i parametri della query di ricerca. Questi parametri di query definiscono ciò che viene ricercato all'interno della sorgente di conoscenza. Ad esempio, potresti specificare che vuoi ricercare solo gli elementi modificati negli ultimi sei mesi. Questo tipo di filtro verrà costruito come segue:

Attributo	Operatore	Valore
Modified on	on or after	X date

Creare condizioni di filtro

Dopo aver aggiunto una fonte di conoscenza SharePoint, puoi impostare condizioni di ricerca.

1. Nella pagina Conoscenza, seleziona la fonte di SharePoint.

2. Seleziona i tre puntini (...) per la sorgente SharePoint e seleziona Modifica.

3. Selezionare Impostazioni avanzate.

4. Compila i filtri per includere o escludere informazioni dalla fonte di conoscenza di SharePoint. Puoi basare il filtro su una delle selezioni seguenti:

   • Titolo
   • Autore
   • Autore modifica
   • Data di modifica

5. Puoi impostare il valore della condizione su uno dei valori seguenti:

   • Un valore statico
   • Input di variabile fornito dall'utente durante la conversazione con l'agente, che viene quindi salvato come variabile globale personalizzata
   • Variabile di sistema

6. Seleziona Salva al termine della configurazione dei filtri.

Altre impostazioni per migliorare la ricerca

Se desideri filtrare la fonte di SharePoint, disattiva le impostazioni seguenti:

• Ricerca Web
• A livello di agente, l'impostazione Usa conoscenza generale nelle impostazioni di IA generativa dell'agente
• A livello di argomento, l'opzione Consenti all'intelligenza artificiale di usare le proprie conoscenze generali (anteprima) nel nodo di risposte generative

La disattivazione di queste impostazioni garantisce che l'agente risponda con "nessuna risposta" se non riesce a trovare un risultato nella fonte di conoscenza di SharePoint filtrata.