Code-Ausführung in der API aktivieren
Auf dieser Seite
Python-Code über die Grok-API ausführen
Die Code-Ausführung ermöglicht es dem Modell, Python-Code in Echtzeit innerhalb einer sicheren, sandboxierten Umgebung zu schreiben und auszuführen. Anstatt lediglich Code zu generieren, den Sie selbst ausführen müssten, führt das Modell den Code direkt aus und gibt die Ergebnisse zurück. Dies ist ein leistungsfähiges Werkzeug für Berechnungen, Datenanalysen und die Validierung von Code.
Werkzeug-Identifikatoren je nach SDK
Die Werkzeug-Identifikation variiert je nach verwendetem SDK:
| SDK | Identifikator |
|---|---|
| xAI SDK | code_execution |
| OpenAI Responses API | code_interpreter |
| Vercel AI SDK | xai.tools.codeExecution() |
Diese Namensunterschiede sind von Bedeutung. Verwenden Sie den Identifikator, der zu Ihrem SDK passt, um Fehler zu vermeiden.
Grundlegende Aktivierung
cURL / Direktes JSON
{
"model": "grok-4.20-0309-reasoning",
"input": "Berechnen Sie die Summe der ersten 1.000 Primzahlen",
"tools": [
{"type": "code_interpreter"}
]
}
xAI SDK (Python)
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Berechnen Sie die Summe der ersten 1.000 Primzahlen",
tools=[client.tools.code_execution()]
)
print(response.output_text)
OpenAI SDK (Python)
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Berechnen Sie die Summe der ersten 1.000 Primzahlen",
tools=[{"type": "code_interpreter"}]
)
Vercel AI SDK (JavaScript)
const response = await generateText({
model: xai("grok-4.20-0309-reasoning"),
prompt: "Berechnen Sie die Summe der ersten 1.000 Primzahlen",
tools: [xai.tools.codeExecution()]
});
Wie das Modell die Code-Ausführung nutzt
Wenn die Code-Ausführung aktiviert ist, verläuft der Prozess wie folgt:
- Das Modell analysiert die Anfrage und bestimmt, dass eine Berechnung oder Datenanalyse erforderlich ist
- Es schreibt Python-Code, der für das Problem geeignet ist
- Der Code wird im Python-Sandbox von xAI ausgeführt
- Das Modell erhält die Ausführungsergebnisse (Standardausgabe, eventuelle Fehler)
- Es formuliert seine Antwort unter Einbeziehung der Ergebnisse
Falls der Code einen Fehler produziert, kann das Modell diesen automatisch korrigieren und erneut ausführen – was mehrere Aufrufe für eine einzelne Anfrage generieren kann.
Temperatur-Empfehlung
Für mathematische Berechnungen und Datenanalysen empfiehlt xAI den Einsatz niedriger Temperaturwerte (0,0 bis 0,3). Eine niedrige Temperatur reduziert die Variabilität bei der Code-Generierung und erzeugt reproduzierbarere Ergebnisse.
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Berechnen Sie das Sharpe-Verhältnis für dieses Portfolio...",
tools=[client.tools.code_execution()],
temperature=0.1
)
Kernaussagen
- Die Code-Ausführung ermöglicht Echtzeit-Execution von Python in einer sicheren Sandbox
- Die Identifikation variiert je nach SDK:
code_execution(xAI),code_interpreter(OpenAI) - Das Modell schreibt, führt und interpretiert den Code automatisch
- Verwenden Sie
grok-4.20-0309-reasoningund eine niedrige Temperatur für Berechnungen - Die Kosten betragen 0,005 USD pro Ausführung, wobei mehrere Aufrufe möglich sind