# Snowflake Cortex Agents 的 Python 执行功能正式全面可用

https://jsonscraper.com/zh/blog/snowflake-cortex-agents-python-generally-available

Author: Michael Johnson

Published: 2026-10-08T04:52:12+00:00

Updated: 2026-10-08T04:52:12+00:00

智能体可以在沙箱中处理查询结果并生成图表。SQL 在沙箱外单独执行，结果文件保存在工作空间中。

2026 年 10 月 5 日，Snowflake [宣布全面开放](https://docs.snowflake.com/en/release-notes/2026/other/2026-10-05-cortex-agents-code-execution-tool-ga) Cortex Agents 内置代码执行工具。该工具让智能体能够在对话过程中运行脚本，进行数据处理、计算和可视化。



![Snowflake Cortex Agents 的 Python 执行功能正式全面可用
背景：2026 年 10 月 5 日，Snowflake 宣布 Cortex Agents 的代码执行工具正式全面可用。本文梳理 SQL 查询、Python 计算和结果保存之间的关系，以及启用该工具时需要注意的限制。
视觉主题：site:snowflake.com Cortex Agent 代码执行 Snowsight 截图](https://jsonscraper.com/assets/uploads/journal/2026/10/7c75c0742257ab8ca24e710ebca07f39.png.hero.webp)

OpenAI · AI 生成图像

 

## 10 月 5 日发生了什么变化

 

变化在于现有工具的发布状态：Snowflake 将其从预览阶段转为正式全面可用，即 GA。单独的[预览版发布记录](https://docs.snowflake.com/en/release-notes/2026/other/2026-08-20-cortex-agents-code-execution-tool-preview)日期为 2026 年 8 月 20 日。10 月的消息意味着预览阶段已经结束。

 

根据[工具配置说明](https://docs.snowflake.com/en/user-guide/snowflake-cortex/cortex-agents-code-execution-tool)，代码执行功能通过智能体规范接入。智能体根据用户请求决定何时创建并运行代码。该工具还可以执行智能体技能中的 Python 脚本；这些技能是针对特定任务接入的指令和资源。

 

## 智能体如何获取数据并执行计算

 

在[专门的工具文档](https://docs.snowflake.com/en/user-guide/snowflake-cortex/cortex-agents-code-execution-tool)中，`code_execution` 被描述为在隔离沙箱中执行 Python。SQL 工具在沙箱外查询 Snowflake 数据，随后由 Python 处理获取的结果。沙箱可以访问传入会话的数据和已连接的工作空间。

 

在整体的 [Cortex Agents 架构](https://docs.snowflake.com/en/user-guide/snowflake-cortex/cortex-agents)中，不同工具负责不同工作阶段。Cortex Analyst 用于结构化数据，Cortex Search 用于文档搜索，而代码执行提供程序化处理能力。按照 Snowflake 的描述，托管编排使智能体能够规划工作、调用工具并生成回答。

 

这一架构对应着分析助手的一种实际使用场景：在一次对话中获取数据集、执行计算并准备图表。设计这类场景时，宜分别明确原始数据集、计算公式和结果验证方式。这能为团队提供清晰的阶段，便于开展可复现测试。

 

阅读访问权限建议时，应注意时间顺序。2026 年 6 月 15 日更新、编辑部于 10 月 8 日核查的[最佳实践指南](https://www.snowflake.com/en/developers/guides/best-practices-to-building-cortex-agents/)提到继承智能体所有者角色的权限，并建议将结果保存到表中。该页面明确指出，材料不会持续维护，可能已经过时。较晚发布的[8 月 20 日预览版记录](https://docs.snowflake.com/en/release-notes/2026/other/2026-08-20-cortex-agents-code-execution-tool-preview)已规定具体规则：SQL 在沙箱外执行，文件保存在已连接的工作空间中，且以 `owner’s rights` 调用时不支持代码执行。现行的专门工具文档也列出了这些条件。



![二进制源代码——HTML、PHP、Java 程序代码——网页设计](https://images.unsplash.com/photo-1610466896927-699424f3c86d?ixid=M3wxMDc5MjYxfDB8MXxhbGx8fHx8fHx8fHwxNzkxNDM0Njc4fA&ixlib=rb-4.1.0&w=1600&h=900&fit=crop&crop=center&q=80&fm=webp)

[Markus Spiske](https://unsplash.com/@markusspiske?utm_source=jsonscraper&utm_medium=referral) · [Unsplash 许可协议](https://unsplash.com/license)

 

## 计算之间会保留哪些内容

 

根据[工作空间规则](https://docs.snowflake.com/en/user-guide/snowflake-cortex/cortex-agents-code-execution-tool)，写入其中的文件在沙箱停止后仍会保留。变量和已导入的模块在不同次执行之间可能丢失。后续步骤所需的结果应写入文件。

 

早在[8 月预览阶段](https://docs.snowflake.com/en/release-notes/2026/other/2026-08-20-cortex-agents-code-execution-tool-preview)，Snowflake 就列出了预装的数据处理和绘图库，包括 pandas、NumPy、matplotlib 和 Plotly。额外的软件包通过 Artifact Repository 接入。准备实际工作场景时，应提前确定其依赖项及中间结果的传递方式。

 

## 启用时需要注意哪些条件

 

[现行文档](https://docs.snowflake.com/en/user-guide/snowflake-cortex/cortex-agents-code-execution-tool)对以所有者权限，即 `owner’s rights` 发起的调用规定了限制。从此类存储过程调用智能体时，代码执行工具会从请求中移除，沙箱不会创建，响应中会包含警告。要执行代码，必须使用调用者权限，即 `caller’s rights` 发起调用。

 

带日期的发布记录确认了 GA 状态。在具体账户中启用前，团队需要核实区域可用性、执行计费、资源限制和支持条件，因为[10 月公告](https://docs.snowflake.com/en/release-notes/2026/other/2026-10-05-cortex-agents-code-execution-tool-ga)没有列出这些参数。

 

## 哪些团队适合使用内置 Python

 

该工具主要适合在 Snowflake 内构建分析助手的团队。其实际作用是在同一个智能体流程中，将数据获取与程序化计算、可视化衔接起来。[Cortex Agents 概述](https://docs.snowflake.com/en/user-guide/snowflake-cortex/cortex-agents)中描述的工具能够结合结构化数据处理与文档搜索，而 Python 则增加了计算环节。

 

实施时有三个关键决策：由哪个工具获取原始数据集、以什么权限调用智能体，以及将结果保存在何处。应通过一个预先已知答案的小型可复现任务来验证这些决策，例如基于固定数据集计算某项指标并生成相应图表。
