Come usare gli slot
Gli slot sono una componente fondamentale degli intenti dinamici in AIsuru. Permettono 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 dalla frase dell'utente e passata al webhook dell'intento. Gli slot permettono di creare intenti dinamici che possono gestire una varietà di input utente, rendendo le interazioni più naturali e contestuali.
Creazione di un nuovo slot
Per configurare un nuovo slot, segui questi passaggi:
Accedi alla sezione "Funzioni" > "Intenti dinamici" del tuo Agente;
Seleziona il tab "Slot" e clicca su "Nuovo slot";
Compila i campi richiesti:
Nome: assegna un nome identificativo allo slot;
Valori fissi: aggiungi i valori predefiniti che lo slot può assumere; usa il pulsante "Aggiungi valore" per inserire più opzioni;
Webhook: inserisci l'URL del servizio esterno che gestirà questo slot;
Validità (minuti): definisci per quanto tempo la risposta dello slot deve essere memorizzata nella cache; se non specificato, la risposta non verrà salvata in cache;
Utilizza il pulsante TEST per assicurarti che funzioni correttamente.
Utilizzo degli slot nelle invocazioni
Gli slot permettono di estrarre informazioni specifiche dalle richieste degli utenti. Per utilizzare gli slot nelle invocazioni:
Definisci gli slot nella configurazione dell'intento;
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:
"Qual è il meteo a {citta}?"
"Prenota un volo da {citta_partenza} a {citta_arrivo} per il {data}"
Quando l'utente fa una richiesta come "Qual è il meteo a Roma?", AIsuru riconoscerà l'intento e estrarrà "Roma" come valore dello slot "citta".
Slot multipli
Puoi utilizzare più slot in una singola invocazione. Ad esempio: "Prenota un tavolo per {numero_persone} persone il {data} alle {ora}"
In questo caso, AIsuru estrarrebbe i valori per tre slot diversi: numero_persone, data e ora.
Gestione degli slot mancanti
Se un slot obbligatorio non viene fornito dall'utente, AIsuru può essere configurato per richiedere esplicitamente l'informazione mancante. Ad esempio:
Utente: "Qual è il meteo?";
AIsuru: "Per quale città vorresti conoscere il meteo?";
Utente: "Roma";
AIsuru: [procede con l'intento utilizzando "Roma" come valore per lo slot "citta"].
Validazione dei valori degli slot
È possibile implementare una logica di validazione nel webhook per assicurarsi che i valori degli slot siano corretti e utilizzabili. Ad esempio:
Verificare che una data sia nel formato corretto e nel futuro;
Controllare che un numero di persone sia ragionevole per una prenotazione;
Validare che una città sia presente nel database del servizio meteo.
Best practices per l'uso degli slot
Usa nomi di slot descrittivi e coerenti in tutto il tuo Agente;
Assicurati che le invocazioni coprano diverse variazioni di come gli utenti potrebbero formulare le richieste;
Testa le invocazioni con diversi input per assicurarti che gli slot vengano estratti correttamente;
Fornisci descrizioni chiare per ogni slot per facilitare la manutenzione e la comprensione dell'intento nel tempo;
Implementa una logica di fallback nel tuo webhook per gestire casi in cui i valori degli slot non sono validi o mancanti.
Esempi avanzati di utilizzo degli slot
Slot con valori predefiniti: Configura slot con valori predefiniti per gestire casi in cui l'utente non specifica un'informazione. Ad esempio, un slot "data" potrebbe avere come valore predefinito la data odierna;
Slot concatenati: Crea intenti che utilizzano le informazioni di slot precedenti per contestualizzare le richieste successive. Ad esempio, dopo aver chiesto il meteo per una città, l'Agente potrebbe ricordare la città per domande successive sulla stessa località;
L'uso efficace degli slot può rendere i tuoi intenti dinamici più potenti e flessibili, permettendoti di creare esperienze conversazionali più naturali e contestuali per i tuoi utenti. Gli slot consentono al tuo Agente di adattarsi a una vasta gamma di input utente, migliorando la sua capacità di comprendere e rispondere alle richieste in modo preciso e pertinente.
Last updated