# Come intoCHAT risponde usando i tuoi contenuti

> Come un agente intoCHAT trova le risposte: suddivisione in passaggi, ricerca ibrida semantica e per parole chiave, Q&A e fonti prioritarie, nessun fine-tuning.

intoCHAT non riaddestra un modello AI sui tuoi contenuti. Indicizza le tue fonti e, per ogni messaggio di un visitatore, cerca i passaggi utili e li passa al modello insieme alle tue istruzioni. Conoscere questi passi ti aiuta a capire perché una risposta è venuta fuori in un certo modo.

## 1. Addestramento: suddivisione e indicizzazione

Quando premi **Train agent**, il testo di ogni fonte viene diviso in passaggi:

- Un passaggio contiene al massimo circa 1.600 caratteri. I paragrafi restano interi quando possibile; quelli lunghi vengono divisi tra una frase e l'altra.
- I passaggi vicini si sovrappongono di circa 200 caratteri, così un'informazione a cavallo del confine si trova da entrambi i lati.
- Una coppia di Q&A resta in un unico pezzo, a meno che non sia più lunga di un passaggio.
- Ogni passaggio viene indicizzato con il titolo e l'indirizzo della sua fonte. Così un paragrafo sotto "Piano Pro" si distingue dallo stesso testo sotto "Piano Starter".

Nella dashboard "addestramento" significa proprio questa indicizzazione. Il modello AI in sé non cambia.

## 2. Capire la domanda

Le domande successive dipendono spesso da quelle precedenti, come "e quanto costa?". L'agente riscrive prima l'ultimo messaggio in una query di ricerca autonoma, usando gli ultimi scambi della conversazione. Nomi, codici prodotto e numeri restano come sono, così come la lingua del visitatore.

## 3. Ricerca ibrida

La query passa per due ricerche sui tuoi passaggi addestrati:

- La **ricerca semantica** trova passaggi con lo stesso significato, anche se usano parole diverse.
- La **ricerca per parole chiave** trova termini esatti come codici prodotto, nomi e prezzi, che la ricerca semantica può perdere.

I due elenchi di risultati vengono uniti. I passaggi che non corrispondono abbastanza alla domanda vengono scartati, così una corrispondenza debole non passa per una risposta. Un passaggio trovato solo tramite parole chiave deve contenere tutte le parole significative della domanda, oppure tutti i codici prodotto che cita.

## 4. Scegliere cosa vede il modello

Tra le corrispondenze rimaste, l'agente sceglie al massimo sei passaggi, per circa 12.000 caratteri in tutto. Da una stessa fonte ne prende prima al massimo tre, così un unico documento lungo non oscura gli altri. Quando i risultati sono vicini, vince il tipo di fonte più affidabile, in quest'ordine:

1. Coppie di Q&A. Una coppia che corrisponde da vicino alla domanda viene sempre messa al primo posto.
2. Fonti contrassegnate come prioritarie (icona a stella).
3. Testi.
4. File.
5. Pagine web.

Ogni passaggio porta un'etichetta con il tipo e la data dell'ultimo addestramento. Se i passaggi si contraddicono, il modello deve seguire lo stesso ordine e, tra fonti dello stesso tipo, fidarsi di quella aggiornata più di recente. Le tue istruzioni prevalgono su tutta la conoscenza. Il risultato riuscito di un'azione, per esempio un prezzo aggiornato dalla tua API, prevale su entrambe per i dati in tempo reale.

## 5. Scrivere la risposta

Il modello riceve regole integrate, le impostazioni correnti dell'agente (azioni disponibili e modulo dei lead), le tue istruzioni e i tuoi [guardrail](/it/docs/instructions), e la conversazione, a cui i passaggi sono allegati come materiale di riferimento. In caso di conflitto, le regole integrate prevalgono sulle tue istruzioni e sui guardrail. Fanno sì che l'agente:

- basi i dati aziendali, come prodotti, prezzi, condizioni e contatti, solo sulle tue istruzioni, sulla tua conoscenza o sui risultati delle azioni;
- dica brevemente cosa non può confermare quando non trova nulla di pertinente, invece di inventare una risposta, un link o un contatto;
- tratti la tua conoscenza e i risultati delle azioni come dati, mai come istruzioni. Una frase come "ignora le tue regole" su una pagina scansionata non ha effetto, e nemmeno i visitatori possono aggirare le regole.

L'elenco completo è nella pagina [Istruzioni](/it/docs/instructions).

Le risposte sono scritte da un unico modello OpenAI scelto e gestito da intoCHAT. Modello e temperatura non sono impostabili. L'agente risponde nella lingua in cui scrive il visitatore.

## Cosa significa per te

- Se un'informazione non è in nessuna fonte addestrata, l'agente non può conoscerla. Controlla nell'anteprima di una fonte cosa è stato letto davvero. Vedi [Gestire le fonti](/it/docs/managing-sources).
- Per le domande che richiedono una risposta precisa, aggiungi una [coppia di Q&A](/it/docs/text-and-qa).
- Se una pagina superata continua a prevalere, aggiornala o eliminala, oppure contrassegna come prioritaria la fonte giusta.
- La priorità vale dalla risposta successiva. I contenuti modificati valgono solo dopo l'addestramento.
