Puoi creare un chatbot per il sito web con Agentkit senza scrivere un'applicazione. Aggiungi pagine o file approvati, scegli come deve rispondere l'agente, testalo nel Playground e poi copia entrambi i tag script generati nell'area codice del tuo sito. L'ultimo passo è un test sulla pagina pubblicata. Una bolla di chat che compare nell'editor non dimostra che i visitatori possano usarla.
Ti servono un account Agentkit, contenuti che hai il permesso di usare e l'autorizzazione ad aggiungere codice personalizzato al tuo sito web. Se il piano del tuo sito o il tuo ruolo non consentono di pubblicare script, un iframe inline può essere un'opzione dove gli embed sono permessi. Controlla le regole del tuo sito prima di iniziare.
1. Parti da una domanda e dalla sua risposta approvata
Scegli tre domande che i visitatori fanno davvero. Includi una domanda di routine, una la cui risposta dipende da una policy in vigore e una a cui le tue fonti non rispondono. Annota per ciascuna la risposta approvata o il canale di contatto umano. Questa piccola chiave di risposte ti dà qualcosa di concreto da verificare in seguito.
Per esempio, un negozio potrebbe chiedere: «Quando posso restituire un articolo in saldo?». Usa la sua policy sui resi in vigore come fonte della risposta. Se la policy non copre gli articoli in saldo, la risposta accettabile è dire che non può confermare la regola e indirizzare il visitatore al negozio. L'esempio è uno schema di test, non un'affermazione sulla policy di un negozio specifico.
2. Crea l'agente e aggiungi le fonti
Crea un account, apri la dashboard e scegli Add AI agent. La procedura guidata ti accompagna attraverso Link, Sources, Design e AI. Puoi fornire l'URL del tuo sito o aggiungere le fonti manualmente. In Sources, seleziona le poche pagine che contengono le tue risposte approvate. Aggiungi un file, un frammento di testo o una coppia domanda-risposta solo quando fornisce una risposta che manca a quelle pagine. La guida alle fonti spiega i tipi di fonte disponibili.
Rivedi ciò che il crawler ha incluso. Un URL del sito non garantisce che ogni pagina sia utilizzabile, aggiornata o approvata. Evita di aggiungere versioni di policy duplicate o contrastanti. Dopo una modifica della policy, aggiorna la fonte interessata e ritesta la sua domanda. Il riaddestramento automatico a pagamento aggiorna gli URL del sito già indicizzati; non scopre ogni nuova pagina né sostituisce per te i file caricati. La guida alle fonti da sito web spiega questo limite.
3. Imposta il design e le regole di risposta
In Design, imposta un nome riconoscibile, un colore e un messaggio di apertura. Dì ai visitatori a cosa può rispondere l'agente. In AI, scegli tra i modelli attualmente offerti nel tuo account e scrivi brevi istruzioni su ambito e incertezza. I nomi dei modelli e l'accesso per piano cambiano, quindi usa il selettore nel tuo workspace invece di un elenco statico in un articolo.
Un'istruzione utile è: «Rispondi alle domande sulla nostra policy sui resi pubblicata usando le fonti fornite. Se manca un dettaglio o le fonti sono in conflitto, dì che non puoi confermarlo e indirizza il visitatore a [canale di supporto]». Sostituisci il testo tra parentesi quadre con un canale che il tuo team monitora davvero. Le istruzioni guidano il comportamento; non possono rendere vero materiale di partenza mancante o contraddittorio.
Completa la procedura guidata e apri il Playground. Fai le tue tre domande, poi una domanda di follow-up che cambia un dettaglio importante. Confronta ogni risposta con la tua chiave di risposte scritta. Correggi la fonte o le istruzioni e ripeti il test se una risposta è sbagliata. Se l'agente offre la raccolta di lead o un'azione, testa la sua destinazione reale prima di attivarla per i visitatori; una promessa nella conversazione da sola non è un passaggio di consegne completato.
4. Installa il codice widget generato
Apri la pagina Channels → Website embed dell'agente, seleziona Chat widget e attiva il canale. Copia il codice completo generato per il tuo agente. Contiene un breve tag di bootstrap della coda comandi seguito da un tag loader asincrono con il tuo ID agente e l'URL del widget configurato. Incolla entrambi i tag insieme nel campo codice del footer del tuo sito o nel template HTML condiviso, prima di </body>. Pubblica il sito. Non copiare un ID o un URL di script da un articolo di esempio.
Se vuoi un pannello di chat dentro una sezione della pagina invece di una bolla flottante, attiva Iframe nella stessa pagina Website embed e usa il codice iframe generato. Per il posizionamento sulle piattaforme, segui la guida corrente del widget JavaScript, di React e Next.js, di WordPress, di Webflow o di Framer. Aggiungi il codice del widget una sola volta per pagina renderizzata.
5. Controlla la pagina pubblica
Apri l'URL pubblicato in una nuova finestra del browser, anche su un telefono. Tieni questo breve registro di accettazione:
| Controllo | Risultato atteso | Se fallisce |
|---|---|---|
| Sorgente della pagina | Entrambi i tag widget generati compaiono una volta | Controlla il permesso di inserimento codice del sito, il passaggio di pubblicazione e la cache. |
| La chat si apre | La bolla si apre e accetta un messaggio | Controlla che Chat widget sia attivo e che lo script si carichi. |
| Domanda nota | La risposta concorda con la fonte approvata | Correggi la fonte o le istruzioni, poi ritesta. |
| Domanda sconosciuta | L'agente evita di inventare una policy e offre il canale di contatto reale | Aggiungi un canale di escalation esplicito e testa di nuovo. |
| Passaggio a un umano | Il link di contatto, il modulo o l'azione raggiunge la destinazione prevista | Correggi la destinazione prima del lancio. |
Se il widget compare nel Playground ma non sul dominio pubblico, controlla le restrizioni di dominio oltre al codice generato. Se la bolla si apre ma non riesce a rispondere, controlla l'elaborazione delle fonti e la tua quota di messaggi. Registra URL di test, domanda, risposta osservata e data così da poter ripetere lo stesso controllo dopo un aggiornamento delle fonti.
Un lancio senza codice richiede comunque la titolarità delle fonti e la revisione delle risposte. Inizia con un insieme ristretto di domande, pubblica e ispeziona le conversazioni reali per individuare lacune. Se vuoi provare questo flusso di lavoro, crea un account Agentkit e testa il widget pubblicato prima di indirizzarvi i visitatori.
