# Aggiungi testi e coppie di Q&A al tuo agente

> Aggiungi testi e coppie di Q&A a un agente intoCHAT: altre formulazioni, importazione ed esportazione CSV ed Excel, perché le Q&A vengono prima e come scriverle.

Con testi e coppie di Q&A scrivi tu la conoscenza, senza bisogno di un sito o di un file. Li aggiungi nella scheda **Knowledge** (conoscenza); valgono dopo l'addestramento e puoi modificarli quando vuoi.

## Testi

Un testo è qualsiasi contenuto che incolli o scrivi: una policy, gli orari di apertura, la descrizione di un prodotto o dettagli che sul sito mancano.

1. In **Add knowledge**, scegli **Text**.
2. Inserisci un **Title** (titolo), per esempio "Condizioni di spedizione". È facoltativo, ma consigliato.
3. Incolla o scrivi il testo in **Content** (contenuto). Il contatore sotto ne mostra la lunghezza in caratteri.
4. Clicca su **Add text** e poi su **Train agent**.

Il titolo diventa il nome della fonte e viene indicizzato con ogni passaggio del testo, il che aiuta la ricerca a trovarlo. Senza titolo, come nome vengono usate le prime parole del testo.

## Coppie di Q&A

Una coppia di Q&A è una domanda con la risposta che vuoi far dare al tuo agente.

1. In **Add knowledge**, scegli **Q&A**.
2. Inserisci la domanda in **Question**, per esempio "Come funziona il rimborso?". Può avere fino a 200 caratteri.
3. Se vuoi, in **Other phrasings** (altre formulazioni) clicca su **Add a phrasing** per ogni altro modo in cui i visitatori chiedono la stessa cosa.
4. Inserisci la risposta in **Answer**.
5. Clicca su **Add Q&A pair** e poi su **Train agent**.

Domanda e risposta sono obbligatorie. La domanda diventa il nome della fonte.

Ogni agente ha una sola coppia per domanda. Se aggiungi una coppia la cui domanda esiste già, senza distinguere maiuscole, minuscole e spazi in più, la coppia esistente viene aggiornata invece di essere duplicata: prende la risposta dal modulo, e anche le altre formulazioni se ne hai inserite (altrimenti tiene le sue), e compare "Q&A updated". Se nulla cambia rispetto alla coppia salvata, non viene salvato niente e compare "Already saved". Non puoi modificare la domanda di una coppia in una che un'altra coppia ha già.

## Altre formulazioni

I visitatori chiedono la stessa cosa con parole diverse: "Come funziona il rimborso?", "Posso riavere i miei soldi?", "Accettate resi?". Aggiungi a una coppia fino a 5 altre formulazioni, ognuna fino a 200 caratteri. Portano tutte alla stessa risposta.

Le formulazioni vengono addestrate insieme a domanda e risposta come un unico passaggio, così la ricerca vede le parole di ognuna. Le formulazioni vuote e quelle che ripetono la domanda o un'altra formulazione vengono scartate al salvataggio. Per cambiare le formulazioni di una coppia esistente, modificala con l'icona della matita in **Knowledge sources** e poi addestra. L'elenco delle fonti mostra quante altre formulazioni ha una coppia, e **Search sources…** trova le coppie anche in base alle formulazioni.

Le formulazioni contano nel limite di caratteri dell'agente, come domanda e risposta.

## Importare ed esportare coppie di Q&A

Sotto il modulo Q&A, **Many pairs at once** (molte coppie insieme) ha due pulsanti.

**Export CSV** scarica tutte le coppie di Q&A dell'agente in un file CSV con tre colonne: `question`, `answer` e `variants`. Le altre formulazioni condividono la cella `variants`, separate da ` | `. Il file si apre correttamente in Excel, accenti compresi, e si può reimportare così com'è.

**Import file** legge le coppie da un foglio di calcolo:

1. Prepara un file CSV, XLSX, XLSM o ODS fino a 4 MB. I file CSV possono usare come separatore virgole, punti e virgola o tabulazioni. In una cartella di lavoro con più fogli viene usato il primo foglio la cui prima riga indica una colonna per le domande e una per le risposte, altrimenti il primo foglio.
2. Metti domanda e risposta in colonne separate. Una terza colonna per le altre formulazioni è facoltativa; separale con `|` o mettile ognuna su una riga nella cella.
3. Clicca su **Import file** e scegli il file. Non viene ancora salvato nulla.
4. Controlla l'anteprima, poi clicca sul pulsante di importazione, per esempio **Import 25 pairs and train**. L'addestramento parte subito.

La prima riga viene letta come intestazione quando indica sia una colonna per le domande sia una per le risposte. Questi titoli vengono riconosciuti, senza distinguere maiuscole, minuscole e accenti:

| Colonna | Titoli riconosciuti |
|---|---|
| Domanda | question, questions, q, faq question, frage, fragen, domanda, domande, pregunta, preguntas |
| Risposta | answer, answers, a, reply, response, antwort, antworten, réponse, réponses, risposta, risposte, respuesta, respuestas |
| Altre formulazioni | variants, variant, variations, phrasings, alternative questions, other phrasings, alternatives, varianten, formulierungen, alternativen, alternative fragen, variantes, formulations, autres formulations, varianti, variazioni, formulazioni, domande alternative, variaciones, formulaciones, preguntas alternativas |

Senza un'intestazione così, la colonna A viene letta come domande, la B come risposte e la C come altre formulazioni, a partire dalla prima riga. L'anteprima lo segnala.

L'anteprima conta le nuove coppie, le coppie che aggiornano una coppia esistente con la stessa domanda, quelle già aggiornate e le righe saltate. Mostra le prime righe con il loro esito ed elenca fino a 10 righe saltate con il motivo:

- Manca la domanda o la risposta.
- Una domanda o una formulazione supera i 200 caratteri.
- La domanda è uguale a quella di una riga precedente del file.

Una riga con più di 5 altre formulazioni viene comunque importata con le prime 5, e l'anteprima lo indica. Una cella delle formulazioni vuota mantiene quelle che una coppia esistente ha già. Le righe vuote vengono ignorate.

Un file può contenere fino a 1.000 righe; quelle in più non vengono importate, e l'anteprima ti dice quante sono. L'anteprima mostra anche quanti caratteri del tuo piano userà l'agente dopo l'importazione. Se l'importazione supererebbe il limite, non viene importato nulla, e il pulsante di importazione resta disattivato finché non togli righe dal file, elimini altre fonti o passi a un piano superiore.

## Migliorare le risposte dalle conversazioni

Quando trovi una risposta debole in una trascrizione della scheda **Conversations**, clicca su **Improve answer** sotto di essa. Si apre una coppia di Q&A già compilata con la domanda del visitatore e la risposta dell'agente, da correggere e salvare. Il salvataggio aggiunge la coppia, o aggiorna quella con la stessa domanda, e la addestra. Vedi [Conversazioni e statistiche](/it/docs/conversations-and-dashboard).

## Come vengono classificate le Q&A

Le coppie di Q&A sono il tipo di conoscenza più affidabile:

- Quando una coppia corrisponde da vicino alla domanda di un visitatore, viene prima di qualsiasi pagina, file o testo.
- Quando più risultati sono vicini, vince la coppia di Q&A. Se le fonti si contraddicono, il modello deve seguire la tua risposta.

L'agente scrive comunque la risposta da sé, nella lingua del visitatore e con il tono delle tue istruzioni: può quindi accorciarla o riformularla. Le coppie di Q&A non si possono contrassegnare come prioritarie, perché vengono già prima. L'ordine completo è in [Come nascono le risposte](/it/docs/how-answers-work).

## Quando usare cosa

| Situazione | Usa |
|---|---|
| Una domanda frequente che richiede una risposta precisa: prezzi, regole di reso, tempi di consegna | Coppia di Q&A |
| Una risposta sbagliata o vaga notata nel Playground o in Conversations | Coppia di Q&A, per esempio con **Improve answer** |
| Una FAQ già pronta in un foglio di calcolo | Importazione di Q&A |
| Un contesto più lungo su un argomento: una policy, la panoramica di un prodotto, cosa include un servizio | Testo |
| Informazioni che mancano sul sito o che lì compaiono solo nelle immagini | Testo |

## Consigli per la scrittura

- **Una domanda per coppia.** Crea coppie separate per domande diverse, invece di una coppia che risponde a tre domande.
- **Usa le parole dei visitatori.** La ricerca confronta significato e parole chiave, quindi includi i termini, i nomi dei prodotti e i codici che i visitatori digitano davvero. Se una domanda viene posta in modi molto diversi, aggiungi quei modi come altre formulazioni.
- **Ogni risposta deve stare in piedi da sola.** Indica il link, il prezzo o la condizione di cui il visitatore ha bisogno.
- **Resta sotto i 1.500 caratteri circa per coppia, formulazioni comprese.** Una coppia che sta in un solo passaggio viene sempre trovata per intero.
- **Un argomento per testo.** Testi separati su spedizioni e resi si trovano più facilmente di un unico testo lungo su tutto.
- **Tienili aggiornati.** Una vecchia risposta Q&A prevale su una pagina web più recente e corretta. Quando un dato cambia, modifica la coppia e addestra di nuovo.

Testi e coppie di Q&A rientrano nel limite di caratteri dell'agente come qualsiasi altra fonte. Per modificarli, vederli in anteprima o eliminarli, vedi [Gestire le fonti](/it/docs/managing-sources).