# Conversazione Basata su Entità

## Una Migliore Esperienza di Conversazione

Parlare con Crystal è ancora più facile!

A partire dalla [<mark style="color:blue;">**Release 2.57**</mark>](https://docs.igenius.ai/italiano/note-di-rilascio/2024/crystal-web/crystal-web-v2.57), Crystal ti offre una **maggiore libertà** nel fare domande.

1. **Puoi chiedere Topic che non sono pre-configurati**

*Prima, dovevi sapere quali Topic erano configurati per poter fare una domanda: ora, non ci sono limiti ai Topic che puoi chiedere a Crystal.*

2. **Puoi fare domande con maggiore flessibilità**

*Prima, esplicitare l'Obiettivo era sempre rigorosamente obbligatorio per chiedere un Topic: ora ci sono anche alcuni scenari in cui non è necessario specificarlo.*

## Un Nuovo Metodo per Generare i Topic&#x20;

Questa esperienza di conversazione potenziata è possibile grazie all'introduzione di una nuova funzionalità di Crystal: la **generazione automatica di Topic basata sulle Entità**.&#x20;

Si tratta di un *metodo aggiuntivo per la generazione di Topic* che si affianca al *preesistente metodo del* [***Processo di Configurazione***](https://docs.igenius.ai/italiano/crystal-console/topics), effettuato dall'Utente Admin nella Crystal Console.

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

Chiamiamo *"Topic Auto-generati"* i Topic generati automaticamente da Crystal per differenziarli dai "Topic Configurati", creati dall'Admin.
{% endhint %}

I Topic Auto-generati, contrariamente a quelli Configurati, non devono essere creati manualmente da nessuno, poiché sono **generati direttamente da Crystal quando li chiedi**.&#x20;

Per questo motivo, ora è possibile fare domande che vanno oltre l'ambito dei Topic Configurati: **la configurazione dei Topic non è più una condizione necessaria per ottenere le risposte**.&#x20;

Tuttavia, la Configurazione dei Topic rimane attualmente ancora supportata, in quanto rimane un pilastro fondamentale della conversazione con Crystal. I due metodi combinati insieme garantiscono l'esperienza di conversazione più avanzata e completa mai disponibile su Crystal.&#x20;

Allo stato attuale, il metodo di generazione automatica dei Topic viene attivato *quando non è disponibile alcun Topic Configurato specifico* per rispondere alla richiesta.&#x20;

In altre parole: quando chiedi un Topic, Crystal cerca di trovare una corrispondenza con un Topic Configurato per il quale hai i permessi di visualizzazione, se presente; altrimenti, genererà un nuovo Topic.&#x20;

*Tutto ciò che devi fare è continuare a fare domande: sarà Crystal a fornire il tipo di Topic migliore per le tue esigenze.*

{% hint style="warning" %} <mark style="color:orange;">**Ricorda**</mark>

Anche se questa funzionalità ha più a che fare con la *logica che sta alla base della formulazione delle risposte di Crystal* (cioè su come Crystal genera autonomamente i Topic), essa impatta anche *il modo in cui puoi fare le domande*.&#x20;

Per parlare con Crystal e ricevere come risposta un Topic Auto-generato, puoi in generale seguire le stesse poche [**regole di conversazione**](https://docs.igenius.ai/italiano/crystal-advisor/parla-con-i-tuoi-dati/conversazione/richiedi-i-topic) necessarie per chiedere Topic configurati, tenendo in considerazione **alcune logiche nuove che rendono le regole meno stringenti**!
{% endhint %}

Approfondiamo!

## Come Funziona?

La funzionalità di generazione automatica di Topic e i miglioramenti della conversazione saranno analizzati separatamente.

### Generazione di Topic Automatica

Crystal è in grado di generare i Topic autonomamente **usando le Entità presenti nel dataset**, singolarmente o in combinazione.&#x20;

Quando chiedi un Topic che non è stato configurato dall'Admin, Crystal sfrutta la **configurazione delle Entità preesistenti in altri Topic Configurati** per **dedurre combinazioni possibili** di Entità.&#x20;

Partendo da un singolo Topic Configurato, Crystal può creare nuovi Topic basati su qualsiasi combinazione di Entità, indipendentemente dall'Obiettivo e dai Filtri richiesti.&#x20;

Ad esempio:&#x20;

* Considera un Topic configurato con l'Entità principale *"Licenze"* e tre Filtri applicati *"paese",* *"regione"* e *"tipo di prodotto"*
* Crystal può creare:&#x20;
  * *"Overtime di licenze (per giorno)"*
  * *"Confronto tra le licenze per regione e paese"*
  * ecc.

<figure><img src="https://242936509-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnKpOPNK55hq8nWnuDD%2Fuploads%2FYxteHakzpXSbfRE9OwJy%2Fimage.png?alt=media&#x26;token=251cf71c-545b-4a7e-86be-c8bdf11a2ca1" alt=""><figcaption><p>Topic Auto-generato</p></figcaption></figure>

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

I Topic auto-generati avranno sempre lo stesso aspetto e saranno costituiti dagli stessi elementi dei Topic Configurati (che puoi approfondire [qui](https://docs.igenius.ai/italiano/fondamenti/topics-di-crystal)).&#x20;

La differenza principale riguarda il *metodo di generazione*: mentre i Topic Configurati possono essere considerati *"reali"*, in quanto possono essere creati e gestiti dall'Admin, quelli auto-generati possono essere considerati *"virtuali",* in quanto esistono ma non possono essere creati o gestiti manualmente.&#x20;

Inoltre, ci sono alcune differenze nelle *funzionalità* che supportano attualmente, come spiegato nel paragrafo seguente.
{% endhint %}

#### Regole&#x20;

* Affinché Crystal generi automaticamente un Topic a partire dalla tua domanda, le Entità contenute nella domanda devono essere **presenti in almeno un Topic Configurato**
* Le Entità che Crystal può utilizzare per la generazione dei Topic possono essere di qualsiasi tipo, **comprese le Entità Personalizzate**
* La generazione automatica **non tiene conto dei permessi di visualizzazione sui Topic**: pertanto, Crystal sarà in grado di generare Topic anche da Topic Configurati per i quali non hai i permessi
* Se fai richieste con più di una Entità, queste possono appartenere indistintamente alla **stessa Tabella** o a **Tabelle diverse** (in questo caso, Crystal le unirà automaticamente per te)
* Quando vengono rilevate **Entità con lo stesso nome**, il rischio di fraintendimento è maggiore: in questo caso, Crystal entra in [**Disambiguazione**](https://docs.igenius.ai/italiano/crystal-advisor/parla-con-i-tuoi-dati/conversazione/disambiguazione) chiedendoti di scegliere la tabella di origine corretta per l'Entità
* Quando richiedi un **Obiettivo "Composizione"**, Crystal applica le seguenti logiche per generare Topic:&#x20;
  * quando confronta *due Entità con unità di misura diverse*, come Visualizzazione predefinita viene fornito un *Focus sul Numero*, contenente tutte le misure richieste&#x20;
  * quando confronta *due Entità con unità di misura diverse con un Breakdown*, come Visualizzazione predefinita viene fornito uno *Scatterplot*
  * in tutti gli altri casi, la Visualizzazione predefinita sarà un *Grafico a Barre*
* Se un'**aggregazione** è riconosciuta in un Topic, questa viene utilizzata anche nel Topic Auto-generato; altrimenti viene decisa un'aggregazione in base alle specifiche del Topic Configurato. In particolare:&#x20;
  * se l'Entità è stata configurata specificando un'aggregazione, viene presa *la prima aggregazione* utilizzata su questa Entità&#x20;
  * se l'Entità non è numerica ed è stata configurata solo come entità Filtro o Categorica, viene utilizzato di default il *conteggio distinto*&#x20;
  * se l'Entità è numerica e non ha un'aggregazione esplicita, viene utilizzata di default *la somma*
* L'**Intervallo di Tempo** predefinito applicato ai Topic auto-generati sarà gestito in modi diversi, a seconda che Crystal sia in grado o meno di eseguire un'**inferenza sull'Entità Temporale**:
  * normalmente, Crystal dovrebbe dedurre l'Entità Temporale *da almeno un Topic configurato*: in questo caso, l'intervallo di tempo predefinito applicato al Topic auto-generato è lo stesso dedotto dai Topic configurati&#x20;
    * nel caso in cui Crystal trovi ambiguità tra più Topic configurati, l'Intervallo di tempo predefinito applicato è *quello configurato nelle Impostazioni di sistema*&#x20;
  * nel caso in cui Crystal non sia in grado di dedurre l'Entità Temporale, l'Entità Temporale sarà assente nel Topic e quindi *saranno estratti e mostrati nel Topic tutti i record dall'inizio alla data odierna*; inoltre, *non potrai filtrare questo Topic utilizzando i Filtri temporali* (ma solo quelli dinamici)&#x20;
* Nel caso in cui Crystal stia generando un **Topic "Overtime"**, se non sono stati configurati Topic con un'Entità Temporale per la specifica Entità richiesta, Crystal farà delle **ipotesi sull'Entità Temporale** da utilizzare; se questa operazione fallisce, verrà visualizzato uno specifico messaggio di errore
* Il **Filtro Temporale predefinito** sarà gestito in questo modo:&#x20;
  * sarà applicato se, e solo se, *almeno un Topic Configurato con la stessa Entità* richiesta è stato configurato con il filtro temporale predefinito&#x20;
  * nel caso di più Topic Configurati con la stessa Entità richiesta, verrà selezionato il filtro temporale *del primo configurato*&#x20;
  * in assenza di Topic Configurati, il filtro temporale predefinito sarà assente e verranno *estratti tutti i record da inizio data*
* L'**aggregazione temporale per i Topic con Obiettivo Overtime** può essere richiesta solo se almeno un altro Topic Overtime è stato precedentemente configurato per la stessa Entità: in tal caso, è possibile richiedere l'aggregazione temporale necessaria; se non viene specificata, tuttavia, l'aggregazione temporale sarà *mensile* di default
* I Topic Auto-generati **ereditano dai Topic Configurati i permessi solo per le Entità e i Valori dei Filtri:** in generale, i Topic Auto-generati non hanno permessi da assegnare loro di per sé, poiché sono Topic "virtuali", che non sono gestiti manualmente dall'Admin come i Topic Configurati
* Tra le altre **funzionalità di Crystal**, le seguenti sono **disponibili anche per i Topic Auto-generati**&#x20;
  * tutte le azioni presenti sulla Topic Card ([Filtra](https://docs.igenius.ai/italiano/crystal-advisor/esplora-i-tuoi-dati/filtri), Imposta un Avviso per [Rilevamento di Anomalia ](https://docs.igenius.ai/italiano/crystal-advisor/analizza-i-tuoi-dati/avvisi/rilevamento-di-anomalia)o [Pianificazione di Topic](https://docs.igenius.ai/italiano/crystal-advisor/analizza-i-tuoi-dati/avvisi/pianificazione-di-topic), Salva nelle [Data Story](https://docs.igenius.ai/italiano/crystal-advisor/racconta-e-discuti-i-tuoi-dati/data-storytelling), [Condividi](https://docs.igenius.ai/italiano/crystal-advisor/racconta-e-discuti-i-tuoi-dati/condividi-un-topic), [Scarica](https://docs.igenius.ai/italiano/crystal-advisor/racconta-e-discuti-i-tuoi-dati/esporta-un-topic), [Chiedi di nuovo](https://docs.igenius.ai/italiano/crystal-advisor/esplora-i-tuoi-dati/chiedi-i-topic), [Forecast](https://docs.igenius.ai/italiano/crystal-advisor/analizza-i-tuoi-dati/previsioni), Espandi)&#x20;
  * [Memoria del Contesto ](https://docs.igenius.ai/italiano/crystal-advisor/parla-con-i-tuoi-dati/conversazione/richiedi-i-topic/memoria-del-contesto)
  * [Insight Automatici](https://docs.igenius.ai/italiano/crystal-advisor/analizza-i-tuoi-dati/insight-automatici)

#### Limitazioni

* Se le Entità richieste **non sono presenti in almeno un Topic Configurato**, Crystal non può generare nuovi Topic
* Quando richiedi **Entità provenienti da Tabelle diverse**, puoi coinvolgere fino a un **massimo di 40 Tabelle** dalla Data Source scelta, poiché questo è il limite attuale per la configurazione delle Tabelle in Crystal
* Se le Entità richieste sono **distribuite su più Data Sources**, non possono essere utilizzate per generare un nuovo Topic
* Quando le Entità utilizzate per la generazione dei Topic sono **Entità Personalizzate**, tieni presente le seguenti limitazioni:&#x20;
  * se un'Entità Personalizzata è definita da Colonne della Tabella A, puoi richiedere Topic Virtuali con Entità diverse da A *solo se esistono Topic configurati che hanno le joins necessarie*&#x20;
  * se l'Entità Personalizzata è definita da Colonne di entrambe le tabelle A e B, puoi richiedere Topic Virtuali con Entità sia di A che di B
* Topic di tipo **Descrizione** o **Confronto - colonna singola pos. neg.** non si possono generare automaticamente
* Quando chiedi un Topic di tipo **Lista**, la visualizzazione della **Tabella** generata automaticamente conterrà tante Colonne quante sono le Entità specificate nella domanda: ciò significa che, se specifichi una sola Entità, la Tabella avrà una sola Colonna e, se servono più Colonne, devi specificare tutte le Entità
  * ad esempio: *"Mostrami un elenco di ID Clienti"* e *"Mostrami un elenco di ID Clienti e relativi nomi ed età"*
* Quando chiedi un Topic di tipo **Classifica**, devi specificare l'Entità per la quale desideri ordinare&#x20;
  * ad esempio: *"Mostrami la classifica degli agenti di vendita in base ai contratti chiusi"*
* I Topic Auto-generati **non saranno coinvolti in altre funzionalità di Crystal** relative ai Topic, che c*ontinueranno a essere disponibili solo per i Topic Configurati*:&#x20;
  * [Topic Overview ](https://docs.igenius.ai/italiano/crystal-advisor/esplora-i-tuoi-dati/dashboard)
  * [Suggerimenti](https://docs.igenius.ai/italiano/crystal-advisor/esplora-i-tuoi-dati/suggerimenti)
  * [Autocomplete](https://docs.igenius.ai/italiano/crystal-advisor/parla-con-i-tuoi-dati/conversazione/richiedi-i-topic/autocomplete)
  * [Analisi dell'Insight](https://docs.igenius.ai/italiano/crystal-advisor/analizza-i-tuoi-dati/analisi-dellinsight)
  * [Impostazione degli Avvisi tramite conversazione](https://docs.igenius.ai/italiano/crystal-advisor/analizza-i-tuoi-dati/avvisi), sia per il Rilevamento delle Anomalie che per il Monitoraggio delle Soglie (puoi invece impostare un Rilevamento di Anomalia tramite Topic Card)

### Nuove Regole di Conversazione

Grazie alla possibilità di ragionare con le Entità, Crystal è anche in grado di **dedurre l'Obiettivo del Topic** anche se non è esplicitata nella domanda.

{% hint style="success" %} <mark style="color:green;">**Esempi**</mark>

* Puoi chiedere semplicemente "*Vendite per Paese"* e Crystal restituirà direttamente una Visualizzazione **Breakdown**, deducendo l'Obiettivo **Composizione**
* Puoi chiedere semplicemente *"Totale delle Vendite"* e Crystal restituirà direttamente una Visualizzazione **Focus sul Numero**, deducendo l'Obiettivo **Highlight**
  {% endhint %}

<figure><img src="https://242936509-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnKpOPNK55hq8nWnuDD%2Fuploads%2F3Utuxj3B081Eoc1rQer6%2Fimage.png?alt=media&#x26;token=3498498e-abc5-48db-b913-48f968f80fef" alt=""><figcaption><p>Inferenza di Obiettivo</p></figcaption></figure>

#### Regole e Limitazioni

* Al momento, questa funzionalità è disponibile solo per due Obiettivi: **Composizione** e **Highlight**&#x20;
* *Per tutti gli altri casi*, è **ancora necessario specificare l'Obiettivo desiderato** per ottenere la Visualizzazione corrispondente.
* *Quando l'Obiettivo non è specificato*, Crystal presume che si stia chiedendo una Composizione: pertanto, verrà restituito un **Breakdown di default** (se i dati sottostanti lo permettono)

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

***
