このページの内容
このページの内容
Tools
コード実行
code_execution は、xAI の Responses API
（https://api.x.ai/v1/responses、x_search が使用するものと同じエンドポイント）上で、サンドボックス化されたリモート Python 分析を実行します。バンドルされている xai Plugin により、tools コントラクトの下で登録されます。
| プロパティ | 値 |
|---|---|
| ツール名 | code_execution |
| プロバイダー Plugin | xai（バンドル済み、enabledByDefault: true） |
| 認証 | xAI 認証プロファイル、XAI_API_KEY、または plugins.entries.xai.config.webSearch.apiKey |
| デフォルトモデル | grok-4.3 |
| デフォルトタイムアウト | 30 秒 |
デフォルトの maxTurns |
未設定（xAI が独自の内部制限を適用） |
計算、集計、簡単な統計、グラフ形式の分析に使用できます。これには、x_search または web_search が返したデータの分析も含まれます。ローカルファイル、シェル、リポジトリ、ペアリング済みデバイスにはアクセスできず、呼び出し間で状態も保持されません。そのため、各呼び出しはノートブックセッションではなく、一時的な分析として扱ってください。最新の X データを使用する場合は、まず x_search を実行し、その結果をパイプで渡します。
ローカルで実行する場合は、代わりに exec を使用してください。
セットアップ
xAI の認証情報を指定する
OAuth には、対象となる SuperGrok または X Premium サブスクリプションが必要です （デバイスコード検証を使用するため、localhost コールバックなしでリモートホストからも利用できます）。
新規インストール時には、オンボーディングでも同じ選択肢を利用できます。
または API キーを使用します。
または設定を使用します。
これら 3 つのいずれを使用しても、x_search と Grok web_search も利用可能になります。
code_execution を有効化して調整する
enabled を省略した場合、code_execution が公開されるのは、アクティブなモデルのプロバイダーが xai であり、かつ xAI の認証情報を解決できる場合のみです。既知の xAI 以外のプロバイダーを使用するアクティブモデルでプロバイダーをまたいだ利用をオプトインするには、plugins.entries.xai.config.codeExecution.enabled を true に設定します。アクティブなモデルのプロバイダーが欠落しているか解決できない場合、ツールは非表示のままです。すべてのプロバイダーで無効にするには、enabled を false に設定します。xAI の認証情報は常に必要です。
同じブロックを使用して、モデル、ターン上限、またはタイムアウトを上書きできます。
Gateway を再起動する
xAI Plugin が再登録され、上記のプロバイダー、有効化、認証の各チェックに合格すると、エージェントのツール一覧に code_execution が表示されます。
使用方法
分析の意図を明示してください。このツールが受け取るパラメーターは task 1 つだけなので、完全なリクエストとインラインデータを 1 つのプロンプトで送信します。
エラー
認証がない場合、ツールは例外をスローせず、構造化された JSON エラーを返すため、エージェントは自己修正できます。
