Aggiungere SharePoint come origine delle informazioni

SharePoint come origine delle informazioni funziona associando l'agente a un URL SharePoint o a elenchi di SharePoint. Questo articolo illustra la funzionalità completa di integrazione SharePoint fornita selezionando l'opzione SharePoint nella finestra di dialogo Aggiungi informazioni.

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 vengono configurati con l'opzione di autenticazione Authenticate with Microsoft, che funziona in ambienti come Microsoft Teams, Power Apps e Microsoft 365 Copilot.

Aggiungere siti 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 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 Featured selezionare SharePoint.

   

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

5. Aggiungere un nome e una descrizione. La descrizione dovrebbe essere il più dettagliata possibile, soprattutto se l'IA generativa è abilitata, poiché la descrizione favorisce l'orchestrazione generativa.

6. Selezionare Aggiungi all'agente per completare l'inserimento dell'origine di conoscenza.

Aggiungere elenchi di SharePoint come origine delle conoscenze

SharePoint elenchi sono un modo comune per archiviare i dati tabulari e fornire accesso rapido e semplice alle informazioni. L'agente può usare questi elenchi come fonte di conoscenza. Aggiungendo un elenco SharePoint come origine conoscenze, 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 avere l'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 Featured selezionare SharePoint.

4. Selezionare Elementibrowse 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. My Lists visualizza solo gli elenchi creati nell'app Elenchi 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 Recent Lists.

   

   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 si vuole usare un elenco di SharePoint con accesso condiviso, ma non viene visualizzato nella Elenco, incollare l'URL dell'elenco nella selezione dell'URL.

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

7. Aggiungere un nome e una descrizione. La descrizione dovrebbe essere il più dettagliata possibile, soprattutto se l'IA generativa è abilitata, poiché la descrizione favorisce l'orchestrazione generativa.

8. Selezionare Aggiungi all'agente per completare l'inserimento dell'origine 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 si connettono a un agente tramite Microsoft Teams, Power Apps o Microsoft 365 Copilot. Tuttavia, se è necessario configurare manualmente l'autenticazione, sono necessari i passaggi seguenti per consentire alle risposte generative di funzionare con SharePoint origini dati.

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

• Per autenticare l'agente, vedi Autenticazione.

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

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

• Quando si configura l'autenticazione, gli ambiti controllano l'accesso degli utenti. Specificare e nel campo degli ambiti vicino ai valori e esistenti in Copilot Studio. Questi ambiti non offrono agli utenti autorizzazioni maggiori quando usano l'agente, ma consentono il contenuto consentito dal sito SharePoint come configurato per le risposte generative.

• SharePoint supporta l'impostazione Authenticate manualmente con i provider di servizi di autenticazione seguenti:

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

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

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

Filtra la tua origine SharePoint

I Maker possono migliorare le prestazioni della fonte di conoscenza di SharePoint dell'agente specificando i parametri delle 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:

Creare condizioni di filtro

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

1. Nella pagina Knowledge selezionare l'origine SharePoint.

2. Selezionare i tre puntini (... ) per l'origine SharePoint e selezionare Edit.

3. Selezionare Impostazioni avanzate.

4. Costruisci i tuoi filtri per includere o escludere informazioni dalla tua origine delle conoscenze di SharePoint. Puoi basare il filtro su una delle selezioni seguenti:

   • Titolo
   • Autore
   • Modificato da
   • Modificato il

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

Altre impostazioni per migliorare la ricerca

Se si vuole filtrare l'origine 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" se non riesce a trovare un risultato nell'origine di conoscenza SharePoint filtrata.