借助 Conversational Analytics API,您可以使用自然语言查询数据。本页提供了有关如何提出有效问题以获得理想输出的指导。本页介绍了以下操作的最佳实践:
提出一般性问题
提出一般性问题时,请尽可能具体并提供相关背景信息。请提供相关详细信息(例如日期、特定类别或数值过滤条件),缩小问题范围,而不是提出宽泛的问题。
示例
原始问题:“每年手动和系统性地创建多少张账单?”
优化后的问题:“提供每年手动和系统性创建的账单数量。假设创建 1 份人工账单需要 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 个结果、特定类别)。
示例
以下问题正确指定了过滤条件:
“显示 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 以文本形式提供结果。
以下问题表明,结果应以文本输出的形式返回:
“计算并提供处理所有人工账单所花费的总时间(以小时为单位)的摘要。”
“过去一周内处理人工开具的账单总共花费了多长时间?”
引导 Conversational Analytics API 以折线图的形式返回结果
在问题中使用“趋势”“变化”或“差值变化”等关键字,可引导 Conversational Analytics API 以折线图的形式提供结果。
以下问题表示结果应以折线图的形式返回:
“2024年各行业月末余额趋势如何。”
“2025 年 5 月 2 日至 2025 年 6 月 3 日期间,未结账单的平均账龄与前一天相比的每日增量变化是多少?”
引导 Conversational Analytics API 以条形图或对比图的形式返回结果
使用“比较”和“方差”等关键字词可引导 Conversational Analytics API 以条形图或比较图的形式提供结果。
以下问题表示结果应以条形图或比较图表的形式返回:
“提供客户应收账款余额中按差异金额排名的前几大行业,以及 2025FP1 的金额(与上年末相比)。”
此问题的结果将以条形图的形式返回,其中显示了每个行业的方差。
其他资源
如需获取更多问题排查提示和常见问题解答,请参阅有关 Conversational Analytics API 的常见问题解答页面。
如需详细了解 API 错误及可能的解决方案,请参阅排查 Conversational Analytics API 错误指南。