Domande e risposte

Nota

A partire dalla Release 22.04, la funzione Q&A viene gradualmente disattivata e sostituita dalla funzione Knowledge. La funzione Knowledge presenta vantaggi significativi rispetto alla funzione Q&A, vale a dire:

È possibile generare gli intenti di risposta nella competenza direttamente dalle domande frequenti o dai documenti della Knowledge Base esistenti. Non è necessario formattare manualmente tali documenti prima di importarli nello skill. Inoltre, vengono generate espressioni di esempio per ogni intento.
Nelle conversazioni con lo skill, gli intenti di risposta generati vengono risolti con l'NLP come intenti normali. Non sono necessarie proprietà o componenti specifici di domande e risposte per gestire tali intenti.

Inoltre, la funzione Q&A non funziona nei flussi di dialogo sviluppati in modalità Visual.

Se si dispone di uno skill esistente con un modulo Q&A, è possibile continuare a utilizzare il modulo Q&A nelle versioni future dello skill. Si consiglia tuttavia di passare all'utilizzo degli intenti di risposta (con l'aiuto della funzione Knowledge o creando manualmente gli intenti di risposta). Vedere Rispondi intenti.

La funzione Domande e risposte consente di rispondere alle domande di interesse generale restituendo una o più coppie di domande e risposte. È un modo per utilizzare un'abilità per individuare le domande frequenti o altri documenti della knowledge base.

L'aggiunta di un modulo di domande e risposte alla tua abilità consente di valutare se l'input dell'utente è destinato a una transazione ("Qual è il mio saldo?") o di rispondere a una domanda ("Qual è l'indirizzo della banca?") e quindi rispondere in modo appropriato.

Aggiunta di domande e risposte a una competenza

Di seguito viene fornita una panoramica di come aggiungere domande e risposte a uno skill utilizzando la funzione Domande e risposte.

Abilitare la funzionalità di domande e risposte facendo clic su Domande e risposte () nella barra di navigazione a sinistra. quindi fare clic su Aggiungi domande e risposte.

Nota

Ciò è possibile solo negli skill creati in modalità finestra di dialogo YAML.
Caricare i file di origine (formattati come CSV) che contengono le coppie di domande e risposte categorizzate. Creare il file di origine dati descrive il formato e fornisce alcune linee guida sul contenuto.

Descrizione della figura add-qna-source.png
Se necessario, è possibile modificare le domande e le risposte. È inoltre possibile aggiungere o eliminare domande e risposte.

Descrizione dell'immagine edit-qna-questions.png
Addestrare la competenza con il formatore Q&A.

Descrizione dell'immagine train-w-qna.png
Testare la nuova funzionalità di domande e risposte inserendo le domande nel tester domande e risposte. Nell'ambito del processo di test, è necessario aggiungere domande alternative all'origine dati per migliorare la capacità di riconoscimento delle domande. È necessario ripetere l'addestramento se si aggiunge o si modifica qualcosa dall'origine dati.
Per utilizzare domande e risposte in un flusso della finestra di dialogo skill, è necessario configurare il componente System.Qna. È inoltre necessario aggiungere una nuova transizione al componente System.Intent che fa riferimento a questo nuovo componente, in modo che le domande di Q&A vengano instradate al componente Q&A. Vedere Come configurare il flusso di finestre di dialogo per le domande e risposte.

Descrizione dell'illustrazione intent-qna-state.png

Aggiungere uno stato per l'azione none e impostare di nuovo la transizione al componente Q&A alla risposta alla domanda aggiungendo qna per la transizione next:

  qna:
    component: "System.QnA"
      transitions:
        actions:
          none: "unresolved"
          next: "qna"
  unresolved:
    component: "System.Output"
      properties:
      text: "Sorry, I did not find any match. Can you rephrase the question?"
    transitions:
      return: "done"

Metti alla prova l'abilità.

Creare il file dell'origine dati

Il file di origine dati per il contenuto di domande e risposte deve essere un file CSV con codifica UTF-8. Questo file ha una riga di intestazione i cui valori sono (da sinistra a destra) category_path, questions e content.

Colonna Contenuto

Colonna	Contenuto
`category_path`	Categoria (o categorie) per una determinata coppia di domande e risposte (Domande e risposte). Quando una coppia di domande e risposte appartiene a più di una categoria, aggiungere ciascuna delle categorie sulla nuova linea. Utilizzare una barra (/) per indicare una gerarchia. Ad esempio: `Trading/Placing Order`.
`questions`	Le domande visualizzate per l'utente. Aggiungere ogni versione alternativa di questa domanda su una nuova riga. La prima domanda, nota come domanda canonica, è la domanda che viene visualizzata nel messaggio dello skill per impostazione predefinita. Le domande successive nella colonna sono versioni alternative.
`content`	Le risposte.

category_path

Categoria (o categorie) per una determinata coppia di domande e risposte (Domande e risposte).

Quando una coppia di domande e risposte appartiene a più di una categoria, aggiungere ciascuna delle categorie sulla nuova linea.

Utilizzare una barra (/) per indicare una gerarchia. Ad esempio: Trading/Placing Order.
Immagine di un file CSV.

questions

Le domande visualizzate per l'utente. Aggiungere ogni versione alternativa di questa domanda su una nuova riga. La prima domanda, nota come domanda canonica, è la domanda che viene visualizzata nel messaggio dello skill per impostazione predefinita. Le domande successive nella colonna sono versioni alternative.
Questa è un'immagine del file CSV.

content

Le risposte.

È possibile modificare il file dell'origine dati dopo averlo importato.

Descrizione di edit-qna-question-dialog.png segue

Descrizione dell'immagine edit-qna-question-dialog.png

Linee guida per le origini dati

L'aggiunta di più domande per ogni risposta aumenta la probabilità che le coppie di domande e risposte pertinenti vengano restituite agli utenti. Crea 2-5 domande per ogni risposta. Fornire domande sufficienti per coprire un campione dei diversi modi in cui ci si aspetta che l'utente chieda informazioni su un argomento. Considera la possibilità di variare il soggetto (ma sii coerente con l'argomento della risposta), il verbo e gli interrogativi come "come", "cosa", "dove", ecc. Ad esempio, Come determinare l'importo disponibile può essere definito come:
- Come posso ottenere il saldo del mio conto?
- Dove posso trovare il saldo del mio conto?
- Posso ottenere il saldo del mio conto?
Ricorda che anche se le domande possono essere inquadrate in modo diverso, dovrebbero restituire tutte le stesse risposte.
Non è necessario creare domande alternative solo per adattarsi a parole, sinonimi o errori di battitura comunemente usati. È possibile utilizzare la pagina Configurazione lingua per aggiungere sinonimi o abbreviazioni. Gli errori di battitura vengono gestiti automaticamente.
Mantenere le risposte il più breve possibile. Fornisci un link per maggiori informazioni. I collegamenti a domande e risposte non possono essere nascosti, il che significa che non è possibile utilizzare <a href> per specificare un nome di sito. I collegamenti devono essere espliciti (ad esempio, http://www.myanswers.com/answer/topic1.html).
Usa sempre solo testo.
Gli utenti sono interessati alle prime tre partite per ottenere le informazioni che desiderano. Mentre dovresti concentrarti sulla prima partita, l'obiettivo dovrebbe essere quello di garantire che le informazioni richieste e correlate siano nelle prime tre partite.
Creare un file di test batch ogni volta che si aggiorna l'origine dati. Questo file batch contiene tutte le domande a cui si desidera assicurarsi che la propria abilità risponda correttamente. Per ulteriori informazioni su questo file, vedere Creare il file CSV per il test batch.

Gestione moduli e origini dati Q&A

Aggiungi altre origini dati

Puoi aggiungere altre domande e risposte per espandere la tua capacità di domande e risposte. Per caricare un altro file CSV con codifica UTF-8 in una nuova origine dati Q&A:

Fare clic su Domande e risposte () nella barra di navigazione a sinistra.
Selezionare la scheda Origini dati, quindi fare clic su Aggiungi origine domande e risposte.
Completare la finestra di dialogo immettendo una lingua, le impostazioni nazionali (se necessario) e il file dell'origine dati.
È possibile aggiungere batch di origini dati scegliendo Crea altro.
Per impostazione predefinita, l'origine dati è abilitata. Se è necessario rimuovere temporaneamente le coppie di domande e risposte dall'origine dati, è possibile scegliere Disabilitato anziché eliminare l'origine dati.
Fare clic su Crea.
Ritira domande e risposte.

Modificare i parametri di configurazione dell'origine dati Q&A

Fare clic su Domande e risposte () nella barra di navigazione a sinistra.
Selezionare la scheda Origini dati.
Passare il puntatore del mouse sull'origine dati per richiamare le icone Modifica ed Elimina.
Fare clic Modifica.
Eseguire una delle operazioni riportate di seguito, quindi fare clic su Salva.
- Modificare la lingua e le impostazioni nazionali.
- Rinominare l'origine.
- Sovrascrivere il file di origine esistente facendo clic su Sostituisci e selezionando un nuovo file.
- Abilitazione o disabilitazione dell'origine.
Riavviare il modulo Q&A.

Descrizione di edit-data-source-dialog.png

Descrizione dell'immagine edit-data-source-dialog.png

Aggiungi domande e risposte una per una

Nella scheda Origini dati, fare clic sull'origine dati.
Fare clic su View All Q&A.
Fare clic su Aggiungi domanda.
Completare la finestra di dialogo come riportato di seguito, quindi fare clic su Crea.
- Domanda canonica: immettere la domanda visualizzata per impostazione predefinita nella chat.
- Alternativa: aggiunge una o più variazioni alla domanda canonica. Tieni presente che devi solo concentrarti su come gli utenti potrebbero porre la stessa domanda in modi diversi, non su come accogliere sinonimi o errori di ortografia comuni.
- Risposta: consente di aggiungere una risposta concisa. Al posto di una lunga spiegazione, aggiungere un URL che punti gli utenti a informazioni più dettagliate. Questo URL verrà visualizzato come testo normale nella finestra del tester, ma verrà visualizzato come collegamento ipertestuale quando lo skill viene eseguito su una piattaforma di messaggistica effettiva.
- Categorie: se applicabile, inserire una categoria o sceglierne una dal menu. Il menu viene popolato con le categorie del file dell'origine dati.
- Per le gerarchie, immettere una stringa con barre in avanti (/).
- Crea un'altra: selezionare questa opzione per aprire una nuova finestra di dialogo dopo aver fatto clic su Crea.
Ritira domande e risposte.
Fare clic su Chiudi nella scheda Origini dati.

Segue la descrizione dell'immagine add-question-category.png

Descrizione dell'illustrazione add-question-category.png

Nota

Tenere presente che queste coppie di domande e risposte vengono visualizzate entro i limiti di una finestra di chat, quindi mantenerle corte. Vedere Linee guida per le origini dati.

Modifica domande e risposte una per una

Anche se la maggior parte dello sviluppo dei contenuti viene eseguita utilizzando il file di origine stesso, è possibile aggiungere aggiornamenti utilizzando la scheda Origini dati.

Nella scheda Origini dati, accedere alla pagina della domanda o individuarla utilizzando uno dei campi di ricerca (categorie, domande e risposte).
Passare il puntatore del mouse sulla domanda, quindi fare clic su Modifica.
Utilizzare la finestra di dialogo Modifica domanda per:
- Cambiare la domanda canonica.
- Aggiungere altre domande alternative.
- Modificare la risposta.
- Aggiungi o rimuovi categorie.
Fare clic suSalva.
Riavviare il modulo Q&A.
Fare clic su Chiudi nella scheda Origini dati.

Nota

È inoltre possibile aggiungere domande alternative utilizzando il tester.

Descrizione dell'immagine edit-qna-question-dialog.png

Esporta data set domande e risposte

È possibile esportare l'intero set di dati Q&A a scopo di controllo della versione, archiviazione e backup.

Nella scheda Origini dati fare clic su Visualizza tutte le domande e risposte.
Scegliere il file dell'origine dati nel riquadro sinistro.
Fare clic su Export, quindi salvare il file sul sistema.
Fare clic su Chiudi.

Accuratezza migliorata con abbreviazioni e parole ignorate

Includiamo set integrati di parole ignorate, abbreviazioni e sinonimi per migliorare l'accuratezza della funzionalità di domande e risposte. Le parole ignorate vengono escluse dall'algoritmo di corrispondenza in modo da non ridurre l'accuratezza. Gli elenchi di abbreviazioni e sinonimi vengono utilizzati per far corrispondere le domande utente che contengono queste parole. Anche se i set integrati possono essere sufficienti per molte abilità, è possibile aggiungerli a questi set per situazioni uniche.

Le aggiunte a questi set vengono effettuate utilizzando la pagina Configurazione lingua. Da questa pagina è possibile modificare gli elenchi di parole, abbreviazioni e sinonimi ignorati.

Di seguito è riportata la descrizione di language-config-page.png

Descrizione dell'immagine language-config-page.png

Aggiungi parole, sinonimi e abbreviazioni ignorati

Selezionare la scheda Configurazione lingua.
Fare clic su Aggiungi voce di configurazione.
Completare la finestra di dialogo:
- Lingua: selezionare una delle lingue disponibili, rese disponibili dalle origini dati.
- Tipo:
  - Parole ignorate: aggiunge parole che non aggiungono valore alle domande. Le parole devono essere in minuscolo.
  - Sinonimi: includere termini slang e parole alternative per ogni parola chiave nell'origine dati. Creare una voce separata per ogni set di sinonimi. Ad esempio, denaro, moolah, verde è una voce separata da coniuge, moglie, marito, partner.
    
    Descrizione dell'immagine sinonimo-entries.png
  - Abbreviazioni: tenere presente che le domande canoniche potrebbero non prevedere abbreviazioni.
- Definizione: immettere i termini specifici del tipo (sinonimi, parole ignorate o abbreviazioni).
- Abilitato: abilita o disabilita le aggiunte apportate ai set di parole, abbreviazioni o sinonimi ignorati. Utilizzare questa opzione quando si eseguono i test delle configurazioni della lingua.
- Crea un altro: selezionare questa opzione per tornare a questa finestra di dialogo dopo aver fatto clic su Crea.
Fare clic su Crea.
Riavviare il modulo Q&A.

Descrizione dell'immagine add-config-dialog.png

Test domande e risposte

La finestra Domande e risposte del tester consente di eseguire il test delle domande una alla volta o in batch.

Dopo aver addestrato il modulo Q&A, è possibile eseguirne il test utilizzando il tester Try Out Intents/Q&A (a cui è possibile accedere facendo clic su Try It Out!). La risposta skill può includere una giostra con più risposte. A differenza del test degli intenti, le risposte alle domande di domande e risposte non sono categorie di intenti (ad esempio, saldi), ma sono invece risposte testuali fornite dalla riga content nel file CSV.

La funzionalità Domande e risposte (non Intent Engine) gestisce le risposte alle espressioni immesse. Queste risposte sono costituite da una serie di domande canoniche che rappresentano gli argomenti più adatti (le risposte fornite dalla colonna content nel file CSV). Queste domande canoniche sono le prime domande immesse nel campo questions del file CSV associate a ciascun argomento (ovvero, la risposta nel campo content nel file CSV).
Descrizione di qna-tester-w-precision.png:
Descrizione dell'immagine qna-tester-w-precision.png

Test di una corrispondenza Q&A

Addestrare il modulo Q&A.
Aprire il tester facendo clic su Prova, quindi scegliendo Domande e risposte.
Fare clic su Domande e risposte.
Facoltativamente, fare clic su per impostare le opzioni per la lingua e la precisione della corrispondenza:
- Lingua: scegliere una lingua (se esistono origini dati multilingue).
- Soglie di corrispondenza: fare clic su Modifica per impostare la percentuale minima e massima di token che una coppia di domande e risposte deve contenere per essere considerata una corrispondenza (ovvero una corrispondenza di domande e risposte).
- Campi corrispondenza: fare clic su Modifica per selezionare il campo (o i campi) Domande e risposte che devono corrispondere al messaggio utente. Sono disponibili le seguenti opzioni:
  - Tutto: restituisce le domande e le risposte in cui le parole chiave dell'input utente corrispondono a qualsiasi categoria, domanda o risposta di domande e risposte.
  - Domande: restituisce le domande e le risposte in cui le parole chiave dell'input utente corrispondono alle domande di domande e risposte.
  - Risposte: restituisce le domande e le risposte in cui le parole chiave nell'input utente corrispondono alla risposta Q&A.
  - Categorie: restituisce le domande e le risposte in cui le parole chiave nell'input utente corrispondono a una categoria di domande e risposte.
  - Domande e categorie: restituisce le domande e le risposte in cui le parole chiave nell'input utente corrispondono alla categoria Domande e risposte o alla risposta Domande e risposte.
Immettere un enunciato, quindi fare clic su Invia.
Se necessario, fare clic su Aggiungi a domanda, quindi rieseguire il training del modulo Q&A.

Crea file CSV per test batch

Per il test in batch, si esegue il test delle competenze utilizzando un file CSV contenente le domande a cui la competenza deve rispondere correttamente insieme alle domande canoniche (corrispondenze domande e risposte) restituite dalla competenza per priorità. Il file CSV descrive questa operazione utilizzando una riga di intestazione le cui colonne (da sinistra a destra) sono: languageTag, question, match-1, match-2, match-3 e così via.

Descrizione di export-qna-conversation.png riportata di seguito

Descrizione dell'immagine export-qna-conversation.png

languageTag: codice di cinque lettere che rappresenta la lingua e le impostazioni nazionali in cui vengono espresse la domanda di test e le domande di corrispondenza. Ad esempio, en-US.
question: la domanda del test. Questa domanda non deve corrispondere a nessuna delle domande di formazione, ma deve rappresentare una domanda tipica che un utente potrebbe porre per l'argomento specificato.
match-1 match-2 …: la prima delle domande canoniche che si ritiene la domanda di test dovrebbe recuperare. Mostriamo le domande canoniche per tutte le partite di domande e risposte. Se la domanda di test deve restituire solo una singola corrispondenza Q&A, immettere la domanda nella colonna match-1 e lasciare vuote le colonne di corrispondenza rimanenti.
queryInfo: un oggetto JSON che utilizza offset e categoryPath per il drill-down e l'offset di una categoria e il limite per l'impaginazione.
```
"{""offset"":0,""categoryPath"":[""General Account Information""],""limit"":3}"
```

Questo CSV rappresenta la baseline per le corrispondenze Q&A previste. Utilizzarla in diverse versioni della competenza per garantire un comportamento coerente. È possibile aggiungere i dati manualmente oppure modificare il log delle conversazioni di domande e risposte. Test batch del modulo Q&A descrive come ottenere questo file e modificarlo con il tester. Una volta completato il set d'oro, gli aggiornamenti devono riflettere solo aggiornamenti significativi all'origine dati Q&A.

Test batch del modulo Q&A

Se si esegue il test con un file CSV derivato dal log delle conversazioni QnA, è necessario effettuare le operazioni riportate di seguito.

Aggiungere e configurare il componente System.Qna nel flusso della finestra di dialogo, quindi chattare con la competenza per creare una cronologia delle conversazioni.
Chatta con l'abilità per creare la cronologia delle conversazioni.
Esportare il log delle conversazioni QnA utilizzando il menu nella casella della competenza scegliendo l'opzione QnA Log delle conversazioni nella finestra di dialogo Esporta log delle conversazioni.

Per eseguire il test in batch:

Nella finestra di test Q&A, attivare o disattivare il batch.
Selezionare la lingua.
Fare clic su Carica.
Impostare le opzioni di test nella finestra di dialogo Carica QnA, quindi fare clic su Test.
- Numero massimo di test concorrenti: il numero di test eseguiti in parallelo. L'aumento del numero di test simultanei può accelerare i test, ma può anche gravare sul sistema.
- Corrispondenze da includere: imposta il numero di corrispondenze di domande e risposte incluse nel test.
- Richiedi corrispondenze nello stesso ordine: consente di passare o non riuscire una corrispondenza a seconda della sua inclusione o della sua posizione all'interno delle corrispondenze di primo livello.
- Nella sua posizione off, questa opzione consente di verificare le corrispondenze quando gli utenti immettono parole chiave anziché domande complete.
- Soglie di corrispondenza: fare clic su Modifica per impostare la percentuale minima e massima di token che una coppia di domande e risposte deve contenere per essere considerata una corrispondenza (ovvero una corrispondenza di domande e risposte).
  
  Suggerimento
  Impostare qui lo stesso valore impostato per le proprietà qnaMiniumumMatch e minimumMatch. Per ulteriori informazioni sull'impostazione dei vari livelli, vedere System.Intent e System.Qna.
- Campi corrispondenza: fare clic su Modifica per selezionare il campo (o i campi) Domande e risposte che devono corrispondere al messaggio utente. Sono disponibili le seguenti opzioni:
  - Tutto: restituisce le domande e le risposte in cui le parole chiave dell'input utente corrispondono a qualsiasi categoria, domanda o risposta di domande e risposte.
  - Domande: restituisce le domande e le risposte in cui le parole chiave dell'input utente corrispondono alle domande di domande e risposte.
  - Risposte: restituisce le domande e le risposte in cui le parole chiave nell'input utente corrispondono alla risposta Q&A.
  - Categorie: restituisce le domande e le risposte in cui le parole chiave nell'input utente corrispondono a una categoria di domande e risposte.
  - Domande e categorie: restituisce le domande e le risposte in cui le parole chiave nell'input utente corrispondono alla categoria Domande e risposte o alla risposta Domande e risposte.
  Descrizione dell'immagine load-qna-dialog.png
  
  I test non riusciti vengono visualizzati nella parte superiore dei risultati.
  
  Descrizione dell'immagine qna-drilldown-success.png
Per le corrispondenze domande e risposte che superano, è possibile eseguire il drill-down e aggiungere domande alternative, modificare le risposte e quindi riaddestrare il modulo Domande e risposte. Queste aggiunte vengono effettuate all'origine dati che semina la competenza, non ai dati di test.

Descrizione dell'immagine qna-test-alt-question-add.png

Come configurare il flusso della finestra di dialogo per Q&A

Il menu Aggiungi componenti, disponibile nella parte superiore sinistra della pagina del flusso della finestra di dialogo, consente di supportare le domande e le risposte in un flusso della finestra di dialogo Modalità YAML aggiungendo uno dei tre modelli di componente seguenti:

Intento e QnA: aggiunge il componente System.Intent ma con proprietà che impostano l'instradamento di transizione al componente Q&A quando l'espressione viene determinata come domanda e non come richiesta transazionale. In Proprietà domande e risposte per il componente System.Intent vengono descritte queste proprietà e in Creazione di uno skill con flussi di intenti e domande e risposte viene descritto il processo complessivo per la creazione di uno skill con intento e funzioni di domande e risposte.
QnA: aggiunge un modello configurato in modo minimo per un componente System.Intent.
QnA Avanzato: simile al modello QnA, ma fornisce proprietà facoltative per un controllo con filtro più avanzato:
- Configurazione keepTurn per la rinuncia o la conservazione del controllo dello skill sul flusso della finestra di dialogo.
- Modularità (chiamando un'abilità Q&A dedicata). Vedere Competenze domande e risposte riutilizzabili.
- QnA dimensionamento e impaginazione.

Per aggiungere i seguenti modelli:

Fare clic su Flussi nella barra di navigazione a sinistra.
Fare clic su Aggiungi componenti nell'angolo superiore sinistro della pagina. (Potrebbe essere necessario scorrere verso l'alto se questo pulsante non è visibile).
Scegliere la tavolozza dei componenti Lingua.
Scegliere uno dei tre modelli di domande e risposte, quindi utilizzare il menu Inserisci dopo per posizionarlo nella definizione del flusso della finestra di dialogo. Fare clic su Applica.
Nota

Per implementare il supporto Q&A, è necessario aggiungere un nuovo componente System.Intent (utilizzando il modello Intento e QnA) alla definizione del flusso della finestra di dialogo oppure modificare un componente System.Intent esistente per abilitare le transizioni al componente Q&A.

Creazione di una competenza con flussi di intento e domande e risposte

Aggiungere il modello Intento con QnA al flusso della finestra di dialogo (a cui si accede dalla lingua).
Per il componente System.Intent, definire quanto segue:
- Aggiungere qnaEnable: true per abilitare il router:
```
intent:
  component: "System.Intent"
  properties:
    variable: "iResult"
    qnaEnable: true
```
- Impostare un'azione di transizione sullo stato QnA:
```
    transitions:
      actions:
        Balances: "startBalances"
        Transactions: "startTxns"
        Send Money: "startPayments"
        Track Spending: "startTrackSpending"
        Dispute: "setDate"
        unresolvedIntent: "unresolved"
        qna: "qna"
```
  Se la risoluzione dell'intento è inferiore alla soglia di affidabilità, lo skill attiva l'azione qna che il motore della finestra di dialogo ha impostato sullo stato qna. In questo caso, il messaggio dello skill include solo il collegamento Visualizza risposte.
```
qna:
    component: "System.QnA"
    transitions:
      actions:
        none: "unresolved"
      next: "intent"
unresolved:
    component: "System.Output"
    properties:
      text: "Sorry I don't understand that question!"
    transitions:
      return: "unresolved"
```
  Ma quando Intent Engine è in grado di risolvere il messaggio al di sopra della soglia di affidabilità e di corrispondere a una domanda e un'offerta, il messaggio dello skill include collegamenti per l'intento e la risposta alla domanda e all'accordo.
  
  Descrizione dell'immagine prioritized-intent-response.png
  Tuttavia, quando Intent Engine classifica il messaggio come richiesta anziché come domanda, lo skill ignora le domande e gli invii al flusso di intenti. In questo caso, il messaggio include solo l'opzione Intento.
  È possibile modificare questo comportamento aggiungendo parole e frasi che chiariscono l'instradamento dell'intento e impostando la proprietà qnaSkipIfIntentFound di System.Intent.

Esempi di finestra di dialogo Q&A

Instradamento domande e risposte per il componente System.Intent

Il seguente snippet mostra come il router viene attivato dalla proprietà qnaEnable del componente System.Intent. Mostra anche la transizione allo stato con il modulo Q&A e lo stato Q&A stesso.


...
  mainIntent:
    component: "System.Intent"
    properties:
      variable: "userInput"
      sourceVariable: "translated"
      qnaEnable: true
      qnaMatchFields: "categories+questions"
    transitions:
      actions:
        Greeting: "greeting"
        Inspire Me: "recommendCategories"
        Returns: "startReturn"
        qna: "qna"
        View Reports: "setMobilePhone"
        TrackOrders: "showOrderStatus"
        unresolvedIntent: "unresolved"
        Vision: "visionBasedProducts"
        Shipping: "startShipping"
...
  qna:
    component: "System.QnA"

Supporto estero e multilingue per Q&A

Utilizzare questa configurazione per le competenze che supportano una o più lingue straniere.

Creare un file di origine dati specifico per la lingua di destinazione.
Nota

Le origini dati in lingua cinese non sono supportate.
Se necessario, aggiungere eventuali sinonimi o aggiornare le parole ignorate.
Configurare un servizio di traduzione. Vedere Aggiungere un servizio di traduzione alla competenza.
Se lo skill include anche funzioni transazionali, regolare la configurazione del ciclo.

Configurare il flusso della finestra di dialogo per il supporto multilingua. Ad esempio:

metadata:
  platformVersion: "1.0"
main: true
name: "ChipCardMultipleLingualQnA"
context:
  variables:
    greeting: "string"
    name: "string"
    cancelChoice: "string"
    rb: "resourcebundle"
states:
  detect:
    component: "System.DetectLanguage"
    properties:
      ...
    transitions:
      ...
  qna:
    component: "System.QnA"
    properties:
      botName: "ChipCardMultipleLingualQnA"
      matchFields: "categories+questions"
      viewAnswerLabel: "${rb.viewAnswerLabel}"
      moreAnswersLabel: "${rb.moreAnswersLabel}"
    transitions:
      actions:
        none: "unresolved"
      next: "detect"
  unresolved:
    component: "System.Output"
    properties:
      text: "${rb.NoMatch}"
    transitions:
      return: "done"

Competenze Q&A riutilizzabili

È possibile modulare le definizioni del flusso della finestra di dialogo creando competenze di domande e risposte riutilizzabili che possono essere richiamate utilizzando le proprietà botName e QnaBotName appartenenti ai componenti System.Intent e System.QnA.

Esempio: proprietà botName

...
states:
  qna:
    component: "System.QnA"
    properties:
      botName: "FinancialQnABot"
    transitions:
      actions:
        none: "unresolved"
      next: "qna"
  unresolved:
    component: "System.Output"
    properties:
      text: "Sorry, I did not find any match. Can you rephrase the question?"
    transitions:
      return: "done"

Esempio: botName e QnABotName

In questo snippet, botName e QnABotName hanno entrambi lo stesso valore.

states:
  intent:
    component: "System.Intent"
    properties:
      botName: "FinancialQnABot"
      qnaMatchFields: "categories+questions"
      variable: "iResult"
      qnaEnable: true
    transitions:
      actions:
        Balances: "startBalances"
        Transactions: "startTxns"
        Send Money: "startPayments"
        Track Spending: "startTrackSpending"
        Dispute: "setDate"
        unresolvedIntent: "unresolved"
        qna: "qna"
...

  qna:
    component: "System.QnA"
    properties:
      botName: "FinancialQnABot"
      matchFields: "categories+questions"   
    transitions:
      actions:
        none: "unresolved"
      next: "intent"

Esempio: botName e qnaBotName in System.Intent

Questo snippet mostra la proprietà botName in due contesti diversi: nel componente System.Intent, in cui chiama una competenza transazionale e nel componente System.Qna, in cui chiama una competenza Q&A.

states:
  intent:
    component: "System.Intent"
    properties:
      botName: "FinancialBot"
      qnaBotName: "FinancialQnABot"
      variable: "iResult"
      qnaEnable: true
    transitions:
      actions:
        Balances: "startBalances"
        Transactions: "startTxns"
        Send Money: "startPayments"
        Track Spending: "startTrackSpending"
        Dispute: "setDate"
        unresolvedIntent: "unresolved"
        qna: "qna"
...

  qna:
    component: "System.QnA"
    properties:
      botName: "FinancialQnABot"   
    transitions:
      actions:
        none: "unresolved"
      next: "intent"

Configura instradamento intento e domande e risposte

Nella pagina Configurazione instradamento domande e risposte vengono fornite parole e frasi di apertura comunemente utilizzate che indicano comandi o domande. È possibile aggiungere a questa pagina il contenuto specifico del dominio che consente al router di distinguere tra domande e risposte e intenti. A questo scopo:

Fare clic su Impostazioni () nella barra di navigazione a sinistra.
Fare clic su Configurazione instradamento domande e risposte.
Selezionare una lingua.
Aggiungere o rimuovere parole e frasi nelle seguenti categorie che influiscono sull'instradamento dell'intento.
- Configurazione transazione: è possibile aggiungere verbi e frasi che consentono al modulo di gestione intenti di identificare un messaggio come transazione.
  - Verbi di richiesta aggiuntivi: i messaggi che iniziano con richieste o comandi quali acquisto, controllo o annullamento sono considerati transazionali e vengono instradati a un intento. Queste parole, che sono di umore imperativo, indicano una transazione, non una domanda.
    
    Manteniamo una libreria di verbi imperativi ampiamente utilizzati per ogni lingua supportata. Tra loro ci sono parole come pagare, rimuovere e terminare. È possibile aggiungere verbi di richiesta specifici dell'azienda o dell'audience.
  - Espansione del verbo della richiesta: set di prefissi (un, dis, re) che, quando vengono applicati i verbi della richiesta aggiunti nel campo Verbi richiesta aggiuntivi, aumentano il vocabolario che identifica un messaggio come vincolato all'intento.
  - Prefisso frase richiesta: parole e frasi associate alle richieste, ad esempio È possibile e Non. I messaggi che iniziano con queste parole vengono instradati come intenti. Manteniamo una libreria di queste parole e frasi orientate alle transazioni che puoi aggiornare.
    
    Descrizione dell'immagine request-verb-output.png
- Configurazione domanda: set di parole e frasi di uso comune in genere utilizzate nelle domande. Queste includono frasi come come faccio e come devo sapere. Indica che un utente fa una domanda, non richiede una transazione. Quando uno skill riceve un messaggio che inizia con uno di questi, ottimizza la risposta assegnando la priorità al collegamento per la risposta Q&A rispetto al collegamento per la risposta dell'intento. Di solito, il comportamento è il contrario: l'abilità dà il primo posto agli intenti che ottengono un punteggio superiore alla soglia di affidabilità configurata.
  
  Descrizione dell'immagine prioritized-qna-response.png
  Ad esempio, quando uno skill riceve Come terminare la polizza, è possibile distinguere facilmente che l'utente sta cercando informazioni e posiziona prima il collegamento Visualizza risposte.
  
  Quando l'input dell'utente è ambiguo, è possibile che il collegamento Domande e risposte non ottenga il primo posizionamento. Ad esempio, il router potrebbe non essere in grado di identificare è possibile terminare il criterio come intento o domande e risposte. Lo skill mostra entrambe le opzioni perché esiste un punteggio dell'intento al di sopra della soglia di affidabilità e una domanda corrispondente, ma classifica l'intento per primo.
  
  Descrizione dell'immagine prioritized-intent-response.png

Documentazione dell'infrastruttura Oracle Cloud