PROMPT 함수

PROMPT 함수는 템플릿 문자열과 인자 목록을 포함하는 정형 OBJECT 를 생성합니다. 이 오브젝트는 메시지를 동적으로 형식화하거나, 정형 프롬프트를 구성하거나, 추가 처리를 위해 형식화된 데이터를 저장하는 데 유용합니다(예: Cortex AI 함수).

구문

SELECT PROMPT('<template_string>', <expr_1> [ , <expr_2>, ... ] )
    FROM <table>;
Copy

인자

필수:

template_string

숫자가 0 이상이고 지정된 식 수보다 적은 {0} 같은 번호가 지정된 자리 표시자가 포함된 문자열입니다. 첫 번째 식은 {0}, 두 번째 식은 {1} 등으로 대체됩니다.

expr_1 [ , expr_2, ... ]

번호가 매겨진 자리 표시자 대신 값이 템플릿 문자열로 치환되는 식입니다. 열 이름이나 다른 식이 될 수 있습니다. 값은 문자열(예: VARCHAR, NUMBER 등) 또는 FILE 로 변환 가능한 임의의 유형일 수 있습니다.

반환

다음 구조를 가진 SQL OBJECT:

{
  'template': '<template_string>',
  'args': ARRAY(<value_1>, <value_2>, ...)
}
Copy

args 배열에는 PROMPT 함수 호출에 지정된 식의 값이 포함됩니다.

사용법 노트

  • PROMPT 는 문자열 형식화 자체는 수행하지 않습니다. Cortex AI 함수에 의해 소비될 오브젝트를 구성하기 위한 것입니다.

  • 템플릿 문자열에 해당 식이 없는 자리 표시자를 사용하는 것은 오류이지만 템플릿 문자열에 사용되지 않는 식이 있는 것은 오류가 아닙니다.

기본 사용법

SELECT PROMPT('Hello, {0}! Today is {1}.', 'Alice', 'Monday');
Copy

출력:

{
    'template': 'Hello, {0}! Today is {1}.',
    'args': ['Alice', 'Monday']
}

Cortex COMPLETE 및 FILE 열과 함께 사용

SNOWFLAKE.CORTEX.COMPLETE('claude-3-5-sonnet',
    PROMPT('Classify the input image {0} in no more than 2 words. Respond in JSON', img_file)) AS image_classification
FROM image_table;
Copy

자세한 예제는 COMPLETE (SNOWFLAKE.CORTEX) (멀티모달) 섹션을 참조하십시오.