
# Ricerca web in tempo reale

La ricerca web in tempo reale offre al tuo bot AI la capacità di cercare informazioni durante una conversazione, sia sul tuo sito web che su Internet. Quando un cliente chiede informazioni su un prodotto specifico, sulla disponibilità o sui prezzi che potrebbero cambiare frequentemente, il bot può controllare e rispondere con informazioni aggiornate.


**In parole semplici:** Invece di fare affidamento solo sulle informazioni statiche inserite durante la configurazione, il bot può visitare le pagine del tuo sito web in tempo reale per trovare i dettagli più recenti.

---

## Perché potresti aver bisogno della ricerca web

Senza la ricerca web, il bot conosce solo ciò che hai inserito nelle sue istruzioni e nelle FAQ. Questo funziona bene per le informazioni che cambiano raramente (come la politica di reso o gli orari di apertura). Tuttavia, per le cose che si aggiornano frequentemente, la ricerca web mantiene il bot aggiornato.

**Con la ricerca web abilitata, il bot può:**

- Cerca sul tuo sito web prodotti specifici in base a ciò che il cliente sta cercando
- Recupera le informazioni più recenti su prezzi, disponibilità o inventario
- Condividi link diretti a pagine specifiche di prodotti o servizi
- Cerca risposte a domande generali su Internet, anche su argomenti non presenti sul tuo sito
- Leggi gli URL che un cliente condivide nella conversazione

**Esempio di conversazione:**

> **Cliente:** Avete appartamenti con 3 camere da letto disponibili ad Amsterdam?
>
> **Bot:** Lascia che controlli le nostre inserzioni attuali per te...
>
> Abbiamo 2 appartamenti con tre camere da letto disponibili ad Amsterdam in questo momento:
>
> 1. Jordaan Canal View - 3 letti/2 bagni, 95m2, 2.450 EUR/mese
> 2. De Pijp Modern - 3 letti/1 bagno, 82m2, 2.100 EUR/mese
>
> Vorresti maggiori dettagli su uno di questi?

Senza la ricerca web, il bot avrebbe dovuto dire qualcosa di generico come "Abbiamo appartamenti disponibili ad Amsterdam. Controlla il nostro sito web per le inserzioni attuali." Con la ricerca web, fornisce al cliente esattamente ciò di cui ha bisogno, direttamente nella chat.

---

## Come funziona

1. Il cliente chiede informazioni su qualcosa di specifico
2. L'AI decide che effettuare una ricerca aiuterebbe a rispondere alla domanda
3. Il bot cerca negli URL dinamici che hai configurato (ricerca nel sito web) o su Internet (ricerca web), utilizzando le parole chiave della conversazione
4. Viene recuperato il contenuto più pertinente
5. L'AI incorpora i risultati nella sua risposta

> **Il bot ha due funzionalità web.** (1) La **ricerca nel sito web** esamina solo gli URL dinamici che configuri qui, ed è anche ciò che permette al bot di aprire un link incollato da un cliente nella chat; pertanto, richiede **almeno un** URL dinamico per funzionare. (2) La **ricerca web** esegue una ricerca pubblica su Internet per domande generali che non riguardano il tuo sito e **non** richiede URL dinamici. Entrambe sono controllate dall'interruttore **Ricerca web AI**: se lo disattivi, il bot non eseguirà nessuna delle due e risponderà solo basandosi sulle tue FAQ, sulle fonti di conoscenza e sulle istruzioni. La ricerca web richiede inoltre un piano che includa la funzionalità di ricerca web in tempo reale.

Il bot utilizza due modalità di ricerca a seconda della domanda:

- **Modalità elenco** - Quando il cliente sta navigando o confrontando le opzioni, il bot scansiona il contenuto della tua pagina e restituisce i risultati più pertinenti. Ad esempio: "Quali appartamenti avete disponibili?"
- **Modalità specifica** - Quando il cliente chiede informazioni su un articolo particolare, il bot trova e condivide un link diretto al prodotto o servizio corrispondente. Ad esempio: "Avete le Nike Air Max 90 in nero?"

Il bot seleziona automaticamente la modalità corretta in base alla conversazione.

Il bot gestisce anche i link condivisi dai clienti. Se un cliente incolla un URL nella chat, il bot può leggere quella pagina e utilizzare le informazioni nella conversazione.

---

## Come abilitare la ricerca web

### Controlla il tuo piano

La ricerca web in tempo reale è disponibile nei piani idonei o quando abilitata sul tuo account. Controlla il tuo [livello di abbonamento](../billing/subscription-tiers.md) per confermare.

### Configurazione

1. Apri l'[Agente](../ai-agents/ai-agents.md) (sotto **AI Studio → AI Agents**). (Per un Agente ancora collegato a una campagna classica, la stessa impostazione appare anche nel passaggio **FAQs & Knowledge** di quella campagna.)
2. Fai clic sulla scheda **FAQs & Knowledge**: la ricerca web si trova lì insieme alle tue FAQ e alle fonti di conoscenza, poiché sono tutti modi in cui il bot trova le risposte.
3. Scorri fino alla sezione **AI web search**.


4. Sposta l'interruttore accanto a **Ricerca web AI** su ON. (Se il tuo piano non include questa funzionalità, l'interruttore sarà disabilitato e apparirà un avviso di aggiornamento: esegui l'aggiornamento in **Impostazioni → Fatturazione** per prima cosa.)
5. Sotto appariranno un elenco e un campo di testo. Questi sono i tuoi **URL dinamici**: le pagine web in cui il bot effettuerà la ricerca, fino a un massimo di **10** per agente. Sono **facoltativi**: lascia l'elenco vuoto e il bot potrà comunque eseguire una ricerca web pubblica. Aggiungere almeno un URL è ciò che attiva la ricerca nelle tue pagine e la lettura dei link che i clienti incollano nella chat.
6. Incolla un URL nel campo di testo, quindi fai clic su **+ Aggiungi** (o premi Invio).


7. Ripeti l'operazione per ogni pagina che desideri aggiungere. Una volta aggiunte 10 pagine, il campo di testo scompare: rimuovine una prima se desideri aggiungere una pagina diversa.
8. Fai clic su **Save changes** in basso.

### Cosa sono gli URL dinamici?

Gli URL dinamici sono le pagine web che vuoi che il bot sia in grado di cercare durante le conversazioni. Sono diversi dagli "URL della pagina di vendita" che potresti aver aggiunto durante la configurazione della campagna:

| | URL della pagina di vendita | URL dinamici |
|--|----------------|-------------|
| **Quando vengono usati** | Lettura una sola volta durante la configurazione della campagna | Ricerca in tempo reale durante ogni conversazione pertinente |
| **Scopo** | Generare istruzioni iniziali e FAQ per il bot | Fornire risposte aggiornate e in tempo reale |
| **Ideale per** | Contenuti statici (pagina chi siamo, informazioni generali) | Contenuti che cambiano frequentemente (elenchi, inventario, prezzi) |

### Quali pagine aggiungere come URL dinamici

- Pagine di elenco prodotti o catalogo
- Pagine dei servizi
- Pagine dei prezzi che cambiano frequentemente
- Pagine di inventario o disponibilità
- Qualsiasi pagina con informazioni che si aggiornano regolarmente

---

## Casi d'uso comuni

| Scenario | Cosa chiede il cliente |
|----------|----------------------|
| **Ricerca prodotti** | "Avete scarpe da corsa blu taglia 44?" |
| **Verifica disponibilità** | "Quali appartamenti avete disponibili questo mese?" |
| **Consultazione prezzi** | "Quanto costa il piano Professional?" |
| **Confronto funzionalità** | "Qual è la differenza tra Basic e Pro?" |
| **Promozioni attuali** | "Avete offerte in corso?" |
| **Verifica link** | Il cliente condivide un link di un prodotto, il bot lo legge e fornisce i dettagli |

---

## Quando il bot effettua la ricerca (e quando non la effettua)?

**Il bot ESEGUIRÀ una ricerca quando:**

- Il cliente chiede informazioni specifiche probabilmente presenti sul tuo sito web
- La domanda riguarda dettagli che cambiano (prezzi, disponibilità, livelli di scorte)
- La risposta non è già coperta dalle istruzioni o dalle FAQ del bot

**Il bot NON eseguirà una ricerca quando:**

- La domanda può ricevere risposta dalle FAQ o dalle Istruzioni AI (non è necessario cercare)
- La domanda non è correlata al contenuto del tuo sito web

---

## Costo in crediti

Una ricerca web viene fatturata come qualsiasi altra chiamata a uno strumento bot, in base al livello di Qualità AI del tuo Agente:

| Livello di Qualità AI | Crediti per ricerca web | Con la tua chiave Anthropic (BYOK) collegata |
|---|---|---|
| Pro | 1 credito | 0 crediti — eseguita con la tua chiave |
| Economy (deprecato) | 0,5 crediti | 0 crediti — eseguita con la tua chiave |
| Max | 0,25 crediti | ancora 0,25 crediti, fatturati anche con la tua chiave collegata, poiché Max viene eseguito sul nostro modello |
| Mini | 0,15 crediti | ancora 0,15 crediti, fatturati anche con la tua chiave collegata, poiché Mini viene eseguito sul nostro modello |

**Suggerimento:** Se il bot esegue ricerche troppo frequentemente per gli stessi tipi di domande, prendi in considerazione l'aggiunta di tali risposte nelle FAQ. Le FAQ sono incluse automaticamente e non comportano costi aggiuntivi in crediti.

---

## Suggerimenti per risultati ottimali

1. **Aggiungi pagine con contenuti strutturati.** Le pagine di elenco prodotti, i cataloghi e le tabelle dei prezzi funzionano meglio. Evita le pagine che richiedono un accesso. Le pagine dinamiche e renderizzate in JavaScript sono supportate.

2. **Usa la ricerca web insieme alle FAQ.** Per le informazioni che cambiano raramente (politiche di reso, orari di apertura, informazioni generali), usa le FAQ. Riserva la ricerca web ai contenuti che si aggiornano frequentemente.

3. **Test in Try Out.** Poni domande specifiche sul prodotto per assicurarti che il bot riesca a trovare e presentare correttamente le informazioni dal tuo sito web.

4. **Monitora l'utilizzo dei crediti.** Se il tuo bot esegue ricerche frequentemente, valuta di espandere le tue FAQ per coprire le domande comuni: ciò riduce la necessità di ricerche web e fa risparmiare crediti.

---

## Prossimi passi

- [Gestione delle FAQ](faq-management.md): l'altro strumento presente nella stessa scheda per basare il bot sui tuoi contenuti.
- [Funzioni personalizzate](custom-functions.md): gli strumenti integrati **Search Your Website**, **Check a Link** e **Search the Web** che questa funzionalità alimenta.
- [Agenti AI](../ai-agents/ai-agents.md): dove si trova la scheda FAQs & Knowledge.
