# Fai cercare sul web il tuo agente IA

> Fai cercare una domanda sul web al tuo agente intoCHAT quando la tua conoscenza non ha la risposta: attivarla, limitarla ad alcuni siti, cosa vedono i visitatori, costi e limiti.

Di norma il tuo agente risponde in base alla tua conoscenza, alle tue istruzioni e alle tue azioni. Con la ricerca web attiva, può anche cercare una domanda sul web quando la tua conoscenza non ha la risposta. La risposta dice allora che l'informazione viene dal web e collega le pagine usate.

La ricerca web è disattivata per impostazione predefinita. Finché è disattivata, l'agente non cerca mai sul web.

## Attivare la ricerca web

1. Apri il tuo agente e vai alla scheda **Setup**. Il riquadro **Web search** si trova sotto le altre impostazioni della scheda.
2. Attiva **Search the web**.
3. Se vuoi, elenca i siti in cui può cercare in **Only search these sites (optional)**. Vedi più sotto.
4. Clicca su **Save web search**. Il riquadro si salva a parte: **Save changes** nell'intestazione non lo salva, e **Save web search** non salva il resto della scheda.
5. Provala nel **Playground** con una domanda che la tua conoscenza non copre. Il Playground usa l'impostazione salvata, quindi salva prima.

## Limitarla ad alcuni siti

Lascia vuoto **Only search these sites (optional)** per cercare in tutto il web. Per cercare solo in alcuni siti, come la documentazione del tuo fornitore o un registro ufficiale, inserisci un sito per riga, fino a 20.

- Inserisci siti interi, come `example.com`. I sottodomini sono inclusi, quindi `example.com` copre anche `docs.example.com`.
- `https://` all'inizio, una `/` alla fine e `*.` all'inizio sono accettati e rimossi.
- Percorsi come `example.com/blog`, porte, indirizzi IP e `localhost` non sono accettati. Il riquadro mostra allora "Not a site name:" seguito dalla voce, e **Save web search** resta grigio finché non la correggi.
- Le pagine fuori dall'elenco non vengono mai collegate sotto una risposta, anche se la ricerca le ha restituite.

Il campo è grigio finché **Search the web** è disattivato.

## Quando l'agente cerca

- Solo quando la tua conoscenza non risponde alla domanda del visitatore e la domanda rientra nelle tue [istruzioni e nei tuoi guardrail](/it/docs/instructions). All'agente viene detto di non cercare mai per richieste fuori tema, per ciò che le tue istruzioni o i tuoi guardrail escludono, né per informarsi su persone private. I tuoi guardrail valgono anche per ciò che trova.
- Preferisce la tua conoscenza ogni volta che copre la domanda. È il modello di IA a decidere quando cercare, quindi ogni tanto può cercare anche quando tu non l'avresti fatto.
- Al massimo una volta per risposta.
- L'agente scrive una breve query di ricerca. Gli viene detto di tralasciare i dati personali del visitatore, come nomi, indirizzi email, numeri di telefono e numeri d'ordine. Viene cercata solo la query, non l'intero messaggio del visitatore.
- La ricerca attende fino a 15 secondi. Se ci mette di più, non riesce o non trova nulla di utile, l'agente dice brevemente che non è riuscito a cercarlo e aiuta con ciò che sa.

La ricerca web funziona anche nelle chat temporanee.

## Cosa vedono i visitatori

La risposta dice che l'informazione viene dal web e non la presenta come propria della tua attività. Sotto la risposta, una riga che inizia con "Dal web" collega fino a 3 pagine usate dalla ricerca. Ogni link mostra il nome della pagina e la apre in una nuova scheda.

- I link vengono dalle citazioni che OpenAI restituisce con il risultato della ricerca. Il modello di IA che scrive la risposta non li sceglie e non li scrive.
- La riga compare qualunque cosa indichi **Show sources under replies** nella scheda [Appearance](/it/docs/appearance). Se quell'interruttore è attivo, compare anche la riga "Fonti" per le tue pagine.
- "Dal web" segue **Widget language**: "From the web", "Aus dem Web", "Sur le web" o "De la web" nelle altre lingue.
- Non compaiono link sotto una risposta che mostra un [modulo in chat](/it/docs/chat-forms), conferma un [passaggio via email](/it/docs/handoff), propone il [modulo lead](/it/docs/lead-collection) o non ha testo.

I risultati del web possono essere sbagliati o non aggiornati, e intoCHAT non controlla quali pagine trova una ricerca. Per le informazioni che devono essere corrette, come prezzi o condizioni, aggiungile alla tua conoscenza, per esempio come [coppia di Q&A](/it/docs/text-and-qa).

## Nelle trascrizioni

Nella scheda **Conversations**, apri **Why this answer** sotto una risposta. Quando l'agente ha cercato, **Actions called** elenca "Web search" con la query tra virgolette, **Succeeded** o **Failed**, e i link alle pagine citate dalla ricerca, fino a 5. Vedi [Conversazioni e statistiche](/it/docs/conversations-and-dashboard#why-this-answer).

## Costi

- Le ricerche passano per la ricerca web di OpenAI. intoCHAT invia la query a OpenAI, che esegue la ricerca e restituisce una breve risposta con le pagine citate.
- Una ricerca non ti costa un messaggio in più. Ogni risposta conta come un messaggio, con o senza ricerca. Vedi [Piani e limiti](/it/docs/plans-and-limits).
- Una risposta con ricerca richiede più tempo, perché l'agente aspetta il risultato prima di rispondere.

## Limiti

- Una ricerca per risposta, con un'attesa fino a 15 secondi.
- Fino a 20 siti nell'elenco, solo siti interi.
- Fino a 3 link sotto una risposta.
- La ricerca web non è un'azione e non conta nel limite di 25 azioni.
- Un'[azione lato client](/it/docs/client-actions) attiva chiamata `search_web`, o con un nome che lo diventa, come "search web", disattiva la ricerca web finché è attiva, anche con l'interruttore acceso, perché il gestore della tua pagina è registrato proprio con quel nome. Il riquadro non ti avvisa; rinomina o disattiva quell'azione. Le [azioni API](/it/docs/api-actions) e i [pulsanti personalizzati](/it/docs/custom-buttons) con quel nome vengono rinominati dietro le quinte e non creano problemi.
- Un [agente duplicato](/it/docs/quick-start) copia l'interruttore e l'elenco dei siti.

## Passi successivi

- Assicurati che l'agente trovi prima i tuoi contenuti: [Come nascono le risposte](/it/docs/how-answers-work).
- Stabilisci che cosa rientra nei compiti dell'agente: [Istruzioni](/it/docs/instructions).
- Mostra anche i link alle tue pagine: [Aspetto](/it/docs/appearance).
