Frasi di addestramento

Nota: ci sono molte importanti best practice per le frasi di addestramento descritte nella guida alle best practice per la progettazione degli agenti.

Le frasi di addestramento sono frasi di esempio per ciò che gli utenti finali potrebbero digitare o dire, denominati espressioni utente finale. Per ogni intent, crei molte frasi di addestramento. Quando un'espressione utente finale assomiglia a una di queste frasi, Dialogflow interagisce con l'intent.

Ad esempio, una frase di addestramento "Voglio che la pizza" possa addestrare il tuo agente a riconoscere le espressioni simili degli utenti finali, ad esempio "Acquista una pizza" oppure "Ordina pizza".

Non è necessario definire tutti i possibili esempi, 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 degli utenti finali. Ad esempio, se vuoi che l'utente riconosca l'espressione di un utente finale riguardo al colore che preferisce, puoi definire le seguenti frasi di addestramento:

• "Mi piace rosso"
• "Il mio colore preferito è il giallo";
• "nero"
• "Blu è il mio preferito".
• …

Dove trovare questi dati

Quando crei un agente, comunemente si utilizza la console di Dialogflow ES (consulta la documentazione, open console). Le istruzioni che seguono riguardano l'utilizzo della console. Per accedere ai dati delle frasi di addestramento:

1. Vai alla console di Dialogflow ES.
2. Seleziona un agente.
3. Seleziona Intent nel menu della barra laterale a sinistra.
4. Seleziona un intent.
5. Scorri verso il basso fino alla sezione Frasi di addestramento.

Se stai creando un agente utilizzando l'API anziché la console, consulta il riferimento per intent. I nomi dei campi dell'API sono simili ai nomi 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:

1. Fai clic sul campo di testo "Mostra espressione utente".
2. Digita le frasi di addestramento e premi il tasto Enter dopo ogni voce.

Annota frasi di addestramento

Nota: esistono molte best practice importanti per le annotazioni con frasi di addestramento descritte nella guida alle best practice per la progettazione degli agenti.

Quando un intent corrisponde a un runtime, Dialogflow mostra i valori estratti dall'espressione dell'utente finale come parametri. Ogni parametro ha un tipo, chiamato tipo di entità, che determina esattamente come vengono estratti i dati. A differenza dell'input dell'utente finale non elaborato, i parametri sono dati strutturati che possono essere facilmente utilizzati per eseguire una logica o generare risposte.

Durante la creazione di un agente, puoi controllare in che modo i dati vengono estratti annotando le parti delle tue frasi di addestramento e configurando i parametri associati.

Ad esempio, prendiamo in considerazione una frase di addestramento come "Come ci sarà la previsione di domani al Tokyo?" Dovresti annotare"domani"con un parametro date e"Tokyo"con un parametro location. Quando prendi nota di parti di una frase di addestramento, Dialogflow riconosce che queste sono solo esempi di valori effettivi che verranno forniti dagli utenti finali in fase di runtime. Per un'espressione dell'utente finale, ad esempio "Qual è la previsione di venerdì per Sydney?", Dialogflow estrae il parametro date da "venerdì" 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 questi parametri in base alle esigenze.

Per annotare manualmente una frase di addestramento con la console:

1. Seleziona la parte della frase di addestramento che vuoi annotare.
2. Seleziona il tipo di entità desiderato dall'elenco.
3. Viene creato un parametro nella tabella dei parametri riportata di seguito.
4. Fai clic sul pulsante Save (Salva) e attendi finché la finestra di dialogo Agent Training non indica il completamento dell'addestramento.

Quando crei un agente con l'API, devi annotare le frasi di addestramento e configurare i parametri manualmente. Consulta i tipi TrainingPhrase e Parameter nel riferimento sugli intent. Il campo Part.alias associa le annotazioni a frase di addestramento a parametri specifici.

Entità implicite create da frasi di addestramento

Nota: devi definire le entità in modo esplicito, invece di basarti su valori di entità personalizzate implicitamente definiti.

La maggior parte delle entità personalizzate viene definita in modo esplicito creando tipi di entità e aggiungendo voci. 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 entità per la voce entità implicitamente aggiunta. Se il tipo di entità è un'entità mappa, il testo diventa anche un sinonimo della voce di entità.

Modalità di esempio e modelli

Attenzione: la modalità modello è deprecata. Utilizza sempre la modalità di esempio per le nuove frasi di addestramento.

Ogni frase di addestramento può essere in una delle due modalità:

• Modalità di esempio: Indicata da a sinistra della frase di addestramento. Le frasi di addestramento in modalità di esempio sono scritte in un linguaggio naturale e sono annotate per l'estrazione dei parametri.
• Modalità modello: indicata da a sinistra della frase di addestramento. Le frasi di addestramento in modalità modello contengono riferimenti diretti ai tipi di entità.