2026 年，智能体将在企业级应用中取得哪些实质性突破？点击下载《2026 年 AI 与数据发展预测》白皮书，获悉专家一手前瞻，抢先拥抱新的工作方式！

上个月，我发现自己需要在四个不同工具之间来回切换，才能调试一个无法正常运行的 dbt 模型：用 Snowsight 探索 SQL、在 VS Code 中修改代码、在终端执行 dbt 命令，还得同时查阅文档确认语法。当 Cortex Code 进入公开预览阶段后，我意识到可以将这套流程中的大部分工作收拢到一个对话式交互界面中。本指南将帮助你在自己的环境中完成 Cortex Code 的部署。

你将了解以下内容：

• 在 Snowflake 账户中启用 Cortex Code；

• Cortex Code 的成本监控；

• 何时使用 Snowsight 中的 Cortex Code，何时使用 Cortex Code CLI。

什么是 Cortex Code？

Cortex Code 是一个内置于 Snowflake 的 AI 驱动型智能体，专为数据工程、数据分析及机器学习任务设计。其所有操作均在您现有的 RBAC 权限体系内执行。

注意：由于 Cortex Code 目前处于公开预览阶段，正式发布时部分功能可能会有所调整。

先决条件

• 商业版 Snowflake 账户（非 Gov/VPS/Sovereign 区域）；

• 拥有 ACCOUNTADMIN 角色（用于执行初始配置）；

• 已启用跨区域推理。

术语表

• 跨区域推理：指将 AI 请求路由至模型实际部署所在区域的能力；

• AGENTS.md：用于为 Cortex Code 设置持久化指令行为的配置文件；

• 差异视图：在应用 AI 建议的更改前，用于进行可视化对比的功能。

设置

第 1 步：启用跨区域推理

 — Choose one (AWS_US recommended for Claude Sonnet 4+)ALTER ACCOUNT SET CORTEX_ENABLED_CROSS_REGION = ‘AWS_US’; — OR: ‘AWS_EU’, ‘AWS_APJ’, ‘ANY_REGION’

跨区域注意事项：

第 2 步：授予数据库角色

GRANT DATABASE ROLE SNOWFLAKE.COPILOT_USER TO ROLE <your_role>;GRANT DATABASE ROLE SNOWFLAKE.CORTEX_AGENT_USER TO ROLE <your_role>;

第 3 步：验证

打开 Snowsight → 查找右下角的 Cortex Code 图标

最佳实践

• 使用完全限定名称：DATABASE.SCHEMA.TABLE；

• 应用更改前检查差异；

• 通过 SNOWFLAKE.ACCOUNT_USAGE.CORTEX_AGENT_USAGE_HISTORY 监控成本；

• 模型选择：Opus 4.5（最高质量）与 Sonnet 4.x（均衡型）对比。

入门指引

• Snowsight 中的 Cortex Code：项目→ 工作区 → 单击 Cortex Code 图标；

• Cortex Code CLI：pip install snowflake-cli 然后执行 snow cortex-code。

成本监控：

https://gist.github.com/parshuanantharam/a277af9995cd3b4adc1239b2c9174852

在以下场景中使用 Cortex Code（Snowsight 内）：

• 数据探索：快速模式发现、数据画像分析；

• 编写即席 SQL：需立即执行的一次性查询；

• 账户管理：配额（Credit）监控、治理策略、用户访问权限控制；

• Notebook 开发：探索性数据分析（EDA）、可视化呈现、机器学习原型验证；

• 学习 Snowflake：文档问答、语法辅助提示；

• 团队演示：可视化差异对比、可共享的工作区上下文。

在以下开发/构建场景中使用 Cortex Code CLI：

• 本地开发：涉及 VS Code、Cursor 或终端中的文件操作；

• dbt 项目：跨代码仓库的模型编写、测试及文档维护；

• Streamlit 应用：构建和迭代本地的 .py 文件；

• Git 工作流：与 Snowflake 操作并行的提交、分支管理、拉取请求（PR）；

• CI/CD 集成：脚本化自动化任务、批量操作；

• 多连接管理：在 Snowflake 账户与角色间快速切换；

• 自定义智能体：针对团队特定工作流的 AGENTS.md 配置、技能扩展、钩子（Hooks）开发；

• 敏感环境部署：操作系统级沙箱隔离、审批流程系统。

混合工作流（推荐）：

经验法则：在 Snowsight 内的 Cortex Code 中开始探索与分析；当需要本地文件持久化存储或 Git 集成时，迁移至 Cortex Code CLI。

相关资源：

Cortex Code in Snowsight

Cortex Code CLI

跨区域推理

原文地址：https://medium.com/snowflake/getting-started-with-cortex-code-a-data-engineers-guide-b79811c44969

点击链接立即报名注册：Ascent - Snowflake Platform Training - China，更多 Snowflake 精彩活动请关注专区。