Активиране на изпълнение на код в 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 код, подходящ за решаване на проблема.
- Кодът се изпълнява в Python sandbox средата на xAI.
- Моделът получава резултатите от изпълнението (стандартен изход, евентуални грешки).
- Той формулира своя отговор, включвайки получените резултати.
Ако кодът генерира грешка, моделът може автоматично да го коригира и да го изпълни отново – което може да доведе до множество извиквания за една единствена заявка.
Препоръка за температура
За математически изчисления и анализ на данни, 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 на изпълнение, като са възможни множество извиквания.