首页/工具/代码执行

代码执行

代码执行工具让 Grok 在沙盒环境中运行 Python 代码,进行数学计算、数据分析等。

工具名称:code_execution / code_interpreter

费用:$5 / 1K 次调用

代码执行工具让模型能够在安全的沙盒环境中编写和运行 Python 代码。 这对于需要精确计算、数据处理或复杂逻辑的任务特别有用 — 模型不需要"心算",而是通过执行实际代码获得准确结果。

基本用法

Python (OpenAI)
from openai import OpenAI

client = OpenAI(api_key=os.getenv("XAI_API_KEY"), base_url="https://api.x.ai/v1")

response = client.responses.create(
    model="grok-4.5",
    input="计算斐波那契数列前 100 项的和",
    tools=[{"type": "code_execution"}],
)

print(response.output_text)

注意:在 gRPC API(Python xAI SDK)中,code_interpreter 不受支持。 请使用 Responses API 或 code_execution 工具名称。

适用场景

  • 数学计算 — 复杂数学公式、统计分析、数值计算
  • 数据处理 — 数据清洗、转换、聚合
  • 算法验证 — 运行算法代码验证结果
  • 文件处理 — 处理上传的 CSV、JSON 等文件
  • 可视化 — 生成图表和可视化(结果以图像返回)

沙盒环境

代码在隔离的沙盒环境中执行,具有以下特性:

  • Python 运行时环境
  • 预装常用科学计算库(如 NumPy、Pandas 等)
  • 无网络访问 — 代码无法访问外部网络
  • 执行时间和资源有限制
  • 每次调用独立 — 不保留之前执行的状态