Skip to content
FundamentalsStandard HarnessLab 02

Lab 02 - Knowledge Sources ​

Tempo stimato: ~45 minuti · Harness: standard

Scenario ​

L'agente IT Support creato nel Lab 01 risponde con le sue istruzioni e con un sito pubblico di Microsoft, ma l'Help Desk di Zava ha procedure proprie: un playbook, gli SLA del servizio, un modello di incident report, un articolo per il reset della password di Microsoft 365 e tre versioni della guida alla VPN ZavaSecure. Un agente che risponde con informazioni generiche trovate sul web rischia di suggerire procedure non conformi.

In questo lab l'agente impara a rispondere con i documenti di Zava, usando tre tipi di fonte di conoscenza: un documento caricato direttamente, un file group che raccoglie le versioni della guida VPN con istruzioni per scegliere la più recente, e un sito SharePoint con la documentazione dell'Help Desk.

Che cosa si costruisce ​

Lo schema mostra le fonti di conoscenza dell'agente IT Support alla fine del lab. La descrizione di ogni fonte aiuta l'agente a scegliere quella giusta e, con le due impostazioni dell'AI generativa disattivate, l'agente risponde solo con queste fonti.

Agente IT Supportrisponde citando la fontenelle referencesSettings · Generative AIUse general knowledge: offUse information from the Web: off
Passa il mouse su un riquadro o selezionalo per vederne il dettaglio.

Prerequisiti ​

Per svolgere questo lab occorre avere:

  • completato il Lab 01 (agente IT Support nel proprio developer environment);
  • accesso a SharePoint con il proprio account aziendale o scolastico.

Creazione Sito SharePoint ​

Questo Lab affronta varie tipologie di Knowledge Base fra cui SharePoint, perciò è necessario creare un sito SharePoint seguendo questi step:

  1. Andare su Microsoft 365, accedere con il proprio account aziendale/scolastico, premere su Apps e selezionare All Apps.

  1. Selezionare SharePoint, successivamente premere su Create Site -> Team Site -> From Microsoft -> Standard Team-> Use Template.

  1. Ora aggiungere i dettagli del sito SharePoint elencati qui sotto e premere su Next.
FieldValue
Site nameHelp Desk CSM-Vostro Nome
Site descriptionCopilot Studio Masterclass
Site addressHelpDeskCSM
  1. Andare avanti premendo su Create site e Finish, senza aggiungere altro.

  2. Andare in Documents, premere + Upload e selezionare i seguenti file, da scaricare prima sul proprio computer:

Upload di Documenti come KB ​

  1. Dalla schermata Home di Copilot Studio selezionare Agents.

  1. Cercare l'agente IT Support creato nel Lab 01 e aprire la pagina di configurazione.

  2. Selezionare Knowledge nel menu in alto adiacente al Nome dell'Agente.

  1. Premere su +Add knowledge.

  1. Una volta premuto apparirà una schermata per aggiungere all'agente fonti di conoscenza.

Nota

Limiti delle fonti

La dimensione massima dei file da caricare è 512 MB e il numero massimo di URL per siti pubblici è 4. Per le altre specifiche tecniche consultare Quotas and limits - Microsoft Copilot Studio | Microsoft Learn

  1. Premere su Upload: verrà aperta una finestra del File Explorer, nella quale selezionare il seguente documento:

Nota

Dataverse search

Gli agenti di Copilot Studio richiedono la Dataverse search per utilizzare questa fonte di conoscenza. Se non è possibile aggiungere file a un agente, chiedere all’amministratore di attivare la Dataverse search nell'Environment.

  1. Modificare la Description con il seguente testo:
Usa questa Knowledge quando un Utente vuole resettare la Password.
  1. Per evitare che l'agente riporti informazioni trovate sul web, e quindi procedure non conformi all'azienda, è necessario disattivare la Web Search.

  2. Andare sui Settings.

  1. Nella sezione Generative AI cercare il paragrafo Knowledge, disattivare Use general knowledge e Use information from the Web e salvare le impostazioni.

Suggerimento

Solo le fonti di Zava

Disattivare la General Knowledge e la Web Search permette all'agente di concentrarsi solo sui dati forniti, limitando così il rischio di allucinazioni.

  1. Testare l'aggiunta della knowledge dalla chat di Test: premere su start a new session e incollare la seguente domanda:
Come posso resettare la Password?

  1. Notare come l'agente ha utilizzato il documento e lo ha riportato nelle references della risposta data.

Files Group come KB ​

  1. Selezionare Knowledge nel menu in alto adiacente al Nome dell'Agente, premere su +Add knowledge.

  2. Una volta premuto apparirà la schermata per aggiungere all'agente fonti di conoscenza: premere Upload e selezionare questi file:

  3. Al posto di premere su Add to agent selezionare Upload as a group.

Nota

Limiti dei file group

Per i limiti e le altre informazioni sui file group consultare la documentazione.

  1. Successivamente modificare il Name e la Description con:
VPN Guide
Contiene le guide di installazione e utilizzo per la VPN ZavaSecure. Utilizza la versione più aggiornata (v3), a meno che non sia richiesta una versione diversa.

  1. Aspettare che il file group diventi Ready e aprirlo per modificarne i dettagli.

  1. Aggiungere le Instructions:
I documenti sono denominati `Zava_Guida_"topic"_vX`, dove X indica la versione (più basso = più vecchio). **Utilizza sempre la versione più recente disponibile** per fornire le istruzioni. Non utilizzare versioni precedenti **a meno che l’utente non lo richieda esplicitamente**. Verifica il numero di versione e l’argomento prima di rispondere e specifica all’utente se stai utilizzando la guida più aggiornata disponibile.
  1. Salvare il file group.

  2. Testare l'aggiunta della knowledge dalla chat di Test: premere su start a new session e incollare la seguente domanda:

Come configuro la VPN secondo la guida del 2022?

Sito SharePoint come KB ​

  1. Selezionare Knowledge nel menu in alto adiacente al Nome dell'Agente.

  1. Premere su +Add knowledge.

Nota

Autenticazione dell'utente

Alcune fonti di conoscenza, come SharePoint e Dataverse, richiedono l'autenticazione dell'utente. Questo significa che l'agente farà riferimento, nelle sue risposte, solo ai dati che l'utente è autorizzato a visualizzare.

  1. Selezionare SharePoint.

  1. Premere su Browse Item.

  1. Cercare il sito SharePoint Help Desk CSM.

  2. Selezionare Documents e premere Confirm Selection.

  1. Aggiornare la descrizione della knowledge con la seguente:
Documentazione essenziale e risorse per supportare la gestione dei servizi IT e l’assistenza agli utenti finali.

Suggerimento

Descrizione della fonte

L'aggiunta di una descrizione aiuta l'agente a identificare meglio quale fonte utilizzare in base alla richiesta posta dall'utente.

  1. Testare l'aggiunta della knowledge dalla chat di Test: premere su start a new session e incollare la seguente domanda:
Quali sono gli orari standard rispetto alla disponibilità del supporto di emergenza?

Nota

Approfondire le fonti di conoscenza

Per ulteriori informazioni sulle fonti di conoscenza consultare la documentazione.

Importante

Lab Completato

L'agente IT Support ora risponde con la documentazione dell'Help Desk di Zava. In questo lab si è visto:

  • come creare un sito SharePoint e caricarvi i documenti dell'Help Desk;
  • come aggiungere un documento come fonte di conoscenza e descriverlo;
  • perché disattivare la conoscenza generale e la ricerca sul web;
  • come raggruppare più versioni di un documento in un file group con istruzioni proprie;
  • come usare un sito SharePoint come fonte, con le autorizzazioni dell'utente.