Le frasi di addestramento sono frasi di esempio per ciò che gli utenti finali potrebbero digitare o dire, definite espressioni dell'utente finale. Per ogni intent, crei molte frasi di addestramento. Quando un'espressione dell'utente finale assomiglia a una di queste frasi, Dialogflow corrisponde all'intent.
Ad esempio, la frase di addestramento "Voglio una pizza" insegna all'agente a riconoscere le espressioni dell'utente finale simili a questa frase, come "Prendi una pizza" o "Ordina pizza".
Non è necessario definire ogni possibile esempio, perché il machine learning integrato di Dialogflow si espande nell'elenco con altre frasi simili. Dovresti creare almeno 10-20 frasi di addestramento (a seconda della complessità dell'intent), in modo che il tuo agente possa riconoscere una varietà di espressioni dell'utente finale. Ad esempio, se vuoi che riconosca l'espressione di un utente finale sul suo colore preferito, puoi definire le seguenti frasi di addestramento:
- "Mi piace il rosso"
- "Il mio colore preferito è il giallo"
- "nero"
- "Il blu è il mio preferito"
- ...
Dove trovare questi dati
Durante la creazione di un agente, è più comune utilizzare Dialogflow ES Console (consulta la documentazione, apri la console). Le istruzioni riportate di seguito sono incentrate sull'utilizzo della console. Per accedere ai dati delle frasi di addestramento:
- Vai alla console Dialogflow ES.
- Seleziona un agente.
- Seleziona Intent nel menu della barra laterale a sinistra.
- Seleziona un intent.
- Scorri verso il basso fino alla sezione Frasi di addestramento.
Se stai creando un agente utilizzando l'API anziché la console, consulta la documentazione di riferimento per gli intent. I nomi dei campi API sono simili a quelli dei campi della console. Le istruzioni riportate di seguito evidenziano eventuali differenze importanti tra la console e l'API.
Aggiungi frasi di addestramento
Per aggiungere frasi di addestramento a un intent:
- Fai clic sul campo di testo visualizzato "Aggiungi espressione utente".
- Digita le frasi di addestramento e premi il tasto
Enter
dopo ciascuna.
Annota le frasi di addestramento
Quando viene trovata una corrispondenza di un intent in fase di runtime, Dialogflow fornisce i valori estratti dall'espressione dell'utente finale come parametri. Ogni parametro ha un tipo, chiamato tipo di entità, che determina esattamente il modo in cui vengono estratti i dati. A differenza dell'input non elaborato dell'utente finale, i parametri sono dati strutturati che possono essere facilmente utilizzati per eseguire una logica o generare risposte.Quando crei un agente, puoi controllare il modo in cui i dati vengono estratti annotando le parti delle frasi di addestramento e configurando i parametri associati.
Prendiamo ad esempio una frase di addestramento come
"Quali sono le previsioni per Tokyo domani?"
Dovresti annotare "domani" con un parametro date
e "Tokyo" con un parametro location
.
Quando annoti parti di una frase di addestramento, Dialogflow riconosce che queste parti sono solo esempi di valori effettivi che verranno forniti dagli utenti finali al momento dell'esecuzione.
Per un'espressione dell'utente finale come
"Quali sono le previsioni per venerdì a Sydney?",
Dialogflow estrarrà il parametro date
da "Friday"
e il parametro location
da "Sydney".
Quando crei un agente con la console, la maggior parte delle annotazioni viene creata automaticamente quando aggiungi frasi di addestramento che contengono parti che possono essere abbinate a un tipo di entità esistente. Queste parti sono evidenziate nella console. Puoi modificare queste annotazioni e parametri in base alle esigenze.
Per annotare manualmente una frase di addestramento con la console:
- Seleziona la parte della frase di addestramento a cui vuoi aggiungere annotazioni.
- Seleziona dall'elenco il tipo di entità che ti interessa.
- Viene creato un parametro per te nella tabella dei parametri riportata di seguito.
- Fai clic sul pulsante Salva e attendi fino a quando la finestra di dialogo Addestramento agente indica che l'addestramento è stato completato.
Quando crei un agente con l'API,
devi annotare le frasi di addestramento e configurare i parametri manualmente.
Vedi i tipi TrainingPhrase
e Parameter
nel riferimento per intent.
Il campo Part.alias
associa le annotazioni delle frasi di addestramento a parametri specifici.
Entità implicite create da frasi di addestramento
La maggior parte delle entità personalizzate viene definita in modo esplicito creando tipi di entità e aggiungendo voci di entità. Tuttavia, le entità personalizzate possono anche contenere valori impliciti. Questo accade quando annoti il testo di una frase di addestramento, in cui il testo annotato non è un valore definito dal tipo di entità selezionato. Il testo annotato diventa un valore di riferimento dell'entità per la voce dell'entità aggiunta implicitamente. Se il tipo di entità è un'entità della mappa, il testo diventa anche un sinonimo della voce dell'entità.
Modalità di esempio e modello
Ogni frase di addestramento può avere una di due modalità:
- Modalità di esempio: indicata da format_quote a sinistra della frase di addestramento. Le frasi di addestramento in modalità di esempio sono scritte in linguaggio naturale e sono annotate per l'estrazione dei parametri.
- Modalità modello: indicata da alternate_email a sinistra della frase di addestramento. Le frasi di addestramento in modalità modello contengono riferimenti diretti ai tipi di entità.