Glossario

Definizioni dei termini chiave usati sulla piattaforma botts.ai. Una guida di riferimento per capire agenti, basi di conoscenza, deployment, crediti, ruoli e altri concetti.

Un riferimento ai termini chiave usati sulla piattaforma botts.ai e in questa documentazione.

A

Agente

Un assistente IA che configuri nella pagina Agenti. Un agente combina un prompt di sistema, le basi di conoscenza collegate, strumenti integrati e personalizzati, la cronologia delle conversazioni e la memoria cliente. La pagina dell'agente raggruppa Configura, Implementa, le pagine del gruppo Test (Test, Previsioni e Cronologia, vedi Test) e le pagine del gruppo Analisi (Chat, Moduli, Utilizzo). Un agente va online tramite uno o più deployment. Il numero di agenti nella tua organizzazione è limitato dal tuo piano. Vedi Agenti.

Auto-Recharge

Un'impostazione di fatturazione opzionale che ricarica automaticamente i tuoi crediti. Scegli un pacchetto di crediti: ogni volta che il tuo saldo scende sotto il 10% dei crediti mensili inclusi nel tuo piano, quel pacchetto viene addebitato sul metodo di pagamento salvato (il controllo avviene a intervalli di pochi minuti). Durante una prova gratuita la ricarica automatica non è attiva; parte quando il piano è pagato. Dopo tre addebiti falliti di fila, la ricarica automatica viene disattivata e resta spenta finché non la riattivi esplicitamente nelle impostazioni di fatturazione (la riattivazione azzera il contatore degli errori). Aggiornare solo il metodo di pagamento non la riattiva. Le e-mail di avviso per saldo basso vengono inviate solo quando la ricarica automatica non è attiva. Vedi Team e fatturazione.

B

Modello di backup

Un secondo modello IA opzionale su un deployment sito web o chat interna. Gestisce il traffico solo quando il modello principale non funziona (vedi Failover). Il modello di backup deve essere un modello di testo e deve essere diverso da quello principale. Puoi scegliere un backup dello stesso provider, ma il modulo del deployment mostra un avviso sull'affidabilità: è consigliato un provider diverso. Se il modello principale comprende le immagini e il backup no, un messaggio con un'immagine allegata non passa al backup (il modulo lo segnala). Il backup viene verificato rispetto al tuo livello di residenza dei dati, perché durante un'interruzione gestisce traffico reale. I deployment telefonici non supportano modelli di backup. Vedi Deployment.

C

Canale

Il modo in cui un deployment raggiunge i suoi utenti. I canali attualmente selezionabili sono Sito Web (widget di chat, facoltativamente con voce IA), Telefono (chiamate vocali su un vero numero di telefono) e Chat (Interna) (chat interna per il tuo team). Telegram, WhatsApp ed Email compaiono nel selettore dei canali, ma non sono ancora disponibili («In arrivo»).

Memoria della chat

La tua memoria personale nella Chat della dashboard: ciò che hai condiviso sul tuo ruolo, sui tuoi progetti e sulle tue preferenze, più un breve riepilogo di ciò su cui hai lavorato di recente, usata da ogni modello con cui chatti. È attiva per impostazione predefinita e la vedi solo tu. In Impostazioni → Memoria della chat puoi disattivarla, eliminare singoli fatti (Dimentica questo) o cancellarla del tutto (Dimentica tutto). Da non confondere con la memoria cliente, che un agente conserva sulle persone con cui parla.

Chunk

Un segmento di testo di un documento, dimensionato per un recupero ottimale. Quando un documento viene elaborato, viene suddiviso in chunk che vengono indicizzati singolarmente. Così il sistema di ricerca può trovare la sezione più pertinente di un documento, non solo il documento più pertinente.

Connessione

Un sistema esterno che la tua organizzazione ha collegato nella scheda Integrazioni → Strumenti. Una connessione contiene l'URL e le credenziali una sola volta e mette a disposizione uno o più strumenti che gli agenti possono chiamare. Esistono tre tipi: un server MCP, un'API HTTP (un URL di base più gli endpoint che definisci tu) e Importa un'API (una specifica OpenAPI che incolli e che diventa una connessione API HTTP). Le credenziali di una connessione sono condivise in tutta l'organizzazione oppure collegate per utente, così ogni membro agisce nel sistema esterno con la propria identità. Vedi Integrazioni.

Contatto (utente finale)

Una persona che interagisce con il tuo agente tramite un deployment: chi visita il sito e scrive nel widget, oppure chi chiama la tua linea telefonica. I contatti sono registrati nella pagina Chat dell'agente (vista Raggruppati), dove vedi le conversazioni di ogni persona e gli eventuali fatti che l'agente ha memorizzato su di lei (vedi Memoria). I contatti non sono membri del team della tua organizzazione. Vedi Persone e memoria.

Conversazione

Una singola sessione di interazione tra un contatto e un agente. Una conversazione contiene tutti i messaggi scambiati durante una sessione di chat o una telefonata. Le conversazioni sono elencate nella pagina Chat dell'agente.

Cronologia delle conversazioni

Una funzione dell'agente (interruttore in Configura) che permette all'agente di vedere i messaggi recenti delle conversazioni precedenti con lo stesso contatto sullo stesso canale. L'identità di un contatto vale per canale: chi visita il sito, chi chiama e chi usa la chat interna sono contatti separati anche se si tratta della stessa persona, quindi la cronologia non passa da un canale all'altro. Puoi impostare quanti messaggi passati includere. A differenza della memoria, che conserva in forma condensata ciò che l'agente ha appreso, la Cronologia conversazioni passa all'agente i messaggi recenti così come sono.

Scansione (crawl)

Il processo automatico che visita pagine web, ne estrae il testo e lo indicizza in una base di conoscenza. Le scansioni seguono i link a partire dall'URL iniziale e possono essere avviate manualmente oppure con una pianificazione giornaliera, settimanale o mensile. La scansione costa 1 credito per pagina scansionata. Vedi Base di conoscenza.

Pacchetto di crediti

Un pacchetto fisso di crediti che puoi acquistare in aggiunta ai crediti mensili del tuo piano, con prezzi in CHF, EUR e USD e pagato con un addebito unico. I crediti acquistati scadono 12 mesi dopo l'acquisto. I pacchetti di crediti sono anche ciò che la ricarica automatica addebita automaticamente.

Crediti

La valuta di utilizzo di botts.ai. I crediti vengono consumati da:

Ogni piano include un contingente mensile di crediti che si rinnova a ogni periodo di fatturazione; i crediti del piano non utilizzati scadono alla fine del periodo. I crediti acquistati (vedi Pacchetto di crediti) durano 12 mesi; vengono sempre usati prima i crediti del piano. Quando il saldo arriva a zero, i nuovi messaggi in chat (widget del sito web, chat interna, Test Chat) vengono rifiutati, la voce IA del widget e le telefonate vengono respinte (le telefonate con un messaggio vocale), le scansioni, i caricamenti di file e le esecuzioni dei test vengono bloccati e le esecuzioni pianificate vengono saltate.

D

Livello di residenza dei dati

Un'impostazione valida per tutta l'organizzazione (chiamata Posizione del server nella pagina Organizzazione → Generale) che limita i modelli IA che la tua organizzazione può usare, in base a dove vengono elaborati i dati e a quale azienda gestisce i server:

La Svizzera e l'UE valgono entrambe come «europee». I selettori del modello elencano solo i modelli conformi, e il salvataggio di un modello non conforme viene rifiutato. Il livello vale anche per la voce IA del widget per il sito web (GPT Live 1, ospitato in Svezia da un'azienda statunitense): con i due livelli svizzeri e con Server europeo, azienda europea l'opzione vocale non è disponibile per chi visita il sito. Se rendi più restrittivo il livello, i deployment esistenti con modelli non più conformi continuano a funzionare, ma vengono segnalati con un badge di avviso sul loro agente. L'archiviazione delle basi di conoscenza e l'infrastruttura della piattaforma sono ospitate in Svizzera per ogni organizzazione, indipendentemente dal livello. Vedi Deployment.

Deployment

Un'istanza attiva di un agente collegata a un canale specifico, gestita nella scheda Implementa dell'agente. Ogni deployment ha il proprio modello IA, un modello di backup opzionale e impostazioni specifiche per il canale. I deployment sito web ricevono inoltre una chiave API univoca che autentica il widget incorporato; i deployment di chat interna e telefonici non ne hanno: la chat interna raggiunge i membri che hanno effettuato l'accesso, e le chiamate arrivano tramite la rete telefonica, dove una chiave del widget non ha alcun ruolo. Un agente può avere più deployment, per esempio uno sul tuo sito web e un altro sulla tua linea telefonica, e tutti condividono la stessa configurazione dell'agente e le stesse basi di conoscenza. Il tuo piano limita quanti deployment attivi puoi avere; disattivare un deployment con il suo interruttore libera spazio. Vedi Deployment.

E

Embedding

Una rappresentazione matematica del testo (un vettore) che ne cattura il significato semantico. Gli embedding rendono possibile la ricerca semantica, cioè trovare contenuti in base al significato invece che a corrispondenze esatte di parole chiave. botts.ai genera gli embedding su infrastruttura svizzera.

Utente finale

Vedi Contatto (utente finale).

Aspettativa

La parte obbligatoria di un test salvato: una descrizione in linguaggio semplice di ciò che deve fare una buona risposta successiva, per esempio i fatti che deve indicare, il tono o un limite di lunghezza. La legge solo il valutatore, mai l'agente, quindi non cambia il modo in cui l'agente risponde. I fatti si possono verificare solo se è l'aspettativa stessa a fornirli. Vedi Test.

F

Failover

Il passaggio automatico dal modello principale di un deployment al suo modello di backup quando il modello principale non funziona. Il failover scatta in caso di errori del server del provider (5xx), limiti di richieste (429), timeout di connessione ed errori di rete, quando un modello non invia il primo token entro 30 secondi, quando il provider segnala il modello stesso come non valido o dismesso, e in caso di generazione vuota (una chiamata andata a buon fine ma senza alcuna risposta, che viene ritentata prima di passare al backup). Anche una conversazione troppo lunga per la finestra di contesto del modello principale viene servita da un backup con una finestra più ampia. Dopo tre errori di fila un modello viene saltato per un po' (circa 12 minuti): le richieste vanno direttamente al backup oppure, se non c'è un backup, terminano subito con «Il modello selezionato non risponde al momento.» Non scatta per altri errori del client, dopo che l'agente ha già iniziato a trasmettere una risposta in una chat dal vivo (le esecuzioni pianificate possono ancora passare al backup a metà turno), né dopo che nello stesso turno è già stato eseguito uno strumento con effetti esterni (come l'invio di un modulo o un HTTP POST). Il failover vale solo per i canali di testo.

Modulo / Cattura Lead

Uno strumento integrato dell'agente (interruttore nella scheda Configura) che permette all'agente di raccogliere dati strutturati dagli utenti: dati di contatto, ticket di supporto, richieste di prenotazione. Definisci uno o più moduli con campi denominati; durante la conversazione l'agente raccoglie i valori in modo naturale e invia il modulo. Gli invii compaiono nella pagina Moduli dell'agente e, se vuoi, puoi ricevere per ogni invio una notifica all'indirizzo e-mail di notifica della tua organizzazione.

H

Ricerca ibrida

Un metodo di ricerca che combina la ricerca semantica (basata sul significato) e la ricerca full-text (basata sulle parole chiave) per fornire risultati completi. È la modalità di ricerca predefinita usata dagli agenti e dalla ricerca di prova della base di conoscenza.

I

Integrazione

Il termine generale per tutto ciò che i tuoi agenti possono raggiungere al di fuori di botts.ai, gestito nella pagina Integrazioni (sezione Officina della barra laterale) con due schede: Strumenti (le connessioni condivise da tutti gli agenti della tua organizzazione) e Segreti (le credenziali cifrate a cui fanno riferimento queste connessioni). Vedi Integrazioni.

Chat interna

Il canale Chat (Interna): un deployment che rende disponibile un agente ai membri del tuo team all'interno della dashboard, tramite Chat nella barra laterale. Ogni agente può avere al massimo un deployment di chat interna. L'accesso può essere limitato all'intera organizzazione, a un ruolo minimo o a un elenco di invitati. Tra le opzioni ci sono un'Immagine Chat, una Descrizione mostrata all'inizio di una chat, l'interruttore Mostra utilizzo strumenti, che stabilisce se gli utenti vedono quali strumenti sta usando l'agente, e l'interruttore Caricamento file, che permette agli utenti di allegare documenti.

K

Base di conoscenza

Una raccolta di informazioni che un agente usa per rispondere alle domande, gestita in Conoscenza nella barra laterale. Le basi di conoscenza si costruiscono aggiungendo fonti: siti web scansionati o file caricati. Il contenuto viene estratto, suddiviso in chunk, trasformato in embedding e indicizzato per il recupero. Un agente può collegare più basi di conoscenza, e una base di conoscenza può essere condivisa da più agenti. Tutti i dati delle basi di conoscenza sono salvati in Svizzera. Vedi Base di conoscenza.

M

Server MCP

Un server remoto che usa il Model Context Protocol, uno standard aperto per mettere strumenti a disposizione degli assistenti IA. Invece di descrivere tu gli endpoint, indichi a botts.ai il server e botts.ai scopre cosa offre; poi importi gli strumenti che ti servono. Gli strumenti importati hanno un nome nella forma servername__toolname, con il nome del server come prefisso. Se in seguito il server cambia l'elenco dei suoi strumenti, botts.ai mostra le differenze e continua a usare l'insieme approvato in precedenza finché non lo approvi di nuovo, così un server non può ridefinire di nascosto ciò che fa il tuo agente. Vedi Server MCP.

Memoria

La funzione Memoria cliente (interruttore nella scheda Configura dell'agente, disattivata per impostazione predefinita). Dopo ogni conversazione, l'agente estrae ciò che ha appreso sulla persona, come il nome preferito, lo stile di comunicazione o istruzioni permanenti, e lo applica automaticamente nelle conversazioni future. La memoria viene salvata per persona e per agente. Un'impostazione di conservazione stabilisce per quanto tempo vengono conservate queste informazioni: Conserva a tempo indeterminato (predefinito), oppure 30, 60, 90, 180 giorni o 1 anno. Puoi rivedere ed eliminare i fatti memorizzati nella pagina Chat dell'agente: passa alla vista Raggruppati e seleziona una persona. Per la memoria delle tue chat nella dashboard, vedi Memoria della chat. Vedi Persone e memoria.

Modello

Un modello linguistico IA che fa funzionare un deployment. Ogni deployment sceglie un modello principale; i deployment sito web e chat interna possono aggiungere un modello di backup. Il selettore del modello mostra per ogni modello il provider, la posizione dell'hosting, le valutazioni di velocità e intelligenza e le tariffe in crediti. I modelli di testo sono fatturati in token (le tariffe sono mostrate per ~1'000 parole come approssimazione); il modello vocale GPT Live 1 è fatturato al minuto (indicato come «Voice N credits / min»). I modelli che comprendono le immagini allegate hanno il badge Images. I deployment telefonici richiedono un modello vocale; tutti gli altri canali usano modelli di testo, e la voce IA opzionale del widget per il sito web funziona sempre con GPT Live 1. Quali modelli sono disponibili dipende dal tuo livello di residenza dei dati.

O

Organizzazione

Uno spazio di lavoro condiviso su botts.ai in cui collaborano i membri del team. Le organizzazioni contengono agenti, basi di conoscenza, integrazioni e membri del team con i rispettivi ruoli. Il piano, il saldo crediti e il livello di residenza dei dati valgono tutti a livello di organizzazione. Tutte le risorse appartengono a un'organizzazione.

P

Pagina

L'unità usata per i limiti di dimensione delle basi di conoscenza: una pagina = 2'000 caratteri di testo estratto e salvato. Il numero di pagine di un documento è il numero di caratteri diviso per 2'000, arrotondato per eccesso. Il limite di pagine vale per i contenuti scansionati e caricati insieme, su tutte le basi di conoscenza della tua organizzazione.

Piano

Il livello di abbonamento della tua organizzazione, che stabilisce i crediti mensili e i limiti delle risorse:

Il piano Personal include solo lo spazio di lavoro della chat IA interna (nessun deployment su canali esterni). Personal e Business iniziano con una prova gratuita (rispettivamente di 1 mese e di 14 giorni, con 150 e 1'500 crediti iniziali), senza carta di credito e una sola per persona. Puoi anche scegliere Preferisco pagare subito, senza prova per avere subito tutti i crediti mensili e lasciare inutilizzata la prova. I vecchi piani Free e Lite non sono più offerti ai nuovi clienti. Vedi Team e fatturazione.

R

Ruolo

Il livello di autorizzazione di un membro del team all'interno di un'organizzazione. La gerarchia è Membro < Builder < Admin < Proprietario; ogni ruolo include tutto ciò che possono fare i ruoli inferiori.

I ruoli determinano anche l'accesso ai deployment basato sul ruolo: un deployment può richiedere un ruolo minimo (per esempio Builder o Admin) per poterlo usare.

S

Test salvato

Una conversazione che termina con un messaggio del cliente, salvata su un agente insieme a un'aspettativa e a tag opzionali. Esegui tutti riesegue ogni test salvato di un agente con la sua configurazione attuale, su una piattaforma, un modello e un insieme di strumenti a scelta, e valuta ogni risposta come Superato, Non superato o Non valutabile. Fino a 200 per agente; si creano a mano, dalla Test Chat o da una conversazione con un cliente, oppure vengono proposti nella pagina Previsioni (Prevedi chat future). Vedi Test.

Attività pianificata

Un'esecuzione ricorrente e personale di un agente, gestita in Pianificate nella barra laterale. Esegue un agente distribuito o un modello generico con cadenza giornaliera, settimanale o mensile, se vuoi a partire da una data di inizio (Inizia il) e fino a una data di fine (Termina il), oppure una sola volta in un giorno a scelta, e consegna il risultato via e-mail oppure nella tua chat, contrassegnato come non letto. Le attività appartengono all'account che le ha create, non all'organizzazione, quindi nessun altro le vede. Ogni esecuzione non riuscita ti viene segnalata via e-mail, e dopo tre errori consecutivi un'attività viene messa in pausa automaticamente; un'esecuzione per cui non ci sono crediti disponibili viene saltata, non messa in coda. Vedi Attività pianificate.

Segreto

Una credenziale cifrata (chiave API, token, password) salvata nella scheda Integrazioni → Segreti. Ai segreti si fa riferimento negli URL delle connessioni, nelle intestazioni, nei campi di autenticazione e nei valori fissi dei parametri con la sintassi $secret:key, che viene risolta al momento della chiamata. I valori sono cifrati a riposo e non vengono mai restituiti dall'API; per sostituire un segreto, eliminalo e crealo di nuovo. Per impostazione predefinita, i segreti valgono per tutta l'organizzazione. Per le connessioni per utente esistono due ambiti più ristretti: il tuo segreto personale e quello che un admin salva per conto di un collega specifico. Usa l'ambito dell'organizzazione per tutto ciò che un agente chiama su un canale pubblico. Vedi Integrazioni.

Ricerca semantica

Un metodo di ricerca che trova i contenuti in base al significato di una domanda, non alle parole esatte usate. Per esempio, una ricerca di «orari di apertura» troverebbe anche contenuti che dicono «orari d'ufficio» o «quando siamo aperti».

Fonte

L'origine di un contenuto in una base di conoscenza. Una fonte è un sito web (un URL che viene scansionato, con impostazioni di scansione proprie e una pianificazione opzionale) oppure un file (un documento .pdf, .doc, .docx, .txt o .md caricato, fino a 100 MB per file). Ogni fonte aggiunge documenti e chunk alla base di conoscenza; eliminare una fonte elimina tutto il suo contenuto indicizzato. Vedi Base di conoscenza.

Prompt di sistema

Le istruzioni che definiscono la personalità, il comportamento e le regole di un agente, modificate nella scheda Configura dell'agente. Il prompt di sistema dice al modello IA chi è, come comunicare, di quali argomenti occuparsi e quali limiti rispettare.

T

Le tre I

Lo schema che descrive i tre pilastri di ogni agente IA su botts.ai: Informazione (base di conoscenza), Intelligenza (configurazione e ragionamento dell'agente) e Interazione (deployment e canali).

Strumento

Una capacità che un agente può usare durante una conversazione. Gli strumenti integrati includono la ricerca nella conoscenza (attivata automaticamente quando colleghi delle basi di conoscenza), Navigazione avanzata della Knowledge Base (permette all'agente di elencare e leggere documenti interi), la ricerca web e Modulo / Cattura Lead. La Prenotazione appuntamenti (trovare orari liberi e prenotare in un calendario Cal.com, in chat e nelle conversazioni vocali) la configura botts.ai su richiesta; vedi Agenti. Nella Chat della dashboard l'assistente può anche eseguire codice in una sandbox isolata per analizzare fogli di calcolo e rispondere con grafici e file scaricabili. Gli strumenti di una connessione permettono all'agente di chiamare sistemi esterni, per esempio per controllare le scorte o cercare un ordine. L'agente decide quando usare uno strumento in base alla conversazione e alla descrizione dello strumento. Ogni strumento si collega agente per agente, e ogni strumento collegato aggiunge testo al prompt del modello: un elenco breve e ragionato funziona meglio di uno lungo. Vedi Integrazioni.

V

Ricerca vettoriale

Vedi Ricerca semantica. Internamente, la ricerca semantica si basa sulla similarità vettoriale: confronta gli embedding matematici della domanda e dei contenuti salvati per trovare le corrispondenze più vicine.

W

Ricerca web

Uno strumento integrato, disattivato per impostazione predefinita, che permette a un agente di cercare sul web in tempo reale e di aprire singole pagine per leggerle per intero, citando le fonti. Si attiva per agente nella sezione Strumenti integrati e, se vuoi, puoi limitarla a un massimo di 10 domini (oppure escludere fino a 10 domini). Viene fatturata per ricerca più per pagina aperta. Le ricerche web sono gestite da un fornitore in Francia, indicato nel pannello Valutazione dei dati del deployment ogni volta che la funzione è attiva. Vedi Ricerca web.

Widget

La finestra di chat che un deployment Sito Web incorpora nel tuo sito tramite un tag script di una riga che contiene la chiave API del deployment; funziona su qualsiasi sito web. Aspetto e comportamento (colori, font, messaggio di benvenuto, messaggi suggeriti, stile del launcher (Bolla, Bolla con messaggio o Scheda con pulsanti), lingua, posizione, dimensione, una Voce IA opzionale con cui chi visita il sito può parlare con l'agente, e altro) si personalizzano dopo la creazione in un editor con anteprima dal vivo, e si applicano con un clic esplicito su Salva modifiche. La chiave è pubblica per scelta (si trova nel codice sorgente della tua pagina e funziona solo per il widget di questo deployment). Nella dashboard non si può sostituire: per una chiave nuova, crea un nuovo deployment sito web e sostituisci il codice di incorporamento. Vedi Deployment.

Ultimo aggiornamento: 4 ottobre 2026