Esercitazione: Aggiungere una knowledge base a Power Virtual Agents

Creare ed estendere un bot Power Virtual Agents per fornire risposte da una knowledge base.

Nota

L'integrazione illustrata in questa esercitazione è in anteprima e non è destinata alla distribuzione negli ambienti di produzione.

In questa esercitazione verranno illustrate le procedure per:

• Creare un bot Power Virtual Agents
• Creare un argomento di fallback di sistema
• Aggiungere QnA Maker come azione a un argomento sotto forma di flusso Power Automate
• Creare una soluzione Power Automate
• Aggiungere un flusso Power Automate alla soluzione
• Pubblicare Power Virtual Agents
• Testare Power Virtual Agents e ricevere una risposta dalla knowledge base di QnA Maker

Nota

Il servizio QnA Maker viene ritirato il 31 marzo 2025. Una versione più recente della domanda e della funzionalità di risposta è ora disponibile come parte del linguaggio di intelligenza artificiale di Azure. Per le funzionalità di risposta alle domande all'interno del servizio linguistico, vedere La risposta alle domande. A partire dal 1° ottobre 2022 non sarà possibile creare nuove risorse QnA Maker. Per informazioni sulla migrazione delle knowledge base QnA Maker esistenti alla risposta alle domande, consultare la guida alla migrazione.

Creare e pubblicare una knowledge base

1. Seguire la guida di avvio rapido per creare una knowledge base. Non completare l'ultima sezione relativa alla creazione di un bot. Usare invece questa esercitazione per creare un bot con Power Virtual Agents.

   

   Immettere le impostazioni della knowledge base pubblicata disponibili nella pagina Settings (Impostazioni) del portale di QnA Maker. Queste informazioni saranno necessarie nel passaggio in Power Automate per configurare la connessione a GenerateAnswer di QnA Maker.

2. Nella pagina Settings (Impostazioni) del portale di QnA Maker trovare la chiave e l'host dell'endpoint e l'ID knowledge base.

Creare un bot in Power Virtual Agents

Power Virtual Agents consente ai team di creare bot avanzati usando un'interfaccia grafica guidata senza codice. Non sono necessari data scientist o sviluppatori.

Creare un bot seguendo la procedura descritta in Creare ed eliminare i bot di Power Virtual Agents.

Creare l'argomento di fallback di sistema

In Power Virtual Agents si crea un bot con una serie di argomenti (aree soggette), per rispondere alle domande degli utenti eseguendo azioni.

Anche se il bot può connettersi all'knowledge base da qualsiasi argomento, questa esercitazione usa l'argomento di fallback di sistema. L'argomento di fallback viene usato quando il bot non riesce a trovare una risposta. Il bot passa il testo dell'utente all'API di GenerateAnswer QnA Maker, riceve la risposta dal knowledge base e lo visualizza all'utente come messaggio.

Creare un argomento di fallback seguendo la procedura descritta in Configurare l'argomento di fallback di sistema in Power Virtual Agents.

Usare il canvas di creazione per aggiungere un'azione

Usare il canvas di creazione di Power Virtual Agents per connettere l'argomento di fallback alla knowledge base. L'argomento inizia con il testo utente non riconosciuto. Aggiungere un'azione che passa tale testo a QnA Maker e quindi mostra la risposta come messaggio. L'ultimo passaggio per la visualizzazione di una risposta è trattato come passaggio separato più avanti in questa esercitazione.

Questa sezione crea il flusso della conversazione sull'argomento di fallback.

1. La nuova azione di fallback potrebbe già includere elementi del flusso della conversazione. Eliminare l'elemento Escalate (Escalation) selezionando il menu Options (Opzioni).

   

2. Sopra il nodo Messaggio selezionare l'icona più (+) e quindi selezionare Chiama un'azione.

   

3. Selezionare Crea un flusso. Il processo passa al portale di Power Automate.

   

   Power Automate apre un nuovo modello. Tuttavia, non si userà questo nuovo modello.

   

Creare un flusso Power Automate per la connessione alla knowledge base

Nota

Attualmente il modello Power Automate non supporta gli endpoint di QnA Maker gestito (anteprima). Per aggiungere una knowledge base di QnA Maker gestito (anteprima) a Power Automate, ignorare questo passaggio e aggiungervi manualmente gli endpoint.

La procedura seguente crea un flusso Power Automate che:

• Accetta il testo utente in ingresso e lo invia a QnA Maker.
• Restituisce la risposta superiore al bot.

1. In Power Automate selezionare Modelli dal riquadro di spostamento a sinistra. Se viene chiesto se si vuole uscire dalla pagina del browser, accettare e uscire.

2. Nella pagina Modelli cercare il modello Generate answer using QnA Maker (Genera risposta usando QnA Maker) quindi selezionare il modello. Questo modello include tutti i passaggi per chiamare QnA Maker con le impostazioni della Knowledge base e restituire la prima risposta.

3. Nella nuova schermata per il flusso di QnA Maker selezionare Continuare.

   

4. Selezionare la casella dell'azione Generate Answer (Genera risposta) e specificare le impostazioni di QnA Maker da una sezione precedente intitolata Creare e pubblicare una Knowledge base. L'host servizio nell'immagine seguente si riferisce all'host della Knowledge base Host ed è espresso nel formato https://YOUR-RESOURCE-NAME.azurewebsites.net/qnamaker.

   

5. Selezionare Salva per salvare il flusso.

Creare una soluzione e aggiungere il flusso

Per trovare e connettersi al flusso, il flusso deve essere incluso in una soluzione Power Automate.

1. Sempre nel portale di Power Automate selezionare Soluzioni nel riquadro di spostamento sinistro.

2. Selezionare + Nuova soluzione.

3. Immettere un nome visualizzato. L'elenco di soluzioni include tutte le soluzioni dell'organizzazione o dell'istituto di istruzione. Scegliere una convenzione di denominazione che consenta di filtrare solo le proprie soluzioni. Si può ad esempio aggiungere al nome della soluzione il proprio indirizzo di posta elettronica come prefisso: jondoe-power-virtual-agent-qnamaker-fallback.

4. Selezionare il server di pubblicazione nell'elenco di opzioni.

5. Accettare i valori predefiniti per il nome e la versione.

6. Selezionare Crea per completare il processo.

Aggiungere il flusso alla soluzione

1. Nell'elenco di soluzioni selezionare la soluzione appena creata. Dovrebbe trovarsi all'inizio dell'elenco. In caso contrario, eseguire una ricerca in base al nome dell'indirizzo di posta elettronica, che fa parte del nome della soluzione.

2. Nella soluzione selezionare + Aggiungi esistente e quindi Flusso nell'elenco.

3. Trovare il flusso nell'elenco Esterni alle soluzioni, quindi selezionare Aggiungi per completare il processo. Se sono presenti molti flussi, esaminare la colonna Modificato per trovare quello più recente.

Aggiungere il flusso della soluzione a Power Virtual Agents

1. Tornare alla scheda del browser con il bot in Power Virtual Agents. Il canvas di creazione dovrebbe essere ancora aperto.

2. Per inserire un nuovo passaggio nel flusso, sopra la casella azione Messaggio selezionare l'icona più (+) . Selezionare quindi Call an action (Chiama un'azione).

3. Dalla finestra popup Flusso selezionare il nuovo flusso denominato Generate answers using QnA Maker knowledge base... (Genera risposte usando la Knowledge base di QnA Maker). La nuova azione verrà visualizzata nel flusso.

   

4. Per impostare correttamente la variabile di input sull'azione di QnA Maker, selezionare Selezionare una variabile, quindi selezionare bot.UnrecognizedTriggerPhrase.

   

5. Per impostare correttamente la variabile di output sull'azione di QnA Maker, nell'azione Messagge (Messaggio) selezionare UnrecognizedTriggerPhrase, quindi selezionare l'icona per inserire una variabile, {x}, e infine FinalAnswer.

6. Selezionare Save (Salva) sulla barra degli strumenti contestuale per salvare i dettagli del canvas di creazione per l'argomento.

Ecco l'aspetto dell'area di disegno del bot finale.

Testare il bot

Durante la progettazione del bot in Power Virtual Agents, è possibile usare il riquadro Test bot per vedere come il bot guida un cliente tramite la conversazione bot.

1. Nel riquadro di test attivare Track between topics (Traccia tra argomenti). In questo modo è possibile controllare l'avanzamento tra argomenti, nonché all'interno di un singolo argomento.

2. Testare il bot immettendo il testo dell'utente nell'ordine seguente. Il canvas di creazione segnala i passaggi corretti con un segno di spunta verde.

   Ordine delle domande	Domande di test	Scopo
   1	Ciao	Avviare la conversazione
   2	Orari di apertura	Argomento di esempio. Viene configurato automaticamente senza operazioni aggiuntive da parte dell'utente.
   3	Sì	In risposta a Did that answer your question?
   4	Eccellenti	In risposta a Please rate your experience.
   5	Sì	In risposta a Can I help with anything else?
   6	Come è possibile migliorare le prestazioni di velocità effettiva per le previsioni delle query?	Questa domanda attiva l'azione di fallback, che invia il testo alla knowledge base per la risposta. Viene quindi visualizzata la risposta. i segni di spunta verdi per le singole azioni indicano l'esito positivo di ogni azione.

   

Pubblicare il bot

Per rendere disponibile il bot a tutti i membri dell'istituto di istruzione o dell'organizzazione, è necessario pubblicarlo .

Pubblicare il bot seguendo la procedura descritta in Pubblicare il bot.

Condividere il bot

Per rendere disponibile il bot ad altri utenti, è prima necessario pubblicarlo in un canale. Per questa esercitazione si userà il sito Web demo.

Configurare il sito Web demo seguendo la procedura descritta in Configurare un chatbot per un sito Web live o demo.

È quindi possibile condividere l'URL del sito Web con i membri dell'istituto di istruzione o dell'organizzazione.

Pulire le risorse

Dopo aver completato le operazioni con la knowledge base, rimuovere le risorse di QnA Maker dal portale di Azure.

Passaggio successivo

Ottenere analisi sulla Knowledge Base

Altre informazioni su:

• Power Virtual Agents
• Power Automate
• Connettore di QnA Maker e impostazioni per il connettore