Prendendo come esempio il CRM, impari come far sì che il Suo analista di insight AI comprenda veramente il Suo business e sprigioni tutto il suo potenziale.
Nel sistema NocoBase, Viz è l'analista di insight AI predefinito. Può riconoscere il contesto della pagina (come Lead, Opportunità, Account) e generare grafici di tendenza, grafici a imbuto e schede KPI. Ma per impostazione predefinita, possiede solo le capacità di interrogazione più basilari:
| Strumento | Descrizione della funzione | Sicurezza |
|---|---|---|
| Get Collection Names | Ottieni elenco delle collezioni | ✅ Sicuro |
| Get Collection Metadata | Ottieni struttura dei campi | ✅ Sicuro |
Questi strumenti permettono a Viz solo di "riconoscere la struttura", ma non ancora di "comprendere veramente il contenuto". Per consentirgli di generare insight, rilevare anomalie e analizzare tendenze, Lei deve estenderlo con strumenti di analisi più adatti.
Nella demo ufficiale del CRM, abbiamo utilizzato due metodi:
Queste due non sono le uniche opzioni; sono più simili a un paradigma di progettazione:
Può seguire i suoi principi per creare un'implementazione più adatta al Suo business.
Per capire come estendere Viz, deve prima comprendere la sua progettazione interna a strati:
| Livello | Descrizione | Esempio |
|---|---|---|
| Definizione del Ruolo | La personalità e il metodo di analisi di Viz: Comprendere → Interrogare → Analizzare → Visualizzare | Fisso |
| Definizione del Compito | Prompt personalizzati e combinazioni di strumenti per uno specifico scenario di business | Modificabile |
| Configurazione dello Strumento | Il ponte per Viz per richiamare fonti dati esterne o flussi di lavoro | Liberamente sostituibile |
Questa progettazione a strati permette a Viz di mantenere una personalità stabile (logica di analisi coerente) e allo stesso tempo di adattarsi rapidamente a diversi scenari di business (CRM, gestione ospedaliera, analisi dei canali, operazioni di produzione...).
Questa documentazione è stata tradotta automaticamente dall'IA.
Overall Analytics è il motore di analisi centrale nella demo CRM. Gestisce tutte le query SQL tramite una collezione di template di analisi dati (data_analysis). Viz non scrive SQL direttamente, ma richiama template predefiniti per generare i risultati.
Il flusso di esecuzione è il seguente:
In questo modo, Viz può generare risultati di analisi sicuri e standardizzati in pochi secondi, e gli amministratori possono gestire e revisionare centralmente tutti i template SQL.
| Nome del campo | Tipo | Descrizione | Esempio |
|---|---|---|---|
| id | Integer | Chiave primaria | 1 |
| name | Text | Nome del template di analisi | Leads Data Analysis |
| collection | Text | Collezione corrispondente | Lead |
| sql | Code | Istruzione SQL di analisi (sola lettura) | SELECT stage, COUNT(*) FROM leads GROUP BY stage |
| description | Markdown | Descrizione o definizione del template | "Conteggio lead per fase" |
| createdAt / createdBy / updatedAt / updatedBy | Campo di sistema | Informazioni di audit | Generato automaticamente |
| Name | Collection | Description |
|---|---|---|
| Account Data Analysis | Account | Analisi dati account |
| Contact Data Analysis | Contact | Analisi dati contatto |
| Leads Data Analysis | Lead | Analisi delle tendenze dei lead |
| Opportunity Data Analysis | Opportunity | Imbuto delle fasi delle opportunità |
| Task Data Analysis | Todo Tasks | Statistiche sullo stato delle attività da fare |
| Users (Sales Reps) Data Analysis | Users | Confronto delle performance dei rappresentanti di vendita |
| Dimensione | Vantaggio |
|---|---|
| Sicurezza | Tutte le query SQL sono memorizzate e revisionate, evitando la generazione diretta di query. |
| Manutenibilità | I template sono gestiti centralmente e aggiornati in modo uniforme. |
| Riutilizzabilità | Lo stesso template può essere riutilizzato da più compiti. |
| Portabilità | Può essere facilmente migrato ad altri sistemi, richiedendo solo la stessa struttura della collezione. |
| Esperienza Utente | Gli utenti business non devono preoccuparsi dell'SQL; devono solo avviare una richiesta di analisi. |
📘 Questa collezione
data_analysisnon deve necessariamente chiamarsi così. La chiave è: memorizzare la logica di analisi in modo basato su template e farla richiamare uniformemente da un flusso di lavoro.
Nella definizione del compito, può indicare esplicitamente a Viz:
In questo modo, Viz richiamerà automaticamente il flusso di lavoro, abbinerà l'SQL più adatto dalla collezione di template e genererà il grafico.
Quando ha bisogno di analisi esplorative, query ad hoc o aggregazioni JOIN tra più collezioni, può far sì che Viz richiami uno strumento SQL Execution.
Le caratteristiche di questo strumento sono:
SELECT;Esempio di compito:
"Si prega di analizzare la tendenza dei tassi di conversione dei lead per regione negli ultimi 90 giorni."
In questo caso, Viz potrebbe generare:
| Punto di rischio | Strategia di protezione |
|---|---|
| Generazione di operazioni di scrittura | Limitare forzatamente a SELECT |
| Accesso a collezioni non correlate | Validare se il nome della collezione esiste |
| Rischio di performance con collezioni di grandi dimensioni | Limitare l'intervallo di tempo, usare LIMIT per il numero di righe |
| Tracciabilità delle operazioni | Abilitare il logging delle query e l'audit |
| Controllo dei permessi utente | Solo gli amministratori possono utilizzare questo strumento |
Raccomandazioni generali:
- Gli utenti regolari dovrebbero avere abilitata solo l'analisi basata su template (Overall Analytics);
- Solo gli amministratori o gli analisti senior dovrebbero essere autorizzati a utilizzare SQL Execution.
Ecco un approccio semplice e generale che può replicare in qualsiasi sistema (non dipendente da NocoBase):
Il nome della collezione può essere qualsiasi (ad es. analysis_templates).
Deve solo includere i campi: name, sql, collection e description.
Logica:
Il prompt del compito può essere scritto così:
In questo modo, il Suo sistema di agente AI avrà capacità di analisi simili a quelle della demo CRM, ma sarà completamente indipendente e personalizzabile.
| Raccomandazione | Descrizione |
|---|---|
| Dare priorità all'analisi basata su template | Sicura, stabile e riutilizzabile |
| Utilizzare SQL Execution solo come supplemento | Limitato al debug interno o a query ad hoc |
| Un grafico, un punto chiave | Mantenere l'output chiaro ed evitare un eccessivo disordine |
| Nomenclatura chiara dei template | Nominare in base alla pagina/dominio di business, ad es. Leads-Stage-Conversion |
| Spiegazioni concise e chiare | Accompagnare ogni grafico con un riassunto di 2-3 frasi |
| Indicare quando manca un template | Informare l'utente "Nessun template corrispondente trovato" invece di fornire un output vuoto |
Sia che Lei si occupi di CRM ospedaliero, produzione, logistica di magazzino o iscrizioni educative, purché Lei possa rispondere alle seguenti tre domande, Viz potrà apportare valore al Suo sistema:
| Domanda | Esempio |
|---|---|
| 1. Cosa desidera analizzare? | Tendenze dei lead / Fasi di trattativa / Tasso di utilizzo delle attrezzature |
| 2. Dove si trovano i dati? | Quale collezione, quali campi |
| 3. Come desidera presentarli? | Grafico a linee, a imbuto, a torta, tabella di confronto |
Una volta definiti questi elementi, Le basterà:
"Overall Analytics" e "SQL Execution" sono solo due implementazioni di esempio. Ciò che è più importante è l'idea che sta dietro di esse:
Far sì che l'agente AI comprenda la Sua logica di business, anziché limitarsi a eseguire i prompt.
Sia che Lei utilizzi NocoBase, un sistema privato o il Suo flusso di lavoro personalizzato, può replicare questa struttura:
In questo modo, Viz non è più solo un'"AI in grado di generare grafici", ma un vero analista che comprende i Suoi dati, le Sue definizioni e il Suo business.