# 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**.&#x20;

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.&#x20;

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.&#x20;

Selezionando l'opzione corretta, fornirai a Crystal le informazioni mancanti per **disambiguare**, cioè risolvere l'ambiguità.&#x20;

Ora la domanda è stata chiarita!

<figure><img src="https://242936509-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnKpOPNK55hq8nWnuDD%2Fuploads%2F7SUe1YuJi4s4njfmIR93%2Fimage.png?alt=media&#x26;token=a57db4f8-ac7b-4682-bb82-951c73883a0c" alt=""><figcaption><p>Opzioni di Disambiguazione</p></figcaption></figure>

{% hint style="info" %} <mark style="color:blue;">**Nota Bene**</mark>

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](https://docs.igenius.ai/italiano/crystal-advisor/parla-con-i-tuoi-dati/conversazione/richiedi-i-topic), sia che stia [attivando qualche altra funzionalità ](https://docs.igenius.ai/italiano/crystal-advisor/parla-con-i-tuoi-dati/conversazione/richiedi-unanalisi-dei-dati)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.&#x20;

Gli scenari possibili sono i seguenti:&#x20;

* [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" %} <mark style="color:blue;">**Nota Bene**</mark>

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.*&#x20;

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.&#x20;

Questa ambiguità si verifica quando si richiede *un'Entità molto comune* che potrebbe essere presente in molti Topic.&#x20;

In questo caso, Crystal cerca di disambiguare in base alla granularità delle [Entità Personalizzate](https://docs.igenius.ai/italiano/crystal-console/topics/configure/configurazione-del-topic-entita-personalizzata).

* Domanda: *"Mostrami la distribuzione delle vendite"*&#x20;
* Ambiguità: *"vendite"*&#x20;
* Topic candidati:&#x20;
  * *"vendite per regione"* *(Entità Personalizzate)*&#x20;
  * *"vendite per categoria"* *(Entità Personalizzate)*

<figure><img src="https://242936509-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnKpOPNK55hq8nWnuDD%2Fuploads%2FsR2PESfFyuJkWM4fv5mY%2Fimage.png?alt=media&#x26;token=e5b8455a-08b3-4b92-8505-6d6ccca9985a" alt=""><figcaption><p>Ambiguità di Entità con Match Totale</p></figcaption></figure>

#### Match Parziale

I Topic combaciano parzialmente se non tutte le Entità richieste possono essere trovate al loro interno.&#x20;

Questa ambiguità si verifica quando si richiede un'Entità che *non è presente in nessun Topic*.&#x20;

In questo caso, Crystal cerca di disambiguare recuperando i Topi che includono l'Entità in qualche altro modo.&#x20;

* Domanda: *"Mi dici il conteggio delle vendite"*&#x20;
* Ambiguità: *"conteggio delle vendite"*&#x20;
* Topic candidati (il Topic *"conteggio delle vendite"* non esiste):&#x20;
  * *"totale del volume delle vendite nette effettive"*&#x20;
  * *"totale del valore delle vendite nette effettive"*

<figure><img src="https://242936509-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnKpOPNK55hq8nWnuDD%2Fuploads%2FxV63qFJ3Kjitmt4GWQet%2Fimage.png?alt=media&#x26;token=b0aee7a3-622b-408e-9483-743f389bdee1" alt=""><figcaption><p>Ambiguità di Entità con Match Pariale</p></figcaption></figure>

### 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.).&#x20;

In questo caso, Crystal restituisce l'elenco delle Entità Personalizzate effettivamente disponibili.

* Domanda: *"Mostrami il costo"*&#x20;
* Ambiguità: *"costo"*&#x20;
* Topic candidati:&#x20;
  * *"totale dei costi"*&#x20;
  * *"costo medio"*

<figure><img src="https://242936509-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnKpOPNK55hq8nWnuDD%2Fuploads%2FVeq6iErYdHsJjG6ZaQAS%2Fimage.png?alt=media&#x26;token=0da46260-7706-4991-9952-1c6c2750845d" alt=""><figcaption><p>Ambiguità di Aggregazione</p></figcaption></figure>

### Valori di Filtro Ambigui

Questa ambiguità si verifica quando la domanda contiene un valore di Filtro che *non esiste ma che* [*corrisponde parzialmente*](https://docs.igenius.ai/italiano/fondamenti/topics-di-crystal) *ad altri valori.*&#x20;

In questo caso, Crystal restituisce i valori effettivamente disponibili per quel Filtro.&#x20;

* Domanda: *"Mostrami il totale delle vendite in America"*&#x20;
* Ambiguità: *"America"*&#x20;
* Valori di Filtro candidati:&#x20;
  * *"America del Nord"*&#x20;
  * *"Sud America"*

{% hint style="info" %} <mark style="color:blue;">**Nota Bene**</mark>

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](https://docs.igenius.ai/italiano/note-di-rilascio/2024/crystal-web/crystal-web-v2.58) puoi farlo utilizzando il pulsante "*Seleziona tutto"* / "*Deseleziona tutto"*!
{% endhint %}

<figure><img src="https://242936509-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnKpOPNK55hq8nWnuDD%2Fuploads%2FC1xgya5369CMx1XcTNAN%2Fimage.png?alt=media&#x26;token=b0d8fe0c-ca87-4cb4-aadf-0cbf679a91df" alt=""><figcaption><p>Ambiguità di Valori di Filtro che corrispondono Parzialmente</p></figcaption></figure>

<div><figure><img src="https://242936509-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnKpOPNK55hq8nWnuDD%2Fuploads%2Fn9Lxd2tgqah2F8AQIQwY%2FScreenshot%202024-09-10%20at%2011.08.38.png?alt=media&#x26;token=ded2e2ec-61e6-499b-9335-1a8500af7326" alt=""><figcaption><p>Seleziona tutto</p></figcaption></figure> <figure><img src="https://242936509-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnKpOPNK55hq8nWnuDD%2Fuploads%2FBfVAQHYbktwfp3nxcZWm%2FScreenshot%202024-09-10%20at%2011.26.11.png?alt=media&#x26;token=d6719b57-33d3-4b64-9fb7-6866a0032417" alt=""><figcaption><p>Deseleziona tutto</p></figcaption></figure></div>

### Aggregatori Temporali Ambigui

Questa ambiguità si verifica quando ci sono più *Topic di Obiettivo Overtime* che differiscono solo nell'*aggregatore di tempo*.&#x20;

* Domanda: *"andamento della tassazione nel tempo"*
* Ambiguità: *"aggregatore di tempo"*&#x20;
* Topic candidati:&#x20;
  * *"andamento della tassazione nel tempo (per giorno)"*&#x20;
  * *"andamento della tassazione nel tempo* *(per semestre)"*&#x20;
  * *"andamento della tassazione nel tempo* *(per trimestre)"*

<figure><img src="https://242936509-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnKpOPNK55hq8nWnuDD%2Fuploads%2FaYE1jcd7afJbCkYrhwOG%2Fimage.png?alt=media&#x26;token=8f72bcd6-7a22-4395-9946-ebde6f266e88" alt=""><figcaption><p>Ambiguità di Aggregatore Temporale</p></figcaption></figure>

### Tabelle di Origine Ambigue&#x20;

Nel contesto della [Conversazione basata sulle Entità](https://docs.igenius.ai/italiano/crystal-advisor/parla-con-i-tuoi-dati/conversazione/richiedi-i-topic/conversazione-basata-su-entita), può accadere che vengano rilevate Entità con lo stesso nome.&#x20;

In questo caso, Crystal ti chiederà di scegliere la tabella di origine corretta per l'Entità.

Continua a parlare con i tuoi dati!&#x20;

***
