Cortex Analyst 의 사용자 지정 지침

사용자 지정 지침을 사용하면 SQL 생성을 더욱 효과적으로 제어할 수 있습니다. 자연어를 사용하여 Cortex Analyst 에 시맨틱 모델 YAML 파일 내에서 SQL 쿼리를 생성하는 방법을 정확히 알려줄 수 있습니다. 예를 들어, 사용자 지정 지침을 사용하여 Cortex Analyst 에 성과 또는 회계 연도 가 무엇을 의미하는지 알려줍니다. 이러한 방식으로 사용자 지정 논리 또는 추가 요소를 통합하여 생성된 SQL 의 정확도를 향상시킬 수 있습니다.

보다 세분화된 제어를 위해 SQL 생성 파이프라인에서 개별 모듈에 대한 사용자 지정 지침을 지정할 수도 있습니다. 자세한 내용은 모듈 사용자 지정 지침 섹션을 참조하십시오.

사용자 지정 지침 작동 방식

Cortex Analyst 는 custom_instructions 필드를 의미 체계 모델 YAML 파일에 도입합니다. 이 필드에서는 SQL 생성에 정의 수정 또는 추가 사항을 적용할 수 있습니다.

의미 체계 모델 구문에 대한 자세한 내용은 Cortex Analyst 의미 체계 모델 사양 섹션을 참조하십시오.

예

사용자 지정 지침의 가능한 사용 사례를 살펴보려면 다음 예를 살펴보십시오.

데이터 출력 형식 지정하기

출력의 모든 숫자가 소수점 이하 두 자리로 반올림되었는지 확인합니다.

의미 체계 모델 YAML 파일의 custom_instructions 필드

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

생성된 SQL 쿼리

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

백분율 조정

일관성을 위해 백분율 또는 요율 계산에 100을 자동으로 곱합니다.

의미 체계 모델 YAML 파일의 custom_instructions 필드

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

생성된 SQL 쿼리

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

기본 필터 추가하기

사용자가 필터를 지정하지 않은 경우 필터를 적용합니다(예: 기본값은 최근 연도).

의미 체계 모델 YAML 파일의 custom_instructions 필드

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

생성된 SQL 쿼리

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

열 필터 링크하기

사용자 입력에 따라 관련 열에 추가 필터를 적용합니다.

의미 체계 모델 YAML 파일의 custom_instructions 필드

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

생성된 SQL 쿼리

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

모듈 사용자 지정 지침

의미 체계 모델의 최상위 레벨에 module_custom_instructions 키를 설정하여 SQL 생성 파이프라인의 특정 구성 요소에 대한 사용자 지정 지침을 정의하십시오. 이 기능은 다음과 같은 사용 사례에 유용합니다.

  • SQL 이 생성되기 전에 사용자 질문이 해석되는 방식에 영향을 미치는 논리를 정의합니다

  • 분석가 워크플로의 여러 부분에 대해 보다 정형 별도의 지침을 유지합니다

  • 사용량이 증가함에 따라 기존 custom_instructions 에서 보다 모듈화된 형식으로 변환하십시오

현재 module_custom_instructions 에서 지원하는 구성 요소는 다음과 같습니다.

  • question_categorization: Cortex Analyst 에서 사용자 질문을 분류하는 방법(예: 특정 항목 차단 또는 사용자 동작 안내 등)을 정의합니다.

  • sql_generation: SQL 생성 방법(예: 데이터 형식 및 필터링)을 지정합니다.

이러한 구성 요소 중 하나 또는 둘 모두에 대한 지침은 module_custom_instructions 키에서 설정할 수 있습니다.

중요

다음 예시와 같이 기존 custom_instructions 구성 요소를 sql_generation 구성 요소로 마이그레이션합니다.

기존 사용자 지정 지침 마이그레이션하기

모델에 이미 custom_instructions 필드가 있는 경우 해당 내용을 module_custom_instructions 아래의 sql_generation 필드로 마이그레이션합니다.

이전:

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

이후:

module_custom_instructions:
  sql_generation: |
     "Ensure that all numeric columns are rounded to 2 decimal points."
Copy

특정 항목에 대한 질문 차단하기

question_categorization 구성 요소를 사용하여 특정 항목에 대한 질문을 차단할 수 있습니다. 예를 들어, 사용자에 대한 질문을 차단하려면 다음 지침을 설정할 수 있습니다. 그런 다음 Cortex Analyst 는 관리자에게 문의하라는 메시지와 함께 사용자의 질문을 거부합니다.

module_custom_instructions:
  question_categorization: |
     Reject all questions asking about users. Ask users to contact their admin.
Copy

질문 분류 지침을 사용하여 누락된 세부 정보를 요청할 수도 있습니다. 다음 예제에서 Cortex Analyst 는 사용자에 대해 물어보고 제품 유형을 지정하지 않은 경우 사용자에게 제품 유형을 제공하도록 요청합니다.

module_custom_instructions:
  question_categorization: |
    - If the question asks for users without providing a product_type, consider this question UNCLEAR and ask the user to specify product_type.
Copy

모범 사례

구체적으로 설명하십시오.

예를 들어, “42로 수정된 값을 가진 열 추가” 또는 “X 열에 대한 합계 계산 포함”과 같이 수정 사항을 명확하게 설명합니다

작게 시작하십시오.

더 복잡한 시나리오로 이동하기 전에 정적 열 또는 기본 필터 추가와 같은 간단한 수정부터 시작하십시오.

생성된 SQL 쿼리 미리 보기.

지침이 의도한 대로 적용되고 생성된 SQL 쿼리가 올바른지 확인합니다.

점진적으로 반복합니다.

기능에 익숙해지면 더 복잡한 사용 사례를 실험해 보십시오.

언어: 한국어