- 类别：
/sql-reference/functions-string`（AI 函数）、:doc:/sql-reference/functions-file`（AI 函数）
AI_COMPLETE¶
备注
AI_COMPLETE 是 COMPLETE (SNOWFLAKE.CORTEX) 的更新版本。要获得最新功能，请使用 AI_COMPLETE。
使用支持的语言模型从文本或图像生成响应（补全）。您可以提供：
文本提示，用于根据模型生成响应。有关更多信息，请参阅 AI_COMPLETE（单字符串）。
单个图像和文本提示，用于根据图像和提示生成响应。有关更多信息，请参阅 AI_COMPLETE（单张图像）。
可以支持多个图像和文本的提示对象。有关更多信息，请参阅 AI_COMPLETE（提示对象）。
语法¶
该函数的语法取决于您提供的输入类型。有关语法的信息，请参阅以下部分：
所有语法变体都接受可选的 return_error_details BOOLEAN 实参作为最终参数。当设置为 TRUE 时，该函数返回一个 OBJECT，其中包含值和错误消息，二者之一为 NULL，具体取决于函数是成功还是失败。请参阅 错误行为 了解详细信息。
错误行为¶
默认情况下，如果 AI_COMPLETE 无法处理输入，函数将返回 NULL。如果查询处理了多行数据，出现错误的行将返回 NULL，并且不会阻止查询完成。
出错时的返回值取决于 return_error_details 实参。下表显示了基于 return_error_details 实参的返回值：
return_error_details返回值
描述
NULL
TRUE
包含
value和error字段的 OBJECTvalue：选择使用 时默认使用的角色和仓库。完成响应（类型与正常返回值相同），如果发生错误则返回 NULL。error：选择使用 时默认使用的角色和仓库。包含错误消息（如果发生错误）的 VARCHAR 值，或者如果函数成功，则返回 NULL。
有关 AI 函数错误处理的更多信息，请参阅 Snowflake Cortex AI Function: Multirow error handling improvements。
访问控制要求¶
用户必须使用已被授予 SNOWFLAKE.CORTEX_USER 数据库角色 的角色。有关此权限的更多信息，请参阅 Cortex LLM privileges。
法律声明¶
有关法律声明，请参阅 Snowflake AI 和 ML。
限制¶
Snowflake Cortex 函数不支持动态表。