# Dati e report

Trasformare i record aziendali e i file di origine in risposte utili, con un percorso chiaro per tornare alle prove.

Source: https://docs.opser.com/it/capabilities/data/

## Lavorare con informazioni strutturate
Chiedi all'agente di trovare, confrontare, riassumere o aggiornare i dati nelle app a cui puoi accedere. Identifica l'app e i filtri utili come l'intervallo di date, il proprietario, il cliente o lo stato.

> Nelle vendite, riassumi gli ordini confermati dovuti il mese prossimo per cliente e valuta. Includi i link agli ordini e gli ordini di bandiera senza una data di consegna.

Per i dati al di fuori di un'app installata, la capacità dei dati della piattaforma può funzionare con entità e record strutturati. Quando hai bisogno di un'interfaccia utente riutilizzabile attorno a tali informazioni, considera un [app interna](https://docs.opser.com/it/capabilities/internal-apps/).

## Dati delle app e dataset gestiti dall’utente

Le app possiedono i loro tavoli e le regole di business. Utilizzare i loro strumenti supportati o le operazioni esposte per tali record. Lo strumento dati della piattaforma gestisce separatamente i set di dati aziendali di proprietà degli utenti: entità, campi, relazioni, record e le loro impostazioni di accesso.

L'agente può ispezionare un set di dati esistente, definire una struttura, importare record e interrogarlo per l'analisi. Il reporting supportato SQL è di sola lettura e rientra nei dati aziendali consentiti. Non è un'interfaccia di query senza restrizioni in tabelle di app o piattaforme private.

## Creare un report
Specificare il pubblico, l'intervallo di date, il raggruppamento e il formato di output. Chiedi i riferimenti alla fonte o i collegamenti di registrazione in modo da poter controllare il risultato. Mantieni le valute e le unità esplicite.

1. Confermare quali record sono inclusi ed esclusi.
2. Controllare le regole di raggruppamento e calcolo.
3. Ispezionare un campione dei record sottostanti.
4. Scegli un output utile: un riepilogo delle conversazioni, un foglio di calcolo, una presentazione o una dashboard.

I dati mancanti dovrebbero essere visibili nel risultato. Chiedi all'agente di segnalare l'incertezza invece di colmare le lacune con le ipotesi.

## Apportare modifiche con attenzione
Analisi esplorativa separata dagli aggiornamenti di massa. Chiedere un'anteprima che identifichi i record interessati, quindi rivederla prima di autorizzare la modifica. Le autorizzazioni e le regole di approvazione specifiche dello strumento si applicano ancora.

> Mostrami i contatti con nomi di aziende mancanti. Suggerisci le corrispondenze utilizzando i loro domini di posta elettronica, ma attendi la mia recensione prima di salvare le modifiche.

## Report ripetibili
Utilizzare a [abilità](https://docs.opser.com/it/agents/skills/) mantenere un formato di report coerente, e [calendario](https://docs.opser.com/it/agents/automations/) per eseguirlo regolarmente. Per una visualizzazione dell'area di lavoro continuamente utile, vedere [Dashboard](https://docs.opser.com/it/capabilities/dashboards/).


## Scoprire tabelle e colonne senza risultati troncati

L'azione `data.describe_schema` dell'agente restituisce l'elenco delle tabelle in pagine di 25 elementi (massimo 50). Usa `search` per filtrare i nomi, poi segui `next_input` finché è null. Specifica `entityId` per esaminare i nomi esatti delle colonne di una tabella; anche questi campi sono paginati. Così eviti di ipotizzare nomi come `sort_order` quando la colonna reale è `position`. La ricerca mantiene i controlli di accesso alle app e ai dati della persona e dell'agente.

L'azione `list_data` di Dashboard usa lo stesso flusso con `limit`, `offset`, `search` e `next_input`. I conteggi esatti richiedono `include_record_count: true` (`includeRecordCount` nello strumento data); la ricerca ordinaria non li calcola. Questi controlli riguardano gli strumenti, non modificano Impostazioni → Dati.

## Limiti dei report SQL

`raw_sql` accetta una sola query SELECT o WITH di sola lettura, con etichette letterali, UNION/UNION ALL, DISTINCT, aggregazioni e conversioni approvate. I risultati sono limitati a 500 righe e la query ha una scadenza di 15 secondi. Sono ammesse solo le tabelle aziendali leggibili dalla persona e dall'agente richiedente. I report non modificano record delle app né concedono accesso a tabelle private o della piattaforma.

Le proiezioni di testo includono `strpos`, `position`, `regexp_matches`, `regexp_replace`, `lower`, `substring` e `split_part`. L'ispezione JSON include `jsonb_object_keys`, `json_object_keys`, estrazione JSON e lunghezza degli array JSON. Usa le funzioni di espansione delle chiavi in SELECT; le funzioni in FROM e le chiamate qualificate con uno schema restano non supportate. Gli errori sulle funzioni non supportate elencano quelle consentite. Funzioni arbitrarie e conversioni non sicure restano vietate.

Per cercare menzioni esatte di una persona, preferisci regex parametrizzate con confini di parola alle ricerche generiche per sottostringa: per esempio `regexp_matches(note, ?, 'i')` con `params: ["\\mPier\\M"]`. Esamina prima lo schema, seleziona solo le colonne necessarie e usa un limite basso. Una sottostringa come `mark` può comparire anche in `marketing`; il supporto SQL non stabilisce automaticamente se una menzione identifica la persona desiderata.