Skip to main content
OpenAI Code Interpreter 为 OpenAI 智能体提供沙箱 Python 环境,用于精确数学运算、数据切片与分析。

它做什么

启用后,智能体可以调用 OpenAI 托管的 python 工具,在临时容器中编写并运行 Python。当你需要语言模型本身无法保证的精确结果时使用它——例如将电子表格行切成精确批次、计算统计量,或转换表格式数据。 重要: Code Interpreter 仅用于计算。可下载文件(PDF、DOCX、XLSX、CSV)仍通过 File Toolswrite_file)创建。智能体应将结果以 CSV/JSON 文本打印出来,然后调用 write_file,以便 Fetch Hive 在你的工作区中保存真实资产。

要求

  • 智能体提供商必须是 OpenAI
  • 该工具默认未启用 — 请从工具选择器中添加。

将工具添加到智能体

  1. 在编辑器中打开一个智能体。
  2. 点击工具提示为 Add MCP Tool or Sub Agent 的按钮。
  3. MCP Tools 中,点击 OpenAI Code Interpreter
v1 没有按工具的设置项。容器使用 OpenAI 默认的 1 GB 内存档位。

与 File Tools 如何配合

典型的电子表格切片流程:
  1. 智能体(或 File Tools 的 read_file)加载源数据。
  2. Code Interpreter 运行 Python 切片或转换数据,并打印 CSV/JSON。
  3. 智能体用该文本调用 write_file,创建可下载的 XLSX/CSV 资产。
在 OpenAI 容器内创建的文件是临时的,不会作为 Fetch Hive 下载项展示。沙箱图片与临时 OpenAI 文件 URL 会从工具活动中脱敏 — 不会显示为下载项。面向用户的文件请始终优先使用 write_file

限制(v1)

  • 仅限 OpenAI — Anthropic 与 xAI 的代码执行工具尚未接入。
  • 无跨轮次 Python 状态 — 每轮智能体对话都会启动新容器;上一轮的变量不会保留。
  • 固定 1 GB 内存 — 更高的 OpenAI 内存档位尚未开放。
  • 每次 Code Interpreter 调用计为 1 个任务积分(与 GPT Search 相同)。容器分钟费用仅作为 completion 上的估算运维元数据(estimated: true)记录 — 不是单独的面向用户的 USD 明细。在托管密钥下,OpenAI 容器分钟由 Fetch Hive 承担。

使用场景

  • 精确行切片(第 1–50、51–100 行……),再导出 XLSX 批次。
  • 必须精确的数值 / 统计计算。
  • 在写入文件前解析或重塑表格式数据。

说明