Aggiungere un sito Web pubblico come fonte di conoscenza

Quando si aggiungono siti Web pubblici come fonti di informazioni a livello di agente, si usano informazioni disponibili pubblicamente per migliorare la portata dell'agente.

Aggiungere un sito Web pubblico

Per aggiungere un sito Web pubblico come origine delle conoscenze, 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. Seleziona Siti Web pubblici.

4. Immettere l'URL del sito Web pubblico. 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. Aggiungi un nome (per impostazione predefinita, viene utilizzato l'URL del sito Web).

6. Aggiungi una descrizione. Fornire una descrizione dettagliata, soprattutto se l'intelligenza artificiale generativa è abilitata, perché la descrizione facilita l'orchestrazione generativa.

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

8. Metti alla prova il tuo agente per vedere come risponde alle domande relative ai contenuti del tuo sito Web. Potresti voler testare le domande sui casi limite per decidere se hai bisogno di una moderazione inferiore per essere più inclusivo.

Considerazioni su URL

L'URL usato nell'agente rappresenta l'ambito del contenuto per la generazione di risposte. Alcuni URL hanno requisiti e restrizioni.

Tipo di URL e struttura

• L'URL può avere fino a due livelli di profondità, con percorsi secondari indicati da una barra /. Tuttavia, è consentita una barra finale.

  Valido	Non valido
  www.contoso.com www.fabrikam.com/engines/rotary www.fabrikam.com/engines/rotary/	www.fabrikam.com/engines/rotary/dual-shaft

• Se l'URL reindirizza a un altro sito di primo livello, il contenuto non viene incluso nei risultati:

  Ad esempio, se www.fabrikam.com reindirizza a www.contoso.fabrikam.com, l'agente non genera risposte dai contenuti di nessuno di questi URL.

• Gli URL che puntano a un sito Web che richiedono l'autenticazione o quelli non indicizzati da Bing non sono supportati.

  Ad esempio, i wiki e i siti SharePoint richiedono l'autenticazione, quindi non è possibile usarli:

  • fabrikam.visualstudio.com/project/_wiki
  • fabrikam.sharepoint.com

Struttura del dominio URL

L'agente usa qualsiasi contenuto visualizzabile pubblicamente nell'URL specificato, inclusi i sottodomini in un dominio di primo livello, per generare contenuto.

Esempi:

• Se si usa www.fabrikam.com/engines/rotary, l'agente usa anche il contenuto in www.fabrikam.com/engines/rotary/dual-shaft per generare risposte.

  L'agente non usa il contenuto in www.fabrikam.com/tools, perché gli strumenti non sono un sottodominio del rotary.

• Se si usa www.fabrikam.com ( www esiste), l'agente non usa contenuto su news.fabrikam.com(www non esiste), poiché le notizie sono un sottodominio nel dominio di primo livello fabrikam.com.

• Se si usa fabrikam.com, l'agente usa il contenuto su www.fabrikam.com e news.fabrikam.com, poiché si trovano sotto il dominio di primo livello fabrikam.com.

URL di social network e forum

Il tuo agente potrebbe generare risposte senza senso, irrilevanti o inappropriate se usi un forum o un sito di social network come tuo URL. Pertanto, il contenuto della community sui social network spesso aumenta il rischio che vengano rifiutate più risposte.

Per ulteriori informazioni, vedi le Domande frequenti per risposte generative. L'intelligenza artificiale è addestrata per evitare di generare risposte dannose e offensive.

URL del motore di ricerca

Non includere URL di motori di ricerca quali bing.com, poiché non forniscono risposte utili.

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: limita le query alla documentazione specifica di un prodotto.

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

• URL specifici dell'ambiente: passaggio 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.