PROMPT¶

구문¶

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 함수에 의해 소비될 오브젝트를 구성하기 위한 것입니다.

• It is an error to use a placeholder in the template string that does not have a corresponding expression, but it is not an error to provide expressions that are not used in the template string.

예¶

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

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

WITH reviews AS (
    SELECT 'Wow... Loved this place.' AS review, 5 AS rating
    UNION ALL
    SELECT 'Crust is not good.', 2 AS rating
)
SELECT * FROM reviews
WHERE AI_FILTER(PROMPT('The reviewer enjoyed the restaurant: {0}, Rating: {1}', review, rating));

AI_COMPLETE('claude-4-sonnet',
    PROMPT('Classify the input image {0} in no more than 2 words. Respond in JSON', img_file)) AS image_classification
FROM image_table;