Dati e report

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.

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à mantenere un formato di report coerente, e calendario per eseguirlo regolarmente. Per una visualizzazione dell'area di lavoro continuamente utile, vedere Dashboard.

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.