Come per file e crawler, le Actions devono essere associate agli assistenti per renderle disponibili durante le conversazioni. Questa associazione ti permette di controllare precisamente quali funzionalità ogni assistente può utilizzare.
Come associare Actions agli assistenti
Metodo 1: Gestione assistente
- Seleziona l'assistente che vuoi configurare
- Nel menu laterale, clicca su "Actions"
- Vedrai la lista di tutte le Actions disponibili
- Spunta le Actions che vuoi rendere disponibili a questo assistente
- Clicca "Salva modifiche" per attivare le Actions
Metodo 2: Durante la creazione dell'Action
- Nell'ultima fase di creazione di una nuova Action
- Puoi selezionare immediatamente a quali assistenti associarla
- Risparmia tempo nella configurazione iniziale
Strategie di associazione
Associazione specializzata per ruolo
Principio: Ogni assistente ha solo le Actions pertinenti al suo ruolo specifico
Esempio pratico:
- Assistente Supporto Clienti:
- Crea ticket supporto
- Controlla stato ordine
- Invia email di follow-up
- Escalation a supporto umano
- Assistente Vendite:
- Crea lead in CRM
- Prenota demo/appuntamento
- Invia preventivo
- Aggiorna pipeline vendite
- Assistente Prenotazioni:
- Controlla disponibilità
- Crea prenotazione
- Invia conferma
- Modifica/cancella prenotazione
Vantaggi:
- Maggiore sicurezza (ogni assistente può fare solo ciò che gli compete)
- Esperienza utente più focalizzata
- Meno confusione nell'AI su quale azione usare
- Facilità di manutenzione e debugging
Associazione gerarchica
Principio: Actions organizzate per livello di complessità o importanza
- Assistente Base: Solo Actions semplici e sicure
- Invia informazioni via email
- Crea contatto semplice
- Salva richiesta informazioni
- Assistente Avanzato: Actions più complesse
- Tutte le Actions dell'assistente base
- Creazione ticket con workflow
- Integrazione con sistemi CRM
- Gestione appuntamenti
- Assistente Premium: Actions critiche per il business
- Tutte le Actions precedenti
- Operazioni finanziarie (rimborsi, sconti)
- Modifiche account clienti
- Accesso a dati sensibili
Gestione delle associazioni
Attivazione graduale
Approccio consigliato per nuove Actions:
- Test iniziale: Associa l'Action solo a un assistente di test
- Validazione: Verifica che funzioni correttamente
- Rollout limitato: Attiva su assistenti non critici
- Monitoraggio: Controlla performance e eventuali errori
- Rollout completo: Estendi a tutti gli assistenti appropriati
Disattivazione temporanea
Quando potresti aver bisogno di disattivare temporaneamente un'Action:
- Manutenzione API esterna: Il servizio terzo è temporaneamente non disponibile
- Problemi di sicurezza: Scoperta di vulnerabilità che richiede fix
- Errori funzionali: L'Action non si comporta come previsto
- Aggiornamenti: Modifica dei parametri o della logica
Monitoraggio utilizzo Actions
Metriche da controllare
- Frequenza di utilizzo: Quante volte ogni Action viene chiamata
- Tasso di successo: Percentuale di chiamate completate con successo
- Tempo di risposta: Quanto tempo impiega il servizio esterno
- Errori comuni: Tipi di errore più frequenti
- Soddisfazione utente: Feedback qualitativo sull'utilità
Analisi per assistente
Nella gestione di ogni assistente puoi vedere:
- Quali Actions sono associate e attive
- Statistiche di utilizzo per ogni Action
- Errors e problemi specifici
- Performance complessiva delle automazioni
Risoluzione problemi comuni
Action non viene mai utilizzata
Possibili cause e soluzioni:
- Descrizione poco chiara: Migliora la descrizione dell'Action per l'AI
- Parametri troppo complessi: Semplifica i parametri richiesti
- Contesto non appropriato: Verifica che l'Action sia pertinente per l'assistente
- Prompt assistente: Aggiorna il prompt per menzionare le capacità operative
Action utilizzata incorrettamente
Possibili cause e soluzioni:
- Ambiguità nella descrizione: Specifica meglio quando usare l'Action
- Conflitto tra Actions: Due Actions simili confondono l'AI
- Parametri mal definiti: Chiarisci meglio i parametri richiesti
- Mancanza di esempi: Fornisci esempi di utilizzo nella descrizione
Errori di esecuzione frequenti
Strategie di risoluzione:
- Validazione parametri: Aggiungi controlli più rigorosi
- Gestione errori API: Migliora la gestione delle risposte d'errore
- Timeout management: Configura timeout appropriati
- Fallback mechanism: Definisci cosa fare se l'Action fallisce
Best practices per le associazioni
Principio di minimo privilegio
- Associa solo le Actions strettamente necessarie per ogni assistente
- Evita di dare a tutti gli assistenti tutte le Actions disponibili
- Considera l'impatto di ogni Action prima di associarla
- Documenta il motivo di ogni associazione
Segregazione per sicurezza
- Actions sensibili: Solo ad assistenti per utenti autenticati
- Actions finanziarie: Limitare a assistenti con controlli rigidi
- Actions di modifica: Non per assistenti pubblici senza supervisione
- Actions di eliminazione: Richiedere sempre conferma esplicita
Testing e validazione
- Test cross-funzionale: Verifica che le Actions non interferiscano tra loro
- Test scenari reali: Simula conversazioni complete con più Actions
- Test error handling: Verifica comportamento quando le Actions falliscono
- Monitoring continuo: Controlla regolarmente le performance
Documentazione delle associazioni
- Matrice assistenti-actions: Tabella che mostra tutte le associazioni
- Motivazioni: Perché ogni Action è stata associata a specifici assistenti
- Limitazioni: Eventuali restrizioni d'uso per ogni associazione
- Procedure di emergenza: Come disattivare rapidamente Actions problematiche