Aggiungere SharePoint come fonte di conoscenza

SharePoint come origine delle informazioni a livello di agente per le risposte generative funziona associando l'agente a un URL di SharePoint o a elenchi di SharePoint. Questa opzione offre il supporto completo di SharePoint in Copilot Studio.

Nota

• Nella finestra di dialogo Aggiungi informazioni 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 illustra l'opzione SharePoint che fornisce il supporto completo di SharePoint in Copilot Studio.

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

• Per aggiungere singoli file o cartelle di SharePoint, vedere 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 il grounding dei grafi tenant con la ricerca semantica offre un recupero delle conoscenze e una qualità di risposta significativamente migliori. Questa caratteristica utilizza strumenti interni all'avanguardia che permettono all'agente di ottenere un maggior volume 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 di SharePoint come origine delle informazioni

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 di SharePoint come origine delle informazioni, seguire questa procedura:

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 selezionare 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 dell'fonte di conoscenza.

Aggiungere elenchi di SharePoint come origine delle informazioni

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 origine delle informazioni. Aggiungendo un elenco di SharePoint come origine delle informazioni, si crea una connessione in tempo reale all'origine, quindi i dati più aggiornati vengono usati per le query 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 selezionare SharePoint.

4. Selezionare 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 e Elenchi recenti. Gli elenchi personali visualizzano solo gli elenchi creati nell'app Elenchi di SharePoint. Tutti gli altri elenchi vengono visualizzati negli elenchi recenti. Se non viene visualizzato un elenco necessario, aprire SharePoint e accedere all'elenco e l'elenco viene visualizzato in Elenchi recenti.

   

   È possibile selezionare fino a 15 elenchi alla volta. Ogni elenco viene aggiunto come elementi individuali alle fonti di conoscenza dell'agente. Per aggiungere altri elenchi all'agente, usare di nuovo questi passaggi e selezionare altri elenchi.

   Nota

   Se si desidera utilizzare un elenco di SharePoint a cui si ha accesso condiviso, ma non è visualizzato in Elenchi recenti, incollare l'URL per l'elenco nella selezione dell'URL.

6. Dopo aver selezionato gli elenchi desiderati, selezionare 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 dell'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 da fonti SharePoint non sono disponibili per gli utenti ospiti nelle app abilitate a SSO.

• 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 Autenticare manualmente con i seguenti fornitori di servizi 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 usando Generic OAuth.

• 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 verrà cercato all'interno dell'origine delle informazioni. Ad esempio, è possibile specificare che si desidera cercare solo gli elementi modificati negli ultimi 6 mesi. Questo tipo di filtro verrà costruito come segue:

Attribute	Operator	Value
Modified on	on or after	X date

Creare condizioni di filtro

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

1. Nella pagina Knowledge selezionare l'origine di SharePoint.

2. Selezionare l'icona Altro (...) dell'origine SharePoint e selezionare Modifica.

3. Selezionare Impostazioni avanzate.

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

   • Titolo
   • Autore
   • Autore modifica
   • Data di modifica

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

   • 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. Selezionare Salva al termine della configurazione dei filtri.

Altre impostazioni per migliorare la ricerca

Se si desidera filtrare l'origine di SharePoint, disattivare le impostazioni seguenti:

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

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