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 è necessario definire ogni possibile esempio, poiché il machine learning integrato di Dialogflow espande l'elenco con altre metriche, frasi simili. Dovresti creare almeno 10-20 frasi di addestramento (a seconda della complessità dell'intento). in modo che l'agente possa riconoscere una varietà di espressioni dell'utente finale. 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 (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 di 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.

Aggiungi frasi di addestramento

Per aggiungere frasi di addestramento a un intent:

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 viene trovata una corrispondenza per 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 come vengono estratti i dati. A differenza dell'input non elaborato dell'utente finale, sono dati strutturati che possono essere facilmente utilizzati per eseguire alcune logiche o generare risposte.

Quando crei un agente, puoi controllare il modo in cui i dati vengono estratti tramite annotazioni delle frasi di addestramento e la configurazione dei parametri associati.

Ad esempio, considera 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 in fase di esecuzione. Per un'espressione utente finale come "Quali sono le previsioni per venerdì a Sydney?", Dialogflow estrarrebbe il parametro date da "Friday" e il parametro location di "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 abbinate a un tipo di entità. Queste parti sono evidenziate nella console. Puoi modificare queste annotazioni e questi parametri in base alle tue esigenze.

Per aggiungere manualmente annotazioni a 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 Save (Salva) e attendi fino al corso di formazione degli agenti indica che l'addestramento è stato completato.

Quando crei un agente con l'API, devi annotare le frasi di addestramento e configurare i parametri manualmente. Consulta TrainingPhrase e Parameter digita 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 tramite la creazione di tipi di entità e l'aggiunta di 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 di 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. Usa sempre la modalità di esempio per nuove frasi di addestramento.

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

• Modalità di esempio: Indicato da a sinistra della frase di addestramento. Le frasi di addestramento nella 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à.