Come usare gli slot

Gli slot sono una componente fondamentale degli intenti dinamici in AIsuru. Ti consentono di estrarre informazioni specifiche dalle richieste degli utenti, rendendo gli intenti più flessibili e potenti.

Cos'è uno slot

Uno slot è una variabile che può essere estratta dal messaggio dell'utente e passata al webhook dell'intento. Gli slot ti consentono di creare intenti dinamici in grado di gestire una varietà di input degli utenti, rendendo le interazioni più naturali e contestuali.

Creare un nuovo slot

Per configurare un nuovo slot, segui questi passaggi:

1. Vai alla sezione "Funzioni" > "Intenti dinamici" del tuo Agente

2. Seleziona la scheda "Slot" e fai clic su "Nuovo slot"

3. Compila i campi richiesti:

   1. Nome: assegna un nome identificativo allo slot

   2. Valori fissi: aggiungi i valori preimpostati che lo slot può assumere; usa il pulsante "Aggiungi valore" per inserire più opzioni

   3. Webhook: inserisci l'URL del servizio esterno che gestirà questo slot

   4. Validità (minuti): definisci per quanto tempo la risposta dello slot deve essere memorizzata nella cache; se non specificato, la risposta non verrà memorizzata nella cache

4. Usa il pulsante TEST per assicurarti che funzioni correttamente.

Usare gli slot nelle invocazioni

Gli slot ti consentono di estrarre informazioni specifiche dalle richieste degli utenti. Per usare gli slot nelle invocazioni:

1. Definisci gli slot nella configurazione dell'intento;

2. Usa le parentesi graffe {} per indicare dove estrarre il valore dello slot nelle frasi di invocazione e inserisci il nome dello slot all'interno delle parentesi graffe.

Esempi di slot in un'invocazione:

• "Che tempo fa a {city}?"

• "Prenota un volo da {departure_city} a {arrival_city} per {date}"

Quando un utente chiede qualcosa come "Che tempo fa a Londra?", AIsuru riconoscerà l'intento ed estrarrà "Londra" come valore dello slot "city".

Slot multipli

Puoi usare più slot in una singola invocazione. Ad esempio: "Prenota un tavolo per {number_of_people} persone il {date} alle {time}"

In questo caso, AIsuru estrarrebbe i valori per tre slot diversi: number_of_people, date e time.

Gestione degli slot mancanti

Se un slot obbligatorio non viene fornito dall'utente, AIsuru può essere configurato per richiedere esplicitamente le informazioni mancanti. Ad esempio:

• Utente: "Che tempo fa?";

• AIsuru: "Per quale città vorresti conoscere il meteo?";

• Utente: "London";

• AIsuru: [procede con l'intento usando "London" come valore dello slot "city"].

Convalida dei valori degli slot

Puoi implementare una logica di convalida nel webhook per assicurarti che i valori degli slot siano corretti e utilizzabili. Ad esempio:

• Verificare che una data sia nel formato corretto e nel futuro;

• Verificare che il numero di persone sia ragionevole per una prenotazione;

• Convalidare che una citta sia presente nel database del servizio meteo.

Best practice per l'uso degli slot

• Usa nomi di slot descrittivi e coerenti in tutto il tuo Agente;

• Assicurati che le invocazioni coprano i vari modi in cui gli utenti potrebbero formulare le loro richieste;

• Testa le invocazioni con input diversi per assicurarti che gli slot vengano estratti correttamente;

• Fornisci descrizioni chiare per ogni slot per semplificarne la manutenzione e la comprensione nel tempo;

• Implementa una logica di fallback nel tuo webhook per gestire i casi in cui i valori degli slot non sono validi o sono mancanti.

Esempi avanzati di utilizzo degli slot

• Slot con valori predefiniti: configura gli slot con valori predefiniti per i casi in cui l'utente non specifica informazioni. Ad esempio, uno slot "date" potrebbe avere come valore predefinito la data odierna;

• Slot concatenati: crea intenti che utilizzano informazioni dagli slot precedenti per contestualizzare le richieste successive. Ad esempio, dopo aver chiesto il meteo per una citta, l'Agente potrebbe ricordare la citta per domande successive sulla stessa localita.

L'uso efficace degli slot puo rendere i tuoi intenti dinamici piu potenti e flessibili, consentendoti di creare esperienze conversazionali piu naturali e contestuali per i tuoi utenti. Gli slot permettono al tuo Agente di adattarsi a un'ampia gamma di input degli utenti, migliorandone la capacita di comprendere e rispondere alle richieste in modo accurato e pertinente.