ホーム › 関数呼び出し・構造化出力
Grokガイド
Grok APIの関数呼び出しと構造化出力の仕様
関数呼び出しは、モデルが「この関数を呼んで」と依頼し、自分のコードが実行して結果を返す仕組みです。構造化出力は、返答をJSONスキーマに沿わせる機能です。
関数呼び出しの流れ(Responses API)
responses.createにinputとtoolsを渡す。response.outputのうちtype == "function_call"の項目から、nameとarguments(JSON)を読む。- 手元の関数を実行する。
function_call_output(call_idと出力)をinputに入れ、toolsとprevious_response_idを付けてもう一度送る。- 出力の
messageから最終回答を読む。
各ツールはname・任意のdescription・JSONスキーマのparametersで定義し、1リクエストに最大350個まで入れられます。ストリーミングでは、関数呼び出しは1つのまとまりで届きます。
ツールの選び方と並列呼び出し
| 設定 | 値・意味 |
|---|---|
| ツール選択 | "auto"(既定)、"required"、"none"、または特定の関数を指定 |
parallel_tool_calls | 既定は有効。falseで無効 |
構造化出力
PythonはPydantic、JavaScriptはZodでスキーマを定義し、response_formatのjson_schemaか、ツール定義で渡します。xAI SDKではchat.parse(Model)で自動的に解析できます。ツールと構造化出力を組み合わせられるのは、対応するGrok 4系のモデルだけです。
| 項目 | 仕様 |
|---|---|
| 使える型 | string・number・integer・boolean・null・enum・const・array・object・anyOf・oneOf・allOf(1つ)・循環しない$ref/$defs |
| 文字列の形式 | date・time・date-time・email・uuid・ipv4・ipv6・uri が検証される |
| 保証される上限 | minLength/maxLength 2,048まで、minItems/maxItems 256まで、minProperties/maxProperties 64まで |
| additionalProperties | 既定はfalse。許可するには明示的にtrue |
| 400エラーになる書き方 | 要素が0個のenum/anyOf、プロパティスキーマの真偽値、maxContains/minContains、配列形式のitems(prefixItemsを使う) |
| 努力目標のみ | not、if/then/else、複数のサブスキーマのallOf。厳密さが必要なら出力を検証する |
| pattern(正規表現) | ECMAScriptの一部。後方参照・先読み・単語境界・Unicodeプロパティは非対応。全文に自動で固定される |
確認した公式資料
上の資料は2026年11月11日に確認しました。内容は予告なく変わるため、使う前に公式のページで最新の表示を確かめてください。
あわせて読むページ
よくある質問
JSONスキーマはどの版が良いですか?
公式は、Draft 2020-12が最もよく動き、Draft-07も受け付けるとしています。
対応モデルは?
公式ページに一覧はなく、例はgrok-4.7を使っています。
更新履歴
- 公式ドキュメントと照合して全面的に書き直しました。