Onboarding questions in Cortex Analyst¶

How onboarding questions work¶

Cortex Analyst operates in one of three modes, depending on the configuration of your semantic model:

1. 使用 大型语言模型 生成问题（默认模式，无验证查询存储库）

   当您的语义模型不包括验证查询存储库 (VQR) 时，Cortex Analyst 会使用底层大型语言模型 (LLMs) 生成最多三个建议的问题。请注意，这些问题并不总是可以回答的；例如，系统可能会提出一个没有结果的问题。

2. 从 验证查询存储库 提供问题建议（默认模式，具有 VQR)

   如果您的语义模型定义了 验证查询存储 (VQR)，Cortex Analyst 最多会从 VQR 返回五个建议的问题。这些问题是根据与用户输入内容的相似度来选择的。例如，如果用户询问 What questions can I ask about revenue?，Cortex Analyst 最多会返回 5 个最有可能回答的问题，这些问题很可能与 VQR 存储库中的收入有关。

3. 返回语义模型中配置的 **入职问题**（可定制模式，具有 VQR)

   要进一步控制显示哪些问题，可以在 VQR 配置中使用新的 use_as_onboarding_question 标志。

   • 当此标志设置为 true 时，Cortex Analyst 将返回标记为入职问题的 所有 问题，无论它们与用户输入内容是否相似。

   • 如果您想为用户提供一整套预定义的可回答问题，例如在入职体验中，该功能非常有用。如果标记的问题超过 5 个，则标记的所有问题都会在响应中返回。

如何配置入职问题¶

要定义入职问题，您需要在语义模型中使用 use_as_onboarding_question 标志标记特定的已验证查询。下面的示例展示了如何进行设置：

verified_queries:

- name: "lowest revenue each month"
  question: For each month, what was the lowest daily revenue and on what date did that lowest revenue occur?

  use_as_onboarding_question: true

  sql: "WITH monthly_min_revenue AS (
SELECT
    DATE_TRUNC('MONTH', date) AS month,
    MIN(daily_revenue) AS min_revenue
FROM \__daily_revenue
GROUP BY
DATE_TRUNC('MONTH', date)

)

SELECT
    mmr.month,
    mmr.min_revenue,
    dr.date AS min_revenue_date
FROM monthly_min_revenue AS mmr JOIN \__daily_revenue AS dr
ON mmr.month = DATE_TRUNC('MONTH', dr.date)
AND mmr.min_revenue = dr.daily_revenue
ORDER BY mmr.month DESC NULLS LAST"

verified_at: 1715187400

verified_by: user_name