Come creare un agente AI per il tuo sito in 7 passaggi

Un agente AI sul tuo sito fa più che rispondere alle domande. Capisce la tua attività, guida i visitatori verso l'informazione giusta, raccoglie lead quando l'intento è alto e lavora senza sosta 24 ore su 24. A differenza di una semplice pagina FAQ o di un chatbot statico con risposte predefinite, un agente AI usa grandi modelli linguistici per sostenere conversazioni naturali fondate sui tuoi contenuti reali.

Questa guida ti accompagna nella creazione di un agente AI per il sito web da zero usando Agentkit. Non serve programmare. Alla fine avrai un agente funzionante che conosce la tua attività, rispetta il tuo brand ed è online sul tuo sito.

Cosa fa davvero un agente AI per il sito web

Prima di crearne uno, capisci cosa porta al tuo sito un agente AI che altri strumenti non offrono.

Capacità principali

Un agente AI si trova all'intersezione tra supporto, vendite e navigazione. Non è solo un help desk. È un membro del team sempre disponibile che conosce tutto della tua attività.

Prerequisiti

Prima di iniziare, assicurati di avere:

• Un sito web su cui vuoi implementare l'agente (qualsiasi sito che permetta JavaScript personalizzato)
• Contenuti su cui addestrare (l'URL del tuo sito è il minimo indispensabile; documenti, FAQ e descrizioni di prodotto migliorano la qualità)
• Uno scopo chiaro per l'agente (supporto, vendite, guida al prodotto o una combinazione)
• 15-45 minuti per la configurazione completa

Non ti servono:

• Competenze di programmazione
• Esperienza in AI o machine learning
• Infrastruttura server
• Chiavi API per i modelli AI (Agentkit le gestisce per te)

Passaggio 1: crea il tuo agente

Registrati su Agentkit e crea il tuo primo chatbot. Il piano Free ti dà 50 messaggi al mese con un chatbot, sufficienti per configurare, testare e validare prima di passare a un piano a pagamento.

Dalla tua dashboard:

1. Clicca su Crea agente.
2. Dagli un nome (è interno; i visitatori non lo vedranno a meno che tu non scelga di mostrarlo).
3. Seleziona il tuo modello AI principale. Buone scelte di partenza:
   • GPT-4o Mini per risposte rapide ed economiche sulla maggior parte degli argomenti
   • GPT-4o per ragionamenti più sfumati e domande complesse
   • Claude Sonnet per risposte conversazionali dal suono naturale
   • Gemini Pro per gestire contesti più lunghi e conversazioni multi-turno

Puoi cambiare il modello in seguito senza dover riaddestrare, quindi non pensarci troppo in questo passaggio.

Passaggio 2: aggiungi le tue fonti di conoscenza

Il tuo agente vale quanto le informazioni a cui ha accesso. Agentkit supporta quattro tipi di fonte, e gli agenti più forti ne usano una combinazione.

Scansione del sito web (inizia da qui)

Inserisci l'URL del tuo sito e lascia che il crawler indicizzi le tue pagine. È il modo più veloce per dare al tuo agente una conoscenza ampia della tua attività.

1. Vai alla scheda Fonti del tuo chatbot.
2. Clicca su Aggiungi fonte e seleziona Sito web.
3. Inserisci l'URL di partenza (di solito la tua homepage).
4. Scegli l'ambito della scansione:
   • Pagina singola: solo quell'URL
   • Sottodirectory: tutte le pagine sotto un percorso (ad es. /docs/ o /help/)
   • Sito completo: ogni pagina raggiungibile dal crawler

Per la maggior parte delle attività, inizia con la scansione del sito completo. Puoi rimuovere le pagine irrilevanti in seguito.

Cosa scansionare:

• Pagine di prodotto e servizio
• Pagina dei prezzi
• FAQ e centro assistenza
• Pagina Chi siamo e informazioni aziendali
• Articoli del blog con contenuti sempreverdi

Cosa saltare:

• Pagine di login e amministrazione
• Pagine di checkout e carrello
• Vecchi articoli del blog con informazioni superate
• Pagine povere di contenuto (archivi di tag, categorie vuote)

Documenti

Carica PDF, documenti Word o file di testo che contengono informazioni non presenti sul tuo sito.

Buoni candidati: specifiche di prodotto, manuali dei dipendenti, documenti di policy, guide utente, schede tecniche.

Coppie di domande e risposte

Scrivi coppie domanda-risposta specifiche per gli argomenti su cui ti serve un controllo preciso della risposta. Prezzi, politiche di rimborso e funzionalità spesso fraintese sono buoni candidati.

Le coppie di domande e risposte hanno priorità sui contenuti scansionati, quindi usale per le tue domande più importanti. Vedi Come addestrare un chatbot per le best practice dettagliate su come scriverle.

Frammenti di testo

Incolla testo grezzo per aggiunte rapide: promozioni in corso, annunci stagionali, messaggi del brand o notizie recenti.

Strategia consigliata per le fonti

Passaggio 3: personalizza l'aspetto dell'agente

Il tuo agente dovrebbe sembrare parte del tuo sito, non uno strumento di terze parti aggiunto in un secondo momento.

Impostazioni visive

Configura queste opzioni nella scheda Impostazioni del chatbot:

• Colore principale: abbinalo al colore principale del tuo brand
• Posizione: in basso a destra (predefinito) o in basso a sinistra
• Messaggio di benvenuto: la prima cosa che i visitatori vedono quando aprono la chat. Rendilo specifico: "Ciao, posso aiutarti a trovare il piano giusto, rispondere a domande sulle nostre funzionalità o guidarti nei primi passi. Cosa stai cercando?"
• Avatar: carica il tuo logo o un'icona personalizzata
• Branding: sui piani a pagamento, puoi rimuovere il branding Agentkit così l'agente appare completamente white-label

Comportamento del widget

• Apertura automatica: scegli se la finestra della chat si apre automaticamente o attende che il visitatore ci clicchi
• Messaggi suggeriti: prompt precompilati che appaiono come pulsanti cliccabili, per guidare i visitatori verso gli argomenti più comuni

Un messaggio di benvenuto forte e messaggi suggeriti scelti bene aumentano significativamente il coinvolgimento. I visitatori che vedono "Chiedimi qualsiasi cosa" spesso non sanno da dove iniziare. I visitatori che vedono prompt specifici come "Quali piani offrite?" e "Come inizio?" cliccano subito.

Passaggio 4: configura le azioni

Le azioni definiscono cosa può fare il tuo agente oltre a rispondere alle domande. Agentkit offre cinque tipi di azione:

Configurare la raccolta lead

Per la maggior parte delle attività, la raccolta lead è l'azione a maggior valore. Configurala nella scheda Azioni:

1. Seleziona Raccogli contatti.
2. Scegli i tuoi campi: email (obbligatoria), nome, azienda, telefono o campi personalizzati.
3. Scrivi l'istruzione del prompt di sistema che dice all'agente quando attivare la raccolta lead. Ad esempio: "Dopo aver risposto alla domanda del visitatore su prezzi o funzionalità, offriti di inviargli una guida comparativa e chiedi la sua email."

Mantieni al minimo i campi obbligatori. Ogni campo obbligatorio in più riduce i tassi di completamento. La sola email basta per iniziare. Puoi raccogliere altre informazioni tramite conversazioni di follow-up o email.

Per un approfondimento sulle strategie di raccolta lead, vedi Come usare i chatbot per la lead generation.

Configurare i messaggi suggeriti

Aggiungi 3-5 messaggi suggeriti che coprono le domande più comuni dei tuoi visitatori:

• "Cosa offrite?"
• "Quanto costa?"
• "Come inizio?"
• "Posso vedere una demo?"
• "Cosa vi rende diversi?"

Questi appaiono come pulsanti cliccabili quando il visitatore apre la chat, rendendo facile avviare una conversazione.

Passaggio 5: scrivi le istruzioni dell'agente

Il prompt di sistema è la configurazione più importante che scriverai. Definisce ogni risposta che il tuo agente fornisce. Investici tempo.

Componenti essenziali

Il tuo prompt di sistema ha bisogno di cinque elementi:

1. Identità: "Sei l'assistente AI di [Nome azienda]. Aiuti i visitatori del sito a capire i nostri prodotti, trovare il piano giusto e ottenere risposte alle loro domande."

2. Tono: "Sii amichevole, diretto e professionale. Usa frasi brevi. Evita il gergo tecnico. Non iniziare le risposte con frasi di riempimento come 'Ottima domanda!' o 'Assolutamente!'"

3. Confini: "Rispondi solo a domande su [Nome azienda] e i nostri prodotti. Se ti viene chiesto di argomenti fuori dalla tua conoscenza, dì: 'Sono specializzato in [Nome azienda]. Per quell'argomento, ti suggerirei [risorsa alternativa]. Come posso aiutarti con i nostri prodotti?' Non inventare mai informazioni."

4. Formato: "Mantieni le risposte sotto le 120 parole. Usa elenchi puntati per le liste. Includi link pertinenti quando disponibili."

5. Escalation: "Se un visitatore è frustrato, scusati per l'inconveniente e fornisci la nostra email di supporto: [email]. Per problemi di fatturazione o account, indirizza sempre al team di supporto."

Per template dettagliati e tecniche avanzate, vedi Prompt engineering per chatbot.

Calibrazione del tono

Il tono che imposti nel prompt di sistema dovrebbe corrispondere al tuo brand. Ecco alcuni punti di riferimento:

Passaggio 6: testa nel Playground

Prima di andare online, testa a fondo il tuo agente nel Playground. È il tuo ambiente di prova per individuare i problemi prima che lo facciano i visitatori.

Checklist di test

Cosa correggere durante i test

Risposte sbagliate: aggiungi o aggiorna le coppie di domande e risposte per le domande specifiche che ricevono risposte sbagliate. Le coppie di domande e risposte hanno priorità sui contenuti scansionati.

Informazioni mancanti: aggiungi il contenuto pertinente tramite scansione del sito web, caricamento di documenti o frammenti di testo.

Tono sbagliato: modifica la sezione tono del tuo prompt di sistema. Aggiungi esempi di risposte se il modello non rispetta la voce desiderata.

Troppo prolisso: aggiungi limiti sul numero di parole nella sezione formato del tuo prompt di sistema.

La raccolta lead sembra insistente: modifica il timing del trigger. Spostalo più avanti nella conversazione o cambia la formulazione per renderla più orientata al valore.

Passaggio 7: incorpora sul tuo sito web

Una volta che il tuo agente supera i test, implementalo sul tuo sito. Agentkit offre quattro metodi di incorporamento:

Widget JavaScript (consigliato)

Aggiungi una riga di codice al tuo sito, appena prima del tag di chiusura </body>:

<script
  src="https://cdn.agentkit.ai/widget.js"
  data-chatbot="YOUR_CHATBOT_ID"
  async>
</script>

È il metodo più veloce e funziona su qualsiasi sito: HTML statico, WordPress, Shopify, Squarespace, Wix, Webflow o qualsiasi CMS personalizzato. Il widget si carica in modo asincrono e non influisce sulla velocità della tua pagina.

Componente React

Se il tuo sito è costruito con React, usa il componente React di Agentkit per un'integrazione più stretta:

import { AgentiChatbot } from '@agentkit/react';

function App() {
  return <AgentiChatbot chatbotId="YOUR_CHATBOT_ID" />;
}

Plugin WordPress

Se usi WordPress, installa il plugin Agentkit dalla directory dei plugin di WordPress. Inserisci l'ID del tuo chatbot nelle impostazioni del plugin e il widget appare automaticamente su ogni pagina. Vedi Come aggiungere un chatbot a WordPress per una guida completa.

Iframe

Per situazioni in cui JavaScript è limitato, incorpora il chatbot come iframe:

<iframe src="https://cdn.agentkit.ai/embed/your-chatbot-id" width="400" height="600"></iframe>

Questo metodo ti dà meno controllo sul posizionamento ma funziona in ambienti che limitano gli script esterni.

Dopo il lancio: ottimizzazione continua

Implementare il tuo agente non è il traguardo finale. I migliori agenti AI migliorano continuamente in base ai dati reali delle conversazioni.

Settimana 1: monitora da vicino

• Rivedi ogni conversazione nei tuoi log chat
• Nota le domande a cui l'agente risponde male o non riesce a rispondere
• Aggiungi coppie di domande e risposte o fonti aggiuntive per colmare le lacune
• Verifica che la raccolta lead si attivi nei momenti giusti

Settimane 2-4: itera sui dati di addestramento

• Aggiungi le prime 10 domande senza risposta come coppie di domande e risposte
• Espandi la scansione del sito web alle pagine inizialmente saltate
• Carica documenti che coprono in modo più approfondito gli argomenti più richiesti
• Rifinisci il tuo prompt di sistema in base alle osservazioni su tono e formato

Ogni mese (in corso):

• Rivedi gli Analytics per i trend del volume delle conversazioni
• Verifica le fonti di addestramento per i contenuti superati
• Aggiorna le coppie di domande e risposte quando cambiano prodotti, prezzi o policy
• Testa con nuove domande man mano che la tua attività evolve

Sui piani Standard ($119.99/mese) e Pro ($399.99/mese), il riaddestramento automatico mantiene sempre aggiornate le tue fonti sito web.

Avanzato: integrazione API e webhook

Una volta che il tuo agente funziona bene, estendi le sue capacità con le integrazioni.

Webhook

Configura i webhook per inviare dati sugli eventi ai tuoi sistemi quando si verificano azioni specifiche:

• Nuovo lead catturato: invia i dettagli di contatto al tuo CRM
• Conversazione completata: registra i dati della conversazione sulla tua piattaforma di analisi
• Modulo personalizzato inviato: instrada i dati del modulo al tuo sistema di ticketing

I webhook inviano una richiesta POST con dati JSON a qualsiasi URL specifichi.

Zapier

Collega il tuo agente a oltre 5.000 app senza scrivere codice. Flussi di lavoro comuni:

• Lead catturato in Agentkit, crea un contatto in HubSpot
• Lead catturato in Agentkit, invia una notifica Slack al canale vendite
• Conversazione completata, aggiungi una riga a Google Sheets per il tracciamento

Zapier è disponibile sui piani Hobby ($29.99/mese) e superiori.

API REST

Costruisci integrazioni personalizzate usando l'API REST di Agentkit. Estrai i dati delle conversazioni, gestisci i chatbot in modo programmatico e integra con strumenti interni. L'API è disponibile sui piani Hobby e superiori.

Per una guida completa alle opzioni di integrazione, vedi Integrazioni API per chatbot.

Domande comuni

Quanto tempo richiede la configurazione?

La configurazione di base (creare l'agente, aggiungere la fonte sito web, personalizzare, incorporare) richiede 15-30 minuti. Aggiungere coppie di domande e risposte, documenti e affinare il prompt di sistema aggiunge altri 15-30 minuti. La maggior parte delle persone ha un agente funzionante online sul proprio sito entro un'ora.

Quanti messaggi usa un agente AI?

Dipende dal traffico e dal coinvolgimento dei visitatori. Un sito di una piccola impresa potrebbe usare 200-500 messaggi al mese. Un sito ad alto traffico con un agente ben configurato potrebbe usarne 5.000-20.000. Inizia con il piano Free (50 messaggi) per valutare il volume, poi passa a un piano superiore secondo necessità.

Posso usare l'agente per più scopi?

Sì. Un singolo agente può gestire domande di supporto, catturare lead e guidare i visitatori verso i contenuti giusti. Il prompt di sistema definisce le priorità. Se il supporto è la priorità, enfatizza risposte accurate. Se la lead generation è la priorità, enfatizza qualificazione e cattura.

Cosa succede se l'agente non conosce la risposta?

Se l'agente non riesce a trovare informazioni pertinenti nei suoi dati di addestramento, segue le istruzioni di fallback nel tuo prompt di sistema. Un buon fallback indirizza il visitatore verso una risorsa alternativa (email di supporto, centro assistenza, numero di telefono) invece di indovinare.

Posso cambiare il modello AI in seguito?

Sì. Passa tra uno qualsiasi dei 12 modelli disponibili (famiglie GPT, Claude, Gemini) dalla pagina delle impostazioni. Non serve riaddestrare. È utile per testare quale modello produce le risposte migliori per i tuoi contenuti.

In sintesi

Creare un agente AI per il tuo sito web non è più un progetto ingegneristico di mesi. Il processo è lineare: crea, addestra, personalizza, configura le azioni, scrivi le istruzioni, testa e implementa. Il lavoro vero inizia dopo il lancio, quando usi i dati delle conversazioni per migliorare continuamente la conoscenza e il comportamento dell'agente.

Inizia in modo semplice. Una fonte sito web, un prompt di sistema chiaro e qualche messaggio suggerito. Metti l'agente online, osserva le conversazioni e migliora da lì. Un agente semplice che migliora ogni settimana batterà un agente sovraingegnerizzato che non viene mai lanciato.

Crea gratis il tuo agente AI →

Nessuna carta di credito richiesta.