类别：: 字符串和二进制函数 (AI Functions)

AI_FILTER¶

将自由格式的提示输入分类为布尔值。目前支持文本和图像筛选。

区域可用性¶

下表显示了可以在其中使用 AI_FILTER 函数来处理文本和图像的区域：

数据类型	AWS US 西部 2 （俄勒冈）	AWS US 东部 1 （弗吉尼亚北部）	AWS 欧洲中部 1 （法兰克福）	AWS 欧洲西部 1 （爱尔兰）	AWS AP 东南部 2 （悉尼）	AWS AP 东北部 1 （东京）	Azure 东部 US 2 （弗吉尼亚）	Azure 西欧（荷兰）	AWS （跨区域）
TEXT	✔	✔	✔	✔	✔	✔	✔	✔	✔
IMAGE	✔	✔	✔						✔

语法¶

将 AI_FILTER 应用于输入字符串：

AI_FILTER( <input> )

Copy

将 AI_FILTER 应用于单张图像：

AI_FILTER( <predicate> , <input> )

Copy

将 AI_FILTER 应用于包含文本和图像的多列，利用 PROMPT：

AI_FILTER( PROMPT('<template_string>',  <col_1>, … ) )

Copy

实参¶

必填：

如果您要指定输入字符串：

input: 包含要分类的文本的字符串。

如果您要筛选一个文件：

predicate: 一个字符串，其中包含将文件输入分类为 TRUE 或 FALSE 的指令。
file: 根据 predicate 中指定的指令对文件进行分类的列。您可以用 IMAGE FILE 作为 AI_FILTER 函数的输入。

如果您使用 PROMPT() 函数来格式化输入：

对于更复杂的提示，尤其是具有多个文件列的提示，您可以使用 PROMPT 来帮助创建 input。

PROMPT() 函数支持跨字符串和 FILE 数据类型进行格式化。有关详细用法，请参阅示例。

返回¶

返回一个布尔值，表示语句对指定文本的计算结果是 TRUE 还是 FALSE。

访问控制要求¶

用户必须使用已被授予 SNOWFLAKE.CORTEX_USER 数据库角色的角色。有关此权限的更多信息，请参阅所需权限。

性能和成本优化¶

默认情况下，AI_FILTER 会对符合条件的查询应用内置的性能优化。该优化可使性能提升 2 到 10 倍，使令牌使用量最多降低 60%，同时对质量的影响极小。

当查询引擎检测到合适的模式时，此优化会自动触发。与其他查询优化类似，Snowflake 不保证此优化将应用于每个查询。该引擎利用自适应路由和上下文感知重写，在可能的情况下执行更高效的 AI 操作。

要为您的账户禁用此优化，请联系您的客户经理。

使用说明¶

为了获得最佳性能，请遵循以下指导原则：

确保发送到 AI_FILTER 的列不包含 NULL 值。
使用英语纯文本作为输入字符串或 PROMPT() 实参。
请提供输入文本说明的详细信息。例如，不使用“听起来很满意”之类的陈述，而是使用“在以下支持记录中，客户听起来很满意”。
考虑以问题的形式来表述输入内容。例如，“在以下支持记录中，客户听起来满意吗？”

示例¶

AI_FILTER：文本¶

可以作为字符串常量的简单标量布尔函数来调用。

SELECT AI_FILTER('Is Canada in North America?');

Copy

TRUE

您可以使用 CONCAT、|| 文本列指令来使用此功能：

WITH reviews AS (
            SELECT 'Wow... Loved this place.' AS review
  UNION ALL SELECT 'The pizza is not good.'
)
SELECT * FROM reviews
WHERE AI_FILTER(CONCAT('The reviewer enjoyed the restaurant: ', review));

Copy

为了更轻松地跨多列进行模板格式化，Snowflake 提供 PROMPT；例如：

WITH reviews AS (

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

Copy

+--------------------------+
| REVIEW                   |
|--------------------------+
| Wow... Loved this place. |
+--------------------------+

在评估 AI_FILTER 的质量时，跨列比较候选谓词会很有帮助。

WITH country AS (
          SELECT 'Switzerland' AS country,
UNION ALL SELECT 'Korea'
),
region AS (
            SELECT 'Asia' AS region,
  UNION ALL SELECT 'Europe'
)
SELECT country,
      region,
      AI_FILTER(PROMPT('{0} is in {1}', country, region)) AS result
FROM country CROSS JOIN region ;

Copy

+-------------+-------+--------+
| COUNTRY     |REGION | RESULT |
|-------------+-------+--------+
| Switzerland |Europe | TRUE   |
|-------------+-------+--------+
| Switzerland | Asia  | FALSE  |
|-------------+-------+--------+
| Korea       |Europe | FALSE  |
+-------------+-------+--------+
| Korea       | Asia  | TRUE   |
+-------------+-------+--------+

使用带 JOIN 的 AI_FILTER¶

您可以使用带有 JOIN 的 AI_FILTER 来表达链接两个表，并使用自然语言提示，让 AI 可以进行推理。

以下示例使用带有 AI_FILTER 函数的提示将 RESUMES 表与 JOBS 表联接。

SELECT *
FROM RESUMES
JOIN JOBS
ON AI_FILTER(PROMPT('Evaluate if this resume {0} fits this job description {1}', RESUME.contents, JOBS.jd));

Copy

AI_FILTER：图像¶

以下示例根据指令筛选图像文件。

通过提供指令谓词和图像文件列来筛选图像：

WITH pictures AS (
  SELECT
      TO_FILE(file_url) AS img
  FROM DIRECTORY(@file_stage)
)
SELECT
FL_GET_RELATIVE_PATH(img) AS file_path FROM pictures
WHERE AI_FILTER('Is this a picture of a cat?', img);

Copy

WITH pictures AS (
  SELECT
      TO_FILE(file_url) AS img
  FROM DIRECTORY(@file_stage)
)
SELECT
    FL_GET_RELATIVE_PATH(img) AS file_path FROM pictures
WHERE AI_FILTER(PROMPT('{0} is a cat picture', img));

Copy

+--------------------------+
|        FILE_PATH         |
|--------------------------+
|        2cats.jpg         |
+--------------------------+
|        cat1.png          |
+--------------------------+
|      orange_cat.jpg      |
+--------------------------+

限制¶

Snowflake AI 函数不支持动态表增量刷新。
Snowflake AI 函数不适用于通过以下暂存区类型的暂存区文件创建的 FILEs：
- 具有加密模式 TYPE = 'SNOWFLAKE_FULL' 的内部暂存区
- 使用任何客户端加密模式的外部暂存区：
  - TYPE = 'AWS_CSE'
  - TYPE = 'AZURE_CSE'
- 用户暂存区、表暂存区
- 带有双引号名称的暂存区