Utilizzare i contenuti di SharePoint per le risposte generative

Le risposte generative ai nodi usando SharePoint come origine delle informazioni a livello di argomento funzionano associando l'agente a un URL di SharePoint, ad esempio contoso.sharepoint. com/sites/policies. 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.

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.

Usare SharePoint in un nodo delle risposte generative

1. In un argomento, aggiungi un nodo di risposte generative.

2. Nel nodo risposte generative dell'argomento rilevante, apri il pannello di configurazione della sorgente dati da uno dei due punti:

   1. Nel nodo Crea risposte generative, seleziona Modifica in Origini dati.

      

   2. In alternativa, nel nodo Crea risposte generative seleziona i tre punti (...), poi seleziona Proprietà e seleziona Sorgente dati.

3. In Origini conoscenze selezionare Aggiungi informazioni. Assicurarsi che l'opzione Cerca solo origini selezionate sia attivata.

4. Nella sezione Featured selezionare SharePoint.

   

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

   Annotazioni

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

6. 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.

7. Seleziona Salva nella parte superiore per salvare le modifiche all'argomento.

8. Metti alla prova il tuo agente con frasi che ti aspetti restituiscano contenuti.

   Annotazioni

   Se l'account utente usato per accedere a copilotstudio.microsoft.com non ha accesso al sito di SharePoint, non si ottiene contenuto o si potrebbe visualizzare un errore di sistema.

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.

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.

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