# Richiedi i Topic

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

Prima di iniziare a parlare con i dati, è necessario assicurarsi di aver familiarizzato con il **concetto di Topic e con tutto ciò che ad esso è correlat**o, poiché i Topic sono le unità di informazione fondamentali che consentono interazioni significative con Crystal.&#x20;

In particolare, è necessario avere familiarità con i seguenti concetti:&#x20;

* Obiettivi, Visualizzazioni, Entità, Filtri Temporali, Filtri Dinamici
* Topic Configurati, Topic Auto-generati

Se ne hai bisogno, puoi approfondire [**qui**](https://docs.igenius.ai/italiano/fondamenti/topics-di-crystal) prima di procedere!
{% endhint %}

## Fondamenti della Conversazione

**Porre una domanda a Crystal significa chiedere un Topic.**&#x20;

Pertanto, per formulare una domanda, devi semplicemente chiedere gli elementi di cui è composto il Topic a cui stai pensando, uno dopo l'altro, ed è fatta!&#x20;

In particolare, in ogni tua domanda:&#x20;

* devi includere l'**Obiettivo (o Visualizzazione)** e l'**Entità (o più Entità)** per quel Topic&#x20;
* puoi anche opzionalmente includere altri dettagli come l'**Intervallo Temporale** e i **Filtri Dinamici**&#x20;

Inoltre, è consigliabile fare domande dirette, chiare e concise.

<figure><img src="https://242936509-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnKpOPNK55hq8nWnuDD%2Fuploads%2FeQgiKKQDegHAwNjsv4vJ%2Fimage.png?alt=media&#x26;token=bc1bb33a-e8ac-4dd3-bf4d-3ccc9fdda17b" alt=""><figcaption><p>Esempio di Domanda </p></figcaption></figure>

Vediamo come fare una domanda passo dopo passo!

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

Le seguenti regole di conversazione considerano le logiche specifiche sia dei Topic Configurati che di quelli generati automaticamente.&#x20;

Basta tenerle a mente e sarà Crystal a fornirti il tipo di Topic migliore in base alla situazione!
{% endhint %}

### Introduci la Domanda (Opzionale)

Puoi cominciare con qualsiasi formula di domanda naturale, come una richiesta, un comando o anche un semplice saluto!

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

* *"Ciao Crystal!"*
* *"Posso vedere..."*&#x20;
* *"Mostrami..."*
  {% endhint %}

### Specifica il Topic (Obbligatorio)&#x20;

Successivamente, specifica il Topic per il quale desideri fare domande.&#x20;

Questo significa indicare l'**Obiettivo** e l'**Entità principale** (o le **Entità principali**) che costituiscono quel Topic.&#x20;

Per quanto riguarda l'Obiettivo, hai anche la possibilità di:

* indicare la Visualizzazione corrispondente
* esprimere lo scopo del Topic con una frase&#x20;

Per quanto riguarda le Entità, puoi specificare:

* una singola Entità principale
* più Entità principali

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

* *"Confronto tra Vendite e Lead"*
* *"Composizione di Utenti per Paese"*
* *"Chi sono stati i migliori venditori nell'ultimo mese?"*
  {% endhint %}

<details>

<summary>Approfondisci! </summary>

* Nel primo esempio, il Topic è costituito dai seguenti elementi:
  * *Confronto =* Obiettivo
  * *Vendite* e *Lead*  = Entità principali
* Nel secondo esempio, il Topic è costituito dai seguenti elementi:&#x20;
  * *Composizione =*  Obiettivo (o Visualizzazione)&#x20;
  * *Utenti per Paese =* Entità principale&#x20;
* Nel terzo esempio, il Topic è costituito dai seguenti elementi:&#x20;
  * *Chi sono stati i migliori  =* Obiettivo Classifica
  * *Venditori* = Entità principale

</details>

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

Con la nuova funzionalità [**Conversazione Basata su Entità**](https://docs.igenius.ai/italiano/crystal-advisor/parla-con-i-tuoi-dati/conversazione/richiedi-i-topic/conversazione-basata-su-entita), è necessario considerare anche le seguenti nuove caratteristiche:&#x20;

* in alcuni **casi specifici**, Crystal è in grado di **dedurre l'Obiettivo e la Visualizzazione** anche se non sono espliciti:&#x20;
  * se chiedi semplicemente *"Vendite per Paese",* Crystal restituirà direttamente una Visualizzazione *Breakdown* per l'Obiettivo *Composizione*
  * se chiedi semplicemente *"Totale delle Vendite"*, Crystal restituirà direttamente una Visualizzazione *numerica* per l'obiettivo *Highlight*&#x20;
* 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 consentono)
  {% endhint %}

### Filtra con un Intervallo Temporale (Opzionale)

Dopo aver specificato il Topic per il quale desideri fare una domanda, puoi aggiungere un intervallo temporale per catturare un momento specifico dei tuoi dati.

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

* *"...nei sei mesi scorsi"*
* *"...nell'ultimo anno"*
* *"...nel 2019"*
  {% endhint %}

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

* I filtri temporali possono essere dinamici (es. *“oggi”*, *“quest'anno”*, ecc.) o personalizzati (ad es. *“dal 01/03/2023 al 29/12/2024”*).
* Ogni Topic è sempre accompagnato da un intervallo temporale, poiché un'analisi senza limiti temporali non è praticabile. L'intervallo temporale è impostato di default dall'Admin durante il [processo di configurazione del Topic. ](https://docs.igenius.ai/italiano/crystal-console/topics)
* Se non specifichi un intervallo temporale nella tua richiesta, i dati saranno mostrati secondo l'intervallo temporale predefinito impostato dall'Admin. Tuttavia, se indichi un intervallo temporale diverso nella tua domanda, modificherai le impostazioni predefinite.
  {% endhint %}

### Filtra con un Filtro Dinamico

Infine, se desideri restringere ulteriormente il campo della tua analisi, anche in modo facoltativo, puoi aggiungere un [Filtro Dinamico,](https://docs.igenius.ai/italiano/fondamenti/topics-di-crystal) cioè un'Entità utilizzata come filtro anziché come Entità principale.

Per farlo, è necessario introdurre il Filtro con la preposizione corretta (ad esempio *"per", "in",* ...) e quindi aggiungere il filtro con una delle seguenti modalità:

* specificando il nome del Filtro e il relativo Valore, che rappresenta l'istanza specifica per quella Entità
* specificando direttamente solo il Valore del Filtro, sottintendendo il nome del Filtro stesso.

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

* *"… per il Paese Spagna"*&#x20;
* *"… per la Spagna"*
  {% endhint %}

<details>

<summary>Approfondisci!</summary>

* Nel primo esempio, è presente sia il Filtro che il Valore del Filtro:
  * *"… per il Paese"* = Filtro&#x20;
  * *"Spagna"* = Valore del Filtro&#x20;
* Nel secondo esempio, è presente solo il Valore del Filtro&#x20;
  * *"… per la Spagna"* = Valore del Filtro

</details>

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

* I Filtri Dinamici possono essere numerici (valute, codici articolo o dimensioni) o non numerici (Paesi, città, aree, nomi di articoli, nomi di clienti)
* Puoi scegliere i Filtri solo tra quelli che il tuo Admin ha configurato e reso disponibili per il Topic selezionato
  {% endhint %}

Infine, nel caso di Filtri Dinamici numerici, è possibile specificare una condizione sui Valori del Filtro, come "maggiore di", "minore di" e "tra".&#x20;

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

*"Elenco dei codici per numero di prodotti venduti..."*

* *"...maggiore di 200"*&#x20;
* *"...inferiore a 200"*
* *"...tra 200 e 300"*
  {% endhint %}

#### Come funziona?&#x20;

Quando richiedi di applicare un filtro in una conversazione, Crystal può:

* riconoscere il filtro per **corrispondenza esatta**
  * ad esempio, quando la domanda è: *"Mostrami le vendite totali per la Francia"* e il filtro è *"Francia"*

<details>

<summary>Corrispondenza Esatta</summary>

Il testo incluso nella domanda è identico a quello della fonte dati (a meno che una modifica non sia già inclusa nella fase di pre-elaborazione, come la presenza di segni di punteggiatura o caratteri speciali).&#x20;

Questo è il caso più semplice per Crystal da riconoscere.&#x20;

Se il filtro è *"Italia"* e scrivi *"Italia"* nella domanda, il sistema lo riconoscerà immediatamente.

</details>

* riconoscere il filtro per **corrispondenza parziale**
  * ad esempio, quando chiedi: *"Mostrami le vendite totali per l'Italia",* ma il filtro impostato è *"Nord Italia"*.

<details>

<summary>Corrispondenza Parziale</summary>

Il testo nella domanda non coincide esattamente con quello presente nella fonte dati, in quanto alcune parti mancano.&#x20;

Questo viene considerato una *"corrispondenza parziale"*: il sistema richiede l'assistenza del **modello di machine learning NER** **(Named-entity recognition)**.&#x20;

NER è un motore di ricerca in grado di analizzare tutte le parole in una frase e fornire una classifica dei termini più rilevanti, con le parole a punteggio più alto come possibili valori di filtro.&#x20;

Per fare un esempio, se digiti accidentalmente *"nrd Italia"* anziché *"Nord Italia"*, il motore di ricerca troverà possibili valori di filtro e li assegnerà a una classifica:&#x20;

* Nord Italia;&#x20;
* Italia;&#x20;
* Sud Italia;&#x20;
* Italia.&#x20;

Poiché *"Nord Italia"* ha il punteggio più alto, sarà il valore più vicino a quello digitato e quindi riconosciuto come il valore di filtro corretto da selezionare, senza la necessità di fare ulteriori domande.&#x20;

D'altra parte, se stai cercando le vendite totali per il mercato australiano e digiti: *"Vendite totali per Austr"*, con Australia e Austria presenti nei tuoi dati, il NER troverà due valori con punteggi equivalenti: Australia e Austria.&#x20;

Poiché Crystal non può essere certo di quale dei due valori tu abbia bisogno, approfondirà la tua richiesta con la funzionalità di [Disambiguazione](https://docs.igenius.ai/italiano/crystal-advisor/parla-con-i-tuoi-dati/conversazione/disambiguazione), chiedendoti di scegliere quale valore desideri.

</details>

### In Breve... <a href="#h_75bb64b7fc" id="h_75bb64b7fc"></a>

Puoi fare riferimento a questa tabella come guida rapida per fare le tue domande.

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

*"Puoi mostrarmi il confronto tra le vendite e i lead negli ultimi sei mesi per la Spagna e per l'Italia?"*
{% endhint %}

<table><thead><tr><th width="69">N.</th><th width="242">Step</th><th width="214">Obbligatorio / Opzionale</th><th>Esempio</th></tr></thead><tbody><tr><td><strong>1</strong></td><td><strong>Incipit della domanda</strong></td><td>Opzionale</td><td><em>Puoi mostrarmi</em></td></tr><tr><td><strong>2</strong></td><td><strong>Obiettivo / Visualizzazione</strong></td><td>Obbligatorio / Altamente Raccomandato <em><strong>(*)</strong></em></td><td><em>il confronto tra</em></td></tr><tr><td><strong>3</strong></td><td><strong>Singola Entità / Più Entità</strong></td><td>Obbligatorio</td><td><em>vendite e lead</em></td></tr><tr><td><strong>4</strong></td><td><strong>Intervallo Temporale</strong></td><td>Opzionale</td><td><em>negli scorsi sei mesi</em></td></tr><tr><td><strong>5</strong></td><td><strong>Filtro Dinamico #1</strong></td><td>Opzionale</td><td>per <em>Spagna</em></td></tr><tr><td><strong>6</strong></td><td><strong>Filtro Dinamico #2</strong></td><td>Opzionale</td><td><em>e per Italia?</em></td></tr></tbody></table>

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

Come mostrato nell'esempio, puoi richiedere più di un Filtro Dinamico contemporaneamente, concatenandoli nella stessa domanda.&#x20;

Semplicemente devi utilizzare la formula *"e per"* e specificare un ulteriori Filtro o altri Filtri.
{% endhint %}

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

Specificando l'Intervallo Temporale e i Filtri Dinamici, puoi gestire il Topic secondo le tue preferenze.

Altrimenti, se specifichi solo il Topic esplicitando l'Obiettivo e le Entità Principali (ad esempio, *"il confronto tra vendite e lead"*), vedrai l'Intervallo Temporale predefinito e i Filtri impostati dall'Admin.
{% endhint %}

{% hint style="danger" %} <mark style="color:red;">**Attenzione**</mark>

***(\*)*** Crystal è in grado di [dedurre gli Obiettivi e le Visualizzazioni ](https://docs.igenius.ai/italiano/crystal-advisor/parla-con-i-tuoi-dati/conversazione/richiedi-i-topic/conversazione-basata-su-entita)dove non espressi *solo in pochi casi* (per gli Obiettivi Composizione e Highlight).

Perciò, come regola generale, **è sempre meglio specificare l'Obiettivo**.&#x20;

In assenza di un Obiettivo chiaro che non può essere dedotto, Crystal **cercherà di restituire un Obiettivo Composizione**, cioè una Visualizzazione **Breakdown**.
{% endhint %}

### Esprimiti con Naturalezza <a href="#h_75bb64b7fc" id="h_75bb64b7fc"></a>

Con Crystal, hai totale libertà di espressione!

Questo è possibile perché Crystal può:&#x20;

* riconoscere parole e frasi anche se scritte male o incomplete

<details>

<summary>Approfondisci!</summary>

Ad esempio, non importa se scrivi:&#x20;

* Mese e Giorno come numeri: *"Totale delle vendite per il 2022 10" o "Totale delle vendite per il 2022 10 7"*
* Mese come parola: *"Totale delle vendite per ottobre 2022"*
* Abbreviazioni dei mesi: Gen, Feb, Mar, Apr, Mag, Giu, Lug, Ago, Set, Ott, Nov, Dic
* Numeri con virgola o punto: 1.000 o 1,000&#x20;

Crystal capirà.

</details>

* riconoscere parole che non appartengono alla lingua attuale ma sono comunemente usate come parte del gergo, come gli anglicismi.

<details>

<summary>Approfondisci!</summary>

Ciò può accadere, ad esempio, utilizzando aggregazioni temporali, poiché parole come *"quarter"* sono frequentemente utilizzate anche in altre lingue.&#x20;

Puoi tranquillamente utilizzare parole inglesi nelle tue richieste anche se stai interagendo in un'altra lingua.&#x20;

Crystal capirà.

</details>

* riconoscere sinonimi e differenze di significato.

<details>

<summary>Approfondisci!</summary>

Quando parli con Crystal, puoi utilizzare la terminologia più adatta al contesto di analisi.&#x20;

Con l'**aliasing**, puoi insegnare a Crystal il linguaggio della tua attività, assegnando sinonimi alle Entità dei tuoi Topic.&#x20;

Per saperne di più, consulta i seguenti articoli:&#x20;

* [Trainare il Topic ](https://docs.igenius.ai/italiano/crystal-console/topics/train)
* [Gestire le Entità](https://docs.igenius.ai/italiano/crystal-console/topics/entita)

</details>

## Funzionalità Avanzate

Quando chiedi un Topic, puoi ricorrere ad alcuni trucchi che possono risultare molto utili.&#x20;

Approfondisci le capacità conversazionali avanzate di Crystal!

***

### Vai alla Sezione

{% content-ref url="richiedi-i-topic/conversazione-basata-su-entita" %}
[conversazione-basata-su-entita](https://docs.igenius.ai/italiano/crystal-advisor/parla-con-i-tuoi-dati/conversazione/richiedi-i-topic/conversazione-basata-su-entita)
{% endcontent-ref %}

{% content-ref url="richiedi-i-topic/memoria-del-contesto" %}
[memoria-del-contesto](https://docs.igenius.ai/italiano/crystal-advisor/parla-con-i-tuoi-dati/conversazione/richiedi-i-topic/memoria-del-contesto)
{% endcontent-ref %}

{% content-ref url="richiedi-i-topic/autocomplete" %}
[autocomplete](https://docs.igenius.ai/italiano/crystal-advisor/parla-con-i-tuoi-dati/conversazione/richiedi-i-topic/autocomplete)
{% endcontent-ref %}

***

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

***