# Disambiguazione I fraintendimenti possono verificarsi in qualsiasi conversazione ma, quando si verificano con Crystal, di sicuro non passano inosservati. ## Una Richiesta Proattiva di Risolvere le Ambiguità I fraintendimenti nelle conversazioni possono verificarsi a causa della presenza di **ambiguità**, cioè di parole o concetti che possono assumere **significati diversi in contemporanea**. Se il tuo Progetto contiene Entità, Filtri, Obiettivi o addirittura interi Topic troppo simili tra loro, Crystal rileverà automaticamente queste ambiguità quando si presenteranno in una domanda. In questi casi, Crystal ha bisogno di maggiori informazioni per capire quale concetto selezionare ed è in grado di fornire proattivamente un **elenco di opzioni** tra cui scegliere per chiarire la domanda. Selezionando l'opzione corretta, fornirai a Crystal le informazioni mancanti per **disambiguare**, cioè risolvere l'ambiguità. Ora la domanda è stata chiarita!

{% hint style="info" %} **Nota Bene** Poiché la disambiguazione implica una *scelta tra Topic*, può avvenire in qualsiasi momento della conversazione in cui si specifica un Topic: ad esempio, sia che tu stia direttamente [chiedendo un argomento](/italiano/crystal-advisor/parla-con-i-tuoi-dati/conversazione/richiedi-i-topic.md), sia che stia [attivando qualche altra funzionalità ](/italiano/crystal-advisor/parla-con-i-tuoi-dati/conversazione/richiedi-unanalisi-dei-dati.md)su un Topic (come nelle richieste di rilevamento di anomalie, monitoraggio di soglie o previsioni). {% endhint %} ## Tipologie di Ambiguità Esistono diversi tipi di ambiguità che possono sorgere, a seconda della natura e della granularità delle informazioni coinvolte. Gli scenari possibili sono i seguenti: * [Entità Ambigue ](#entita-ambigue) * [Aggregazioni Ambigue di Entità](#aggregazioni-ambigue-di-entita) * [Valori di Filtro Ambigui ](#valori-di-filtro-ambigui) * [Aggregatori Temporali Ambigui](#aggregatori-temporali-ambigui) {% hint style="info" %} **Nota Bene** Una domanda può contenere più ambiguità e di diversi tipi. {% endhint %} Vediamole nel dettaglio. ### Entità Ambigue Questa ambiguità si verifica quando la combinazione delle Entità nella domanda porta a *più Topic possibili.* I Topic dell'elenco possono combaciare con le Entità in modo totale o parziale. #### Match Totale I Topic combaciano totalmente se tutte le Entità richieste possono essere trovate al loro interno. Questa ambiguità si verifica quando si richiede *un'Entità molto comune* che potrebbe essere presente in molti Topic. In questo caso, Crystal cerca di disambiguare in base alla granularità delle [Entità Personalizzate](/italiano/crystal-console/topics/configure/configurazione-del-topic-entita-personalizzata.md). * Domanda: *"Mostrami la distribuzione delle vendite"* * Ambiguità: *"vendite"* * Topic candidati: * *"vendite per regione"* *(Entità Personalizzate)* * *"vendite per categoria"* *(Entità Personalizzate)*

#### Match Parziale I Topic combaciano parzialmente se non tutte le Entità richieste possono essere trovate al loro interno. Questa ambiguità si verifica quando si richiede un'Entità che *non è presente in nessun Topic*. In questo caso, Crystal cerca di disambiguare recuperando i Topi che includono l'Entità in qualche altro modo. * Domanda: *"Mi dici il conteggio delle vendite"* * Ambiguità: *"conteggio delle vendite"* * Topic candidati (il Topic *"conteggio delle vendite"* non esiste): * *"totale del volume delle vendite nette effettive"* * *"totale del valore delle vendite nette effettive"*

### Aggregazioni Ambigue di Entità Questa ambiguità si verifica quando ci sono più Topic che contengono la stessa Entità che differisce solo per la *funzione di aggregazione* (somma, conteggio, totale, ecc.). In questo caso, Crystal restituisce l'elenco delle Entità Personalizzate effettivamente disponibili. * Domanda: *"Mostrami il costo"* * Ambiguità: *"costo"* * Topic candidati: * *"totale dei costi"* * *"costo medio"*

### Valori di Filtro Ambigui Questa ambiguità si verifica quando la domanda contiene un valore di Filtro che *non esiste ma che* [*corrisponde parzialmente*](/italiano/fondamenti/topics-di-crystal.md) *ad altri valori.* In questo caso, Crystal restituisce i valori effettivamente disponibili per quel Filtro. * Domanda: *"Mostrami il totale delle vendite in America"* * Ambiguità: *"America"* * Valori di Filtro candidati: * *"America del Nord"* * *"Sud America"* {% hint style="info" %} **Nota Bene** In questo scenario di disambiguazione, a differenza di tutti gli altri, puoi *selezionare più di un Valore di Filtro alla volta*, se necessario. Dalla [Release 2.58](/italiano/note-di-rilascio/2024/crystal-web/crystal-web-v2.58.md) puoi farlo utilizzando il pulsante "*Seleziona tutto"* / "*Deseleziona tutto"*! {% endhint %}

Ambiguità di Valori di Filtro che corrispondono Parzialmente

### Aggregatori Temporali Ambigui Questa ambiguità si verifica quando ci sono più *Topic di Obiettivo Overtime* che differiscono solo nell'*aggregatore di tempo*. * Domanda: *"andamento della tassazione nel tempo"* * Ambiguità: *"aggregatore di tempo"* * Topic candidati: * *"andamento della tassazione nel tempo (per giorno)"* * *"andamento della tassazione nel tempo* *(per semestre)"* * *"andamento della tassazione nel tempo* *(per trimestre)"*

### Tabelle di Origine Ambigue Nel contesto della [Conversazione basata sulle Entità](/italiano/crystal-advisor/parla-con-i-tuoi-dati/conversazione/richiedi-i-topic/conversazione-basata-su-entita.md), può accadere che vengano rilevate Entità con lo stesso nome. In questo caso, Crystal ti chiederà di scegliere la tabella di origine corretta per l'Entità. Continua a parlare con i tuoi dati! *** --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.igenius.ai/italiano/crystal-advisor/parla-con-i-tuoi-dati/conversazione/disambiguazione.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.