Skip to main content
code_execution executa análises remotas em Python em sandbox na Responses API da xAI (https://api.x.ai/v1/responses, o mesmo endpoint usado por x_search). Ele é registrado pelo plugin xai incluído, conforme o contrato tools.
code_execution é executado nos servidores da xAI. A xAI cobra US$ 5 por 1.000 chamadas de ferramenta, além dos tokens de entrada e saída do modelo.
Use-o para cálculos, tabulação, estatísticas rápidas e análises no estilo de gráficos, inclusive com dados retornados por x_search ou web_search. Ele não tem acesso a arquivos locais, ao seu shell, ao seu repositório nem a dispositivos pareados, e não mantém estado entre chamadas; portanto, trate cada chamada como uma análise efêmera, e não como uma sessão de notebook. Para obter dados recentes do X, execute primeiro x_search e encaminhe o resultado. Para execução local, use exec.

​
Configuração

1

Forneça as credenciais da xAI

O OAuth exige uma assinatura elegível do SuperGrok ou X Premium (verificação por código de dispositivo, portanto funciona em hosts remotos sem um callback de localhost):
Durante uma nova instalação, a mesma opção está disponível na integração inicial:
Ou use uma chave de API:
Ou pela configuração:
Qualquer uma dessas três opções também habilita x_search e o web_search do Grok.
2

Ative e ajuste code_execution

Quando enabled é omitido, code_execution só é disponibilizado quando o provedor do modelo ativo é xai e as credenciais da xAI são encontradas. Para um modelo ativo com um provedor conhecido que não seja da xAI, defina plugins.entries.xai.config.codeExecution.enabled como true para aceitar o uso entre provedores. Se o provedor do modelo ativo estiver ausente ou não puder ser resolvido, a ferramenta permanecerá oculta. Defina enabled como false para desativá-la para todos os provedores. As credenciais da xAI são sempre obrigatórias.Use o mesmo bloco para substituir o modelo, o limite de turnos ou o tempo limite:
3

Reinicie o Gateway

code_execution aparecerá na lista de ferramentas do agente quando o plugin da xAI for registrado novamente e as verificações de provedor, ativação e autenticação acima forem aprovadas.

​
Como usar

Explicite a finalidade da análise; a ferramenta recebe um único parâmetro task, portanto envie a solicitação completa e todos os dados em linha em um único prompt:

​
Erros

Sem autenticação, a ferramenta retorna um erro JSON estruturado (em vez de lançar uma exceção), permitindo que o agente faça a autocorreção:

​
Relacionados

Ferramenta Exec

Execução local de shell na sua máquina ou em um Node pareado.

Aprovações do Exec

Política de permissão/negação para execução de shell.

Ferramentas web

web_search, x_search e web_fetch.

Provedor xAI

Modelos Grok, pesquisa na web/no X e configuração da execução de código.