Frasi di addestramento

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

Le frasi di addestramento sono frasi di esempio di ciò che gli utenti finali potrebbero digitare o dire, chiamate espressioni utente finale. Per ogni intento, crei molte frasi di addestramento. Quando un'espressione dell'utente finale assomiglia a una di queste frasi, Dialogflow trova una corrispondenza con l'intenzione.

Ad esempio, la frase di addestramento "Voglio una pizza" insegna all'agente a riconoscere le espressioni degli utenti finali simili a quella frase, come "Fammi una pizza" o "Ordina una pizza".

Non devi definire ogni possibile esempio, poiché il machine learning integrato di Dialogflow amplia il tuo elenco con altre frasi simili. Devi creare almeno 10-20 frasi di addestramento (a seconda della complessità dell'intenzione), in modo che l'agente possa riconoscere una serie 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"
• "black"
• "Il blu è il mio colore preferito"
• …

Dove trovare questi dati

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

1. Vai alla console Dialogflow ES.
2. Seleziona un agente.
3. Seleziona Intenti nel menu della barra laterale a sinistra.
4. Seleziona un'intenzione.
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 Intent. I nomi dei campi dell'API sono simili a quelli della console. Le istruzioni riportate di seguito mettono in evidenza eventuali differenze importanti tra la console e l'API.

Aggiungere frasi di addestramento

Per aggiungere frasi di addestramento a un intento:

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

Annotare le frasi di addestramento

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

Quando un'intenzione viene associata in fase di esecuzione, 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 alcune operazioni logiche o generare risposte.

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

Ad esempio, considera una frase di addestramento come "Quali sono le previsioni per domani per 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 esecuzione. Per un'espressione dell'utente finale come "Quali sono le previsioni per venerdì a 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 contenenti 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 dall'elenco il tipo di entità che ti interessa.
3. Viene creato un parametro nella tabella dei parametri di seguito.
4. Fai clic sul pulsante Salva e attendi che la finestra di dialogo Formazione agenti annunci il completamento della formazione.

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, piuttosto che fare affidamento su valori di entità personalizzate definiti in modo implicito.

La maggior parte delle entità personalizzate viene definita esplicitamente creando tipi di entità e aggiungendo voci di entità. Tuttavia, le entità personalizzate possono contenere anche valori impliciti. Questo 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 dell'entità aggiunta implicitamente. Se il tipo di entità è un'entità mappa, il testo diventa anche un sinonimo per la voce dell'entità.

Modalità Esempio e Modello

Attenzione: la modalità Modelli è 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à Esempio: indicated by to the left of the training phrase. Le frasi di addestramento in modalità di esempio sono scritte in linguaggio naturale e sono annotate per l'estrazione dei parametri.
• Modalità modello: indicated by to the left of the training phrase. Le frasi di addestramento in modalità modello contengono riferimenti diretti ai tipi di entità.