参考

本页提供有关使用 Snowflake Intelligence 的参考信息。本文档涵盖了以下概念：

  • 可用于创建、管理 Cortex Agent 并与之交互的 REST API 端点和SQL 命令

  • 支持的 AI 模型及其区域可用性

  • 有关模型使用和数据分类的法律声明

SQL 命令和 API 参考

Snowflake 提供以下编程方法来创建 Cortex Agent 并与之交互，以便与 Snowflake Intelligence 一起使用：

Cortex Agent 对象 REST API

Cortex Agent 对象 REST API 提供了一整套端点，用于构建与 Snowflake Intelligence 集成的 AI 应用程序。您可以使用 REST API 管理代理对象并协调与数据的交互。

代理管理操作

代理对象 REST API 支持以下用于管理 Cortex Agent 对象的操作：

操作

端点

描述

创建

POST /api/v2/databases/{database}/schemas/{schema}/agents

创建具有指定属性和工具配置的新 Cortex Agent。

描述

GET /api/v2/databases/{database}/schemas/{schema}/agents/{name}

检索现有代理的配置和元数据。

更新

PUT /api/v2/databases/{database}/schemas/{schema}/agents/{name}

修改现有代理的配置、工具或说明。

列表

GET /api/v2/databases/{database}/schemas/{schema}/agents

列出指定数据库和架构中的所有代理，并提供筛选选项。

删除

DELETE /api/v2/databases/{database}/schemas/{schema}/agents/{name}

从您的账户中移除代理。

有关详细的 API 规格（包括请求参数、响应架构和示例），请参阅 Cortex Agents REST API。

代理 SQL 命令

Snowflake 提供 SQL 命令，用于创建和管理 Cortex Agent 对象，以便在 Snowflake Intelligence 中使用。

代理管理命令

以下 SQL 命令可用于管理 Cortex Agent：

命令

描述

CREATE AGENT

创建一个新的 Cortex Agent，或使用指定的属性、配置文件设置及 YAML 规范替换已有的 Cortex Agent。

DESCRIBE AGENT

检索现有代理的完整配置、规范和元数据。

SHOW AGENTS

列出您具有访问权限的所有 Cortex Agent，并提供筛选和分页选项。

DROP AGENT

从当前或指定的架构中移除代理。

有关详细的 SQL 语法、参数和示例，请参阅 Cortex Agent 命令。

支持的模型和区域

Snowflake Intelligence 支持 模型 中列出的模型。只要账户有权访问这些模型，您就可以使用它们。有关更多信息，请参阅 控制模型访问。

创建代理时，我们建议选择 Auto 作为模型。这样，Snowflake Intelligence 就能自动为您的账户选择最高质量的模型，并在有新模型可用时自动改进。

在默认模式下，当传入的问题与已验证查询高度相似时，Snowflake Intelligence 会使用 Arctic Text2SQL R1.5，在不使用扩展思考的情况下更快地回答问题。这有助于降低已验证查询库中已有已验证 SQL 的常见问题的响应延迟。

虽然列出的模型可能并非在 所有区域 都可用，但您可以借助 Cortex 跨区域推理在任何云或区域中使用 Snowflake Intelligence。这包括模型不可用的云和区域。有关配置 Cortex 跨区域推理的更多信息，请参阅 跨区域推理。

  • AWS US - 在 AWS 中，Claude 4+ 提供最高的质量和最佳速度性能。我们建议您为 aws_us 设置 Cortex 跨区域推理，以便使用 Claude 4 并获得最佳性能。如果没有 Cortex 跨区域推理，则只能在 aws_us 中使用 Claude 3.5。

  • Azure US - 如果您在 East US 中使用 Snowflake Intelligence，则可以在不使用 Cortex 跨区域推理的情况下使用 GPT 4.1+。其他区域和模型组合需要为 azure_us 设置 Cortex 跨区域推理。

  • AWS EU - 只要您为 aws_eu 配置了 Cortex 跨区域推理，就可以在该区域使用 Claude 4+。

  • AWS APJ - 只要您为 aws_apj 配置了 Cortex 跨区域推理，就可以在该区域使用 Claude 4+。