# Topics di Crystal

<figure><img src="/files/UJpHko1jaCQhbrSup87Q" alt=""><figcaption><p>Topic di Crystal</p></figcaption></figure>

Per poter iniziare a esplorare i tuoi dati al meglio, è importante familiarizzare con il concetto di Topic.

**Un Topic è l'unità di informazione fondante per interagire con Crystal.**

Infatti, fare una **domanda** a Crystal vuol dire chiedere un Topic; così come ricevere una **risposta** significa ricevere un Topic.

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

Per poter chiedere e comprendere un Topic devi prima sapere in che cosa consiste.
{% endhint %}

Iniziamo!

## Che Cos'è un Topic?

**Da un punto di vista analitico, un Topic è un'aggregazione di dati che costituisce uno specifico&#x20;*****Key Performance Indicator*****&#x20;(KPI ) o&#x20;*****Insight:*****&#x20;come tale, rappresenta una specifica analisi dati.**

Un Topic può avere i seguenti componenti:

<table><thead><tr><th width="74">N.</th><th>Tipo di Dato</th><th>Obbligatorio / Opzionale</th></tr></thead><tbody><tr><td><strong>1</strong></td><td><strong>Obiettivo / Visualizzazione</strong></td><td>Obbligatorio</td></tr><tr><td><strong>2</strong></td><td><strong>Topic Chart</strong></td><td>Obbligatorio</td></tr><tr><td><strong>3</strong></td><td><strong>Entità Principale / Entità Principali</strong></td><td>Obbligatorio</td></tr><tr><td><strong>4</strong></td><td><strong>Filtro Temporale</strong></td><td>Obbligatorio</td></tr><tr><td><strong>5</strong></td><td><strong>Filtro Dinamico</strong></td><td>Opzionale</td></tr><tr><td><strong>6</strong></td><td><strong>Key Value</strong> </td><td>Opzionale</td></tr></tbody></table>

Guardiamoli nel dettaglio!

### **Obiettivo / Visualizzazione**

**Con Obiettivo si intende l'obiettivo dell'analisi dati espressa dal Topic.**

Risponde alla domanda: "*Quali informazioni sto cercando con questo specifico Topic?*".

Ogni Obiettivo si articola poi a sua volta in **Visualizzazione, ovvero come visualizzi l'Obiettivo.** Ogni Obiettivo può avere una o più Visualizzazioni.

Vediamoli nel dettaglio.

<details>

<summary>Confronto</summary>

**Scopo** Evidenziare le somiglianze o le differenze tra elementi o eventi diversi.

**Esempio** *"Puoi farmi un confronto tra Vendite e Budget?"*

**Visualizzazioni**

* ***Grafici a Barre (Default)***
  * Colonna Singola
  * Colonna Singola Pos. Neg.
  * Colonne Raggruppate - Entità Singola
  * Colonne Raggruppate - Entità Multiple
* ***Scatterplot (Default)***
  * A due dimensioni
  * A tre dimensioni
* ***Grafici a Linea (Opzionale)***
  * Linea Singola
  * Multi Linea - Entità Singola
  * Multi Linea - Entità Multiple

<mark style="color:blue;">**Nota Bene**</mark>&#x20;

Anche se i Grafici a Barre e le Scatterplot sono le visualizzazioni predefinite per i Topic di tipo Confronto, dalla [Release 2.58](/italiano/note-di-rilascio/2024/crystal-web/crystal-web-v2.58.md) puoi [cambiare il grafico](/italiano/crystal-advisor/esplora-i-tuoi-dati/cambia-il-grafico.md) dalla Topic Card e scegliere di visualizzare un Confronto anche come Grafico a Linee (solo nel caso dei Grafici a Barre, non per le Scatterplot)!

Puoi scegliere di visualizzare i dati all'interno del Topic anche come Tabella.

</details>

<details>

<summary>Composizione</summary>

**Scopo** Suddividere il totale nelle sue componenti individuali e evidenziarne la composizione.

**Esempio** "*Mostrami la composizione delle vendite complessive di scarpe per numero di articolo."* Nota: questo Obiettivo funziona solo per valori positivi.&#x20;

**Visualizzazioni**

* Breakdown (Donut Chart)

<mark style="color:blue;">**Nota Bene**</mark>&#x20;

Dalla [Release 2.58](/italiano/note-di-rilascio/2024/crystal-web/crystal-web-v2.58.md) puoi [cambiare il grafico](/italiano/crystal-advisor/esplora-i-tuoi-dati/cambia-il-grafico.md) dalla Topic Card e scegliere di visualizzare i dati all'interno del Topic anche come Tabella.

</details>

<details>

<summary>Overtime</summary>

**Scopo** Evidenziare l'evoluzione del dato in un periodo di tempo specifico.

**Esempio** *"Puoi mostrarmi le vendite nell'ultimo mese?"*

**Visualizzazioni**

* ***Grafici a Linea (Default)***
  * Linea Singola
  * Multi Linea - Entità Singola
  * Multi Linea - Entità Multiple
* ***Grafici a Barre (Opzionale)***
  * Colonna Singola
  * Colonna Singola Pos. Neg.
  * Colonne Raggruppate - Entità Singola
  * Colonne Raggruppate - Entità Multiple

<mark style="color:blue;">**Nota Bene**</mark>

Anche se i Grafici a Linea sono le visualizzazioni predefinite per i Topic di tipo Overtime, dalla [Release 2.58](/italiano/note-di-rilascio/2024/crystal-web/crystal-web-v2.58.md) puoi [cambiare il grafico](/italiano/crystal-advisor/esplora-i-tuoi-dati/cambia-il-grafico.md) dalla Topic Card  e scegliere di visualizzare un Overtime anche come Grafico a Barre!

Puoi scegliere di visualizzare i dati all'interno del Topic anche come Tabella.

</details>

<details>

<summary>Progresso</summary>

**Scopo** Evidenziare lo status di un elemento o evento in relazione a un obiettivo o una scala.

**Esempio** *"Quanto mi manca per raggiungere il mio obiettivo di vendita del 2020?"*

**Visualizzazioni**

* ***Gauge***
  * Progress
  * Donut

<mark style="color:blue;">**Nota Bene**</mark>&#x20;

Dalla [Release 2.58](/italiano/note-di-rilascio/2024/crystal-web/crystal-web-v2.58.md) puoi [cambiare il grafico](/italiano/crystal-advisor/esplora-i-tuoi-dati/cambia-il-grafico.md) dalla Topic Card e scegliere di visualizzare i dati all'interno del Topic anche come Tabella.

</details>

<details>

<summary>Descrizione</summary>

**Scopo** Descrivere in modo dettagliato un elemento o una entità.

**Esempio** *"Mostrami i dettagli di prodotto del modello sneaker X3."*

**Visualizzazioni**

* Tabella Light

</details>

<details>

<summary>Highlight</summary>

**Scopo** Evidenziare un singolo valore che specifica lo stato o il livello di un elemento o evento.

**Esempio** *"Dammi il totale di sneaker X3 vendute."*

**Visualizzazioni**

* Focus sul Numero
* Testo

<mark style="color:blue;">**Nota Bene**</mark>&#x20;

Dalla [Release 2.58](/italiano/note-di-rilascio/2024/crystal-web/crystal-web-v2.58.md) puoi [cambiare il grafico](/italiano/crystal-advisor/esplora-i-tuoi-dati/cambia-il-grafico.md) dalla Topic Card e scegliere di visualizzare i dati all'interno del Topic anche come Tabella.

</details>

<details>

<summary>Lista</summary>

**Scopo** Evidenziare una lista di elementi che di default non seguono un ordine specifico ma che possono essere organizzati in colonne in base alle esigenze.

**Esempio** *"Mostrami la lista delle sedi dei fornitori."*

**Visualizzazioni**

* Tabella

</details>

<details>

<summary>Classifica</summary>

**Scopo** Evidenziare la posizione di più elementi ordinati (può essere considerata come una Lista ordinata).

**Esempio** *"Mostrami la classifica dei prodotti più venduti il mese scorso."*

**Visualizzazioni**

* Tabella

</details>

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

Un Topic può essere introdotto da:

* un Obiettivo (ad esempio, Composizione)
* una Visualizzazione (ad esempio, Breakdown)
* una formulazione specifica (ad esempio, "Il totale di...")

Tutte queste formulazioni esprimo lo scopo del Topic.
{% endhint %}

<figure><img src="/files/kdScgzVgiGwr8MF9vQyQ" alt=""><figcaption><p>"Breakdown" è la Visualizzazione dell'Obiettivo "Composizione"</p></figcaption></figure>

Puoi approfondire ulteriormente Obiettivo e Visualizzazione [in questa pagina](https://igenius.gitbook.io/resources_it/crystal-console/topics/configure/obiettivi-e-visualizzazioni).

### Topic Chart

**Il Topic Chart è la rappresentazione grafica dei dati e si basa sullo specifico Obiettivo e la specifica Visualizzazione del Topic.**

Ogni Visualizzazione è associata a un grafico (Chart) specifico. Ad esempio:

* Le Visualizzazioni di Obiettivo Confronto possono essere grafico a barre e grafico a diffusione (*scatterplot*) di più tipologie
* Le Visualizzazioni di Obiettivo Progresso possono essere grafici Gauge di più tipologie
* Le Visualizzazioni Breakdown (Obiettivo Composizione) sono grafici ad anello

<figure><img src="/files/a8aQUrCGz3OaqyaZStxp" alt=""><figcaption><p>Un grafico ad anello che rappresenta la Visualizzazione Breakdown (Obiettivo Composizione)</p></figcaption></figure>

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

I Topic Chart sono sempre interattivi, per permetterti di approfondire l'analisi!

Ad esempio, puoi interagire con la *legenda* per filtrare i dati di tuo interesse o puoi evidenziare elementi specifici del grafico (Chart) per focalizzarti su informazioni dettagliate tramite un *tooltip*.
{% endhint %}

### Entità Principale / Entità Principali

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

**Le Entità sono il cuore del Topic.**

**Una Entità rappresenta una singola unità di dati utilizzati per l'analisi, che di solito rappresenta una dimensione o una metrica.**

Esempi di Entità sono: "Vendite", "Costo", "Target", "Paese per Linea di Prodotto", "Media delle vendite", etc.

Puoi [**personalizzare le Entità**](https://igenius.gitbook.io/resources_it/crystal-console/topics/configure/configurazione-del-topic-entita-personalizzata) attraverso l'uso di formule, facilitando l'aggregazione di dati attraverso calcoli specifici (ad esempio la somma o la mediana).
{% endhint %}

**L'Entità che assume il ruolo di metrica primaria del Topic è chiamata Entità Principale.**

I Topic possono avere una **sola Entità Principale** o **più Entità Principali** in base a Obiettivo e Visualizzazione. Ad esempio:

* Il Topic Composizione ha una sola Entità Principale (Singola Entità Principale)
* Un grafico Multi Line può avere più Entità Principali (Multi-Entità)

<figure><img src="/files/1kTy8tMGXbfsUjR9QoDq" alt=""><figcaption><p>Topic con una Singola Entità Principale personalizzata ("Paese per Linea di Prodotto")</p></figcaption></figure>

<figure><img src="/files/hqLTtxTbFe83hJCK05GL" alt=""><figcaption><p>Topic con Entità Principali multiple ("Costi di Manutenzione", "Entrate", "Ricavi")</p></figcaption></figure>

### Filtro Temporale

**Il Filtro Temporale rappresenta un determinato Intervallo Temporale che si applica a un Topic per definire il perimetro temporale dell'analisi.**

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

Tutti i Topic hanno *sempre* un Filtro Temporale applicato *di default* perché non sarebbe possibile fare un'analisi senza specificare un Intervallo Temporale.
{% endhint %}

<figure><img src="/files/3Vs478Gewl8QFrHUI6az" alt=""><figcaption><p>Filtro Temporale</p></figcaption></figure>

I Filtri Temporali possono essere:

* **Dinamici**, quando si aggiornano nel tempo in base alla data attuale
  * Per esempio:
    * *"oggi", "ieri", "domani"*
    * *"quest'anno"* (seleziona l'intervallo di tempo tra il 1° gennaio dell'anno corrente e oggi)
    * *"l'anno scorso"* (seleziona l'intervallo di tempo tra il 1° gennaio e il 31 dicembre dell'anno scorso)
    * *"la scorsa settimana"* (seleziona l'intervallo di tempo che inizia da ieri fino agli ultimi 7 giorni)
    * ecc.
* **Personalizzati**, quando identificano un intervallo di tempo specifico con date di inizio e fine definite
  * Per esempio: *"dal 01/03/2023 al 29/12/2024"*

### Filtro Dinamico

**Il Filtro Dinamico è una Entità che puoi usare per restringere il perimetro della tua analisi, filtrando l'Entità in base a un valore specifico.**&#x20;

**Quando una Entità assume il ruolo di filtro, come accade per i Filtri Dinamici, prende il nome di Entità Filtro. Quindi, i Filtri Dinamici possono essere chiamati anche Entità Filtro.**

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

In Crystal puoi avere due tipi diversi di Entità:

* Entità Principale (il soggetto di un Topic)
* Entità Filtro (i Filtri Dinamici che applichi a un Topic)
  {% endhint %}

I Filtri Dinamici possono essere:

* **Numerici**, sia positivi sia negativi
  * Ad esempio, valute, codici, taglie, etc.
* **Non numerici**
  * Ad esempio, Paesi, città, zone, nome dei clienti, etc.

Ogni Entità Filtro è definita da un **Valore** (anche chiamato Entity Value): l'unità di dati elementare che definisce la metrica specifica rappresentata dal filtro. Se una Entità rappresenta una metrica, il valore della Entità (Entity Value) è l'**istanza concreta o la misura** all'interno di quella metrica.

Ad esempio:

* se l'Entità Filtro è "Ricavi", i valori corrispondenti possono includere somme specifiche come "€10.000", "€15.000", etc.
* se l'Entità Filtro è "Paese", i valore corrispondenti possono includere "Argentina", "Italia", "Stati Uniti", etc.

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

La presenza dei Filtri Dinamici è *opzionale*.
{% endhint %}

<figure><img src="/files/FK5ColKFEb4kjXEZLsRQ" alt=""><figcaption><p>Filtro Dinamico</p></figcaption></figure>

### Key Value

**I Key Value sono valori numerici che riassumono i dati più rilevanti di un Topic.**

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

La presenza dei Key Value è *opzionale*.
{% endhint %}

<figure><img src="/files/k2nlC5Pqhh3h6dshwd9e" alt=""><figcaption><p>Key Value</p></figcaption></figure>

## Esplora la Topic Card

Ora che sai che cos'è un Topic, è importante ricordare che ogni Topic è sempre presentato all'interno della **Topic Card**, ovvero il *pannello di controllo* che graficamente racchiude tutte le componenti del Topic.

Ogni Topic Card si compone dei seguenti elementi:

1. **Titolo del Topic** Il titolo vero e proprio del Topic e riassume Obiettivo e Entità Principale
2. **Topic** Il Topic stesso, con tutte le sue componenti (Filtri, grafico (Chart), Key Value)
3. **Azioni del Topic** Tutte le azioni che puoi fare all'interno della Topic Card

<figure><img src="/files/j96uD6f9ZcVp9HBBBbtY" alt=""><figcaption><p>Topic Card</p></figcaption></figure>

### **Azioni della Topic Card**

Qui trovi l'elenco di tutte di tutte le azioni che puoi fare nella Topic Card, ordinate in base al punto di accesso.

{% hint style="info" %}
Per ulteriori informazioni su ciascuna funzionalità, puoi consultare la sezione dedicata nelle Risorse.
{% endhint %}

**Parte inferiore della Topic Card**

Nella parte inferiore della Topic Card trovi una sezione dedicata che ti consente di avere a disposizione alcune delle funzioni più utili in un click.

<details>

<summary>Filtra</summary>

Il primo bottone che trovi nella parte inferiore della Topic Card ti permette di [**filtrare il Topic**](https://igenius.gitbook.io/resources_it/crystal-advisor/esplora-i-tuoi-dati/filtri).

Non dimenticare che puoi filtrare i Topic anche in [Conversazione](https://igenius.gitbook.io/resources_it/crystal-advisor/parla-con-i-tuoi-dati/conversazione)!

</details>

<details>

<summary>Avvisa</summary>

Il secondo bottone che trovi nella parte inferiore della Topic Card ti permette di impostare un avviso per il Topic che stai vedendo, scegliendo tra le seguenti opzioni:

* Rileva un'anomalia
* Pianifica un Topic

Non dimenticare che puoi impostare il rilevamento di un'anomalie anche in [Conversazione](https://igenius.gitbook.io/resources_it/crystal-advisor/parla-con-i-tuoi-dati/conversazione)!&#x20;

</details>

<details>

<summary>Salva</summary>

Il terzo bottone che trovi nella parte inferiore della Topic Card ti permette di [**aggiungere il Topic**](https://igenius.gitbook.io/resources_it/crystal-advisor/racconta-e-discuti-i-tuoi-dati/data-storytelling) a una o più Data Story, scegliendo tra quelle disponibili.

</details>

<details>

<summary>Condividi</summary>

Il quarto bottone che trovi nella parte inferiore della Topic Card ti permette di [**condividere qualsiasi Topic**](https://igenius.gitbook.io/resources_it/crystal-advisor/racconta-e-discuti-i-tuoi-dati/condividi-un-topic) con i tuoi colleghi, dando loro la possibilità di esplorare i dati più rilevanti della tua azienda.

</details>

<figure><img src="/files/PIolUSqGFdqyBmDFA7Dq" alt=""><figcaption><p>Azioni nella parte inferiore della Topic Card</p></figcaption></figure>

**Menu in alto a destra della Topic Card**

In alto a destra, all'interno della Topic Card, trovi un menu dedicato - con tre punti - che ti consente di avere a disposizione alcune delle funzioni più utili in un click.

<details>

<summary>Esporta</summary>

I due bottoni *Download Excel* e *Download PDF* consentono di [**esportare**](https://igenius.gitbook.io/resources_it/crystal-advisor/racconta-e-discuti-i-tuoi-dati/esporta-un-topic) il Topic in **formato Excel o PDF**.

</details>

<details>

<summary>Chiedi</summary>

Questo bottone consente di [**chiedere di nuovo un Topic specifico**](https://igenius.gitbook.io/resources_it/crystal-advisor/esplora-i-tuoi-dati/chiedi-i-topic) senza doverlo digitare due volte.

</details>

<details>

<summary>Fai previsioni (Beta)</summary>

Solo per i Topic Overtime, puoi chiedere una [previsione](https://igenius.gitbook.io/resources_it/crystal-advisor/analizza-i-tuoi-dati/previsioni) del trend per vedere come evolverà in futuro.&#x20;

Non dimenticare che puoi impostare una previsione anche in [Conversazione](https://igenius.gitbook.io/resources_it/crystal-advisor/analizza-i-tuoi-dati/previsioni)!

Questa funzionalità è attualmente in *versione Beta*.

</details>

<figure><img src="/files/FX9FnqnqzaYOXp4M2hQI" alt=""><figcaption><p>Azioni nel menù in alto a destra della Topic Card</p></figcaption></figure>

#### Cambia il Grafico

Dalla [Release 2.58](/italiano/note-di-rilascio/2024/crystal-web/crystal-web-v2.58.md), in alto a destra della Topic Card, accanto al Menu, è presente un nuovo pulsante che consente di [cambiare il Grafico](#cambia-il-grafico) con un solo click.

<figure><img src="/files/xy1kuWY15QhhxJcBHGzj" alt=""><figcaption><p>Azione di cambio grafico</p></figcaption></figure>

### Modalità Espansa

Ogni Topic Card può essere visualizzata anche in modalità espansa: cliccando sul bottone *"Espandi"* accanto al menù in alto a destra potrai visualizzare una *versione più grande* della Topic Card, che ti consente di vedere ed esplorare il Topic Chart con maggiore facilità.&#x20;

La Topic Card espansa contiene comunque tutte le *azioni* e gli [*Insight*](/italiano/crystal-advisor/analizza-i-tuoi-dati/insight-automatici.md) disponibili nella versione normale.

<figure><img src="/files/iALYBJDVZIVigGCrZwIH" alt=""><figcaption><p>Icona Espandi</p></figcaption></figure>

<figure><img src="/files/lCU8hFayX0EwtrJZunZN" alt=""><figcaption><p>Topic Card in modalità espansa</p></figcaption></figure>

## Tipi di Topic

Tutti i Topic che si trovano su Crystal hanno sempre lo stesso aspetto, sono costituiti dagli stessi elementi e supportano le stesse azioni dalle Topic Card.

Tuttavia, la recente introduzione della funzionalità di [**Conversazione Basata su Entità**](/italiano/crystal-advisor/parla-con-i-tuoi-dati/conversazione/richiedi-i-topic/conversazione-basata-su-entita.md) ha definito **due diversi tipi di Topic** da tenere in considerazione:

* **Topic Configurati**
* **Topic Auto-generati**

Vediamo brevemente le due tipologie!

### Topic Configurati

I Topic Configurati sono quelli che risultano dal classico [**processo di Configurazione dei Topic**](/italiano/crystal-console/topics.md), chiamato anche **Creazione di Topic**, che è stato il modo principale per generare Topic finora.

La configurazione/creazione di Topic può essere effettuata solo dagli [**Utenti Admin**](/italiano/fondamenti/crystal.md) nella [**Crystal Console**](/italiano/crystal-console/inizia-la-tua-esperienza-con-crystal.md) e consiste sostanzialmente nel *creare manualmente il Topic da zero* scegliendo tutti gli elementi che lo devono costituire (Obiettivo, Entità, Filtri, ecc.).&#x20;

Questo tipo di Topic sarà disponibile per gli Utenti Member che potranno richiederlo in Advisor solo dopo la conclusione del processo di creazione ([fase di pubblicazione](/italiano/crystal-console/topics/pubblicazione.md)) e *solo se l'Admin ha concesso i permessi di visualizzazione per tali Topic.*&#x20;

Per richiedere questo tipo di Topic, è sufficiente conoscere alcune [**regole di conversazione**](/italiano/crystal-advisor/parla-con-i-tuoi-dati/conversazione/richiedi-i-topic.md) semplici e chiare.

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

Quando si interagisce con i Topic Configurati in Crystal Advisor, alcuni degli elementi scelti dall'Admin rimangono impostati e non modificabili, mentre altri possono essere modificati.

**Elementi non modificabili:**&#x20;

* Obiettivo e Visualizzazione&#x20;
* Topic Chart
* Entità Principali&#x20;
* Key Values

**Elementi modificabili:**&#x20;

* Filtro Temporale&#x20;
* Filtri Dinamici&#x20;

In particolare, puoi sempre modificare i Filtri nell'Advisor in diversi modi: in [Conversazione](/italiano/crystal-advisor/parla-con-i-tuoi-dati/conversazione/richiedi-i-topic.md), tramite la funzionalità [Filtra i Topic](/italiano/crystal-advisor/esplora-i-tuoi-dati/filtri.md) o nella Sezione [Topic Overview](/italiano/crystal-advisor/esplora-i-tuoi-dati/dashboard.md).
{% endhint %}

### Topic Auto-generati

Come suggerisce il nome, i Topic Auto-generati sono Topic **generati automaticamente da Crystal**, senza che l'Utente Admin debba crearli da zero.&#x20;

Questa nuova funzionalità rappresenta un **nuovo metodo per la generazione di Topic** che consente di **fare domande che vanno oltre i limiti dei Topic Configurati**, ovvero di chiedere qualsiasi Topic di cui si ha bisogno senza necessariamente passare dalla creazione di Topic.&#x20;

In generale, puoi chiedere Topic Auto-generati nello stesso modo in cui puoi chiedere i Topic Configurati.

Leggi l'articolo relativo alla [**"Conversazione Basata su Entità"**](/italiano/crystal-advisor/parla-con-i-tuoi-dati/conversazione/richiedi-i-topic/conversazione-basata-su-entita.md) per approfondire come Crystal genera i Topic e come chiederli.

Ora sei pronto a esplorare 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/fondamenti/topics-di-crystal.md?ask=<question>
```

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.