Per creare un agente AI per il tuo sito web, parti da un solo compito del visitatore e da un piccolo insieme di risposte approvate. In Agentkit, aggiungi quelle fonti, regola la chat, testala nel Playground e poi copia il codice di incorporamento da Channels → Website embed. Pubblica solo quando una pagina reale restituisce le risposte che ti aspetti. Puoi aggiungere azioni una volta che il percorso base di domande e risposte funziona.
Questa guida riguarda una chat per sito web basata su conoscenza, con azioni facoltative. Non promette che un agente possa completare una prenotazione, emettere un rimborso o modificare un ordine solo perché è in grado di parlare di quei compiti.
1. Scegli il compito prima di scegliere il modello
Scrivi la richiesta che vuoi gestire per prima. Per esempio: "Aiutare i visitatori a trovare la nostra politica di spedizione e spiegare quando un ordine ha diritto alla consegna gratuita." Indica la fonte di riferimento e il percorso alternativo per le domande a cui l'agente non può rispondere. Così avrai un criterio per giudicare il risultato in seguito.
Se ti serve un albero decisionale fisso senza risposte generate, una chat a copione può essere più adatta. Se ti servono dati specifici di un account o una transazione, pianifica l'integrazione e il suo confine di approvazione prima di invitare i visitatori a usarla. Una fonte sito web da sola non può consultare un ordine privato né completare un acquisto.
2. Crea l'agente e controlla le sue fonti
Crea un account Agentkit e avvia un nuovo chatbot. La procedura guidata accetta un URL di sito web o fonti manuali, poi mostra le pagine trovate prima di passare al design e alle impostazioni AI. Modelli e quote disponibili dipendono dal tuo piano attuale, quindi usa le opzioni mostrate nel tuo account e controlla i prezzi attuali prima di pianificare il budget per il traffico pubblico.
Per un URL di sito web, la procedura mostra le pagine trovate, ma non permette di rimuoverne una alla volta in questa fase. Dopo la configurazione e l'addestramento, apri Sources → Website. Rimuovi le pagine su cui i visitatori non dovrebbero fare affidamento, come offerte scadute o vecchie versioni delle policy. Mantieni le pagine attuali di prodotto, policy e assistenza. Se il crawler salta una pagina, aggiungila da Sources → Website dopo la configurazione. Da Sources puoi anche aggiungere file, testo e voci di domande e risposte. La guida alla fonte sito web spiega i controlli di scansione.
Parti da poche pagine che puoi verificare. Una scansione più ampia è utile solo se le sue pagine sono accurate e pertinenti. Non inserire documenti privati nelle fonti di un agente pubblico solo perché un controllo di caricamento li accetta.
3. Imposta l'aspetto e le istruzioni della chat
Nella procedura guidata, scegli il design e le impostazioni AI adatte al compito del visitatore. Dopo la creazione, puoi tornare al design e alle istruzioni dell'agente. Un messaggio di apertura utile indica a cosa l'agente sa rispondere: "Chiedi di consegne, resi o cura del prodotto." Le domande suggerite possono dare ai visitatori un punto di partenza, ma non sostenere che migliorino la conversione senza misurarlo sul tuo sito.
Dai all'agente un confine che possa rispettare. Per l'esempio della spedizione: "Usa le nostre informazioni pubblicate su spedizioni e resi. Se una data di consegna dipende da un ordine specifico, di' che non puoi vedere quell'ordine e indirizza il visitatore all'assistenza." Includi il percorso di assistenza reale. Le istruzioni non sostituiscono una fonte corretta né un test della risposta.
4. Testa le risposte prima di aggiungere azioni
Usa il Playground per fare domande sulle pagine approvate. Annota domanda, fonte e risposta attesa. Questo piccolo set di lancio rende più facile controllare le modifiche successive.
| Domanda di test | Risultato atteso | Errore da correggere |
|---|---|---|
| "Quando la spedizione è gratuita?" | Indica la soglia attuale dalla pagina di spedizione pubblicata. | Cita una soglia vecchia o ne inventa una. |
| "Dov'è l'ordine 12345?" | Dice che non può vedere un ordine privato senza una ricerca ordini collegata e indica il percorso di assistenza. | Indovina una data di consegna. |
| "Potete fare un'eccezione alla politica di reso?" | Spiega la policy pubblicata e rimanda le eccezioni a una persona. | Promette un'eccezione. |
Il numero d'ordine è un test illustrativo, non un record reale di un cliente. Se una risposta è sbagliata, controlla prima la fonte. Aggiorna la pagina obsoleta o aggiungi una voce precisa di domande e risposte, poi ripeti la stessa domanda. La guida all'addestramento copre la manutenzione delle fonti e il controllo delle risposte.
5. Aggiungi una sola azione, e solo quando ha un risultato chiaro
Le azioni possono raccogliere un lead, mostrare un pulsante o collegare un servizio supportato. Scegli un'azione che appartenga al compito del visitatore, poi testa nel Playground sia il percorso di successo sia quello di errore. Per esempio, un'azione Collect Leads può chiedere un'email perché una persona possa ricontattare. Un lead inviato è una richiesta di contatto, non la prova che una vendita o un appuntamento siano avvenuti. La guida a Collect Leads mostra la configurazione.
Se l'azione apre un fornitore di prenotazioni, completa una prenotazione di prova su quel fornitore e verifica la sua conferma. Se ha bisogno di dati specifici di un account, controlla i permessi ed evita di promettere un risultato finché l'integrazione non lo restituisce. Per un agente utile di domande e risposte puoi lasciare le azioni disattivate.
6. Copia il codice generato dal tuo account
Quando le risposte e le eventuali azioni superano i test, apri Channels → Website embed. Scegli Chat widget per una bolla flottante o Iframe per un pannello integrato. Attiva il canale che intendi usare. I due canali hanno interruttori separati. Agentkit segnala che l'iframe non supporta le funzioni avanzate. Se hai aggiunto un'azione, provala nel canale che pubblicherai.
Per il widget, copia il codice generato completo. Contiene un piccolo script di avvio e uno script asincrono del widget con l'ID del tuo agente e l'host configurato. Inserisci entrambi i tag una sola volta nel footer condiviso o nel template HTML del tuo sito, prima di </body>, poi pubblica. Per un pannello integrato, copia invece l'iframe generato e dagli abbastanza altezza nel tuo layout. Non usare un URL del widget, un percorso iframe o un pacchetto React copiati da un articolo più vecchio. La guida all'incorporamento copre posizionamento e risoluzione dei problemi. Chi gestisce un sito WordPress può seguire la guida WordPress attuale.
7. Verifica una pagina pubblica e continua a controllarla
Apri la pagina pubblicata in una nuova finestra del browser. Conferma che la bolla o il pannello compaia, si apra, accetti un messaggio e restituisca una risposta basata su una fonte a una delle tue domande di lancio. Poi fai una domanda che dovrebbe rifiutare o passare a una persona. Annota cosa è successo. Un incorporamento funzionante dimostra solo che la chat si è caricata; non dimostra che ogni risposta sia sicura.
Se la chat non compare, controlla che il canale corretto sia attivo e che la pagina pubblicata contenga il codice generato completo o l'iframe. Un editor del sito o una cache possono rimuovere o ritardare gli script. Se si carica ma non riesce a rispondere, controlla lo stato di addestramento delle fonti e le impostazioni dell'agente. La guida alle restrizioni di dominio spiega un possibile blocco dell'incorporamento.
Dopo il lancio, esamina le conversazioni reali per individuare domande senza risposta che si ripetono. Correggi la fonte, poi ripeti la domanda di lancio interessata e un controllo sulla pagina pubblica. Mantieni visibile un normale canale di contatto quando l'agente non può aiutare. Questo è lo standard pratico per un agente di sito web: i visitatori ottengono una risposta utile, capiscono quando non ce l'ha e raggiungono la persona o la pagina successiva.
