Conversational Analytics API は、自然言語を使用してデータをクエリできる強力なツールです。このページでは、理想的な出力を得るために効果的な質問の形式を設定する方法について説明します。このページでは、次のアクションに関するベスト プラクティスについて説明します。
一般的な質問をする
一般的な質問をする場合は、具体的にコンテキストを提示してください。広範な質問ではなく、日付、特定のカテゴリ、数値フィルタなどの関連する詳細を含めて、範囲を絞り込みます。
例
元の質問: 「毎年手動で作成される請求書とシステムで作成される請求書の数はそれぞれどれくらいですか？」
改良された質問: 「毎年手動で作成される請求書とシステムで作成される請求書の数を教えてください。手動の請求書を 1 通作成するのに 15 分かかると仮定して、すべての手動の請求書を処理するのにかかる合計時間を時間単位で計算して、概要を提示してください。」
この手法が有効な理由: 質問を改良することで、具体的な計算要件（手動の請求書に費やした時間）が追加され、出力形式（要約）が指定されます。
より複雑な分析を行うために、複数の質問を一度に送信する
複雑な質問を複数の部分に分割して、Conversational Analytics API が各コンポーネントを正確に処理できるようにします。
例
元の質問: 「各売掛金タイプ（PHA、協同組合リベート、クレジット カード、リテール メディア）の現金受け取りと支払いの決済の平均所要日数は何日ですか？また、そのうち手動決済の割合は何パーセントですか？手動決済に 1 つの売掛金あたり 15 分かかると仮定すると、各売掛金タイプについて、Cash App での決済に年間どれくらいの時間を費やしていることになりますか？」
改良された質問、パート 1: 「2025 年 5 月 5 日から 2025 年 6 月 1 日までの各売掛金タイプの平均所要日数は何日ですか？」
改良された質問、パート 2: 「2025 年 5 月 5 日から 2025 年 6 月 1 日までの各売掛金タイプの決済のうち、手動決済の割合はどれくらいですか？」
改良された質問、パート 3: 「手動決済に 1 つの売掛金あたり 15 分かかると仮定した場合、各売掛金タイプについて、Cash App と決済に年間でどれくらいの時間を費やしていますか？」
この手法が有効な理由: 質問を個別にすることで、Conversational Analytics API は、各指標（平均処理時間、手動決済の割合、合計所要時間）に適切なフィルタを適用して、より正確な結果を得ることが可能です。
データ条件を指定して質問する
データ条件を含む質問をする場合は、正確な日付、数値の上限、特定のカテゴリなど、必要なすべてのフィルタと条件を質問で明確に指定してください。Conversational Analytics API が正しいフィルタ（日付範囲、上位 N 件の結果、特定のカテゴリなど）を適用していることを確認します。
例
次の質問では、フィルタ条件を正しく指定しています。
「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 に結果をテキスト形式で返すよう指示する
「概要」などの主な用語を使用するか、簡単な回答のみを必要とする質問をすると、Conversational Analytics API はテキストで結果を提示します。
次の質問では、結果がテキスト出力で返されることが想定されています。
「すべての請求書の手動処理にかかった合計時間を計算して、概要を提示してください。」
「過去 1 週間に請求書の手動処理にかかった合計時間はどのくらいですか？」
Conversational Analytics API に結果を折れ線グラフとして返すよう指示する
質問に「傾向」、「変化」、「変化率」などの主な用語を使用すると、Conversational Analytics API は結果を折れ線グラフで提示します。
次の質問では、結果が折れ線グラフとして返されることが想定されています。
「2024 年の各業種の月末残高の月次推移を教えてください。」
「2025 年 5 月 2 日から 2025 年 6 月 3 日までの前日と比較した未払い請求書の平均経過日数における 1 日あたりの変化の差分はどのくらいですか？」
Conversational Analytics API に結果を棒グラフまたは比較表として返すよう指示する
「比較」や「分散」などの主な用語を使用すると、Conversational Analytics API は結果を棒グラフや比較表として提示します。
次の質問では、結果を棒グラフまたは比較表として返すことが想定されています。
「顧客の売掛金残高の差額の上位業種と、2025FP1 の金額と前年度末の金額の比較を表示してください。」
この質問の結果は、各業種の分散を示す棒グラフとして返されます。
参考情報
トラブルシューティングのヒントやよくある質問への回答については、Conversational Analytics API に関するよくある質問ページをご覧ください。
API エラーと解決策の詳細については、Conversational Analytics API エラーのトラブルシューティング ガイドをご覧ください。