# Il tuo primo agente chat > Con circa 20 minuti di lavoro, più l'attesa dell'allenamento, crei un agente che risponde per iscritto ai tuoi clienti, gli insegni la tua attività con il sito e i documenti, lo provi nella chat di prova e lo metti online con il widget. Pagina: https://supportfast.ai/it/guida/primi-passi/primo-agente-testuale/ · Sezione: Primi passi · Aggiornata il 30 ottobre 2026 **Crea** — Nome e ambito dell'attività. → **Allena** — Sito, documenti, FAQ. → **Istruisci** — Il prompt nel Playground. → **Prova** — Con la chat di prova. → **Pubblica** — Il widget sul sito. > **Prima di iniziare** > > - Il sito o i documenti della tua attività e, per il passo 6, l'accesso al pannello del sito. ## 1. Crea l'agente 1. **Apri la creazione** Entra nel workspace e premi Crea elemento nella barra in alto. Nella finestra «Cosa vuoi creare?», sulla scheda Agente Chat, premi Crea agente: si apre una seconda finestra, «Nuovo Agente Chat». 2. **Dai un nome e un ambito** In Nome dell'Agente scrivi un nome che ti aiuti a riconoscerlo, per esempio «Assistente Officina». In Ambito e settore dell'attività descrivi in poche parole la tua attività, per esempio «Officina meccanica a Milano: tagliandi, revisioni e gomme». L'ambito entra nelle istruzioni e dice all'agente per chi lavora. 3. **Crea e parti dall'allenamento** In fondo alla finestra «Nuovo Agente Chat» premi Crea Agente: è il pulsante della seconda finestra, non quello del passo 1. Nella finestra che si apre, sulla scheda Allena la conoscenza premi Allena. Tutti i dettagli, compresi i valori di partenza dell'agente: [Creare e gestire l'agente](https://supportfast.ai/it/guida/agente-testuale/crea.md). ## 2. Insegnagli la tua attività L'agente risponde con quello che gli insegni: questo è l'**allenamento**. Parti dal sito. 1. **Scegli il sito come fonte** In Agente chat › Allenamento premi Nuovo allenamento, poi Seleziona Sito Web. 2. **Indica da dove leggere** Scegli Intero Sito, incolla l'indirizzo del sito, per esempio `https://www.esempio.it`, e premi Esamina sorgente. 3. **Togli le pagine inutili** Nella colonna «Fonti estratte» togli con la X le pagine che non servono, come carrello, area riservata o pagine vuote. 4. **Allena** Premi Allena Agente e aspetta che la riga del sito diventi «Completato». La lista si aggiorna da sola. Con lo stesso bottone Nuovo allenamento aggiungi documenti, FAQ con le risposte esatte alle domande più frequenti e testi con le informazioni che non sono sul sito. Fonti, stati, limiti e sincronizzazione automatica del sito sono in [Allenamento: come funziona](https://supportfast.ai/it/guida/agente-testuale/allenamento.md). ## 3. Controlla le istruzioni nel Playground Le istruzioni, o **prompt**, dicono all'agente chi è e come comportarsi. L'agente nasce con istruzioni di partenza che vanno già bene per iniziare. 1. **Apri le istruzioni** Vai in Agente chat › Playground e premi il nodo AGENTE, il primo riquadro della tela. A destra si apre il pannello «Istruzioni e modello AI». 2. **Scegli il prompt di partenza** Apri Prompt di partenza e scegli il più vicino alla tua attività, per esempio «Supporto clienti» o «Agente di vendita». Se vuoi, modifica il testo in Istruzioni per l'AI (prompt) e rileggi l'Ambito dell'attività. 3. **Salva e pubblica** Premi Salva modifiche, poi Pubblica e, nella finestra «Pubblica Agente», Conferma e Pubblica. La barra mostra «Pubblicato». Finché non pubblichi, i clienti parlano con la versione precedente: vedi [Provare e pubblicare](https://supportfast.ai/it/guida/agente-testuale/prova-e-pubblica.md). Come scrivere istruzioni efficaci, e cosa lasciare alla base di conoscenza: [Scrivere buone istruzioni](https://supportfast.ai/it/guida/agente-testuale/istruzioni.md). Tutti i comandi: [Playground: istruzioni e flussi](https://supportfast.ai/it/guida/agente-testuale/playground.md). ## 4. Dai un aspetto alla chat 1. **Apri l'interfaccia** Vai in Agente chat › Profilo Agente › Interfaccia. A destra l'«Anteprima Chat» cambia mentre scrivi. 2. **Scrivi i testi e scegli i colori** In Nome della chat metti il nome che leggono i clienti, per esempio «Officina Rossi». Scrivi il Messaggio di Benvenuto e, se vuoi, alcune Domande Suggerite. Poi imposta Colore primario e icona del bottone. 3. **Salva** Premi Salva modifiche in fondo alla pagina. Tutte le opzioni: [Profilo Agente: Interfaccia](https://supportfast.ai/it/guida/agente-testuale/interfaccia.md). ## 5. Provalo come un cliente Con Test Chat, la chat di prova del Playground, provi l'agente dentro la console, anche prima di mettere il widget sul sito. Le prove sono vere: consumano i messaggi del piano e fanno partire le automazioni attive del workspace. 1. **Apri la chat di prova** Premi Test Chat nella barra in alto dell'agente. In cima al pannello leggi se stai provando la bozza salvata o la versione pubblicata. 2. **Fai le domande vere** Chiedi quello che chiedono i tuoi clienti: orari, servizi, come prenotare. Prova anche una domanda fuori tema. L'elenco completo da usare prima del lancio è in [La prova con 20 domande vere](https://supportfast.ai/it/guida/primi-passi/messa-online.md#la-prova-con-20-domande-vere). 3. **Correggi** Dove correggere una risposta sbagliata, caso per caso: [Quando una risposta è sbagliata](https://supportfast.ai/it/guida/agente-testuale/prova-e-pubblica.md#quando-una-risposta-e-sbagliata). > **Consiglio** > > **Vuoi provarlo dal telefono?** In Profilo Agente › Condividi, riquadro «Link e Condivisione Diretta», premi Copia e apri il link sul telefono. Il link apre la versione pubblicata: le chat che nascono così sono conversazioni vere. ## 6. Metti la chat sul tuo sito 1. **Copia il codice del widget** In Profilo Agente › Condividi, nel riquadro «Bottone chat», premi Copia. Il codice è diverso per ogni agente: copialo sempre dalla tua console. 2. **Incollalo nel sito** Incolla il codice nella sezione `` del codice del sito, subito prima di ``, nel modello comune a tutte le pagine. Su WordPress o Shopify non serve toccare il codice a mano: segui [WordPress](https://supportfast.ai/it/guida/sito-web/wordpress.md) o [Shopify](https://supportfast.ai/it/guida/sito-web/shopify.md). Per gli altri siti: [HTML e altri siti](https://supportfast.ai/it/guida/sito-web/altri-siti.md). 3. **Se vuoi, indica il dominio del sito** È facoltativo. In Profilo Agente › Generali scrivi in Dominio di Pubblicazione (Opzionale) il dominio del sito in lettere minuscole, senza `https://` e senza `www`, per esempio `esempio.it`, e salva. Da quel momento il bottone compare solo su quel dominio, con o senza `www`: su un altro dominio, o su un sottodominio come `shop.esempio.it`, non compare. Vedi [Il dominio di pubblicazione](https://supportfast.ai/it/guida/sito-web/installa-widget.md#dominio). 4. **Controlla** Apri il sito e ricarica la pagina: il widget compare in basso a destra, o a sinistra se l'hai scelto. Tutto sull'installazione: [Installare il widget](https://supportfast.ai/it/guida/sito-web/installa-widget.md). > **Risultato** > > Hai un agente che risponde 24 ore su 24 sul tuo sito con le informazioni della tua attività. Le conversazioni arrivano in Conversazioni. Prima di annunciare la chat ai clienti, fai i controlli di [Prima di andare online](https://supportfast.ai/it/guida/primi-passi/messa-online.md). ## Se qualcosa non va Parti da [Problemi con il widget sul sito](https://supportfast.ai/it/guida/aiuto/problemi-widget.md) o da [Problemi dell'agente chat e della conoscenza](https://supportfast.ai/it/guida/aiuto/problemi-agente-testuale.md). ## Domande frequenti **Posso fermare l'agente per un po'?** Sì: premi «Attivo» in alto a destra e scegli «In pausa». Non si cancella niente e lo riattivi quando vuoi. Cosa succede in pausa: [Attivo e In pausa](https://supportfast.ai/it/guida/agente-testuale/panoramica.md#attivo-e-in-pausa). **Può rispondere anche su WhatsApp?** Sì. Collega WhatsApp al workspace ([WhatsApp: collegare il numero](https://supportfast.ai/it/guida/integrazioni/whatsapp.md)), poi in Profilo Agente › Integrazioni premi Collega sulla riga del canale. **Un collega può entrare nella chat al posto dell'agente?** Sì, con la live chat (scheda Chat Operatore), disponibile nei piani che la comprendono: vedi [Profilo Agente: Chat Operatore](https://supportfast.ai/it/guida/agente-testuale/chat-operatore.md) e [Piani, quote e consumi](https://supportfast.ai/it/guida/account/piani-e-consumi.md). ## Leggi anche - [Allenamento: come funziona](https://supportfast.ai/it/guida/agente-testuale/allenamento.md): Tutte le fonti, i limiti e la sincronizzazione del sito. - [Scrivere buone istruzioni](https://supportfast.ai/it/guida/agente-testuale/istruzioni.md): Ruolo, tono, regole: esempi pronti da adattare. - [Installare il widget](https://supportfast.ai/it/guida/sito-web/installa-widget.md): Il codice, il dominio e la verifica sul sito.