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. Gera perguntas usando Large Language Models (modo padrão sem Verified Query Repository)

   Quando seu modelo semântico não inclui um Verified Query Repository (VQR), o Cortex Analyst usa os Grandes modelos de linguagem (LLMs) subjacentes para gerar até três perguntas sugeridas. Observe que essas perguntas nem sempre podem ser respondidas; por exemplo, o sistema pode sugerir uma pergunta que não produz resultados.

2. Sugere perguntas do Verified Query Repository (modo padrão com VQR)

   Se o seu modelo semântico tiver um Verified Query Repository (VQR) definido, o Cortex Analyst retorna até cinco perguntas sugeridas do VQR. Essas perguntas são selecionadas com base em sua similaridade com a entrada do usuário. Por exemplo, se um usuário perguntar, What questions can I ask about revenue?, o Cortex Analyst retornará até 5 perguntas que provavelmente são sobre a receita do repositório VQR e que provavelmente serão respondidas.

3. Retorna perguntas de integração configuradas no modelo semântico (modo personalizável com VQR)

   Para ter mais controle sobre quais perguntas são exibidas, você pode usar o novo sinalizador use_as_onboarding_question em sua configuração do VQR.

   • Quando este sinalizador é definido como verdadeiro, o Cortex Analyst retornará todas as perguntas marcadas como perguntas de integração, independentemente de sua semelhança com a entrada do usuário.

   • Esse recurso é útil se você quiser apresentar um conjunto completo de perguntas predefinidas e passíveis de resposta para os usuários, como em uma experiência de integração. Se você sinalizar mais de 5 perguntas, todas as perguntas sinalizadas serão retornadas na resposta.

Como configurar perguntas de integração¶

Para definir perguntas de integração, você precisa marcar consultas verificadas específicas no modelo semântico com o sinalizador use_as_onboarding_question. O exemplo abaixo mostra como definir isso:

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