> ## Documentation Index
> Fetch the complete documentation index at: https://docs.befailproof.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Query

> Esplora i dati di sessione, eventi e valutazioni con SQL riutilizzabile.

Le query sono il livello flessibile sottostante ai dashboard, agli audit e alle indagini. Usa SQL ad hoc per testare un'idea, quindi salva la query quando diventa parte di un workflow ricorrente.

## Creare ed eseguire una query

<Tabs>
  <Tab title="Dashboard">
    1. Vai su **Analyze → Queries** e seleziona **new query**.
    2. Apri il browser dello schema e scegli i campi dai dati di eventi, sessioni o valutazioni.
    3. Scrivi SQL, aggiungi parametri se necessario ed esegui la query.
    4. Salvala con un nome e una descrizione chiari, quindi usa **add to dashboard** quando il risultato deve essere monitorato.

    L'editor di query combina lo schema degli eventi, SQL, parametri e un'anteprima dei risultati in modo da poter convalidare la domanda prima di salvarla.

    <img src="https://mintcdn.com/exosphere/WgPwQzedeDNwJBTy/images/dashboard/query-lab.png?fit=max&auto=format&n=WgPwQzedeDNwJBTy&q=85&s=78f7043cd9c3f851aa821a1128801728" alt="L'editor di query SQL con un browser dello schema e una griglia di risultati in tempo reale." width="3200" height="2000" data-path="images/dashboard/query-lab.png" />

    Le query salvate appaiono quindi nella libreria condivisa, dove i tuoi colleghi possono rieseguirle o aggiungere i loro risultati ai dashboard.

    <img src="https://mintcdn.com/exosphere/WgPwQzedeDNwJBTy/images/dashboard/queries.png?fit=max&auto=format&n=WgPwQzedeDNwJBTy&q=85&s=425798528473f808cdbebb4910ec57a3" alt="La libreria Queries salvate contenente query riutilizzabili integrate e personalizzate." width="3200" height="2000" data-path="images/dashboard/queries.png" />

    Usa un nome e una descrizione chiari in modo che il risultato rimanga comprensibile senza riaprire il suo SQL.
  </Tab>

  <Tab title="CLI">
    ```bash theme={null}
    fp query schema
    fp query create "retry loops" --sql "SELECT ..."
    fp query run <query-id>
    fp query show <query-id>
    fp query update <query-id> --sql "SELECT ..."
    ```

    Usa `fp query list` per trovare gli ID e `fp query delete <query-id>` per rimuovere una query salvata.
  </Tab>
</Tabs>

## Usi comuni

* Trova sessioni con chiamate ripetute allo stesso strumento.
* Confronta i punteggi di valutazione tra modelli o ambienti.
* Misura il tempo tra un'attesa umana e la ripresa.
* Identifica negazioni di policy seguite da un'alternativa riuscita.
* Costruisci una coorte per un audit.

Apri **Queries → Schema** prima di scrivere query su campi non familiari. Preferisci filtri di tempo e ambiente espliciti e mantieni limiti di risultati durante l'esplorazione.

<Warning>
  Una query può identificare un modello sospetto, ma non stabilisce da sola la modalità di errore. Apri tracce rappresentative o esegui un audit prima di trasformare il risultato in una policy.
</Warning>