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