View a markdown version of this page

向主题添加自定义指令 - Amazon Quick
自定义指令示例自定义指令的最佳实践

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

向主题添加自定义指令

 适用于：企业版 
   目标受众：Amazon Quick 管理员和作者 

自定义指令是持久的自然语言规则，指导 AI 引擎解释特定领域的术语和跨数据集逻辑。没有它们，引擎会按字面解释术语。例如，“今年” 默认为日历年。但是，如果贵组织的财政年度从 4 月 1 日开始，则需要说明来改写该默认值。

自定义指令对以下情况特别有用：

  • 消歧规则。当同一个商业术语可以映射到多个数据集或字段时，告诉 AI 更喜欢哪个数据集或字段。例如：“当用户询问'销售'时，使用 SALES_FACT。当用户询问'退货'或'退款'时，使用 RETURNS_FACT。”

  • Cross-dataset 定义。定义跨越多个数据集的指标。例如：“净收入 = 总和（销售FACT.total额_金额）-总和（退货_金额）。FACT.refund”

  • 默认联接行为。指定保留预期语义的连接方向。例如：“最好使用事实表中的 LEFT JOIN 而不是维度表，这样不匹配维度记录的事实就不会被静默删除。”

  • 自定义日期逻辑。例如：“财政年度从 4 月 1 日开始。使用财政年度边界来解释 “今年”。”

添加自定义指令

  1. 打开要配置的主题。

  2. 导航到自定义说明选项卡。

  3. 选择编辑。

  4. 将您的说明作为自然语言规则输入。为清晰起见，使用要点样式。

  5. 选择保存更改。

自定义指令示例

以下示例显示了零售分析主题的一组可供生产使用的主题级说明：

Disambiguation:
- "sales", "revenue", "orders" -> use SALES_FACT
- "returns", "refunds" -> use RETURNS_FACT
- "net sales", "net revenue" -> join SALES_FACT LEFT JOIN RETURNS_FACT on order_line_id

Cross-dataset metrics:
- Net Revenue = SUM(SALES_FACT.total_amount) - SUM(RETURNS_FACT.refund_amount)
- Return Rate = COUNT(RETURNS_FACT.return_id) / COUNT(SALES_FACT.order_line_id)

Default joins:
- SALES_FACT LEFT JOIN CUSTOMER_DIM on customer_id
- SALES_FACT LEFT JOIN PRODUCT_DIM on product_id

Date handling:
- Fiscal year starts April 1. Interpret "this year" using fiscal year boundaries.
- YTD: current fiscal year up to and including today.

自定义指令的最佳实践

  • 保持说明简洁。与散文段落相比，更喜欢要点规则列表。

  • 仅对跨数据集逻辑使用主题级指令。 Single-dataset语义（颗粒、密钥、聚合规则）属于数据集自己的丰富元数据。

  • 避免数据集级别和主题级指令之间的矛盾。

  • 通过在聊天中提问并在解释面板中查看生成的 SQL 来测试您的指令。