Ativar a Execução de Código na API
Nesta página
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.
Identificadores da ferramenta por SDK
O identificador da ferramenta varia consoante o SDK que utilizar:
| SDK | Identificador |
|---|---|
| xAI SDK | code_execution |
| OpenAI Responses API | code_interpreter |
| Vercel AI SDK | xai.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:
- O modelo analisa o pedido e determina que é necessário um cálculo ou uma análise de dados
- Escreve código Python adequado ao problema
- O código é executado na sandbox Python da xAI
- O modelo recebe os resultados da execução (saída padrão, eventuais erros)
- 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-reasoninge uma temperatura baixa para cálculos - O custo é de $0,005 por execução, sendo possíveis múltiplas invocações