Instruções personalizadas no Cortex Analyst

As instruções personalizadas permitem que você tenha maior controle sobre a geração do SQL. Usando linguagem natural, você pode informar ao Cortex Analyst exatamente como gerar consultas SQL a partir do seu arquivo de modelo semântico YAML. Por exemplo, use instruções personalizadas para informar ao Cortex Analyst o que você quer dizer com desempenho ou ano financeiro. Dessa forma, você pode melhorar a precisão do SQL gerado incorporando lógica personalizada ou elementos adicionais.

Como funcionam as instruções personalizadas

O Cortex Analyst introduz o campo custom_instructions no arquivo YAML do modelo semântico. Esse campo permite que você aplique modificações ou acréscimos de definição à geração de SQL.

Para obter mais informações sobre a sintaxe do modelo semântico, consulte Especificação do modelo semântico Cortex Analyst.

Exemplos

Para explorar possíveis casos de uso de instruções personalizadas, considere os exemplos a seguir.

Formatação da saída de dados

Certifique-se de que todos os números na saída sejam arredondados para duas casas decimais.

O campo custom_instructions no arquivo YAML do modelo semântico

custom_instructions: "Ensure that all numeric columns are rounded to 2 decimal points in the output."
Copy

Consulta SQL gerada

SELECT
  ROUND(column_name, 2) AS column_name,
  ...
FROM
  your_table;
Copy

Ajuste de porcentagens

Multiplicar automaticamente os cálculos de porcentagem ou taxa por 100 para manter a consistência.

O campo custom_instructions no arquivo YAML do modelo semântico

custom_instructions: "For any percentage or rate calculation, multiply the result by 100."
Copy

Consulta SQL gerada

SELECT
  (column_a / column_b) * 100 AS percentage_rate,
  ...
FROM
  your_table;
Copy

Como adicionar filtros padrão

Aplique um filtro se o usuário não especificar um (por exemplo, padrão para o último ano).

O campo custom_instructions no arquivo YAML do modelo semântico

custom_instructions: "If no date filter is provided, apply a filter for the last year."
Copy

Consulta SQL gerada

SELECT
  ...
FROM
  your_table
WHERE
  date_column >= DATEADD(YEAR, -1, CURRENT_DATE);
Copy

Vinculação de filtros de coluna

Aplique filtros adicionais em colunas relacionadas com base na entrada do usuário.

O campo custom_instructions no arquivo YAML do modelo semântico

custom_instructions: "If a filter is applied on column X, ensure that the same filter is applied to dimension Y."
Copy

Consulta SQL gerada

SELECT
  ...
FROM
  your_table
WHERE
  column_x = 'filter_value' AND
  dimension_y = 'filter_value';
Copy

Práticas recomendadas

Seja específico.

Descreva claramente as modificações; por exemplo, «Adicione uma coluna com um valor fixo de 42» ou «Inclua um cálculo de soma para a coluna X».

Comece com pouco.

Comece com modificações simples, como adicionar uma coluna estática ou filtros padrão, antes de passar para cenários mais complexos.

Visualize a consulta SQL gerada.

Certifique-se de que as instruções sejam aplicadas como pretendido e que a consulta SQL gerada esteja correta.

Itere gradualmente.

Faça experiências com casos de uso mais complexos à medida que sua familiaridade com o recurso aumentar.

Linguagem: Português