本頁內容
本頁內容
Tools
程式碼執行
code_execution 會在 xAI 的 Responses API 上執行沙箱化的遠端 Python 分析
（https://api.x.ai/v1/responses，與 x_search 使用相同的端點）。它由隨附的 xai 外掛依據 tools 合約註冊。
| 屬性 | 值 |
|---|---|
| 工具名稱 | code_execution |
| 提供者外掛 | xai（隨附，enabledByDefault: true） |
| 驗證 | xAI 驗證設定檔、XAI_API_KEY 或 plugins.entries.xai.config.webSearch.apiKey |
| 預設模型 | grok-4.3 |
| 預設逾時 | 30 秒 |
預設 maxTurns |
未設定（xAI 會套用其內部限制） |
可用於計算、表格化、快速統計與圖表式分析，
包括分析由 x_search 或 web_search 傳回的資料。它無法存取
本機檔案、你的 shell、你的儲存庫或已配對裝置，且不會在呼叫之間
保留狀態，因此應將每次呼叫視為暫時性分析，而非
筆記本工作階段。若要取得最新的 X 資料，請先執行 x_search，
再將結果輸入其中。
若要在本機執行，請改用 exec。
設定
提供 xAI 認證資訊
OAuth 需要符合資格的 SuperGrok 或 X Premium 訂閱 （採用裝置代碼驗證，因此可從遠端主機使用，無須 localhost 回呼）：
全新安裝時，也可以在初始設定中選擇相同選項：
或使用 API 金鑰：
或透過設定：
這三種方式都能同時支援 x_search 與 Grok web_search。
啟用並調整 code_execution
省略 enabled 時，只有在使用中
模型的提供者為 xai 且可解析 xAI 認證資訊時，才會公開 code_execution。
如果使用中模型已有已知的非 xAI 提供者，請將
plugins.entries.xai.config.codeExecution.enabled 設為 true，以選擇啟用
跨提供者使用。若缺少使用中模型的提供者或無法解析，
此工具會維持隱藏。將 enabled 設為 false，即可對所有
提供者停用此工具。無論如何都必須提供 xAI 認證資訊。
使用相同區塊覆寫模型、回合上限或逾時：
重新啟動閘道
當 xAI 外掛重新註冊，且通過上述提供者、啟用狀態及驗證檢查後，
code_execution 就會出現在代理程式的工具清單中。
使用方式
請明確說明分析目的；此工具只接受一個 task 參數，
因此請在單一提示中傳送完整要求與任何內嵌資料：
錯誤
若未提供驗證，此工具會傳回結構化 JSON 錯誤（而非擲回 例外），讓代理程式能自行修正：
