對話式數據分析 API 是十分強大的工具，可讓您使用自然語言查詢資料。本頁面提供指引，說明如何格式化有效問題，以獲得理想輸出內容。本頁面包含下列動作的最佳做法：
提出一般問題
提出一般問題時，請具體說明並提供背景資訊。請提供相關詳細資料，例如日期、特定類別或數值篩選條件，縮小範圍，而非提出廣泛的問題。
範例
原始問題：「每年手動和系統性建立的發票數量各是多少？」
修正後的問題：「請提供每年手動和系統建立的月結單數量。假設建立一張手動月結單需要 15 分鐘，請計算並提供處理所有手動月結單的總時數摘要。」
運作原理：經過修正的問題新增了特定計算需求 (手動發票所花費的時間)，並指定輸出格式為摘要。
提出多個問題，進行更複雜的分析
將複雜問題拆解為多個部分，協助 Conversational Analytics API 準確處理每個元件。
範例
原始問題：「每種應收款項類型 (PHA、合作退款、信用卡、零售媒體) 的貨到付款和款項結算平均處理天數為何？其中手動結算的比例是多少？假設我們手動結清每筆應收款項需要 15 分鐘，每年在現金應用程式上結清每種應收款項類型需要多少時間？
修正後的問題 (第 1 部分)：「2025 年 5 月 5 日至 2025 年 6 月 1 日期間，每種應收款項類型的平均處理時間 (以天為單位) 是多少？」
修正後的問題，第 2 部分：「在 2025 年 5 月 5 日至 2025 年 6 月 1 日期間，每種應收款項類型的手動結算百分比是多少？」
修正問題，第 3 部分：「假設我們為每筆應收款項手動結算作業花費 15 分鐘，每年在現金應用程式上花費多少時間，以及結算每種應收款項類型需要多少時間？」
運作原理：分開提問可讓 Conversational Analytics API 針對每個特定指標 (平均處理時間、手動結算百分比、總花費時間) 套用適當的篩選條件，進而提供更準確的結果。
使用資料條件提問
提出附有資料條件的問題時，請在問題中清楚說明所有必要篩選條件，包括確切日期、數字限制和特定類別。請確認 Conversational Analytics API 套用了正確的篩選器 (例如日期範圍、前 N 個結果、特定類別)。
範例
下列問題正確指定了篩選條件：
「Show me the invoice date from 2025-05-02 until 2025-06-03 along with the respective average age of outstanding invoices only.」(顯示 2025 年 5 月 2 日至 2025 年 6 月 3 日的月結單日期，以及相應的未付款月結單平均天數。)這個問題清楚指定了日期範圍。
「請提供超過 46 天的應收帳款記錄，包括客戶名稱、未付餘額總和、平均帳齡和應收帳款類型。將結果限制為最多 5 筆未結餘額記錄。這個問題會指定記錄年齡、提供限制，以及提供排序規定。
「請提供應收帳款餘額差異金額最大的產業，以及 2025FP1 與前一年底的金額。」這個問題會指定「熱門產業」和比較期間。
要求匯總資料
詢問匯總資料時，請指定匯總類型 (例如「未付餘額總和」或「平均年齡」)，以及要匯總的維度 (例如「客戶名稱」、「應收款類型」或「產業」)。
範例
下列問題有效指定了資料匯總的明確需求：
「針對超過 46 天的記錄，提供客戶名稱、未付餘額總和、平均天數和應收帳款類型。」
提出後續問題
提出後續問題時，請參考先前建立的背景資訊，但要明確說明變更或新增內容。舉例來說，如要變更日期範圍或限制，請清楚說明新的參數。
範例
原始問題：「請提供逾期超過 46 天的記錄，包括客戶名稱、未付餘額總和、平均年齡和應收帳款類型。將結果限制為最多 5 筆未結餘額記錄。
後續問題：「提供超過 90 天的記錄的先前指標，最多 10 筆記錄。」
運作原理：後續問題清楚指定「超過期限」篩選器的變更內容和結果限制，同時參照前一個問題的相同指標，提供相關背景資訊。
要求提供格式化結果
如果提出的問題未指定結果格式，Conversational Analytics API 會根據問題中提供的特定條件和關鍵字，決定最合適的格式。
在問題中加入關鍵字，即可引導 Conversational Analytics API 提供下列格式的結果：
引導 Conversational Analytics API 以表格形式傳回結果
下列問題表示結果應以表格格式傳回，因為問題中指定了維度和指標的資料欄名稱：
「針對超過 46 天的記錄，提供客戶名稱、未付餘額總和、平均天數和應收帳款類型。」
引導 Conversational Analytics API 以文字形式傳回結果
使用「摘要」等關鍵字，或提出只需要直接回答的問題，即可引導對話式 Analytics API 以文字形式提供結果。
下列問題表示結果應以文字輸出形式傳回：
「計算並提供處理所有手動應付憑據的總時數摘要。」
「過去一週處理手動發票的總時數是多少？」
引導對話式數據分析 API 以折線圖形式傳回結果
在問題中使用「趨勢」、「變化」或「變化量」等關鍵字，可引導對話式數據分析 API 以折線圖的形式提供結果。
下列問題表示結果應以折線圖形式傳回：
「2024 年各產業的期末餘額月趨勢為何？」
「2025 年 5 月 2 日至 2025 年 6 月 3 日期間，每日未付款應付憑據平均天數的每日差異變化為何？」
引導 Conversational Analytics API 以長條圖或比較圖表的形式傳回結果
使用「比較」和「差異」等關鍵字詞，引導 Conversational Analytics API 以長條圖或比較圖的形式提供結果。
下列問題表示結果應以長條圖或比較圖表的形式傳回：
「請提供客戶應收帳款餘額差異金額最大的產業，以及 2025 年第 1 季的金額，並與前一年底的金額進行比較。」
這項問題的結果會以長條圖形式傳回，顯示各產業的差異。
其他資源
如需其他疑難排解提示和常見問題解答，請參閱「Conversational Analytics API 常見問題」頁面。
如要進一步瞭解 API 錯誤和可能的解決方案，請參閱「排解對話式數據分析 API 錯誤」指南。