Skip to main content
code_execution esegue analisi Python remote in sandbox tramite l’API Responses di xAI (https://api.x.ai/v1/responses, lo stesso endpoint usato da x_search). Viene registrato dal plugin xai incluso tramite il contratto tools.
code_execution viene eseguito sui server di xAI. xAI addebita 5 USD ogni 1.000 chiamate allo strumento, oltre ai token di input e output del modello.
Usalo per calcoli, tabulazioni, statistiche rapide e analisi in stile grafico, inclusi i dati restituiti da x_search o web_search. Non ha accesso ai file locali, alla shell, al repository o ai dispositivi associati e non mantiene lo stato tra le chiamate; considera quindi ogni chiamata un’analisi temporanea, non una sessione di notebook. Per dati X aggiornati, esegui prima x_search e passa il risultato come input. Per l’esecuzione locale, usa invece exec.

​
Configurazione

1

Fornisci le credenziali xAI

OAuth richiede un abbonamento SuperGrok o X Premium idoneo (con verifica tramite codice del dispositivo, quindi funziona da host remoti senza callback su localhost):
Durante una nuova installazione, la stessa scelta è disponibile nella configurazione iniziale:
Oppure usa una chiave API:
Oppure tramite configurazione:
Ognuno di questi tre metodi abilita anche x_search e web_search di Grok.
2

Abilita e configura code_execution

Se enabled viene omesso, code_execution è disponibile solo quando il provider del modello attivo è xai e le credenziali xAI vengono risolte. Per un modello attivo con un provider noto diverso da xAI, imposta plugins.entries.xai.config.codeExecution.enabled su true per abilitare esplicitamente l’uso tra provider. Se il provider del modello attivo è mancante o non risolto, lo strumento rimane nascosto. Imposta enabled su false per disabilitarlo per tutti i provider. Le credenziali xAI sono sempre obbligatorie.Usa lo stesso blocco per sostituire il modello, il limite di turni o il timeout:
3

Riavvia il Gateway

code_execution compare nell’elenco degli strumenti dell’agente quando il plugin xAI viene registrato nuovamente e i controlli precedenti relativi a provider, abilitazione e autenticazione vengono superati.

​
Come usarlo

Rendi esplicito lo scopo dell’analisi; lo strumento accetta un unico parametro task, quindi invia la richiesta completa e tutti i dati incorporati in un solo prompt:

​
Errori

Senza autenticazione, lo strumento restituisce un errore JSON strutturato (non un’eccezione generata), consentendo all’agente di correggersi autonomamente:

​
Contenuti correlati

Strumento Exec

Esecuzione locale della shell sul computer o sul nodo associato.

Approvazioni Exec

Criteri di autorizzazione o rifiuto per l’esecuzione della shell.

Strumenti web

web_search, x_search e web_fetch.

Provider xAI

Modelli Grok, ricerca web/X e configurazione dell’esecuzione del codice.