L'API Analisi conversazionale è uno strumento potente che ti consente di eseguire query sui dati utilizzando il linguaggio naturale. Questa pagina fornisce indicazioni su come formattare domande efficaci per ottenere l'output ideale. Questa pagina include le best practice per le seguenti azioni:
- Porre domande generali
- Porre domande in più parti per analisi più complesse
- Porre domande con condizioni sui dati
- Richiedere l'aggregazione dei dati
- Porre domande aggiuntive
- Richiedere risultati formattati
Porre domande generali
Quando poni domande generali, sii specifico e fornisci il contesto. Invece di porre domande generiche, restringi l'ambito includendo dettagli pertinenti, come date, categorie specifiche o filtri numerici.
Un agente di dati che utilizza un'origine dati Looker potrebbe porre domande aggiuntive per chiarire eventuali ambiguità nella query originale. Ad esempio, se sono presenti più campi con nomi simili, l'agente di dati potrebbe chiederti di chiarire quale campo è più appropriato da utilizzare per elaborare la query. Queste domande verranno visualizzate in una risposta Richiesta di chiarimenti.
Esempio
Domanda originale: "Quante fatture vengono create manualmente e sistematicamente ogni anno?"
Domanda perfezionata: "Fornisci un conteggio delle fatture create manualmente e sistematicamente ogni anno. Supponendo che ci vogliano 15 minuti per creare una fattura manuale, calcola e fornisci anche un riepilogo del tempo totale impiegato in ore per elaborare tutte le fatture manuali."
Perché funziona: la domanda perfezionata aggiunge un requisito di calcolo specifico (tempo trascorso sulle fatture manuali) e specifica un formato di output, un riepilogo.
Porre domande in più parti per analisi più complesse
Suddividi le domande complesse in più parti per aiutare l'API Analisi conversazionale a elaborare con precisione ogni componente.
Esempio
Domanda originale: "Qual è il tempo di risposta medio in giorni di incasso alla consegna e di compensazione dei pagamenti per ogni tipo di credito (PHA, rimborso cooperativo, carta di credito, media retail) e qual è la percentuale di compensazioni manuali? Supponendo di impiegare 15 minuti per ogni credito compensato manualmente, quanto tempo spendiamo per l'app di incasso e la compensazione per ogni tipo di credito ogni anno?"
Domanda perfezionata, parte 1: "Qual è il tempo di risposta medio in giorni per il tipo di credito tra il 5 maggio 2025 e il 1° giugno 2025?"
Domanda perfezionata, parte 2: "Qual è la percentuale di compensazioni manuali tra il 5 maggio 2025 e il 1° giugno 2025 per ogni tipo di credito?"
Domanda perfezionata, parte 3: "Supponendo di impiegare 15 minuti per ogni credito compensato manualmente, quanto tempo spendiamo per l'app di incasso e la compensazione per ogni tipo di credito ogni anno?"
Perché funziona: porre le domande separatamente consente all'API Analisi conversazionale di affrontare ogni metrica specifica (tempo di risposta medio, percentuale di compensazioni manuali, tempo totale trascorso) con i filtri appropriati, per un risultato più accurato.
Porre domande con condizioni sui dati
Quando poni domande con condizioni sui dati, indica chiaramente tutti i filtri e le condizioni necessari nella domanda, incluse date esatte, limiti numerici e categorie specifiche. Assicurati che l'API Analisi conversazionale applichi i filtri corretti (intervalli di date, primi N risultati, categorie specifiche e così via).
Esempi
Le seguenti domande specificano correttamente i criteri di filtro:
"Mostrami la data della fattura dal 2 maggio 2025 al 3 giugno 2025 insieme alla rispettiva età media delle fatture in sospeso." Questa domanda specifica chiaramente l'intervallo di date.
"Fornisci il nome del cliente, la somma del saldo in sospeso, l'età media e il tipo di credito per i record con un'età superiore a 46 giorni. Limita i risultati a un massimo di 5 record in base al saldo in sospeso." Questa domanda specifica l'età del record, fornisce un limite e fornisce i requisiti di ordinamento.
Fornisci i settori principali in base all'importo della varianza nei saldi dei crediti dei clienti, nonché gli importi per il primo semestre 2025 rispetto alla fine dell'anno precedente. Questa domanda specifica "settori principali" e i periodi di confronto.
Richiedere l'aggregazione dei dati
Quando poni domande per aggregare i dati, specifica il tipo di aggregazione (ad esempio "somma del saldo in sospeso" o "età media") e le dimensioni in base alle quali vuoi aggregare (ad esempio "nome del cliente", "tipo di credito" o "settore").
Esempio
La seguente domanda specifica in modo efficace i requisiti chiari per l'aggregazione dei dati:
"Fornisci il nome del cliente, la somma del saldo in sospeso, l'età media e il tipo di credito per i record con un'età superiore a 46 giorni."
Porre domande aggiuntive
Quando poni una domanda aggiuntiva, fai riferimento al contesto stabilito in precedenza, ma sii esplicito in merito a modifiche o aggiunte. Ad esempio, se vuoi modificare un intervallo di date o un limite, indica chiaramente i nuovi parametri.
Esempi
Domanda originale: "Fornisci il nome del cliente, la somma del saldo in sospeso, l'età media e il tipo di credito per i record con un'età superiore a 46 giorni. Limita i risultati a un massimo di 5 record in base al saldo in sospeso."
Domanda aggiuntiva: "Fornisci le metriche precedenti per i record con un'età superiore a 90 giorni e limita a un massimo di 10 record."
Perché funziona: la domanda aggiuntiva specifica chiaramente le modifiche al filtro "età superiore a" e al limite dei risultati, facendo riferimento alle stesse metriche della domanda precedente per il contesto.
Richiedere risultati formattati
Quando poni una domanda che non specifica un formato dei risultati, l'API Analisi conversazionale determina il formato più adatto ai criteri specifici e ai termini chiave forniti nella domanda.
Puoi indicare all'API Analisi conversazionale di fornire i risultati nei seguenti formati includendo i termini chiave nella domanda:
Indicare all'API Analisi conversazionale di restituire i risultati in una tabella
La seguente domanda implica che i risultati devono essere restituiti in formato tabellare, perché specifica i nomi delle colonne di dimensione e metrica:
"Fornisci il nome del cliente, la somma del saldo in sospeso, l'età media e il tipo di credito per i record con un'età superiore a 46 giorni."
Indicare all'API Analisi conversazionale di restituire i risultati come testo
L'utilizzo di termini chiave come "riepilogo" o una domanda che richiede solo una risposta semplice indica all'API Analisi conversazionale di fornire i risultati come testo.
Le seguenti domande implicano che i risultati devono essere restituiti in un output di testo:
"Calcola e fornisci un riepilogo del tempo totale impiegato in ore per l'elaborazione di tutte le fatture manuali."
"Qual è il tempo totale impiegato per elaborare le fatture manuali nell'ultima settimana?"
Indicare all'API Analisi conversazionale di restituire i risultati come grafico a linee
L'utilizzo di termini chiave come "tendenza", "variazione" o "variazione delta" in una domanda indica all'API Analisi conversazionale di fornire i risultati come grafico a linee.
Le seguenti domande implicano che i risultati devono essere restituiti come grafico a linee:
"Qual è la tendenza mensile dei saldi finali per ogni settore nell'anno 2024?"
"Qual è la variazione delta giornaliera dell'età media delle fatture in sospeso per il giorno rispetto al giorno precedente tra il 2 maggio 2025 e il 3 giugno 2025?"
Indicare all'API Analisi conversazionale di restituire i risultati come grafico a barre o comparativo
L'utilizzo di termini chiave come "confronta" e "varianza" indica all'API Analisi conversazionale di fornire i risultati come grafico a barre o comparativo.
La seguente domanda implica che i risultati devono essere restituiti come grafico a barre o comparativo:
Fornisci i settori principali in base all'importo della varianza nei saldi dei crediti dei clienti, nonché gli importi per il primo semestre 2025 rispetto alla fine dell'anno precedente.
I risultati di questa domanda verranno restituiti come grafico a barre che mostra la varianza per ogni settore.
Risorse aggiuntive
Per altri suggerimenti per la risoluzione dei problemi e risposte alle domande frequenti, consulta la pagina Domande frequenti sull'API Analisi conversazionale.
Per ulteriori informazioni sugli errori delle API e sulle potenziali soluzioni, consulta la guida Risolvere i problemi relativi all'API Analisi conversazionale.