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.

Annotazioni

• Nella finestra di dialogo Aggiungi informazioni sono disponibili due opzioni 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 offre il supporto completo delle SharePoint in Copilot Studio.

• Per un elenco dei limiti e delle funzionalità supportate di SharePoint, vedere Limiti delle app Web di SharePoint.

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

• Le risposte dell'agente che usano SharePoint come origine delle informazioni non sono incluse nelle trascrizioni di conversazione.

• Per gli agenti che si basano su fonti di conoscenza SharePoint, Turn on Work IQ offre una migliore qualità di accesso e risposta delle conoscenze. Questa funzionalità usa strumenti di recupero interni all'avanguardia che consentono all'agente di ottenere un volume di contesto maggiore, 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 vengono configurati con l'opzione di autenticazione Authenticate with Microsoft, che funziona in ambienti come Microsoft Teams, Power Apps e Microsoft 365 Copilot.

Annotazioni

È possibile usare risposte generative con SharePoint dati nelle chat Microsoft Teams e non richiedere l'autenticazione manuale. Per usare questo metodo per un agente pubblicato in precedenza, riconfigurare l'agente in modo che usi Authenticate con Microsoft e quindi pubblicarlo 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 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). Per usare una variabile anziché un URL statico, selezionare l'icona di selezione variabile accanto al campo URL e scegliere una variabile Personalizzata, Sistema o Ambiente .

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 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 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 Sfoglia elementi per trovare l'elenco desiderato oppure immettere l'URL di un sito 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.

   

   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.

   Annotazioni

   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.

Importante

Se SharePoint Ricerca con restrizioni è abilitato, 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 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 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:

Attribute	Operatore	Value
Modified on	on or after	X date

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 di SharePoint.

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

3. Selezionare Impostazioni avanzate.

4. Crea i tuoi filtri per includere o escludere informazioni dalla tua fonte di conoscenza 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:

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

Usare le variabili come URL

Usare variabili negli URL di siti web pubblici o delle origini di conoscenza di SharePoint per controllare dinamicamente l'ambito dei contenuti utilizzati dall'agente.

Anziché creare più origini conoscenze per scenari diversi, definire una singola origine conoscenze e inserire una variabile nell'URL. In fase di esecuzione, Copilot Studio risolve la variabile e usa l'URL risultante per il grounding.

Supporto delle variabili

Quando si aggiunge o si modifica un sito Web pubblico o l'URL della risorsa di conoscenza di SharePoint, è possibile inserire una variabile nel campo URL.

Usare una variabile per:

• Aggiungere un percorso a un URL di base

  https://www.contoso.com/{variable}

• Sostituire l'intero URL

  {variable}

In fase di esecuzione, la variabile viene risolta in un valore stringa. L'origine della fonte di conoscenza è delimitata all'URL risolto.

Annotazioni

L'uso di una variabile modifica l'URL usato per il grounding. Non modifica i requisiti di struttura degli URL o le limitazioni di profondità per i siti Web pubblici.

Creare e impostare una variabile

Per usare una variabile in un sito Web pubblico o in una fonte di conoscenza SharePoint:

1. Creare una variabile stringa con ambito globale .

2. Impostare il valore della variabile usando una delle opzioni seguenti:

   • Input degli argomenti
   • Proprietà del profilo utente, ad esempio lingua
   • Variabili di ambiente
   • Flussi o connettori dell'agente

3. Inserire la variabile nel campo URL selezionando {x} (Inserisci variabile).

4. Testare l'agente per verificare che la variabile si risolva nell'URL previsto.

Esempio: Ambito per prodotto

È possibile definire l'ambito delle conoscenze in diverse aree di prodotto in base alla query dell'utente.

1. Usare un input tematico per acquisire il nome del prodotto come variabile denominata Product.

2. Aggiungere un nodo Imposta valore variabile dopo il nodo Trigger e creare una nuova variabile denominata ProductTable.

3. Usare una formula di Power Fx per definire ed eseguire il mapping dei nomi dei prodotti ai percorsi URL.

    Table(
        { Product: "Copilot", Path: "microsoft-365-copilot" },
        { Product: "Teams", Path: "microsoft-teams" },
        { Product: "Surface", Path: "surface" }
    )
   

4. Aggiungere un altro nodo Imposta valore variabile e usarlo per creare una nuova variabile globale di tipo stringa denominata GlobalProductURL.

5. Nell'impostazione valore A seleziona Formula e utilizza una funzione Power Fx per eseguire una ricerca nella tabella in base al valore della variabile di input Product, Topic.Product, come segue:

   LookUp(Topic.ProductTable, Product = Topic.Product, Path)

6. Usare la variabile nell'URL della sorgente di conoscenza:

   https://www.microsoft.com/en-us/{GlobalProductURL}

L'agente esegue una query solo nella sezione limitata del sito Web in fase di esecuzione.

Scenari comuni

Usare le variabili nelle origini delle informazioni del sito Web pubblico per:

• Routing basato sul prodotto: limitare le query a una documentazione specifica del prodotto.

• Filtro di area o lingua: mappare User.Language a URL localizzati (ad esempio, en-us, it-it).

• URL specifici dell'ambiente: passa tra siti di sviluppo, test e produzione.

Considerazioni

• Le fonti di informazioni sul sito Web pubblico usano la ricerca Bing e si basano sul contenuto indicizzato.
• I limiti di profondità URL si applicano ancora quando si usano le variabili.
• Le variabili modificano solo l'URL di destinazione. Non influiscono sul modo in cui il contenuto viene indicizzato o recuperato.

Importante

La variabile deve essere risolta in un URL pubblico valido che soddisfi i requisiti per le origini di conoscenza del sito Web pubblico. Gli URL non validi o non supportati potrebbero non restituire risultati.