ホーム › 関数呼び出し・構造化出力

Grokガイド

Grok APIの関数呼び出しと構造化出力の仕様

関数呼び出しは、モデルが「この関数を呼んで」と依頼し、自分のコードが実行して結果を返す仕組みです。構造化出力は、返答をJSONスキーマに沿わせる機能です。

確認・更新 

関数呼び出しの流れ(Responses API)

  1. responses.createにinputとtoolsを渡す。
  2. response.outputのうちtype == "function_call"の項目から、nameとarguments(JSON)を読む。
  3. 手元の関数を実行する。
  4. function_call_output(call_idと出力)をinputに入れ、toolsとprevious_response_idを付けてもう一度送る。
  5. 出力の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を使っています。

更新履歴

  • 公式ドキュメントと照合して全面的に書き直しました。

編集:ちんあなご編集部(運営者情報)。誤りに気づいたらお問い合わせからお知らせください。