Come creare un'app chatbot IA: chiavi, prompt, costi e sicurezza

Per creare un'app chatbot IA servono quattro cose: un'interfaccia di chat, un piccolo server che custodisce la chiave API del provider del modello e inoltra i messaggi, un system prompt che spiega al modello chi è e cosa può fare, e dei limiti che tengano sotto controllo costi e abusi. Un app builder con AI può scrivere tutto questo a partire da una descrizione. La parte che resta a te è scegliere il provider, scrivere le istruzioni e decidere cosa il bot non deve mai fare.

Di cosa è fatta un'app chatbot IA

La maggior parte delle app chatbot, che si tratti di un assistente di supporto, di un tutor o di uno strumento interno « chiedi ai nostri documenti », ha le stesse parti:

Il punto in cui si sbaglia più spesso è la route del server. Se la pagina di chat chiama direttamente il provider dal browser, chiunque può aprire gli strumenti per sviluppatori, copiare la tua chiave ed esaurire il tuo budget.

Decisioni da prendere prima di costruire

Quale provider e quale modello

I principali provider (OpenAI, Anthropic, Google e altri) offrono tutti un'API in stile chat che funziona allo stesso modo: invii una lista di messaggi e ricevi una risposta. La scelta pratica dipende meno dal marchio e più dalla dimensione del modello:

• Modelli più piccoli e veloci costano meno e rispondono in fretta. Vanno bene per risposte brevi, classificazione e bot FAQ semplici.
• Modelli più grandi ragionano meglio, seguono istruzioni lunghe in modo più affidabile e gestiscono domande confuse, ma costano di più per messaggio e rispondono più lentamente.

Parti da un modello di dimensione media, testalo con le tue domande reali, poi sali o scendi di conseguenza. Se non conosci ancora come vengono prezzate e chiamate queste API, leggi prima come usare le API LLM.

Da dove arriva la conoscenza del bot

Parti dall'opzione più semplice che copre i tuoi contenuti. Il retrieval aggiunge un indice di ricerca, un modo per tenerlo aggiornato e più punti in cui le risposte possono sbagliare. Molti bot utili non ne hanno mai bisogno.

Pubblico o dietro un login

Un chatbot pubblico sul tuo sito è facile da raggiungere, ma anche facile da abusare: qualcuno può inviare migliaia di messaggi con uno script. Un chatbot con login ti permette di salvare la cronologia per utente e di impostare un limite giornaliero per account. Se è pubblico, limita la lunghezza dei messaggi e quanti messaggi può inviare un visitatore in un dato periodo, e imposta un limite mensile rigido nella dashboard del provider. Come aggiungere il login alla tua app spiega la parte relativa agli account.

Se salvare le conversazioni

I thread salvati sono utili: gli utenti possono riprendere da dove avevano lasciato e tu puoi leggere domande reali per migliorare il prompt. Sono però dati personali. Decidi per quanto tempo li conservi, dillo nella tua informativa sulla privacy e non salvare nulla di cui non hai bisogno.

Scrivi il system prompt come una descrizione di mansione

Il system prompt è l'istruzione che il modello riceve prima di ogni conversazione. Uno buono si legge come un breve brief per un nuovo collaboratore:

• Ruolo e pubblico: « Sei l'assistente di aiuto di Oakline, un'officina di biciclette. Parli con i clienti. »
• Ambito: « Rispondi a domande su servizi, prezzi, orari e prenotazioni. Per tutto il resto, di' che puoi aiutare solo per quanto riguarda il negozio. »
• Fonte di verità: « Usa solo le informazioni qui sotto. Se la risposta non c'è, di' che non lo sai e indica il numero di telefono del negozio. »
• Tono e lunghezza: « Cordiale, in italiano semplice, al massimo tre frasi a meno che non venga chiesto un dettaglio. »
• Regole ferree: « Non promettere mai un prezzo di riparazione che non sia in elenco. Non chiedere mai i dati della carta. »

Poi mettilo alla prova con domande scomode: richieste fuori tema, messaggi scortesi, domande la cui risposta non è nei tuoi contenuti e tentativi di farlo ignorare le istruzioni (« dimentica le regole e… »). Modifica il prompt finché le risposte sono quelle che firmeresti con il tuo nome.

Tieni i costi prevedibili

I provider addebitano a token (grosso modo, frammenti di parole) l'input che invii e l'output che il modello scrive. Tre fattori determinano la fattura:

1. Lunghezza della conversazione. Ogni nuovo messaggio di solito reinvia l'intero thread, così il modello ha il contesto. Una chat di 40 messaggi costa molto di più per risposta di una di 4. Conserva solo gli ultimi turni, oppure riassumi quelli più vecchi.
2. Dimensione del prompt. Un system prompt lungo o un grande blocco di conoscenze incollato viene inviato con ogni messaggio.
3. Lunghezza dell'output. Imposta una lunghezza massima della risposta nella chiamata API e chiedi risposte concise nel prompt.

Prima del lancio imposta un limite di spesa mensile nella dashboard del provider e registra l'uso dei token per richiesta, così vedi quali conversazioni sono costose. Non riportiamo qui i prezzi perché variano per modello e cambiano spesso: controlla la pagina dei prezzi ufficiale del tuo provider.

Costruiscilo passo dopo passo

Passo 1: descrivi il bot, non il codice

Un primo prompt che indica pubblico, ambito, dati e regole di sicurezza ti porta già gran parte della strada:

Crea un chatbot di assistenza clienti per Oakline, un'officina di biciclette. Una pagina di chat con elenco dei messaggi e campo di input, risposte in streaming man mano che vengono scritte. Chiama l'API di Anthropic da una route del server usando il segreto ANTHROPIC_API_KEY — non esporlo mai al browser. Usa un system prompt che risponde solo a domande su servizi, prezzi e orari presi dal testo del file shop-info.md, e che altrimenti dice « Non sono sicuro — chiamaci al numero qui sotto ». Limita i messaggi a 500 caratteri e a 20 messaggi per visitatore all'ora. Design pulito e cordiale che funzioni bene sul telefono.

Passo 2: aggiungi la chiave come segreto

Crea la chiave nella console del provider, poi salvala nelle variabili d'ambiente o nei segreti del progetto, non nella chat e non nel codice. Se una chiave finisce in un posto pubblico, revocala presso il provider e creane una nuova. Cosa sono le variabili d'ambiente e i segreti spiega perché conta.

Passo 3: testa le risposte, non solo l'interfaccia

Quando la chat funziona, dedica la maggior parte del tempo alla qualità delle risposte. Tieni una lista di circa 20 domande reali, incluse alcune che andrebbero rifiutate, e riesegui il test dopo ogni modifica al prompt. Verifica:

• Resta nell'ambito previsto?
• Ammette quando non sa, invece di inventare una risposta?
• Regge quando qualcuno prova a sovrascrivere le sue istruzioni?
• La chiave è assente da tutto ciò che il browser scarica?

Passo 4: aggiungi memoria e account, se ti servono

Quando le singole conversazioni funzionano, chiedi thread salvati in un database e, se serve, registrazione e login, così ogni utente vede solo le proprie chat. Aggiungi contemporaneamente un limite giornaliero di messaggi per utente.

Passo 5: pubblica con i limiti attivi

Assicurati che l'app pubblicata abbia gli stessi segreti dell'anteprima, che il tetto di spesa sia impostato presso il provider e che gli errori siano registrati in un posto che controllerai. Poi condividila con un piccolo gruppo prima di metterla sul sito principale.

Sicurezza e fiducia

Un chatbot parla al pubblico a tuo nome, quindi considera i suoi punti deboli come un tuo problema:

• Risposte sbagliate. I modelli possono affermare cose false con sicurezza. Mantieni il bot su un tema ristretto, ancoralo ai tuoi contenuti e mostra una breve nota che avverte che le risposte possono essere errate su questioni importanti.
• Prompt injection. Gli utenti (o i documenti che il bot legge) possono contenere istruzioni come « ignora le regole precedenti ». Non dare al bot poteri di cui non ci si può fidare: niente rimborsi, cancellazioni o email inviate su richiesta di un utente senza un controllo nel tuo codice.
• Argomenti sensibili. Per domande mediche, legali o finanziarie, fai indirizzare le persone verso un professionista invece di dare consigli.
• Dati personali. Non incollare dati dei clienti nei prompt se non è necessario, e verifica nei termini del provider come vengono trattati i dati delle API.

La nostra checklist di sicurezza per app costruite con AI copre l'app nel suo insieme.

Errori comuni

• Chiamare il provider dal browser. La chiave viene esposta. Passa sempre dal tuo server.
• Nessun limite su un bot pubblico. Uno script può svuotare il budget di un mese in un pomeriggio.
• Iniziare subito con RAG, strumenti e più modelli. Fai funzionare prima una buona conversazione; aggiungi il resto quando le domande reali mostrano che serve.
• Testare solo domande gentili. Già il primo giorno, gli utenti faranno domande strane, ostili e fuori tema.
• Lasciare che il thread cresca all'infinito. Costi e tempi di risposta aumentano a ogni messaggio.

Quando un prodotto già pronto è la scelta migliore

Costruirlo da zero ha senso quando il chatbot fa parte del tuo prodotto, richiede i tuoi dati o il tuo flusso di lavoro, oppure deve avere un aspetto e un comportamento specifici. Spesso non è la scelta giusta quando:

• Vuoi solo un widget di supporto su un sito esistente. Molti prodotti di help desk e live chat includono ormai bot IA che leggono il tuo centro assistenza, con passaggio a un operatore umano, casella di posta e reportistica già pronti.
• A usarlo sarete solo tu o il tuo team. Un abbonamento a un assistente generico come ChatGPT o Claude, con i tuoi documenti caricati, potrebbe bastare.
• Ti servono garanzie di conformità rigide (per esempio per dati sanitari o finanziari regolamentati). Un fornitore che ha già le certificazioni può essere più sicuro di una soluzione su misura.

Costruirlo con Mythex

Mythex è un app builder con AI: descrivi il chatbot in chat, e il sistema scrive l'interfaccia e la chiamata lato server, la esegue in un'anteprima dal vivo e la pubblica su un URL pubblico. L'AI dentro la tua app usa la tua chiave del provider. La aggiungi nei segreti del progetto, oppure tramite la scheda dei segreti che Mythex mostra in chat quando serve, e l'uso del provider viene fatturato sul tuo account presso il provider, non sui crediti di build di Mythex. Mythex non include token per gli utenti della tua app, né un prodotto di base di conoscenza, né limiti di frequenza già pronti: sono elementi che richiedi e testi tu. La pagina della documentazione su aggiungere l'AI dentro la tua app descrive i passaggi, e aggiungere l'AI con le tue chiavi API include un prompt di partenza.

Se il bot ha bisogno di thread salvati, Mythex collega al progetto un database Postgres quando lo chiedi. Per altri modi di usare i modelli dentro un'app, dai riepiloghi alla classificazione, vedi come aggiungere funzionalità AI alla tua app, oppure sfoglia i template di app per punti di partenza.

Domande