Introduzione

Il modulo Gestione agenti AI ti permette di creare assistenti virtuali personalizzati per supporto clienti, vendite, logistica o uso interno del team. Ogni agente risponde in modo automatico tramite intelligenza artificiale, rispettando tono, regole e documenti che configuri tu.

Dove si trova nel pannello

Apri il menu laterale e vai in Strumenti (Tools) → Gestione agenti AI. Da lì vedi l'elenco degli agenti, le statistiche e il pulsante Nuovo agente.

Se non vedi la voce di menu, verifica che:

• il modulo sia incluso nel tuo piano SaaS;
• il tuo profilo staff abbia almeno il permesso Visualizza agenti (o superiore).

Permessi consigliati per il team

Puoi assegnare permessi granulari dal profilo ruoli staff:

• Visualizza — consulta elenco, log e test chat;
• Crea — avvia il wizard per nuovi agenti;
• Modifica — aggiorna configurazione e stato (attivo / pausa / bozza);
• Elimina — rimuove un agente e i dati collegati.

Prerequisiti importanti

• Quota token mensile: ogni conversazione consuma token (input + output). Nel pannello agenti vedi l'utilizzo del periodo e, se previsto dal piano, il link per ricaricare crediti quando la quota è esaurita.
• Modulo attivo: senza il modulo nel pacchetto, la sezione non è disponibile.

Creare il primo AI Agent

Clicca Nuovo agente e completa il wizard. Ogni passo ha un'anteprima a destra che si aggiorna mentre configuri.

1. Identità

• Nome e ruolo — es. "Aria", "Assistente vendite B2B".
• Istruzioni — regole rapide (lingua, cosa evitare, come salutare).
• Avatar — colore e icona per riconoscere l'agente in elenco e nel widget.
• Modello AI — scegli tra opzioni economiche, bilanciate o premium in base a complessità e budget token.
• Template rapido (opzionale) — Supporto, Vendite, Analista, Logistica per partire più velocemente.

2. Comportamento

• Tono — professionale, amichevole, tecnico, empatico, assertivo.
• Lunghezza risposta — breve, bilanciata o dettagliata.
• Tratti di personalità — curioso, diretto, paziente, ecc.
• System prompt — istruzioni di base (puoi usare segnaposto come nome agente e azienda).
• Vincoli — cosa l'agente non deve mai fare (es. non citare prezzi senza approvazione).

3. Formazione e competenze

• File competenze (.md) — procedure e know-how strutturato.
• Knowledge base dell'agente — PDF, Word, Excel, testo su cui basare le risposte.
• Esempi di training (Q&A) — coppie domanda/risposta; almeno una decina di esempi reali migliora molto la precisione.

4. Capacità

• Rivedi modello, temperatura e token massimi per equilibrio tra creatività e precisione.
• Abilita le capacità utili: memoria conversazione, analisi documenti, escalation a operatore, multilingua, ecc.
• Seleziona le integrazioni consentite (lead CRM, ticket supporto, ordini, mailbox, …) in base a cosa hai attivo nel tenant.

5. Distribuzione

• Canali — widget chat sulla piattaforma, email, WhatsApp (dove disponibile), API.
• Orari di servizio — 24/7 oppure fasce per giorno della settimana.
• Limiti — messaggi per sessione, token per risposta, tipo di accesso (pubblico, registrati, solo team interno).
• Stato — salva come bozza, metti in pausa o Attivo per andare live.

Dopo Pubblica agente ottieni i codici di distribuzione (embed, webhook, URL chat standalone).

Widget chat nel pannello

Se abiliti il canale widget piattaforma e l'agente è Attivo, compare un pulsante chat in basso a destra in tutto il pannello admin del tenant. È ideale per:

• assistenza rapida al team interno;
• testare le risposte prima di esporre l'agente ai clienti;
• procedure operative (logistica, CRM, supporto).

Dall'elenco agenti puoi anche usare Test chat per una prova isolata senza disturbare gli utenti.

Gestione quotidiana

Nella lista agenti hai a disposizione:

• Log — cronologia chat, escalation ed eventi;
• Modifica — riapre il wizard;
• Attiva / Pausa — spegni temporaneamente senza cancellare la configurazione;
• Filtri e ordinamento — trova rapidamente agenti attivi o in bozza.

Quota token e piani

Il contatore Token AI (periodo) mostra quanto hai consumato rispetto al limite del pacchetto. Se raggiungi il tetto, le chat rispondono con un messaggio di quota esaurita e, se previsto, un link per acquistare crediti aggiuntivi dall'area account cliente.

Per ottimizzare i costi:

• usa modelli più leggeri per FAQ semplici;
• limita i token per risposta;
• carica documentazione chiara negli esempi Q&A per ridurre tentativi ripetuti.

Canali verso clienti esterni

Oltre al widget interno puoi distribuire l'agente su:

• Sito / embed — codice da incollare nelle pagine che scegli;
• Email — inoltro verso l'endpoint indicato nel builder (configura il provider secondo le istruzioni in pagina);
• WhatsApp — collegamento Meta Cloud API con Phone Number ID, Verify Token e Access Token;
• API — integrazione custom per app o portali proprietari.

Per ogni canale copia l'URL o lo snippet generato dopo la pubblicazione e conserva le credenziali in modo sicuro.

Buone pratiche

• Parti da un solo agente per un caso d'uso (es. solo supporto ordini), poi espandi.
• Scrivi vincoli espliciti su prezzi, promesse legali e dati sensibili.
• Aggiorna i documenti di training quando cambiano policy o listini.
• Monitora i log settimanalmente per domande senza risposta e affina il Q&A.
• Metti in Pausa prima di modifiche importanti, poi riattiva dopo il test.

Domande frequenti

Perché l'agente non risponde?

Controlla stato Attivo, canale abilitato, quota token disponibile e che la sessione non abbia superato i limiti messaggi.

Posso avere più agenti?

Sì, uno per area (supporto, vendite, logistica) con training e tono dedicati.

Serve aiuto?

Per problemi sul piano, quota o attivazione modulo contatta il supporto Emawerly dal tuo account. Per affinare prompt e documentazione, usa i log dell'agente e iterazioni brevi sul wizard piuttosto che cambiare tutto in una volta.