Ir para o conteúdo principal
Português— Escolher um idioma
Menu

Ativar a Execução de Código na API

Aula 12 de 16 Atualizada a 30 de julho de 2026 Programador
Nesta página
  1. Executar código Python através da API Grok
  2. Identificadores da ferramenta por SDK
  3. Ativação básica
  4. Como o modelo utiliza a Execução de Código
  5. Recomendação de temperatura
  6. Pontos-chave

Executar código Python através da API Grok

A Execução de Código permite ao modelo escrever e executar código Python em tempo real num ambiente seguro e isolado (sandbox). Em vez de simplesmente gerar código para que o execute, o modelo executa-o diretamente e devolve os resultados. É uma ferramenta poderosa para cálculos, análise de dados e validação de código.

🐍
Python em Sandbox
NumPy
Pandas, SciPy...
🔒
Isolado e seguro
$5
/ 1.000 chamadas

Identificadores da ferramenta por SDK

O identificador da ferramenta varia consoante o SDK que utilizar:

SDKIdentificador
xAI SDKcode_execution
OpenAI Responses APIcode_interpreter
Vercel AI SDKxai.tools.codeExecution()

Esta diferença de nomenclatura é importante. Utilize o identificador correspondente ao seu SDK para evitar erros.

Ativação básica

cURL / JSON direto

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Calculate the sum of the first 1,000 prime numbers",
  "tools": [
    {"type": "code_interpreter"}
  ]
}

xAI SDK (Python)

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Calculate the sum of the first 1,000 prime numbers",
    tools=[client.tools.code_execution()]
)

print(response.output_text)

OpenAI SDK (Python)

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Calculate the sum of the first 1,000 prime numbers",
    tools=[{"type": "code_interpreter"}]
)

Vercel AI SDK (JavaScript)

const response = await generateText({
  model: xai("grok-4.20-0309-reasoning"),
  prompt: "Calculate the sum of the first 1,000 prime numbers",
  tools: [xai.tools.codeExecution()]
});

Como o modelo utiliza a Execução de Código

Quando a Execução de Código está ativada, o processo funciona da seguinte forma:

  1. O modelo analisa o pedido e determina que é necessário um cálculo ou uma análise de dados
  2. Escreve código Python adequado ao problema
  3. O código é executado na sandbox Python da xAI
  4. O modelo recebe os resultados da execução (saída padrão, eventuais erros)
  5. Formula a sua resposta incorporando os resultados

Se o código gerar um erro, o modelo pode corrigi-lo automaticamente e executá-lo novamente, o que pode gerar várias invocações para um único pedido.

Recomendação de temperatura

Para cálculos matemáticos e análise de dados, a xAI recomenda utilizar valores de temperatura baixos (0,0 a 0,3). Uma temperatura baixa reduz a variabilidade na geração de código e produz resultados mais reproduzíveis.

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Calculate the Sharpe ratio for this portfolio...",
    tools=[client.tools.code_execution()],
    temperature=0.1
)

Pontos-chave

  • A Execução de Código permite a execução de Python em tempo real numa sandbox segura
  • O identificador varia consoante o SDK: code_execution (xAI), code_interpreter (OpenAI)
  • O modelo escreve, executa e interpreta o código automaticamente
  • Utilize grok-4.20-0309-reasoning e uma temperatura baixa para cálculos
  • O custo é de $0,005 por execução, sendo possíveis múltiplas invocações