# Utilizzo dell'assistente test

Utilizzare l'Assistente test per fare domande sui dati e verificare che questi vengano trasferiti correttamente e siano aggiornati. Questa opzione consente anche di verificare che non si condividano dati errati o riservati.

Nota di avvisoQuesta funzionalità utilizza l'intelligenza artificiale. È responsibilità dell'utente controllare e verificare qualsiasi output dell'IA prima di utilizzarlo o condividerlo, e di valutare se il suo utilizzo è appropriato per un caso di utilizzo specifico e se rispetta le leggi applicabili.

Nota informaticaÈ necessaria una sottoscrizione Qlik Talend Cloud Enterprise.

## Porre domande

Avviare l'assistente test dalla pagina Attività dati:

1. Eseguire l'attività dati.
2. Una volta completata, fare clic su Assistente test nella barra dei menu. L'Assistente test viene visualizzato nel pannello di destra.

Per porre una domanda, inserirla e inviarla in uno seguenti modi:

* Premendo il tasto INVIO sulla tastiera.
* Facendo clic su Invio.

I dati possono essere utilizzati dall'assistente test solo se sono definiti come Metadati.

1. Andare alla scheda Set di dati.

2. Selezionare la casella di controllo Metadati.

   ![Casella di controllo Metadati](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Resources/Images/datasets_metadata_checkbox.png)

3. Eseguire l'attività. Una volta completata, è possibile porre domande sui dati selezionati.

## Cronologia delle domande

È possibile visualizzare, copiare, eliminare e riproporre le domande precedenti. È possibile anche copiare le risposte.

Le conversazioni non possono essere salvate.

Fare clic su the Cronologia domande icon, posizionare il mouse sulla domanda e selezionare l'azione: Copia, Invia nuovamente o Elimina.

![Cronologia dell'assistente test](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Resources/Images/test-assistant-history.png)

L'eliminazione di una domanda dalla cronologia non può essere annullata.

## Impostazioni

Questa tabella descrive le impostazioni della scheda Assistente testAssistente test.

| Impostazioni | Descrizione |
| --- | --- |
| Numero di documenti in contesto | Il numero di documenti rilevanti che verranno passati al modello come contesto. |
| Modello prompt | Inserire il modello che l'IA deve seguire per filtrare i documenti da includere. |
| Filtro | Inserire l'espressione per filtrare i documenti da includere.<br><br>Poiché il filtro si basa sui metadati e i knowledge mart basati su file non hanno metadati, considerare attentamente il filtro che da configurare. Potrebbe essere più pertinente escludere i dati anziché includerli.<br><br>Per ulteriori informazioni, vedere [Utilizzo dell'assistente test](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/KnowledgeMart/Test-Assistant.htm#). |
| Recupero documento | Selezionare l'opzione dall'elenco a discesa:<br><br><ul><li><span>Mostra contesto recuperato</span>: l'Assistente test fornisce i documenti che utilizza per generare le risposte.</li><li><span>Non mostrare contesto recuperato</span>: l'Assistente test genera una risposta, ma non fornisce i documenti.</li></ul> |
| Generazione risposte | Selezionare l'opzione dall'elenco a discesa:<br><br><ul><li><span>Genera risposte</span>: l'Assistente test genera una risposta in base ai documenti.</li><li><span>Non generare risposte</span>: l'Assistente test risponde unicamente con i documenti.</li></ul> |

## Esempi di filtri

L'assistente test può aiutare a definire il Filtro da utilizzare nelle Impostazioni, ma il formato del filtro dipende dai database vettoriali.

### Esempi di knowledge mart

La tabella seguente mostra alcuni esempi di domande che è possibile porre e i filtri restituiti dall'assistente test.

| Database vettoriale | Domande | Risposta da usare come filtro | Formato | Documentazione |
| --- | --- | --- | --- | --- |
| Elasticsearch | Scrivere un filtro per i documenti in cui metadata.UnitsInStock = 39 | `{'terms': {'metadata.UnitsInStock': [39]}}` | JSON | [Query booleana](https://www.elastic.co/docs/reference/query-languages/query-dsl/query-dsl-bool-query#filter-clause)<br><br>[DSL di query](https://www.elastic.co/guide/en/elasticsearch/reference/current/query-filter-context.html) |
| OpenSearch | Scrivere un filtro per i documenti in cui metadata.UnitsInStock = 39 | `{'terms': {'metadata.UnitsInStock': [39]}}` | JSON | [Testo completo query](https://docs.opensearch.org/docs/latest/query-dsl/full-text/index/) |
| Pinecone | Filtro in stile Mongo per ottenere i vettori dove UnitsInStock = 39 | `{"UnitsInStock": 39}` | JSON | [Filtrare in base ai metadati](https://docs.pinecone.io/guides/search/filter-by-metadata) |
| Snowflake Cortex | Scrivere una query SQL Cortex per filtrare le righe dove metadata.UnitsInStock = 39 | `"metadata":"UnitsInStock" = 39` | SQL | Sintassi SQL |
| Databricks | Scrivere una query SQL Databricks per filtrare le righe dove metadata.UnitsInStock = 39 | `{"metadata LIKE": "%\"UnitsInStock\":39%"}` | SQL | Sintassi SQL |

Ricordare che le risposte dipendono dai dati, questi sono solo degli esempi.

### Esempi di knowledge mart basati su file

Utilizzare il Filtro per limitare la ricerca a file specifici. La tabella seguente mostra alcuni esempi:

| Database vettoriale | Filtro | Formato | Documentazione |
| --- | --- | --- | --- |
| Elasticsearch | `{"terms": {"source_id.keyword": ["gs://ai-ready/test/hello.txt"]}}` | JSON | [Query booleana](https://www.elastic.co/docs/reference/query-languages/query-dsl/query-dsl-bool-query#filter-clause)<br><br>[DSL di query](https://www.elastic.co/guide/en/elasticsearch/reference/current/query-filter-context.html) |
| OpenSearch | `{"terms": {"source_id.keyword": ["gs://ai-ready/test/hello.txt"]}}` | JSON | [Testo completo query](https://docs.opensearch.org/docs/latest/query-dsl/full-text/index/) |
| Pinecone | `{"source_id": "s3://username-filebased/docxfiles/newF/cv.docx"}` | JSON | [Filtrare in base ai metadati](https://docs.pinecone.io/guides/search/filter-by-metadata) |
| Snowflake Cortex | `"source_id" like "s3://username-filebased/pdf/small_pdf/%"` | SQL | Sintassi SQL |
| Databricks | `"source_id" like "s3://username-filebased/pdf/small_pdf/%"` | SQL | Sintassi SQL |

Ricordare che le risposte dipendono dai dati, questi sono solo degli esempi.