Skip to main content
code_execution выполняет изолированный удалённый анализ на Python через Responses API от xAI (https://api.x.ai/v1/responses, тот же эндпоинт, который использует x_search). Он регистрируется встроенным плагином xai в рамках контракта tools.
code_execution выполняется на серверах xAI. xAI взимает $5 за 1,000 вызовов инструмента плюс стоимость входных и выходных токенов модели.
Используйте его для вычислений, табулирования, быстрой статистики и анализа в виде диаграмм, включая данные, возвращаемые x_search или web_search. У него нет доступа к локальным файлам, вашей оболочке, репозиторию или сопряжённым устройствам, и он не сохраняет состояние между вызовами, поэтому рассматривайте каждый вызов как одноразовый анализ, а не сеанс работы с блокнотом. Для получения актуальных данных X сначала запустите x_search и передайте результат в него. Для локального выполнения используйте exec.

​
Настройка

1

Предоставьте учётные данные xAI

Для OAuth требуется подходящая подписка SuperGrok или X Premium (проверка с помощью кода устройства, поэтому этот способ работает на удалённых хостах без обратного вызова localhost):
При новой установке тот же вариант доступен во время первоначальной настройки:
Или используйте ключ API:
Либо задайте его в конфигурации:
Любой из этих трёх вариантов также обеспечивает работу x_search и Grok web_search.
2

Включите и настройте code_execution

Если enabled не задан, code_execution доступен только тогда, когда провайдером активной модели является xai и учётные данные xAI успешно определены. Для активной модели с известным провайдером, отличным от xAI, задайте plugins.entries.xai.config.codeExecution.enabled равным true, чтобы явно разрешить использование между провайдерами. Если провайдер активной модели отсутствует или не определён, инструмент остаётся скрытым. Задайте enabled равным false, чтобы отключить его для всех провайдеров. Учётные данные xAI требуются всегда.В том же блоке можно переопределить модель, ограничение количества итераций или тайм-аут:
3

Перезапустите Gateway

code_execution появится в списке инструментов агента после того, как плагин xAI повторно зарегистрируется и успешно пройдут указанные выше проверки провайдера, включения и аутентификации.

​
Использование

Явно укажите цель анализа; инструмент принимает один параметр task, поэтому передавайте полный запрос и все встроенные данные в одном промпте:

​
Ошибки

При отсутствии аутентификации инструмент возвращает структурированную ошибку JSON (а не выбрасывает исключение), поэтому агент может самостоятельно исправить проблему:

​
Связанные материалы

Инструмент Exec

Локальное выполнение команд оболочки на вашем компьютере или сопряжённом узле.

Подтверждения Exec

Политика разрешения и запрета выполнения команд оболочки.

Веб-инструменты

web_search, x_search и web_fetch.

Провайдер xAI

Модели Grok, поиск в интернете и X, а также конфигурация выполнения кода.