Frasi di addestramento

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

Le frasi di addestramento sono frasi di esempio che gli utenti finali potrebbero digitare o pronunciare, chiamate espressioni degli utenti finali. Per ogni intent, crei molte frasi di addestramento. Quando un'espressione dell'utente finale assomiglia a una di queste frasi, Dialogflow associa l'intent.

Ad esempio, la frase di addestramento "Voglio una pizza" addestra l'agente a riconoscere le espressioni degli utenti finali simili a questa frase, come "Prendi una pizza" o "Ordina una pizza".

Non devi definire ogni possibile esempio, perché il machine learning integrato di Dialogflow espande l'elenco con altre frasi simili. Dovresti creare almeno 10-20 frasi di addestramento (a seconda della complessità dell'intent), in modo che l'agente possa riconoscere una varietà di espressioni degli utenti finali. Ad esempio, se vuoi che l'intent 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

Quando crei un agente, è più comune utilizzare la console Dialogflow ES (consulta la documentazione, apri la console). Le istruzioni riportate di seguito si concentrano sull'utilizzo della console. Per accedere ai dati delle frasi di addestramento:

1. Vai alla console 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 agli intent. I nomi dei campi API sono simili ai nomi dei campi della console. Le istruzioni riportate di seguito evidenziano le differenze importanti tra la console e l'API.

Aggiungere frasi di addestramento

Per aggiungere frasi di addestramento a un intent:

1. Fai clic sul campo di testo in cui è visualizzato "Aggiungi espressione utente".
2. Digita le frasi di addestramento e premi il tasto Enter dopo ognuna.

Annotare le frasi di addestramento

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

Quando un intent viene associato 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 come vengono estratti i dati. A differenza dell'input utente finale non elaborato, i parametri sono dati strutturati che possono essere facilmente utilizzati per eseguire una logica o generare risposte.

Quando crei un agente, controlli la modalità di estrazione dei dati annotando parti delle frasi di addestramento e configurando i parametri associati.

Ad esempio, considera una frase di addestramento come "Che tempo farà domani a Tokyo?". 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 in fase di runtime. Per un'espressione dell'utente finale come "Che tempo farà venerdì a Sydney?", Dialogflow estrarrebbe 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 associate a un tipo di entità esistente. Queste parti sono evidenziate nella console. Puoi modificare queste annotazioni e questi parametri in base alle tue 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. Nella tabella dei parametri sottostante viene creato un parametro.
4. Fai clic sul pulsante Salva e attendi che la finestra di dialogo Addestramento dell'agente indichi che l'addestramento è completato.

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 agli intent. Il campo Part.alias associa le annotazioni delle frasi di addestramento a parametri specifici.

Entità implicite create dalle frasi di addestramento

Nota: devi definire le entità in modo esplicito, anziché fare affidamento sui valori delle entità personalizzate definiti in modo implicito.

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 contenere anche valori impliciti. Ciò accade quando annoti il testo di una frase di addestramento, dove 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 di entità aggiunta in modo implicito. Se il tipo di entità è un'entità mappa, il testo diventa anche un sinonimo della voce di entità.

Modalità Esempio e Modello

Attenzione: la modalità Modello è stata ritirata. Utilizza sempre la modalità Esempio per le nuove frasi di addestramento.

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

• Modalità Esempio: indicata da a sinistra della frase di addestramento. Le frasi di addestramento in modalità Esempio sono scritte in linguaggio naturale e vengono 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à.