PROMPT 함수¶
PROMPT 함수는 템플릿 문자열과 인자 목록을 포함하는 정형 OBJECT 를 생성합니다. 이 오브젝트는 메시지를 동적으로 형식화하거나, 정형 프롬프트를 구성하거나, 추가 처리를 위해 형식화된 데이터를 저장하는 데 유용합니다(예: Cortex AI 함수).
구문¶
SELECT PROMPT('<template_string>', <expr_1> [ , <expr_2>, ... ] )
FROM <table>;
인자¶
필수:
template_string
숫자가 0 이상이고 지정된 식 수보다 적은
{0}
같은 번호가 지정된 자리 표시자가 포함된 문자열입니다. 첫 번째 식은{0}
, 두 번째 식은{1}
등으로 대체됩니다.expr_1 [ , expr_2, ... ]
번호가 매겨진 자리 표시자 대신 값이 템플릿 문자열로 치환되는 식입니다. 열 이름이나 다른 식이 될 수 있습니다. 값은 문자열(예: VARCHAR, NUMBER 등) 또는 FILE 로 변환 가능한 임의의 유형일 수 있습니다.
반환¶
다음 구조를 가진 SQL OBJECT:
{
'template': '<template_string>',
'args': ARRAY(<value_1>, <value_2>, ...)
}
args
배열에는 PROMPT 함수 호출에 지정된 식의 값이 포함됩니다.
사용법 노트¶
PROMPT 는 문자열 형식화 자체는 수행하지 않습니다. Cortex AI 함수에 의해 소비될 오브젝트를 구성하기 위한 것입니다.
템플릿 문자열에 해당 식이 없는 자리 표시자를 사용하는 것은 오류이지만 템플릿 문자열에 사용되지 않는 식이 있는 것은 오류가 아닙니다.
예¶
기본 사용법¶
SELECT PROMPT('Hello, {0}! Today is {1}.', 'Alice', 'Monday');
출력:
{
'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;
자세한 예제는 COMPLETE (SNOWFLAKE.CORTEX) (멀티모달) 섹션을 참조하십시오.