Ενεργοποίηση εκτέλεσης κώδικα στο API
Σε αυτήν τη σελίδα
Εκτέλεση κώδικα Python μέσω του Grok API
Η Εκτέλεση Κώδικα επιτρέπει στο μοντέλο να γράφει και να τρέχει κώδικα Python σε πραγματικό χρόνο, εντός ενός ασφαλούς περιβάλλοντος απομόνωσης (sandbox). Αντί απλώς να παράγει κώδικα για να τον εκτελέσετε εσείς, το μοντέλο τρέχει τον κώδικα απευθείας και επιστρέφει τα αποτελέσματα. Πρόκειται για ένα ισχυρό εργαλείο για υπολογισμούς, ανάλυση δεδομένων και επικύρωση κώδικα.
Αναγνωριστικά εργαλείων ανά SDK
Το αναγνωριστικό του εργαλείου διαφέρει ανάλογα με το SDK που χρησιμοποιείτε:
| SDK | Αναγνωριστικό |
|---|---|
| xAI SDK | code_execution |
| OpenAI Responses API | code_interpreter |
| Vercel AI SDK | xai.tools.codeExecution() |
Αυτή η διαφορά στην ονομασία είναι σημαντική. Χρησιμοποιήστε το αναγνωριστικό που αντιστοιχεί στο SDK σας για να αποφύγετε σφάλματα.
Βασική ενεργοποίηση
cURL / Άμεσο JSON
{
"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()]
});
Πώς χρησιμοποιεί το μοντέλο την Εκτέλεση Κώδικα
Όταν η Εκτέλεση Κώδικα είναι ενεργοποιημένη, η διαδικασία λειτουργεί ως εξής:
- Το μοντέλο αναλύει το αίτημα και καθορίζει ότι απαιτείται υπολογισμός ή ανάλυση δεδομένων.
- Γράφει κώδικα Python κατάλληλο για το πρόβλημα.
- Ο κώδικας εκτελείται στο sandbox Python της xAI.
- Το μοντέλο λαμβάνει τα αποτελέσματα της εκτέλεσης (τυπική έξοδος, τυχόν σφάλματα).
- Διαμορφώνει την απάντησή του ενσωματώνοντας τα αποτελέσματα.
Εάν ο κώδικας παράγει σφάλμα, το μοντέλο μπορεί να τον διορθώσει αυτόματα και να τον εκτελέσει ξανά, γεγονός που μπορεί να οδηγήσει σε πολλαπλές κλήσεις για ένα μόνο αίτημα.
Σύσταση για τη θερμοκρασία (Temperature)
Για μαθηματικούς υπολογισμούς και ανάλυση δεδομένων, η xAI συνιστά τη χρήση χαμηλών τιμών θερμοκρασίας (0,0 έως 0,3). Μια χαμηλή θερμοκρασία μειώνει τη μεταβλητότητα στη δημιουργία κώδικα και παράγει πιο αναπαραγώγιμα αποτελέσματα.
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
)
Βασικά σημεία
- Η Εκτέλεση Κώδικα επιτρέπει την εκτέλεση Python σε πραγματικό χρόνο σε ένα ασφαλές sandbox.
- Το αναγνωριστικό διαφέρει ανά SDK:
code_execution(xAI),code_interpreter(OpenAI). - Το μοντέλο γράφει, εκτελεί και ερμηνεύει τον κώδικα αυτόματα.
- Χρησιμοποιήστε το
grok-4.20-0309-reasoningκαι μια χαμηλή θερμοκρασία για υπολογισμούς. - Το κόστος είναι 0,005 $ ανά εκτέλεση, με δυνατότητα πολλαπλών κλήσεων.