# Configurazione del bot AI

Il tuo bot AI è il cuore della piattaforma. Legge i messaggi dei tuoi clienti, comprende le loro esigenze e risponde in modo naturale, come un membro del team esperto che non dorme mai. Questa guida ti accompagna passo dopo passo nella configurazione del tuo bot.

**La buona notizia:** non sono necessarie competenze tecniche. Se sai descrivere come vuoi che si svolga una conversazione, puoi configurare il tuo bot.


> **Dove si trova.** Tutto ciò che vedi in questa pagina si trova nel passaggio **Istruzioni AI** del tuo [AI Agent](../ai-agents/ai-agents.md), il primo nell'editor dell'agente.

---

## Cosa può fare il tuo bot AI

Una volta configurato, il tuo bot può:

- **Rispondere alle domande** su prodotti, servizi, prezzi e politiche
- **Prenotare appuntamenti** e gestire il tuo calendario
- **Qualificare i lead** ponendo le domande giuste e raccogliendo i dettagli di contatto
- **Connettersi ad altri strumenti** come il tuo CRM, il sistema di ordini o la piattaforma di prenotazione
- **Effettuare follow-up automatici** quando le conversazioni si interrompono
- **Passare la palla al tuo team** quando incontra qualcosa che non è in grado di gestire

Ogni Agente ha la propria configurazione bot, quindi puoi impostare bot diversi per scopi diversi - un bot di supporto, un bot per le vendite, un bot per eventi e così via - e riutilizzare ciascuno di essi in ogni canale o Broadcast che lo richiede.

---

## Provider AI (Come pensa il bot)

La piattaforma utilizza i modelli di IA più recenti per alimentare il tuo bot. Il livello **Pro** si basa su **Anthropic Claude (Sonnet)**: eccelle nel seguire le istruzioni e nel comprendere il contesto. La maggior parte degli account dispone anche di **Max**, il nostro livello interno più veloce ed economico, che rappresenta il miglior rapporto qualità-prezzo per quasi tutti (vedi [Perché Max è il miglior rapporto qualità-prezzo](ai-model-comparison.md)), e di **Mini** al suo fianco: la stessa famiglia interna su una configurazione più leggera, per il prezzo più basso per risposta. Puoi scegliere il livello per ogni Agente nell'impostazione **Qualità IA**. Finché non selezioni un livello e salvi, l'Agente viene eseguito su **Pro** e addebita 1 credito per azione, anche se Max è disponibile sul tuo account. (Il vecchio livello **Economy** è in fase di dismissione: usa invece Max.)

**Non è necessario scegliere un fornitore di IA.** Scegli un livello di **Qualità IA** sull'Agente (Pro, Max o Mini) e la piattaforma esegue il modello dietro quel livello per te. Tu devi solo concentrarti sul dire al bot cosa fare.

---

## Avvio rapido: configurazione automatica tramite onboarding

Se stai configurando l'app per la prima volta, la **procedura guidata di onboarding** può configurare il tuo bot automaticamente. Durante l'onboarding, inserisci l'URL del tuo sito web e l'AI della piattaforma analizza il tuo sito per:

- **Generare istruzioni per il bot** su misura per la tua attività, inclusi tono, obiettivi e flusso di conversazione
- **Creare FAQ** dai contenuti del tuo sito web in modo che il bot conosca già i tuoi prodotti, i prezzi e le politiche
- **Impostare le informazioni sulla tua azienda** in base a ciò che trova sul tuo sito

Questo ti offre un bot perfettamente funzionante in pochi minuti. Puoi sempre perfezionare la configurazione generata automaticamente in seguito utilizzando i passaggi seguenti.

---

## Il flusso di lavoro consigliato (Playbook)

Non devi (e non dovresti) scrivere il playbook perfetto il primo giorno. I bot di maggior successo sulla piattaforma — inclusi quelli che hanno chiuso **milioni di dollari di entrate** — seguono lo stesso ciclo di iterazione snella. Ecco il flusso di lavoro che funziona:

### 1. Genera la prima bozza da un URL

Crea l'Agente puntandolo a un sito web (la tua pagina di vendita, pagina prodotto, landing page). La piattaforma genera il playbook iniziale dal contenuto della pagina: questo compila automaticamente le Istruzioni AI dell'Agente. Non modificare troppo per ora: dai solo un'occhiata ai campi generati, correggi ciò che è palesemente errato e procedi.

### 2. Perfeziona con Ottimizza con AI

Apri l'Agente e clicca su **Ottimizza con AI**: su un Agente si trova nell'intestazione della chat **Prova**, ed è presente su ogni Agente. Invece di riscrivere il playbook a mano, fornisci a Ottimizza l'**obiettivo generale** in un linguaggio semplice, ad esempio:

> "Stiamo lanciando una promozione per il Black Friday: 30% di sconto sul nostro pacchetto annuale fino al 1° dicembre. Aggiorna il playbook per menzionare questa offerta e spingere per le iscrizioni prima della scadenza."

L'IA riscrive l'intero playbook per adattarlo al nuovo obiettivo. Al termine, visualizzerai una **schermata di revisione** prima che qualsiasi modifica diventi operativa: ogni modifica proposta viene mostrata fianco a fianco, confrontando il testo attuale con quello che l'IA suggerisce. Mantieni le modifiche che ti piacciono e disattiva quelle che non ti convincono; le aggiunte, le modifiche e le rimozioni suggerite per le FAQ sono elencate separatamente e ognuna viene applicata solo se la accetti esplicitamente. **Applica** salva la tua selezione, **Rifiuta tutto** ripristina il playbook esattamente com'era, e chiudere la revisione mantiene le modifiche in sospeso per una decisione successiva. Su un Agente, ciò che applichi viene salvato come **bozza**: prova alcuni messaggi nella scheda **Prova** per assicurarti che il risultato sia corretto, quindi fai clic su **Pubblica** nel banner ambra in alto nell'editor per renderlo operativo. La maggior parte dei playbook dovrebbe essere pubblicata entro **20.000 caratteri**, ben al di sotto del limite.

### 3. Itera dalle conversazioni dal vivo

Una volta che il bot è online, osserva le chat reali che arrivano. Quando una risposta del bot non è del tutto corretta:

1. Apri quella chat nell'[Interfaccia Chat](../chats/chat-interface.md).
2. Usa il ciclo **chat → playground → correggi → salva** documentato in [Chat Playground](../chats/playground.md#fixing-a-live-chat-with-try-out-replay-loop): metti pollice verso al turno errato, modifica il playbook nel pannello laterale, riavvia, salva.

Ogni correzione aggiunge o regola una piccola regola nel playbook. Nelle **1-2 settimane** successive — solitamente dopo 20-50 conversazioni dal vivo — il playbook converge. Dopodiché, raramente lo toccherai di nuovo. Alcuni dei bot più longevi sulla piattaforma non vengono modificati da due anni.

### Mantieni il tuo playbook snello

I limiti di caratteri esistono per essere **generosi**, non per essere riempiti. I playbook di successo tendono a collocarsi nell'intervallo di **10.000-30.000 caratteri**, non verso il tetto massimo di 80.000+. Un playbook denso e focalizzato supera sempre uno dispersivo.

**Perché la densità è importante (l'analogia del dipendente):** Immagina di formare un nuovo dipendente. Se gli dai un obiettivo chiaro, lo eseguirà bene. Se gli dai dieci obiettivi diversi, centinaia di regole per ogni possibile messaggio e un manuale di 50 pagine come contesto, finirà per deviare dall'obiettivo principale, confondersi e commettere più errori. L'IA si comporta allo stesso modo.

Consigli concreti:

- **Un Agent = un obiettivo chiaro.** Se hai obiettivi molto diversi (vendita, supporto, reclutamento, prenotazioni), crea Agent separati per ciascuno. Un bot specializzato per obiettivo supera in prestazioni un bot generalista.
- **Non riversare interi post di blog, presentazioni di vendita o white paper nel playbook.** Estrai i fatti di cui il bot ha effettivamente bisogno per chiudere l'affare. Tutto il resto va nelle FAQ (dove la ricerca intelligente carica solo ciò che è rilevante per messaggio).
- **Smetti di aggiungere regole preventivamente.** Aspetta che una conversazione dal vivo vada male, quindi aggiungi una regola per quel caso specifico. Le regole che immagini di aver bisogno raramente corrispondono a quelle di cui hai effettivamente bisogno.
- **Metà del limite è più che sufficiente.** Se stai raggiungendo il limite di caratteri, di solito è un segnale che il playbook ha perso il focus, non un segnale per aumentare il limite.

---

## Configurazione del bot (passo dopo passo)

1. Nella barra laterale principale, sotto **AI Studio**, fai clic su **AI Agents**.
2. Apri l'Agent che desideri configurare.
3. Fai clic sulla sua scheda **Istruzioni AI**.


**Lingua principale** si trova nella parte superiore della scheda, sopra ogni altra cosa. È la lingua in cui la tua IA scrive per impostazione predefinita e la lingua che utilizza per le note che ti scrive: avvisi di passaggio all'operatore umano, attività, FAQ suggerite. Non è un blocco: il tuo bot risponde comunque a ogni contatto nella lingua in cui tale contatto scrive.

Scegline una nuova e verrà salvata immediatamente: questo campo non attende la **Pubblicazione** come il resto della scheda. Ciò che *non* fa è riscrivere qualcosa di già scritto: le tue istruzioni e FAQ esistenti rimangono nella lingua in cui sono state scritte, quindi se vuoi che l'agente cambi completamente lingua, ritraduci anche quelle.

Due controlli di script vengono eseguiti autonomamente, non c'è nulla da attivare. Un agente impostato su **Cinese (Tradizionale)** o **Cinese (Hong Kong)** vedrà qualsiasi carattere semplificato isolato convertito nella sua forma tradizionale prima dell'invio di una risposta (请问 diventa 請問), mentre il testo già in tradizionale rimane esattamente com'è. Un agente che scrive in **Giapponese** vedrà ogni risposta controllata per individuare caratteri esistenti solo in cinese (semplificazioni della Cina continentale come 这, 现 e 们, e forme arcaiche non più utilizzate in giapponese); se ne dovesse sfuggire uno, la risposta viene rigenerata una volta con una correzione e viene inviata la versione corretta. I kanji comuni, inclusi nomi come 達也, non vengono mai modificati. Il controllo giapponese è attivo sui livelli Max e Mini, che è dove si è verificato questo caso; copre anche i follow-up e le risposte ai commenti.

Se la tua lingua principale è **Cinese (Tradizionale)** o **Cinese (Hong Kong)**, ogni risposta viene controllata prima dell'invio e qualsiasi carattere cinese semplificato inserito accidentalmente dall'IA viene convertito nella sua forma tradizionale (请问 diventa 請問, 适合 diventa 適合). Il testo già in tradizionale viene lasciato esattamente com'è, incluso 台 in 台北 o 台灣 e 里 in un indirizzo, quindi questo processo rimuove solo i caratteri semplificati isolati. Copre le risposte normali, i follow-up, le risposte ai commenti e le didascalie delle foto, e non c'è nulla da attivare.

Il resto della scheda è organizzato in quattro sezioni comprimibili: Persona e Obiettivo, Contesto aziendale, Comportamento della conversazione e Escalation e Conclusione. Se hai utilizzato la procedura guidata di onboarding, molti di questi campi saranno già compilati per te. (Il passaggio 5 di seguito, l'aggiunta di FAQ e risorse, avviene nella scheda separata **FAQ e Conoscenza**.)

> **I nuovi Agenti ottengono un set di campi più snello.** Ogni nuovo Agente inizia con il formato attuale, che mantiene ogni sezione sui suoi campi principali (di seguito). Gli Agenti più vecchi creati prima di questa modifica potrebbero ancora mostrare alcuni campi extra: **Fonte del contatto** (Persona e obiettivo), **Punti di forza unici**, **Posizionamento di mercato** e **Informazioni sui prezzi** (Contesto aziendale), e **Gestione delle obiezioni** e **Domande** (Comportamento conversazionale). Se li vedi, funzionano esattamente allo stesso modo: usali semplicemente per il contesto aggiuntivo che richiedono.

### 1. Persona e Obiettivo

Chi è l'IA e qual è il suo scopo.

| Campo | Cosa scrivere | Esempio |
|-------|--------------|---------|
| **Persona** | Il nome e il ruolo del bot: la sua personalità. | "Sei Sarah, un'assistente alle vendite presso GreenFit Supplements. Amichevole, diretta, mai insistente." |
| **Obiettivo** | Cosa significa avere successo in questa conversazione. | "Aiuta i clienti a trovare l'integratore giusto e guidali verso l'effettuazione di un ordine." |

**Immagina di formare un nuovo dipendente:** gli spiegheresti il suo ruolo, come accogliere i clienti, cosa consigliare e quando chiedere aiuto. Mantieni i messaggi brevi: dì al bot di scrivere come una persona reale che invia messaggi, 2-3 frasi per messaggio.

### 2. Contesto aziendale

Fatti sulla tua azienda su cui l'IA può fare affidamento.


| Campo | Cosa scrivere | Esempio |
|-------|--------------|---------|
| **Informazioni sull'azienda** | Il nome della tua azienda, cosa fai e chi sono i tuoi clienti | "GreenFit Supplements vende integratori fitness premium a base vegetale ad adulti attenti alla salute di età compresa tra 25 e 45 anni." |

### 3. Comportamento nella conversazione

Come l'IA dovrebbe guidare e gestire la chat.


| Campo | Cosa scrivere | Esempio |
|-------|--------------|---------|
| **Regole** | Cosa il bot non dovrebbe mai fare o dire | "Non fare mai affermazioni mediche. Non inventare mai informazioni che non sono presenti nelle informazioni aziendali o nelle FAQ." |
| **Flusso di conversazione** | Cosa dovrebbe succedere prima, dopo, poi | "1. Saluta per nome. 2. Chiedi informazioni sugli obiettivi di salute. 3. Consiglia 1-2 prodotti. 4. Condividi il link del prodotto. 5. Offriti di rispondere alle domande. 6. Guida al checkout." |

**Esempio di una regola che copre anche le obiezioni comuni:**

```
Never give a final quote in chat — share only the published starting price.
If someone says "it's too expensive," mention the money-back guarantee and
compare it to the cost of not solving the problem, instead of dropping price.
```

### 4. Escalation e conclusione

Quando passare la conversazione a un operatore umano e quando terminare.


| Campo | Cosa scrivere | Esempio |
|-------|--------------|---------|
| **Avvisa un umano quando** | Le condizioni che dovrebbero mettere in pausa il bot e avvisare il tuo team | "Il contatto chiede di parlare con un responsabile. Il contatto ha un reclamo sulla fatturazione. Il contatto sembra frustrato o turbato." |
| **Concludi quando** | Quando il bot dovrebbe considerare il suo lavoro terminato per questa conversazione | "Il contatto ha prenotato un appuntamento o afferma esplicitamente di non essere interessato." |

Quando il bot avvisa un operatore umano, la chat viene messa in pausa e ricevi una notifica. Il bot non invierà altri messaggi finché non lo riattiverai.

### 5. Aggiungi FAQ e risorse

- Le **FAQ** forniscono al bot risposte precise a domande comuni. Consulta la guida [Gestione FAQ](faq-management.md).
- Le **Risorse** sono link che il bot può condividere durante le conversazioni (il tuo sito web, pagina dei prezzi, pagina di prenotazione, catalogo prodotti, ecc.).
- **Altre informazioni** (nella sezione **Contesto extra** in fondo alla scheda FAQ e Conoscenza) è un campo di testo libero che l'AI legge oltre alle tue istruzioni. Usalo per qualsiasi cosa temporanea o intercambiabile - una vendita in corso questa settimana, o un contesto specifico per la nicchia a cui ti rivolgi - in modo che le tue istruzioni permanenti rimangano intatte.

---

## Rendere il bot più umano (Impostazioni di risposta)

Più in basso nella stessa scheda **Istruzioni IA**, le sezioni **Tempistiche di risposta** e **Limiti di risposta** controllano il ritmo e lo stile dei messaggi del tuo bot, in modo che sembrino provenire da una persona reale e non da una macchina.


| Impostazione | Cosa fa | Predefinito |
|---------|-------------|---------|
| **Ritardo minimo risposta** | Secondi minimi prima che il bot inizi a "scrivere" | 15 secondi |
| **Ritardo massimo risposta** | Secondi massimi prima che il bot inizi a "scrivere" | 30 secondi |
| **Usa ritardo minimo per nuovi contatti** | Velocizza la primissima risposta in modo che un contatto nuovo riceva una risposta più rapida | Attivo |
| **Velocità di digitazione** *(non è un campo modificabile)* | La pausa tra ogni messaggio suddiviso, basata sul tempo che una persona impiegherebbe a scrivere quel messaggio. È sempre attiva e non può essere disattivata; è impostata in base alla **Velocità di risposta AI** scelta più in basso nella scheda (Umanoide è la più lenta e naturale, Rapida e Veloce inviano i messaggi uno dopo l'altro) | Umanoide |
| **Lunghezza risposta** *(impostata durante la configurazione, non modificabile qui)* | Lunghezza target per ogni messaggio (in parole) | 30-60 parole |
| **Lunghezza frase** *(impostata durante la configurazione, non modificabile qui)* | Numero target di frasi per messaggio | 2-4 |
| **Messaggi massimi per risposta** *(etichettato come "Max blocchi" su alcuni Agenti meno recenti)* | Numero massimo di fumetti di messaggio separati per risposta | 6 |
| **Applica messaggi massimi** | Applica rigorosamente il limite di cui sopra: se l'IA scrive più messaggi di quelli consentiti, quelli in eccesso vengono combinati nell'ultimo messaggio invece di essere inviati separatamente | Disattivo |

> **Quando utilizzare Applica messaggi massimi:** Per impostazione predefinita, il limite è un'istruzione forte per l'IA, che quasi sempre rispetta, ma occasionalmente una risposta prolissa può passare come fumetti extra. Attivare questa opzione garantisce il limite, a un piccolo costo: i messaggi combinati possono sembrare più densi e meno naturali rispetto al ritmo dell'IA. Lascialo disattivato a meno che le risposte divise non ti stiano causando problemi.


> **Non giudicare il ritmo in Prova.** La chat di test **Prova** è deliberatamente velocizzata per evitare attese: salta completamente l'attesa prima del primo messaggio e inserisce pochi secondi fissi tra i messaggi suddivisi. Non utilizza mai i ritardi di risposta sopra indicati. Le tue chat dal vivo lo fanno. Se vuoi vedere il ritmo reale, osserva una conversazione reale.

**Come funziona:** Invece di inviare un lungo paragrafo, il bot suddivide la sua risposta in più messaggi brevi, proprio come una persona reale che scrive. Inoltre, fa delle pause tra i messaggi e mostra un indicatore "sta scrivendo..." (su WhatsApp Web) per rendere la conversazione naturale. Non devi attivare nulla di tutto ciò: è automatico in ogni risposta dal vivo. Impostare **Messaggi massimi per risposta** su 1 o 2 è ciò che lo disattiva in pratica, dato che non rimane nulla da suddividere. Un'eccezione: una risposta molto lunga (circa 1.500 caratteri o più) viene inviata come un unico messaggio, indipendentemente da ciò che dice il limite.

**Quale valore viene utilizzato?** Il bot non sceglie un numero casuale tra i due. Controlla da quanto tempo la chat è inattiva dall'ultimo messaggio: una risposta che arriva entro un minuto ottiene l'attesa **Min**, mentre una chat inattiva da 30 minuti o più ottiene l'attesa **Max** completa, con tutto ciò che sta nel mezzo scalato in modo fluido. Quindi, se imposti un Max elevato (diciamo 300 secondi), la prima risposta dopo una lunga pausa attenderà tutti i 5 minuti. È un comportamento previsto, non un errore; abbassa il Max se desideri prime risposte più rapide dopo un periodo di inattività.

Se un Agente non ha alcun ritardo di risposta configurato, il bot ripiega su un ritardo di 30-60 secondi.

> **Perché un ritardo predefinito così lungo?** I clienti chiedono continuamente di ridurre il ritardo. Non farlo. Le risposte istantanee segnalano che si tratta di un "bot" e le difese dei potenziali clienti si alzano. La finestra di 15-30 secondi, unita ai messaggi suddivisi e a un tono colloquiale, rende l'IA più umana, che è ciò che permette di concludere le vendite.

> **Rimani vicino al valore predefinito di 15–30 secondi.** Non impostare il minimo a 0 o 1: le risposte che arrivano istantaneamente sembrano robotiche, e la pausa è ciò che fa sembrare l'IA una persona che sta scrivendo. Se hai davvero bisogno di risposte più rapide, riduci il minimo a 5 secondi, ma non azzerarlo mai. Anche andare nella direzione opposta è controproducente: un minimo di un minuto o più significa che un potenziale cliente che ha fatto una domanda veloce rimane a fissare il vuoto, e amplia la finestra temporale in cui i suoi messaggi successivi vengono uniti nella stessa risposta.

### Come funziona la gestione dei messaggi rapidi

Se un contatto invia diversi messaggi brevi di fila ("ehi", "ci sei?", "volevo chiedere informazioni sui prezzi"), il bot attende che finisca, raggruppa tutti i messaggi e risponde una sola volta con una risposta coerente.

Questa è una funzionalità, non un ritardo. Impedisce all'IA di interrompersi a metà pensiero ed evita che invii tre risposte separate a quella che in realtà era un'unica domanda. L'attesa è parte del motivo per cui la conversazione sembra naturale: anche una persona reale aspetterebbe che l'interlocutore finisca di scrivere prima di rispondere.

> **Il tempo di attesa corrisponde al ritardo di risposta.** Il raggruppamento non è illimitato: il bot unisce solo i messaggi che arrivano prima che inizi a rispondere, e tale finestra temporale è il **Ritardo di risposta min/max** impostato sopra. Con l'impostazione predefinita di 15-30 secondi, un messaggio di follow-up inviato 45 secondi dopo arriva quando la risposta è già stata inviata, quindi riceverà una risposta separata. Questo comportamento è intenzionale, non un errore. Se i contatti tendono a scrivere i propri pensieri in più messaggi e desideri che ne vengano raggruppati di più in un'unica risposta, aumenta il ritardo di risposta; se desideri risposte più rapide, aspettati meno raggruppamenti. Non è possibile avere entrambi.

---

## Trasparenza dell'IA (Informare i contatti che stanno chattando con un'IA)

Molti paesi ora richiedono alle aziende di informare le persone quando stanno chattando con un'AI: nell'UE questa è la regola di trasparenza dell'AI Act, che si applica dal 2 agosto 2026. <span data-t="appName">Your AI Connector</span> gestisce questo aspetto per te con l'interruttore **Informa i contatti che stanno chattando con un'AI**, nel passaggio **Abilità AI** del tuo agente. La procedura guidata di configurazione mostra lo stesso interruttore durante la creazione del tuo primo agente e, ogni volta che è attivo, gli editor delle **Istruzioni AI** e la chat di test **Prova** riportano una nota con il proprio interruttore, così puoi vedere che è attivo, capire perché l'AI si presenta come tale e disattivarlo direttamente lì senza dover cercare l'impostazione.

Quando è attivo, la primissima risposta AI che un contatto riceve include naturalmente una breve menzione del fatto che si tratta di un assistente AI, integrata nel saluto, non come un banner legale. Tutto qui: ogni risposta successiva, inclusi i follow-up automatici e qualsiasi conversazione futura che lo stesso contatto avrà con te, rimane completamente invariata e il bot mantiene il suo tono e ritmo normali. Una menzione di una riga all'inizio non danneggia una conversazione ben gestita e ti mantiene in regola con le norme.


Alcune cose da sapere:

- **I nuovi agenti lo hanno attivo per impostazione predefinita.** Gli agenti esistenti prima dell'introduzione di questa impostazione rimangono esattamente come erano: attivalo per ogni agente quando sei pronto.
- **Puoi disattivarlo.** Se il tuo pubblico non è coperto dalle regole di trasparenza, disattivalo: l'editor mostra una breve nota che ti ricorda che la conformità per il tuo pubblico è quindi una tua responsabilità.
- **L'interruttore diventa attivo quando pubblichi.** Come ogni altra modifica nell'editor dell'Agente, attivare questo interruttore crea una bozza: la chat di Prova lo usa immediatamente, ma le conversazioni reali mantengono la vecchia impostazione finché non clicchi su **Pubblica** (il banner ambra in cima all'editor te lo ricorda). Se l'AI continua a presentarsi dopo aver disattivato l'interruttore, quasi sempre è a causa di una bozza non pubblicata.
- **Con l'opzione attiva, il bot non finge di essere umano quando richiesto.** Se un contatto chiede "sto parlando con un bot?", l'AI risponde onestamente invece di negarlo, anche se il tuo playbook le dice di dire il contrario. Con l'interruttore disattivato, quella garanzia decade, quindi qualsiasi cosa dica il tuo playbook sul dichiararsi umano è responsabilità tua. In ogni caso, non istruirla a dichiararsi umana: è proprio ciò che le leggi sulla trasparenza puniscono.
- **Se un'istruzione come "di' che sei un membro dello staff" sembra ignorata, è a causa di questa impostazione.** Mentre l'interruttore è attivo, le istruzioni su come presentare l'AI come un essere umano o un membro dello staff vengono deliberatamente sovrascritte: è l'impostazione che fa il suo lavoro, non l'AI che non segue il playbook. Gli editor delle Istruzioni AI mostrano una nota con il proprio interruttore ogni volta che questa funzione è attiva, così puoi disattivarla sul momento (e si applica la nota sulla conformità di cui sopra).
- I messaggi di apertura scritti da te non vengono toccati: sono le tue parole, non quelle dell'AI, quindi non viene aggiunta alcuna informativa.

---

## Modalità di velocità dell'IA (Quanto pensa a fondo il bot)

Le modalità di velocità dell'IA controllano quanto "pensa" il bot prima di rispondere. Immagina di fare una domanda a qualcuno: a volte una risposta rapida va bene, altre volte vuoi che ci rifletta davvero.


| Modalità | Come funziona | Ideale per |
|------|-------------|----------|
| **Rapida** | Più veloce. Il bot risponde senza un passaggio di riflessione esteso. | FAQ semplici, chat ad alto volume, supporto in stile FAQ |
| **Veloce** | Un breve passaggio di riflessione. Intelligente e rapido. | La maggior parte dei casi d'uso generali che non richiedono un ragionamento profondo |
| **Riflessiva** | Un passaggio di riflessione bilanciato. Leggermente più attenta di Veloce. | Conversazioni in cui l'accuratezza è importante ma non vuoi spendere per "Simile a un umano" |
| **Simile a un umano** | Passaggio di riflessione più profondo. Analizza attentamente l'intera conversazione prima di rispondere. | Vendite di alto valore, supporto tecnico, tutto ciò in cui ogni risposta conta davvero. **Predefinito**. |

**Consigliato:** Lascialo su "Simile a un umano" a meno che tu non abbia un motivo specifico per cambiarlo. Il guadagno in termini di precisione vale solitamente più della leggera latenza aggiuntiva.

---

## Qualità dell'IA (Qualità vs Costo)

Indipendentemente dalla velocità dell'IA, puoi anche scegliere il modello di IA sottostante. Nella scheda **Istruzioni IA**, questa impostazione è denominata **Qualità IA**. Si tratta puramente di un selettore di costo/qualità.


| Livello | Ideale per |
|------|------|
| **Max** | La nostra IA interna, creata appositamente per la messaggistica ad alto volume. Eguaglia Pro in termini di qualità, è più veloce nella maggior parte delle chat ed è l'opzione più conveniente. Disponibile sugli account idonei. |
| **Mini** | Il fratello minore di Max: la stessa famiglia di IA interna su una configurazione più leggera, a un prezzo inferiore per risposta. Ottimo per conversazioni ad alto volume dove ogni credito conta; presenta una probabilità leggermente maggiore di piccoli errori rispetto a Max, quindi per le conversazioni in cui un dettaglio errato può costare una vendita, scegli Max. Appare sugli account che dispongono di Max. |
| **Pro** | Il modello premium originale di Anthropic (Claude Sonnet). Testato sul campo, con anni di esperienza in produzione. La qualità è alla pari con Max. |
| **Economy** *(deprecato)* | **Non più disponibile per i nuovi Agenti.** Gli Agenti già su Economy continueranno a funzionare con questo piano per il momento, ma l'opzione non potrà essere riselezionata una volta effettuato il passaggio. Passa invece a Max (o Pro, se Max non è offerto sul tuo account). |

**Max** funziona interamente sulla nostra infrastruttura — nessuna chiave API di terze parti da gestire, nessun limite di velocità di cui preoccuparsi e nessuna fattura esterna a sorpresa — ed è il livello più conveniente. È disponibile sugli account idonei; per tutti gli altri, il livello Standard (Pro) è quello predefinito.

**Mini** appare subito sotto Max sugli account idonei. Funziona sulla stessa infrastruttura di Max a un prezzo per azione inferiore: il compromesso è un leggero calo di precisione nelle domande fattuali complesse. Per i prezzi esatti per azione di entrambi, consulta la guida al [Sistema di fatturazione](../billing/billing-system.md).

**Pro** rimane disponibile per gli utenti che desiderano specificamente il modello Anthropic originale con anni di esperienza alle spalle. In termini di qualità, Max e Pro sono intercambiabili per la stragrande maggioranza dei casi d'uso. Se stai già usando Pro e ne sei soddisfatto, non c'è motivo di cambiare. Puoi modificare i livelli in qualsiasi momento in base alle tue preferenze di costo/qualità.

**Economy è deprecato.** È stato sostituito da Max, che utilizza un modello di nuova generazione. Gli Agenti Economy esistenti non subiscono modifiche: continueranno a funzionare con Economy finché non cambierai livello, ma l'opzione Economy nel selettore sarà disattivata a meno che l'Agente non sia già impostato su di essa. Una volta passato un Agente a Pro o Max, non potrai tornare a Economy.

> **"Pro" qui indica un livello di qualità dell'IA, non un piano di abbonamento.** Definisce solo il costo di un'azione IA; non ha nulla a che fare con il piano che hai sottoscritto.

Per il costo esatto in crediti di ogni livello, consulta la guida al [Sistema di Fatturazione](../billing/billing-system.md).

---

## Limiti dei messaggi del bot

Ogni Agente ha un'impostazione **Messaggi IA massimi** (in **Limiti di risposta**) che limita il numero di risposte IA che il bot può inviare a un singolo contatto prima di sospendersi:

- **Predefinito**: 20 risposte IA per contatto
- **Configurabile** su valori più alti o su illimitato, dove il tuo piano lo consente
- **Quando viene raggiunto il limite**: Il bot viene messo in pausa per quel contatto. Su un account diretto riceverai un'**email e una notifica push** in modo che un operatore umano possa prendere in carico la conversazione. **Account gestiti:** questo avviso segue le impostazioni di notifica del tuo provider, quindi se hanno disattivato tali email, non verrà inviata alcuna notifica.

Questa è una rete di sicurezza affinché un singolo contatto troppo loquace non possa esaurire i tuoi crediti all'infinito. Solo le risposte dell'AI contano ai fini di questo limite, non i messaggi in entrata del contatto.

Separatamente, alcuni piani prevedono un limite rigido al numero di risposte AI possibili per chat. Quando **tale** limite viene raggiunto, il bot smette semplicemente di rispondere a quel contatto, senza inviare alcuna email. È comunque possibile inviare messaggi al contatto manualmente.


| Funzionalità del piano | Limite rigido |
|-------------|------------|
| 20 risposte per chat | Fino a 20 risposte per contatto |
| 50 risposte per chat | Fino a 50 risposte per contatto |
| 100 risposte per chat | Fino a 100 risposte per contatto |
| Risposte illimitate | Nessun limite rigido |

Una volta raggiunto il limite rigido per un contatto specifico, il bot smette di rispondere automaticamente.

---

## Budget per le istruzioni del bot (Quanto puoi scrivere)

Il **Budget di contesto** mostrato nella scheda Istruzioni AI è un budget di caratteri che distribuisci sulla maggior parte dei campi delle istruzioni del bot: persona, obiettivo, informazioni sull'azienda e così via. Un livello da 20K significa circa 20.000 caratteri totali in quei campi (circa 3.000-4.000 parole). Questo riguarda quanto puoi *scrivere* nelle tue istruzioni, non quanto della conversazione il bot ricorda: il bot vede sempre la cronologia recente della conversazione indipendentemente dal livello, e le chat molto lunghe vengono automaticamente riassunte in background senza costi aggiuntivi.


**Ogni campo di istruzione nelle quattro sezioni precedenti contribuisce al budget**, incluse le Regole e il Flusso della conversazione. Ciò che non conta è la tua **knowledge base**: FAQ, documenti importati, dettagli su prodotti e prezzi vivono separatamente e non incidono mai su questo budget. È la sede ideale per materiale di riferimento voluminoso e specifico per il cliente: l'IA estrae solo le voci pertinenti a ciascuna conversazione, quindi la tua knowledge base può crescere ben oltre il tuo budget di caratteri.

| Funzionalità del piano | Budget totale caratteri |
|-------------|------------|
| Contesto 20K | Circa 20.000 caratteri in tutti i campi istruzioni |
| Contesto 50K | Circa 50.000 caratteri |
| Contesto 75K | Circa 75.000 caratteri |
| Contesto 100K | Circa 100.000 caratteri |

Quale ottieni dipende dal tuo piano. Tutti e tre i piani venduti oggi — Business, Agency e Agency Unlimited — includono l'intero limite di 100.000 caratteri. Nei livelli lifetime di AppSumo, il budget varia in base al livello: 20.000 nel Piano 1, 50.000 nel Piano 2, 75.000 nel Piano 3 e l'intero limite di 100.000 dal Piano 4 in su. La tua cifra specifica è quella mostrata nel misuratore del Budget di contesto.

Per la maggior parte degli agenti, 20.000 caratteri sono più che sufficienti. Ti ricordiamo che i budget sono pensati per essere generosi: un playbook snello e mirato, ben al di sotto del limite, offre prestazioni migliori di uno che lo riempie completamente.

Non devi contare per conto tuo. Mentre modifichi le tue istruzioni, una barra mostra quanto del tuo budget hai utilizzato ("12.340 / 50.000 caratteri utilizzati"). Diventa ambra quando ti avvicini al limite e rossa quando stai per esaurirlo, e conteggia tutti i campi delle istruzioni insieme anziché separatamente.

---

## Quanta parte della conversazione ricorda l'IA

L'IA legge l'intera conversazione recente ogni volta che risponde: abbastanza da coprire quasi ogni conversazione reale dall'inizio alla fine.

Anche i messaggi più vecchi non vengono eliminati. Quando una chat diventa molto lunga, la piattaforma riassume la parte precedente in background e l'IA continua a utilizzare quei riassunti insieme ai messaggi recenti, in modo da sapere ancora cosa è stato concordato settimane prima. Mini funziona con una memoria di conversazione più leggera rispetto a Max (questo fa parte del suo prezzo inferiore) e passare un Agente a Max ripristina immediatamente la memoria completa.

La lunghezza della conversazione non cambia mai ciò che paghi: una risposta dell'IA costa la stessa tariffa fissa in crediti, indipendentemente dal fatto che la chat sia lunga 10 o 1.000 messaggi. Non c'è nulla da configurare: la memoria non è un'impostazione.

---

## Modifica del Playbook come blocco di testo unico

Una volta scritto un playbook che ti soddisfa, non devi riscriverlo per il prossimo Agente e non devi modificarlo campo per campo se preferisci lavorare in un editor di testo. Fai clic su **Modifica come testo** nella parte superiore della scheda Istruzioni IA per passare dai campi strutturati a un blocco di testo semplice, con ogni sezione sotto il proprio titolo `#`:


```
#personality
Friendly, direct, never pushy...

#goal
Book a demo call...
```

Ciò significa che puoi anche copiare l'intero blocco, modificarlo in qualsiasi editor di testo o documento, quindi incollarlo nuovamente: utile per copiare un playbook che ti piace in un nuovo Agente. Fai clic su **Modifica come campi** per tornare indietro. Prima che venga salvato qualsiasi elemento, ti viene mostrato esattamente quali sezioni cambierebbero: non viene scritto nulla finché non confermi. Qualsiasi titolo non riconosciuto viene segnalato invece di essere ignorato silenziosamente, quindi un errore di battitura in un titolo non può cancellare inavvertitamente una sezione.

---

## Come funzionano i crediti AI

La piattaforma utilizza un semplice sistema di crediti per monitorare l'utilizzo dell'AI:

**Cosa consuma crediti - la tariffa dipende dal livello di Qualità IA del tuo Agente (Pro 1 credito, Max 0,25, Mini 0,15, Economy 0,5, e 0 con la tua chiave Anthropic personale, eccetto Max e Mini, che addebitano sempre 0,25 e 0,15):**
- Ogni volta che l'IA genera una risposta (un ciclo di "pensiero", anche se invia più fumetti di messaggio)
- Ogni volta che l'IA utilizza uno strumento (come prenotare un appuntamento, cercare sul tuo sito web o chiamare una funzione personalizzata)
- Ogni volta che l'IA esegue un'attività in background (come estrarre il nome di un contatto o valutare la conversazione)

**Cosa NON costa crediti:**
- Inviare un messaggio manualmente
- Ricevere messaggi dai contatti
- Messaggi modello (questi hanno un costo separato)

**Crediti inclusi nel tuo piano:**

Il tuo piano include un pacchetto di crediti AI. Il riquadro Assegnazione mensile in **Impostazioni → Fatturazione** è l'unica cifra ufficiale per il tuo account.


Puoi acquistare crediti aggiuntivi in qualsiasi momento o abilitare la **ricarica automatica** affinché il tuo bot non rimanga mai senza durante una conversazione.

**Bring Your Own Key (BYOK):** BYOK ti consente di collegare la tua chiave API Anthropic (un codice privato di Anthropic che permette al tuo account di inviare richieste direttamente al loro servizio di IA) in modo che le risposte dell'IA vengano fatturate direttamente sul tuo account Anthropic invece di consumare i crediti della piattaforma. Se BYOK è abilitato sul tuo account, puoi configurarlo da **Impostazioni → Avanzate → Chiavi API BYOK**. I costi dell'infrastruttura del canale (come la tariffa mensile del proxy WhatsApp Web o le tariffe di consegna per messaggio di WhatsApp) rimangono applicabili.

---

## Testare il bot in Prova

Prima di andare online, testa sempre il tuo bot nella scheda **Prova**. Simula una conversazione reale in modo da poter vedere esattamente come si comporterà il tuo bot.

**Come usarlo:**

1. Apri l'Agente.
2. Clicca sul passaggio **Prova**: è l'ultimo nell'editor.
3. Digita un messaggio nella casella di input in basso, come se fossi un vero cliente.
4. Premi Invio. Il bot risponde utilizzando la configurazione completa dell'Agente (istruzioni, FAQ, tono, modello, tutto).
5. Se una risposta non è corretta: torna alla scheda **Istruzioni AI** o alla scheda **FAQ e Conoscenza**, apporta le modifiche e clicca su **Salva**.
6. Torna a **Prova** e testa di nuovo. Le modifiche salvate si applicano immediatamente alla chat di test, ma **non sono ancora attive**: le conversazioni reali continuano a utilizzare la configurazione precedente mentre testi.
7. Ripeti finché non sei soddisfatto delle risposte.
8. Clicca su **Pubblica** nel banner ambra in cima all'editor. È il momento in cui le tue modifiche diventano effettive per i clienti reali. Hai cambiato idea? **Scarta** nello stesso banner ripristina tutto alla configurazione live.

**Cosa testare:**

- Domande comuni poste dai tuoi clienti
- Casi limite (domande fuori tema, incomprensibili, menzioni della concorrenza)
- Se il bot avvisa correttamente un operatore umano quando dovrebbe
- Flussi di prenotazione appuntamenti (se applicabile)
- Che il bot rimanga entro i limiti che hai impostato

La funzione Prova utilizza esattamente la stessa IA delle conversazioni dal vivo, quindi ciò che vedi durante i test è ciò che sperimenteranno i tuoi contatti.

---

## Suggerimenti per ottenere i migliori risultati

1. **Compila tutto.** Più informazioni fornisci al bot (informazioni aziendali, FAQ, risorse), migliori saranno le sue prestazioni. Non lasciare sezioni vuote.

2. **Struttura le tue istruzioni in modo chiaro.** Usa elenchi numerati e sezioni chiare. L'IA segue le istruzioni strutturate molto meglio dei lunghi paragrafi.

3. **Aggiungi FAQ per le domande comuni.** Se i contatti continuano a chiedere le stesse cose, aggiungile come FAQ. Il bot trova automaticamente la FAQ giusta per ogni domanda. Vedi [Gestione FAQ](faq-management.md).

4. **Usa "Altre informazioni" per conoscenze temporanee o specifiche di nicchia.** Il campo si trova nella sezione **Contesto extra** della scheda FAQ e Conoscenza. Hai una vendita in corso questa settimana o ti rivolgi a un settore specifico? Aggiungi quel contesto lì in modo che il bot lo sappia senza che tu debba modificare le tue istruzioni permanenti.

5. **Aggiungi link alle risorse.** Includi link al tuo sito web, alla pagina dei prezzi, alla pagina di prenotazione o al catalogo prodotti. Il bot li condividerà in modo naturale durante le conversazioni.

6. **Controlla regolarmente le conversazioni.** Verifica le tue conversazioni in tempo reale per vedere come sta andando il bot. Se gestisce qualcosa in modo inadeguato, aggiorna le tue istruzioni o le FAQ.

7. **Usa "Ottimizza con l'IA".** Fai clic su di esso nell'intestazione del pannello Prova, descrivi cosa dovrebbe migliorare (o metti un pollice verso a una risposta che non ha centrato l'obiettivo) e rivedi la riscrittura proposta fianco a fianco prima di accettare qualsiasi cosa. Funziona in base a ciò che gli dici, non dalle tue conversazioni dal vivo passate. Per quelle, leggi i tuoi [Riepiloghi giornalieri](../daily-summaries/daily-summaries.md) e porta qui i punti chiave. Vedi [Ottimizza con l'IA](../chats/playground.md#optimize-with-ai).

8. **Imposta l'auto-tagging per le azioni chiave.** L'auto-tagging si trova nel passaggio **Tag** dell'Agente. Clicca su **+ Aggiungi Tag** e compila due campi per tag: un **Nome Tag** (es. `booked`) e una **Descrizione del Tag e Quando Assegnarlo** (es. "Assegna questo tag quando il contatto conferma un appuntamento con data e ora specifiche"). Il bot usa la tua descrizione come regola e applica il tag automaticamente quando una conversazione corrisponde. I tag che crei qui possono quindi attivare webhook (notifiche automatiche inviate a un'altra app o sistema) o modifiche allo stato dell'affare altrove nella piattaforma.

9. **Se utilizzi la prenotazione basata sull'IA, istruisci il bot a chiedere l'email del contatto PRIMA di prenotare.** Altrimenti, l'invito di Google Calendar non ha un destinatario a cui inviare la conferma e il contatto non riceve mai il link per la riunione. Aggiungi un passaggio al tuo **Flusso di Conversazione** come: "Prima di prenotare qualsiasi appuntamento, chiedi al contatto il suo indirizzo email e confermalo con lui."

10. **Devi rinominare qualcosa all'interno del playbook?** Se rinomini una linea di prodotti, un livello di prezzo o un membro del team, devi aggiornare ogni riferimento ad esso in tutto il playbook, nelle istruzioni, nelle FAQ e nelle risorse. Due modi per gestire la cosa:
    - **Passa a Modifica come Testo.** Copia il testo del playbook in uno strumento come Note, Word o VS Code e usa la funzione trova e sostituisci. Incollalo di nuovo quando hai finito.
    - **Usa "Ottimizza con IA".** L'IA riscriverà il playbook per te, ma questo **costa crediti** — quindi conservalo per ristrutturazioni più ampie, non per rinominare singole parole.

11. **Non riversare l'intero contenuto del blog nel playbook o nelle FAQ.** È allettante incollare ogni post del blog, white paper o presentazione di vendita che hai, ma **un contesto troppo pesante danneggia la precisione**. L'IA funziona meglio quando il playbook è focalizzato e le FAQ sono concise. Se hai diversi obiettivi molto differenti — vendite, supporto, prenotazioni, reclutamento — **crea più Agenti**, invece di riempire un unico bot con tutto. Ogni Agente specializzato supererà in prestazioni un gigantesco generalista.

12. **Se scrivi messaggi di esempio, scrivili in ogni lingua che supporti.** Le frasi di esempio sono l'influenza più forte sul modo in cui scrive il tuo bot: copia la loro formulazione molto più fedelmente di quanto segua una regola scritta. Quindi, se tutti i tuoi esempi sono in una lingua, il bot tornerà a quella lingua a metà conversazione. Questo accade anche quando gli hai detto di corrispondere alla lingua del contatto, e anche dopo che ha risposto correttamente per diversi messaggi. Il segnale rivelatore è che cambia lingua esattamente in un passaggio per il quale hai scritto un esempio (conferma dei dettagli, offerta di orari per le riunioni), mentre le parti a forma libera rimangono nella lingua corretta. O fornisci ogni esempio in ogni lingua che supporti, oppure riducili a brevi scheletri e aggiungi una riga come "questi esempi sono scritti in catalano — scrivi sempre nella lingua del contatto." Fai lo stesso per qualsiasi messaggio di trasferimento o di fallback che hai scritto.

13. **Fai attenzione alle istruzioni che contrastano con un'impostazione.** Alcune cose sono controllate da un'impostazione, non dalle tue istruzioni, e l'impostazione ha sempre la meglio. La più comune: scrivere "non dividere mai una risposta in due messaggi" mentre **Max Chunks** è impostato su 6. Se desideri messaggi singoli, imposta Max Chunks su 1: consulta [Impostazioni di risposta](#making-your-bot-feel-human-response-settings).

---

## Domande frequenti

**Ho modificato l'Agente: perché non è cambiato nulla?** Salvare una modifica non la rende più attiva: salva una bozza che solo la chat di **Prova** utilizza. Quando esiste una bozza non pubblicata, appare un banner ambra in cima all'editor; clicca su **Pubblica** lì e la modifica diventerà immediatamente effettiva ovunque venga utilizzato l'Agente.

**Due Agenti possono condividere la stessa libreria di FAQ ma rispondere da parti diverse di essa?** Sì: le FAQ risiedono nella tua libreria condivisa e sono collegate per Agente, quindi ogni Agente può collegare il proprio set. Consulta [Gestione FAQ](faq-management.md#global-faqs-vs-agent-specific-faqs).

**Il mio agente giapponese ha inserito un carattere cinese in una risposta. Devo correggerlo io?** No. Le risposte in giapponese vengono controllate prima dell'invio e una risposta contenente un carattere esclusivamente cinese viene rigenerata una volta con una correzione, sui livelli Max e Mini. Mantieni la **Lingua principale** dell'agente su Giapponese e scrivi i tuoi messaggi di esempio anch'essi in giapponese: l'IA copia la lingua dei suoi esempi più fedelmente di qualsiasi regola tu possa scrivere. Vedi [Lingua principale](#setting-up-your-bot-step-by-step) sopra.

**Il mio Agente non sta ancora rispondendo a nessuno: posso comunque testarlo e migliorarlo?** Sì, certamente. La chat **Prova** viene eseguita sull'Agente stesso, quindi un Agente nuovo di zecca può essere testato nel momento in cui hai scritto la sua prima istruzione; anche **Ottimizza con AI** e il pollice verso per ogni risposta funzionano lì. Ciò che decide quali conversazioni reali raggiungono l'Agente sono i suoi **Punti di ingresso**: consulta [Punti di ingresso](../ai-agents/entry-points.md).

---

## Prossimi passi

- [Agenti IA](../ai-agents/ai-agents.md) — cos'è un Agente e come le schede si integrano tra loro.
- [Gestione FAQ](faq-management.md) — fornisci al tuo Agente risposte pronte all'uso.
- [Perché Max è il miglior rapporto qualità-prezzo](ai-model-comparison.md) — le motivazioni complete per il livello Max.
- [Modello IA & BYOK](ai-model-and-byok.md) — porta la tua chiave Anthropic.