L'API Conversational Analytics è un potente strumento che ti consente di eseguire query sui dati utilizzando un 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:
- Fare domande di carattere generale
- Poni domande in più parti per analisi più complesse
- Fare domande con condizioni dei dati
- Chiedere l'aggregazione dei dati
- Fare domande aggiuntive
- Chiedere risultati formattati
Porre domande generali
Quando poni domande generali, sii specifico e fornisci un contesto. Anziché porre domande generiche, restringi l'ambito includendo dettagli pertinenti, come date, categorie specifiche o filtri numerici.
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 dedicato alle fatture manuali) e specifica un formato di output, un riepilogo.
Poni domande in più parti per analisi più complesse
Suddividi le domande complesse in più parti per aiutare l'API Conversational Analytics a elaborare ogni componente in modo accurato.
Esempio
Domanda originale: "Qual è il tempo di elaborazione medio in giorni del pagamento in contanti alla consegna e della compensazione dei pagamenti per ogni tipo di credito (PHA, rimborso cooperativa, carta di credito, media retail) e qual è la percentuale di queste compensazioni manuali? Supponendo di dedicare 15 minuti a ogni credito compensato manualmente, quanto tempo dedichiamo all'app di cassa e alla compensazione per ogni tipo di credito ogni anno?"
Domanda perfezionata, parte 1: "Qual è il turnaround medio in giorni per ogni 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 05/05/2025 e il 01/06/2025 per ogni tipo di credito?"
Domanda perfezionata, parte 3: "Supponendo di dedicare 15 minuti a ogni credito compensato manualmente, quanto tempo dedichiamo all'app di cassa e alla compensazione per ogni tipo di credito ogni anno?"
Perché funziona: porre le domande separatamente consente all'API Conversational Analytics di indirizzare ogni metrica specifica (tempi di risposta medi, percentuale di compensazioni manuali, tempo totale trascorso) con i filtri appropriati, per un risultato più accurato.
Fare 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 Conversational Analytics applichi i filtri corretti (intervalli di date, primi N risultati, categorie specifiche, ad esempio).
Esempi
Le seguenti domande specificano correttamente i criteri di filtro:
"Mostrami la data della fattura dal 02/05/2025 al 03/06/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 insoluto, l'età media e il tipo di credito per i record che hanno superato i 46 giorni. Limita i risultati a un massimo di 5 record in base al saldo insoluto." Questa domanda specifica l'età del record, fornisce un limite e i requisiti di ordinamento.
"Fornisci i settori principali in base all'importo della varianza nei saldi dei crediti dei clienti, insieme agli importi per 2025FP1 rispetto alla fine dell'anno precedente." Questa domanda specifica i "settori principali" e i periodi di confronto.
Richiedere l'aggregazione dei dati
Quando poni domande per aggregare i dati, specifica il tipo di aggregazione ("somma del saldo insoluto" o "età media", ad esempio) e le dimensioni in base alle quali vuoi eseguire l'aggregazione ("nome cliente", "tipo di credito" o "settore", ad esempio).
Esempio
La seguente domanda specifica in modo efficace requisiti chiari per l'aggregazione dei dati:
"Fornisci il nome del cliente, la somma del saldo insoluto, l'età media e il tipo di credito per i record con un'anzianità superiore a 46 giorni".
Fai domande aggiuntive
Quando poni una domanda aggiuntiva, fai riferimento al contesto stabilito in precedenza, ma sii esplicito su 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 insoluto, l'età media e il tipo di credito per i record con un'anzianità superiore a 46 giorni. Limita i risultati a un massimo di 5 record in base al saldo insoluto."
Domanda aggiuntiva: "Fornisci le metriche precedenti per i record meno recenti di 90 giorni e limita i risultati ai primi 10 record".
Perché funziona: la domanda di follow-up specifica chiaramente le modifiche al filtro "Più vecchi di" e al limite dei risultati, facendo riferimento alle stesse metriche della domanda precedente per fornire un contesto.
Chiedere risultati formattati
Quando poni una domanda che non specifica un formato dei risultati, l'API Conversational Analytics determina il formato più adatto ai criteri specifici e ai termini chiave forniti nella domanda.
Puoi guidare l'API Conversational Analytics a fornire risultati nei seguenti formati includendo termini chiave nella domanda:
Guida l'API Conversational Analytics a 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 dimensioni e metriche:
"Fornisci il nome del cliente, la somma del saldo insoluto, l'età media e il tipo di credito per i record con un'anzianità superiore a 46 giorni".
Guida l'API Conversational Analytics a restituire i risultati come testo
L'utilizzo di termini chiave come "riepilogo" o la formulazione di una domanda che richiede solo una risposta diretta guida l'API Conversational Analytics a 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?"
Guida l'API Conversational Analytics a restituire i risultati come grafico a linee
L'utilizzo di termini chiave come "tendenza", "variazione" o "variazione delta" in una domanda guida l'API Conversational Analytics a fornire i risultati come grafico a linee.
Le seguenti domande implicano che i risultati devono essere restituiti come grafico a linee:
"Qual è il trend mensile dei saldi finali per ogni settore nell'anno 2024?"
"Qual è la variazione giornaliera del delta dell'età media delle fatture in sospeso per il giorno rispetto al giorno precedente tra il 2/05/2025 e il 3/06/2025?"
Guida l'API Conversational Analytics a restituire i risultati come grafico a barre o di confronto
L'utilizzo di termini chiave come "confronta" e "varianza" guida l'API Conversational Analytics a fornire i risultati come grafico a barre o di confronto.
La seguente domanda implica che i risultati devono essere restituiti come grafico a barre o di confronto:
"Fornisci i settori principali in base all'importo della varianza nei saldi dei crediti dei clienti, insieme agli importi per 2025FP1, 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 Conversational Analytics.
Per ulteriori informazioni sugli errori dell'API e sulle potenziali soluzioni, consulta la guida Risolvere i problemi relativi agli errori dell'API Conversational Analytics.