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, ... ]

表达式的值最终被替换为模板字符串，以代替编号占位符。这些可以是列名或其他表达式。值可以是可强制转换为字符串或 FILE 的任何类型（例如，VARCHAR、NUMBER 等）。

返回

具有以下结构的 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 列结合使用

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;
Copy

有关更多示例，请参阅 AI_COMPLETE（提示对象）。

语言: 中文