I parametri sono le informazioni che l'assistente raccoglie dalla conversazione con l'utente e invia al servizio esterno. Una gestione corretta dei parametri è essenziale per il funzionamento efficace delle Actions.
Tipi di parametri
Parametri obbligatori
- Definizione: Informazioni essenziali senza le quali l'Action non può funzionare
- Comportamento: L'assistente chiederà esplicitamente questi dati se mancanti
- Esempi:
- Email utente per invio comunicazioni
- Descrizione problema per ticket di supporto
- ID prodotto per controllo disponibilità
- Data e ora per prenotazioni
Parametri opzionali
- Definizione: Informazioni utili ma non indispensabili
- Comportamento: L'assistente può procedere anche senza questi dati
- Utilità: Migliorano la qualità del servizio o forniscono informazioni aggiuntive
- Esempi:
- Numero di telefono in un modulo di contatto
- Priorità di un ticket (con valore default)
- Note aggiuntive per una prenotazione
- Preferenze specifiche dell'utente
Parametri con valori di default
- Definizione: Parametri che hanno un valore predefinito se non specificato
- Utilità: Semplificano l'esperienza utente e garantiscono valori sensati
- Esempi:
- Priorità ticket: "normale" se non specificato
- Lingua comunicazione: "italiano" come default
- Categoria problema: "generale" se non categorizzato
Definizione parametri nell'interfaccia
Informazioni base per ogni parametro
- Nome parametro: Identificatore univoco (es. "email_utente", "descrizione_problema")
- Etichetta descrittiva: Nome comprensibile per l'amministratore
- Tipo di datos: Stringa, numero, data, booleano, ecc.
- Descrizione: Spiegazione per l'AI su cosa rappresenta questo parametro
- Obbligatorio/Opzionale: Se il parametro è necessario o meno
Opzioni avanzate
- Valore di default: Valore usato se il parametro non viene fornito
- Validazione: Regole per verificare che il valore sia corretto
- Formato richiesto: Pattern o esempio del formato atteso
- Valori consentiti: Lista di opzioni per parametri con scelte limitate
Esempi di configurazione parametri
Action: Creazione ticket supporto
| Nome | Tipo | Obbligatorio | Default | Descrizione |
|---|---|---|---|---|
| email_cliente | Stringa | Sì | - | Email del cliente che richiede supporto |
| oggetto | Stringa | Sì | - | Titolo/oggetto del problema |
| descrizione | Testo | Sì | - | Descrizione dettagliata del problema |
| priorita | Opzione | No | normale | Priorità: bassa, normale, alta, urgente |
| categoria | Opzione | No | generale | Categoria: tecnico, fatturazione, generale |
Action: Prenotazione appuntamento
| Nome | Tipo | Obbligatorio | Default | Descrizione |
|---|---|---|---|---|
| nome_cliente | Stringa | Sì | - | Nome completo del cliente |
| Sì | - | Email per conferma appuntamento | ||
| data_preferita | Data | Sì | - | Data desiderata per l'appuntamento |
| ora_preferita | Ora | No | 14:00 | Orario preferito |
| telefono | Stringa | No | - | Numero di telefono (opzionale) |
| note | Testo | No | - | Note aggiuntive o richieste speciali |
Come l'AI estrae i parametri
Estrazione automatica dalla conversazione
L'assistente analizza automaticamente la conversazione per identificare i valori dei parametri:
Utente: "Ho un problema con il login, la mia email è mario.rossi@email.com"
AI identifica:
- email_cliente: "mario.rossi@email.com"
- categoria: "tecnico" (dedotto da "problema con il login")
- oggetto: "Problema con il login" (estratto dal messaggio)
Richiesta parametri mancanti
Se mancano parametri obbligatori, l'AI chiederà esplicitamente:
AI: "Ho capito che hai un problema con il login. Puoi descrivermi più nel dettaglio cosa succede quando provi ad accedere?"
Scopo: Ottenere il parametro "descrizione" che è obbligatorio
Validazione e controllo qualità
Validazione formato
- Email: Verifica che sia un indirizzo email valido
- Telefono: Controlla formato numerico e lunghezza
- Date: Valida che sia una data reale e futura (se necessario)
- URL: Verifica che sia un URL ben formato
Controlli logici
- Date future: Per appuntamenti, verifica che la data non sia nel passato
- Valori in range: Ad es. priorità deve essere tra le opzioni consentite
- Lunghezza testo: Descrizioni non troppo corte o troppo lunghe
- Campi correlati: Se c'è telefono, verifica coerenza con paese
Gestione errori nei parametri
Parametri non validi
Cosa succede quando un parametro non passa la validazione:
- Feedback all'utente: "L'email che hai fornito non sembra valida. Puoi ripeterla?"
- Richiesta correzione: L'AI chiede una nuova versione del parametro
- Suggerimenti: "Il formato deve essere nome@dominio.com"
Parametri ambigui
Quando l'AI non è sicura del valore estratto:
- Conferma: "Ho capito che la tua email è mario@email.com, è corretto?"
- Chiarimento: "Per priorità intendi alta o urgente?"
- Opzioni multiple: Presenta scelte quando non è sicura
Best practices per la definizione parametri
Nomi parametri chiari
- Usa nomi descrittivi: "email_cliente" invece di "email"
- Evita abbreviazioni ambigue
- Mantieni coerenza tra diverse Actions
- Usa convenzioni di naming (snake_case, camelCase, ecc.)
Descrizioni efficaci
- Spiega chiaramente cosa rappresenta il parametro
- Includi esempi quando utile
- Specifica formato richiesto se particolare
- Indica quando il parametro viene usato
Valori default intelligenti
- Usa valori che hanno senso per la maggior parte dei casi
- Non impostare default per informazioni personali
- Considera il contesto di utilizzo
- Documenta perché hai scelto quel default
Test dei parametri
- Test completezza: Verifica che tutti i parametri necessari vengano raccolti
- Test validazione: Prova con valori non validi per verificare i controlli
- Test conversazioni: Simula dialoghi reali per vedere come vengono estratti i parametri
- Test edge cases: Cosa succede con valori limite o situazioni particolari