Pular para o conteúdo principal

​
Code Execution

code_execution executa análise remota em Python com sandbox na Responses API da xAI. Isso é diferente de exec local:
  • exec executa comandos de shell na sua máquina ou nó
  • code_execution executa Python no sandbox remoto da xAI
Use code_execution para:
  • cálculos
  • tabulação
  • estatísticas rápidas
  • análise no estilo de gráficos
  • análise de dados retornados por x_search ou web_search
Não o use quando você precisar de arquivos locais, do seu shell, do seu repositório ou de dispositivos pareados. Use exec para isso.

​
Configuração

Você precisa de uma chave de API da xAI. Qualquer uma destas funciona:
  • XAI_API_KEY
  • plugins.entries.xai.config.webSearch.apiKey
Exemplo: 
{
  plugins: {
    entries: {
      xai: {
        config: {
          webSearch: {
            apiKey: "xai-...",
          },
          codeExecution: {
            enabled: true,
            model: "grok-4-1-fast",
            maxTurns: 2,
            timeoutSeconds: 30,
          },
        },
      },
    },
  },
}

​
Como usá-lo

Pergunte naturalmente e deixe explícita a intenção de análise: 
Use code_execution to calculate the 7-day moving average for these numbers: ...

Use x_search to find posts mentioning OpenClaw this week, then use code_execution to count them by day.

Use web_search to gather the latest AI benchmark numbers, then use code_execution to compare percent changes.
A ferramenta recebe internamente um único parâmetro task, então o agente deve enviar a solicitação completa de análise e quaisquer dados inline em um único prompt.

​
Limites

  • Esta é uma execução remota da xAI, não execução local de processo.
  • Ela deve ser tratada como análise efêmera, não como um notebook persistente.
  • Não presuma acesso a arquivos locais nem ao seu workspace.
  • Para dados recentes do X, use x_search primeiro.

​
Veja também