Le migliori pratiche per impostare il suo Chatbot RAG utilizzando GoodBarber

Cosa sono i crediti?

Ogni abbonamento a GoodBarber RAG Chatbot include **5.000 crediti al mese**, rinnovati automaticamente. I crediti sono la valuta interna di GoodBarber che copre tutte le operazioni AI che il suo chatbot esegue:

- indicizzazione dei suoi contenuti (articoli, eventi, punti della mappa)
- Elaborazione delle domande degli utenti (convertendole in rappresentazioni vettoriali)
- Generare risposte (la fase che richiede più crediti).

Crediti vs Gettoni: Perché GoodBarber utilizza i crediti invece dei token

Se ha familiarità con i prezzi di OpenAI, sa che i modelli di intelligenza artificiale si fanno pagare per token (all'incirca una parola o un frammento di parola). Allora perché GoodBarber non mostra semplicemente il conteggio dei token?

La risposta è semplice: il costo finanziario di un token varia notevolmente tra i vari modelli. Un token elaborato da GPT-4o costa molto di più dello stesso token elaborato da GPT-4o-mini. Il sistema di crediti di GoodBarber normalizza questa differenza in un'unica unità, indipendente dal modello. Un credito ha sempre lo stesso costo per lei, ma il numero di gettoni che ottiene per credito dipende dal modello di AI che seleziona.

La consideri in questo modo: i crediti sono come una moneta universale, e i gettoni sono i beni che acquista - i modelli più economici le danno più gettoni per credito, mentre i modelli premium le danno meno gettoni.

Stime del mondo reale: Quanti messaggi può inviare?
Sebbene il consumo esatto dipenda dalla lunghezza della conversazione, dalla complessità del contenuto e dal modello selezionato, ecco delle cifre indicative pratiche basate sulle indicazioni del team di assistenza e sui rapporti degli utenti:

Modello	Messaggi stimati per 5.000 crediti	Migliore per
GPT-4o-mini	Fino a ~10.000 messaggi	Applicazioni ad alto volume, efficienti dal punto di vista dei costi
GPT-4o	~2.000-3.000 messaggi	Qualità e costi equilibrati.
GPT-4.1 / GPT-5	~1.000-1.500 messaggi	Massima qualità di risposta

Consiglio: se è agli inizi, inizi con il GPT-4o-mini. Offre una qualità di risposta sorprendentemente buona per la maggior parte dei casi d'uso, mentre estende i suoi crediti di 3-5 volte rispetto ai modelli premium. Potrà sempre passare a un modello più avanzato in un secondo momento, una volta compresi i suoi modelli di utilizzo.

Cosa succede quando i crediti si esauriscono?

Quando i suoi crediti mensili sono esauriti, il chatbot smette di rispondere fino al rinnovo mensile o all'acquisto di crediti aggiuntivi. I pacchetti di crediti aggiuntivi sono disponibili in qualsiasi momento: 5.000 crediti aggiuntivi per 20 euro. GoodBarber le invia un avviso via e-mail quando raggiunge il 20% di crediti residui, dandole il tempo di agire prima che il chatbot diventi silenzioso.

Come monitorare l'utilizzo del credito

Si rechi nelle impostazioni del suo Chatbot RAG nel back office di GoodBarber per visualizzare il suo saldo di credito attuale. Il monitoraggio dell'utilizzo durante le prime settimane è essenziale per stabilire una linea di base per il suo contenuto specifico e il suo pubblico.

Cosa significa "Articoli per feed"?

Il parametro Items Per Feed definisce il numero di elementi di contenuto che il chatbot indicizza da ogni sezione o sottosezione che lei ha abilitato. Controlla direttamente l'ambito della base di conoscenza del suo chatbot.

Ad esempio, se ha una sezione chiamata "Blog" con 500 articoli e imposta Voci per feed su 24, il chatbot indicizzerà solo i 24 articoli più recenti. I restanti 476 articoli sono invisibili all'AI - semplicemente non li trova, indipendentemente dalla loro rilevanza per la domanda dell'utente.

Perché l'impostazione predefinita è bassa (e perché è intelligente)

Una frustrazione comune: "Il mio chatbot non può rispondere a domande su contenuti che so essere presenti nella mia app". In molti casi, il colpevole è un valore basso di Items Per Feed.

GoodBarber imposta di proposito un valore predefinito conservativo. Ecco perché questa è una scelta di design intelligente:

1. Promuove la freschezza dei contenuti. Poiché il chatbot indicizza prima gli articoli più recenti, un limite controllato assicura che le query degli utenti siano abbinate ai suoi contenuti più recenti e aggiornati. Questo è particolarmente prezioso per le notizie, gli eventi o qualsiasi app in cui la tempestività è importante: il suo chatbot dà naturalmente la priorità alle informazioni fresche rispetto agli articoli più vecchi e potenzialmente obsoleti.
2. L'indicizzazione consuma crediti. Ogni articolo indicizzato utilizza crediti dalla sua dotazione mensile. Se ha 10.000 articoli e li indicizza tutti il primo giorno, potrebbe consumare una parte significativa dei suoi crediti prima che un solo utente faccia una domanda.
3. La protegge durante la configurazione. Quando sperimenta diversi modelli, dimensioni di incorporamento e configurazioni, non vuole che ogni prova consumi migliaia di crediti.

Buone notizie: L'impostazione predefinita è già 100 articoli per feed

GoodBarber imposta il valore predefinito di 100 articoli per feed, che è un punto di partenza ragionevole per la maggior parte delle applicazioni. Ciò significa che può andare in onda senza toccare questa impostazione: il suo chatbot indicizzerà fino a 100 elementi per sezione, subito dopo l'installazione.

Tuttavia, se la sua libreria di contenuti è più grande, vorrà aumentare questo valore dopo la convalida della configurazione iniziale. Se vuole indicizzare 10.000 articoli, faccia pure - il limite esiste per proteggere i suoi crediti durante la fase di sperimentazione, non per limitarla in modo permanente.

Quando aumentarlo:
- Dopo aver confermato che la configurazione del suo chatbot funziona bene (modello corretto, buona richiesta, risposte pertinenti).
- Quando si accorge che il chatbot non riesce a trovare contenuti che lei sa essere presenti in sezioni con più di 100 articoli
- Dopo la fase di test iniziale, quando è pronto per andare in produzione.

Dopo aver modificato il valore, i suoi contenuti saranno reindicizzati automaticamente nel ciclo successivo - GoodBarber esegue la reindicizzazione automatica ogni 2 ore, quindi non c'è nulla da attivare manualmente. Basta aggiornare l'impostazione, salvare, e la sua libreria di contenuti ampliata sarà raccolta alla prossima sincronizzazione.

Buono a sapersi: GoodBarber reindicizza automaticamente i suoi contenuti ogni 2 ore. Dopo aver modificato il valore Items Per Feed, è sufficiente salvare le impostazioni e attendere il prossimo ciclo di indicizzazione - non è necessaria alcuna azione manuale.

Come gli articoli per feed influiscono sulla qualità della ricerca

L'impostazione Items Per Feed non influisce solo sul "numero" di risultati che il chatbot può trovare, ma cambia radicalmente la qualità della ricerca semantica. RAG (Retrieval-Augmented Generation) funziona trovando i contenuti semanticamente più simili alla domanda dell'utente. Se l'articolo pertinente non è mai stato indicizzato perché non rientrava nel limite di Items Per Feed, il chatbot restituirà un risultato meno pertinente o dirà all'utente che non è riuscito a trovare nulla.

Questo è particolarmente critico per le app con grandi librerie di contenuti. Se ha 1.400 articoli (come alcuni utenti di GoodBarber) ma ne indicizza solo 24, il chatbot sta lavorando con meno del 2% della sua base di conoscenze.

Che cos'è il prompt di sistema?

Il prompt di sistema (chiamato anche "Messaggio di sistema" o "Tono di scrittura" nell'interfaccia di GoodBarber) è un insieme di istruzioni che indica all'AI come comportarsi, quale personalità adottare e come strutturare le sue risposte. È l'impostazione più importante per la qualità e lo stile delle risposte del suo chatbot.

Senza un prompt di sistema, il suo chatbot utilizzerà un tono neutro e generico. Con un prompt ben realizzato, può diventare un ambasciatore del marchio che si adatta perfettamente alla voce della sua app.

Cosa NON includere nel prompt di sistema

Un errore comune è quello di includere istruzioni tecniche nel prompt di sistema. GoodBarber gestisce già l'impianto tecnico - il recupero di RAG, l'iniezione di contesto e la formattazione della risposta sono configurati sul lato server.

Rimuova questi elementi dal prompt, se li ha:
- # Origine della conoscenza o istruzioni sull'origine dei dati
- Variabili tecniche o parametri correlati all'API
- Formato di uscita o regole di formattazione JSON/HTML

L'AI sa già dove cercare i dati e come formattare i risultati. L'aggiunta di queste istruzioni può confondere il modello o annullare le impostazioni ottimizzate di GoodBarber.

Cosa includere: I tre pilastri di un buon prompt di sistema

Concentri il suo prompt di sistema su tre aree:

Pilastro 1: Ruolo e identità
Dica all'IA chi è. Le dia un nome, un ruolo e uno scopo.

Lei è "Luna", un'assistente amichevole e competente per l'applicazione HealthyLife.
Il suo ruolo è quello di aiutare gli utenti a trovare consigli sulla salute, ricette e suggerimenti sul benessere
dalla nostra libreria di contenuti.

Pilastro 2: Linee guida di stile e tono
Definisca il modo in cui l'AI deve comunicare. Sia specifico sul registro linguistico, sulla lunghezza e sulla personalità.
-

Utilizzi un tono caldo e incoraggiante
- Mantenga le risposte concise (2-3 paragrafi al massimo)
- Eviti il gergo medico - spieghi i concetti in termini semplici
- Concluda sempre con una nota incoraggiante
- Si rivolga agli utenti in modo informale (usi il "tu" e i nomi di battesimo quando possibile

)
Pilastro 3: Comportamento e limiti della risposta
Stabilire dei confini per ciò che l'IA deve e non deve fare. -

Rispondere solo a domande relative alla salute, al benessere e alla nutrizione
- Se un utente chiede qualcosa che non rientra nei contenuti dell'app, reindirizzarlo gentilmente
- Non inventare mai informazioni - se non è in grado di trovare contenuti pertinenti, lo dica onestamente
- Quando cita un contenuto, menzioni il titolo dell'articolo in modo che gli utenti possano trovare il pezzo completo

Passo dopo passo: come modificare il tono del suo Chatbot

Ecco come accedere e modificare il prompt del sistema in GoodBarber:

Passo 1: acceda al back office di GoodBarber

Passo 2: vada su Impostazioni → Sezione RAG → Selezionare la sezione del suo chatbot → Configurazione

Fase 3: Scorra fino al campo "Messaggio di sistema" o "Tono di scrittura".

Fase 4: inserire il suo messaggio di sistema personalizzato seguendo i tre pilastri di cui sopra

Passo 5: salvare le impostazioni e fare un test con alcune domande

Modello di incorporazione: Piccolo o grande

Il modello di embedding indicizza i suoi contenuti - converte il testo in rappresentazioni vettoriali che consentono la ricerca semantica.

- Piccolo: più economico nel consumo di credito. Ottimo per le applicazioni con contenuti semplici e ricchi di testo.
- Grande: Più preciso nella comprensione delle sfumature, dei sinonimi e del contesto. Consigliato per i contenuti con un vocabolario specializzato o quando la precisione è importante.

Raccomandazione: Se il suo budget lo consente, utilizzi il modello di incorporazione Large. La differenza di qualità nei risultati di ricerca è significativa e il costo aggiuntivo del credito al momento dell'indicizzazione è una spesa una tantum per l'aggiornamento del contenuto, non per la query dell'utente.

Modello di completamento: Bilanciare costi e qualità

Il modello di completamento genera la risposta effettiva che l'utente vede. È qui che il compromesso credito-per-token è più importante, perché ogni domanda dell'utente attiva il modello di completamento.

Faccia riferimento alla tabella della Sezione 1 per stimare il suo volume mensile. Per la maggior parte delle applicazioni, GPT-4o-mini offre il miglior rapporto qualità-costo.

L'impostazione di un Chatbot GoodBarber RAG in modo efficace si riduce a tre decisioni: comprendere il suo budget di credito, configurare la giusta portata dei contenuti e dare al suo bot una personalità che corrisponda al suo marchio.

Ecco la sua lista di controllo rapida:

1. Inizi con GPT-4o-mini per massimizzare i messaggi per credito durante i test.
2. Impostare gli articoli per feed a 50-100 durante la configurazione iniziale.
3. Scriva un prompt di sistema mirato che copra il Ruolo, lo Stile e il Comportamento - salti le istruzioni tecniche.
4. Esegua un test approfondito con domande di utenti reali prima di scalare il sistema.
5. Aumentare gli articoli per feed per coprire l'intera libreria di contenuti, una volta convalidata la configurazione.
6. Monitorare il consumo di credito settimanalmente durante il primo mese per stabilire la sua linea di base.
7. Cambi i modelli, se necessario, una volta compresi i modelli di utilizzo del mondo reale.

Il suo chatbot è buono quanto la sua configurazione. Si prenda il tempo necessario per configurarlo correttamente e diventerà una delle funzioni più preziose della sua app.