Panoramica sulla creazione degli intenti

• Pianifica gli intenti per la tua applicazione.

  Cosa potrebbero voler fare i tuoi clienti e cosa vuoi che sia in grado di gestire la tua applicazione al loro posto. Ad esempio, potresti volere che la tua applicazione aiuti i tuoi clienti ad effettuare un acquisto. Se è così, puoi aggiungere un intento #buy_something. (Il # che viene aggiunto come prefisso al nome dell'intento consente di identificarlo chiaramente come un intento.)

• Insegna a watsonx Assistant i tuoi intenti.

  Dopo aver deciso quali richieste di business vuoi che la tua applicazione gestisca per i tuoi clienti, devi istruire watsonx Assistant su di esse. Per ogni obiettivo di business (ad esempio #buy_something), devi fornire almeno 5 esempi di espressioni che i tuoi clienti utilizzano normalmente per indicare il proprio obiettivo. Ad esempio, I want to make a purchase.

  Idealmente, trova degli esempi di espressioni utente reali che puoi estrarre da processi di business esistenti. Personalizzare gli esempi utente in base alla propria attività specifica. Ad esempio, se sei una compagnia di assicurazioni, un esempio utente potrebbe essere simile a questo, I want to buy a new XYZ insurance plan.

  Il tuo assistente utilizza gli esempi che fornisci per creare un modello di machine learning che può riconoscere gli stessi e simili tipi di espressioni e associarli all'intento appropriato.

Inizia con pochi intenti e verificali mentre espandi in modo iterativo l'ambito dell'applicazione.

Creazione di intenti

1. Fare clic su Intenti.

2. Seleziona Crea intento.

3. Nel campo Nome intento, immetti un nome per l'intento.

   • Il nome intento può contenere lettere (in Unicode), caratteri di sottolineatura, trattini e punti.
   • Il nome non può essere costituito da .. o da qualsiasi altra stringa di soli punti.
   • I nomi intento non possono contenere spazi e non devono superare i 128 caratteri. Di seguito sono riportati degli esempi di nomi intento:
     • #weather_conditions
     • #pay_bill
     • #escalate_to_agent

   Un prefisso # di segno numerico viene incluso automaticamente nel nome dell'intento per aiutare a identificare il termine come un intento. Non è necessario aggiungerlo.

   Mantieni il nome il più breve possibile per la leggibilità nel riquadro "Provalo" e nei log di conversazione.

   Facoltativamente aggiungi una descrizione dell'intento nel campo Descrizione.

4. Seleziona Crea intento per salvare il tuo nome intento.

   

5. Nel campo Esempio utente, immetti il testo di un esempio utente per l'intento. Un esempio può essere qualsiasi stringa composta da un massimo di 1.024 caratteri. Le seguenti espressioni possono essere degli esempi per l'intento #pay_bill:

   • I need to pay my bill.
   • Pay my account balance
   • make a payment

   Per ulteriori informazioni sull'impatto di includere dei riferimenti alle entità nei tuoi esempi utente, vedi Come vengono trattati i riferimenti entità.

   I nomi intento e il testo di esempio possono essere visualizzati negli URL quando un'applicazione interagisce con watsonx Assistant. Non includere informazioni sensibili o personali in queste risorse.

6. Fai clic su Aggiungi esempio per salvare l'esempio utente.

   

7. Ripeti lo stesso processo per aggiungere altri esempi.

   Fornisci almeno cinque esempi per ogni intento.

8. Una volta aggiunti gli esempi, fare clic sulla freccia di chiusura per terminare la creazione dell'intento.

Il sistema si addestra sull'intento e sugli esempi utente che hai aggiunto.

Importante:

• I dati di esempio dell'intento devono essere dati rappresentativi e tipici che vengono forniti dai tuoi utenti. Gli esempi possono essere raccolti dai dati utente effettivi o da persone esperte nel campo specifico. La natura rappresentativa e accurata dei dati è importante.
• Sia i dati di addestramento che quelli di test (per scopi valutativi) devono riflettere la distribuzione degli intenti nell'utilizzo reale. In genere, intenti più frequenti hanno relativamente più esempi e una miglior copertura della risposta.
• È possibile includere la punteggiatura nel testo di esempio, se appare in modo naturale. Se credi che alcuni utenti esprimono i loro intenti con esempi che includono la punteggiatura mentre altri non lo faranno, includi entrambe le versioni. In genere, maggiore è la copertura per i diversi modelli, migliore è la risposta.

Come vengono trattate le entità

Quando includi una citazione dell'entità in un esempio utente, il modello di machine learning utilizza le informazioni in diversi modi in questi scenari:

• Riferimento ai sinonimi e ai valori dell'entità negli esempi di intento
• Citazioni annotate
• Riferimento diretto a un nome dell'entità in un esempio di intento

Riferimento diretto a un nome dell'entità in un esempio di intento

Questo approccio è avanzato. Se utilizzato, lo deve essere in modo coerente.

Puoi scegliere di fare direttamente riferimento alle entità nei tuoi esempi di intento. Ad esempio, diciamo che hai un'entità chiamata @PhoneModelName, che contiene i valori Galaxy S8, Moto Z2, LG G6e Google Pixel 2. Quando crei un intento, ad esempio #order_phone, potresti quindi fornire i dati di addestramento come segue:

• Come posso procurarmi un @PhoneModelName?
• Aiutami a ordinare un @PhoneModelName.
• @PhoneModelName è disponibile?
• Aggiungi un @PhoneModelName al mio ordine.

Attualmente, puoi fare direttamente riferimento solo a entità sinonimo che hai definito (i valori modello vengono ignorati). Non è possibile utilizzare entità di sistema.

Se scegli di fare riferimento ad un'entità come a un esempio di intento (ad esempio, @PhoneModelName) anywhere nei dati di addestramento, verrà annullato il valore dell'utilizzo di un riferimento diretto (ad esempio, Galaxy S8) in un esempio di intento dappertutto. Tutti gli intenti utilizzeranno poi l'approccio entità come esempio di intento. Non puoi applicare questo approccio solo a un intento specifico.

In pratica significa che se hai precedentemente eseguito l'addestramento della maggior parte dei tuoi intenti in base ai riferimenti diretti (Galaxy S8) e ora utilizzi i riferimenti di entità (@PhoneModelName) solo per un intento, la modifica influisce sui tuoi precedenti addestramenti. Se scegli di utilizzare i riferimenti @Entity, devi sostituire tutti i precedenti riferimenti diretti con i riferimenti @Entity.

La definizione di un intento di esempio con un @Entity che ha 10 valori definiti per esso non equivale a specificare 10 volte tale esempio di intento. Il servizio watsonx Assistant non dà molta importanza a tale sintassi dell'intento di esempio.

Test degli intenti

Dopo aver finito di creare nuovi intenti, puoi testare il sistema per vedere se riconosce i tuoi intenti come ti aspetti.

1. Fai clic su Try it.

2. Nel riquadro "Provalo" immetti una domanda o un'altra stringa di testo e premi Invio per vedere quale intento viene riconosciuto. Se viene riconosciuto l'intento errato, puoi migliorare il tuo modello aggiungendo questo testo come esempio all'intento corretto.

   Se effettui modifiche recenti nella tua capacità, potresti visualizzare un messaggio che indica che il sistema è ancora in fase di riaddestramento. Se visualizzi questo messaggio, attendi che l'addestramento venga completato prima di eseguire il test:

   La risposta indica quale intento è stato riconosciuto dal tuo input.

   

3. Se il sistema non riconosce l'intento corretto, puoi correggerlo. Per correggere l'intento riconosciuto, seleziona l'intento visualizzato e quindi seleziona l'intento corretto dall'elenco. Dopo aver inviato la tua correzione, il sistema si riaddestra automaticamente per incorporare i nuovi dati.

   

4. Se l'input non è correlato ad alcun intento nella tua applicazione, puoi istruire il tuo assistente selezionando l'intento visualizzato e poi facendo clic su Contrassegna come irrilevante.

   

Se i tuoi intenti non vengono riconosciuti correttamente, puoi apportare i seguenti tipi di modifiche:

• Aggiungere il testo non riconosciuto come esempio all'intento corretto.
• Spostare gli esempi esistenti da un intento a un altro.
• Considera se i tuoi intenti sono troppo simili e ridefinirli.

Punteggio assoluto

Il servizio watsonx Assistant calcola i punteggi di attendibilità di ogni intento indipendentemente, non in relazione ad altri intenti. Questo approccio aggiunge flessibilità; possono essere rilevati più intenti in un solo input utente. Significa anche che il sistema potrebbe non restituire alcun intento. Se l'intento principale ha un basso punteggio di affidabilità (meno dello 0,2), l'intento principale viene incluso nell'array di intenti restituito dall'API, ma tutti i nodi con una condizione sull'intento non vengono attivati. Se desideri rilevare quando non vengono rilevati intenti con dei buoni punteggi di affidabilità, utilizza la condizione speciale irrelevant nel tuo nodo di dialogo.

Poiché i punteggi di affidabilità dell'intento cambiano, i tuoi dialoghi potrebbero richiedere una ristrutturazione. Ad esempio, se un nodo di dialogo utilizza un intento nella propria condizione e il punteggio di affidabilità dell'intento inizia ad essere costantemente al di sotto dello 0,2, il nodo di dialogo interrompe l'elaborazione. Se il punteggio di attendibilità cambia, anche il comportamento del dialogo può cambiare a sua volta.

Limiti di intenti

Il numero di intenti ed esempi che puoi creare dipende dal tuo tipo di piano watsonx Assistant:

Modifica degli intenti

Puoi fare clic su qualsiasi intento nell'elenco per aprirlo per la modifica. Puoi apportare le seguenti modifiche:

• Rinomina l'intento
• Elimina l'intento
• Esempi di aggiunta, modifica o eliminazione
• Spostare gli esempi in un intento diverso

Per spostare o eliminare un esempio, fai clic sulla casella di spunta associata con esso e poi fai clic su Sposta o Elimina.

Ricerca degli intenti

Utilizza la funzione Ricerca per trovare gli esempi utente, i nomi intento e le descrizioni.

1. Dalla pagina Intenti, fare clic sull'icona Cerca .

2. Invia una frase o un termine di ricerca. È anche possibile selezionare Includi corrispondenza parziale.

   La prima volta che si cerca qualcosa, è possibile che venga visualizzato un messaggio che indica che il contenuto è in fase di indicizzazione. In questo caso, attendi un minuto e poi invia nuovamente il termine di ricerca.

   Gli intenti che contengono il tuo termine di ricerca vengono visualizzati.

   

Download degli intenti

Puoi scaricare una serie di intenti in un file CSV, in modo da poterli quindi caricare e riutilizzarli in un'altra applicazione watsonx Assistant.

1. Vai alla pagina Intenti.

• Per scaricare tutti gli intenti, ovvero gli intenti elencati in questa e le eventuali pagine aggiuntive, non selezionare alcun intenti individuali. Fai invece clic sull'icona Scarica tutti gli intenti .

• Per scaricare gli intenti elencati solo nella pagina corrente, seleziona la casella di controllo nell'intestazione. Questa azione seleziona tutti gli intenti nella pagina corrente. Quindi, fare clic su Scarica.

• Per scaricare uno o più intenti specifici, seleziona gli intenti che vuoi scaricare e fai clic sul pulsante Scarica.

1. Specificare il nome e l'ubicazione in cui memorizzare il file CSV generato, quindi fare clic su Salva.

Caricamento di intenti ed esempi

Se hai molti intenti ed esempi, potresti trovare più semplice caricarli da un file CSV (comma - separated value) piuttosto che definirli uno per uno. Assicurati di rimuovere tutti i dati personali dagli esempi utente che includi nel file.

1. Raccogli gli intenti ed esempi in un file CSV o esportali da un foglio di calcolo in un file CSV. Il formato richiesto per ogni riga nel file è il seguente:

   <example>,<intent>
   

   dove <example> è il testo di un esempio utente e <intent> è il nome dell'intento che si desidera che l'esempio corrisponda. Ad esempio:

   Tell me the current weather conditions.,weather_conditions
   Is it raining?,weather_conditions
   What's the temperature?,weather_conditions
   Where is your nearest location?,find_location
   Do you have a store in Raleigh?,find_location
   

   Importante: salva il file CSV con la codifica UTF-8 e nessun contrassegno di ordine di byte (BOM).

2. Dalla pagina Intenti, fare clic sull'icona Carica intenti .

3. Trascinare un file o sfogliare per selezionare un file dal computer.

   Importante: la dimensione massima del file CSV è 10 MB. Se il tuo file CSV è più grande, considera la possibilità di suddividerlo in più file e caricarli separatamente.

4. Fai clic su Upload intents.

   Il file viene convalidato e caricato e il sistema si addestra sui nuovi dati.

Puoi visualizzare gli intenti caricati e gli esempi corrispondenti sulla scheda Intenti. Per vedere i nuovi intenti potresti dover aggiornare la pagina.

Eliminazione di intenti

Puoi selezionare una serie di intenti da eliminare.

Eliminando gli intenti che stai eliminando anche tutti gli esempi associati e questi elementi non possono essere richiamati in un secondo momento. Tutti i nodi di dialogo che fanno riferimento a questi intenti devono essere aggiornati manualmente per non fare più riferimento al contenuto eliminato.

1. Vai alla pagina Intenti

   • Per eliminare tutti gli intenti, ovvero gli intenti elencati in questa pagina e le eventuali pagine aggiuntive, non selezionare alcun intenti singolo. Fai invece clic sull'icona Elimina tutti gli intenti.

   • Per eliminare gli intenti che sono elencati solo sulla pagina corrente, seleziona la casella di spunta nell'intestazione. Questa azione seleziona tutti gli intenti elencati nella pagina corrente. Fai clic su Delete.

   • Per eliminare uno o più intenti specifici, seleziona gli intenti che vuoi eliminare e poi fai clic su Elimina.