GROK：モデル・ツール・情報源・状態の選択

Source SHA-256 7db02ec76bac8cf0b70b608176dc605372a6ff50e2c592bf915ed6984aa38fb3

PRODUCT_MAPPING_ID: PM-GROK-CORE-04-v0.1

PROVIDER: GROK / xAI

CORE_PACKET: PKT-GEMINI-A-CORE-04-v0.1

AS_OF: 2026-09-12 21:00 JST

STATUS: PUBLIC_MAPPING_AUDITED / LIVE_RUNTIME_AND_ORG_PENDING

LAYER: PRODUCT_MAPPING (not Enterprise AI Core; not Organization Overlay)

CORE-04のmodel / tool / source / state routing、fallback、service capacity、cost/error observability契約をxAI APIへ対応づける。model alias/date pin、retired-slug redirect、search/tool、Priority/Default、rate limit、online/deferred/Batch、SDK別telemetryを同一routeとしない。公開仕様から閉じないteam tier、quota、契約、live latency/quality、実効routing、外部受入はUNKNOWNに残す。

• ROW: PM-C04-GROK-001; Core contract: model route identity; xAI surface and evidence: current model catalogはbare name/-latestをlatest stable、date suffixを固定releaseとして区別する。一方、2026-05-15 retirementでは複数の旧slugがgrok-4.3等へ自動redirectされ、reasoning effortと価格も変化した; Mapping decision: requested_model / resolved_model / alias_or_date / reasoning_effort / response_model / retirement_rule_versionを別記録する。HTTP成功を同一model実行の証明にしない; Required verification / UNKNOWN: tenant availability、実際のserving build/cohort、redirect readbackの全endpoint coverageはUNKNOWN

• ROW: PM-C04-GROK-002; Core contract: capability/prohibition prefilter; xAI surface and evidence: real-time dataはsearch toolを有効にしない限り利用不可。全modelがBatch対応ではなく、4.20以降はlogprobs/top_logprobsをsilent ignoreする; Mapping decision: required capabilityをmodel/tool/endpoint matrixで先に検査し、silent-ignore対象はresponse-side sentinelで確認する。非対応を品質scoreやretryで埋めない; Required verification / UNKNOWN: current tenantのmodel/tool matrix、silent-ignore以外のparameter behaviorはlive固定版試験なしではUNKNOWN

• ROW: PM-C04-GROK-003; Core contract: tool/source route; xAI surface and evidence: client tool、server tool、web/X/search、Collections、Remote MCPは実行場所・権限・source/receiptが異なる; Mapping decision: tool_declared / selected / execution_location / allowed_tools / authorization / result / citation / external_receipt / readbackを分離する。検索可能性をauthority/freshness/permissionと同一視しない; Required verification / UNKNOWN: source ACL、MCP upstream IAM、external transaction、provider内部dispatchはUNKNOWN

• ROW: PM-C04-GROK-004; Core contract: requested vs effective service; xAI surface and evidence: service_tier:"priority"を要求してもcapacity不足時にdefaultへfallbackし得て、responseのservice_tierが実際のtierを示す; Mapping decision: requested tierとobserved tierを別fieldにし、Priority→Defaultをmodel/capability同値とみなさない。billing/SLO判定もobserved tierへ結合する; Required verification / UNKNOWN: team契約capacity、実効price、SLO、fallback頻度はOrganization/live scope

• ROW: PM-C04-GROK-005; Core contract: quota/rate-limit route; xAI surface and evidence: limitはteam/model単位のRPS/TPMで、cached/reasoning/completion/input tokenを含む。超過は429、team tierはConsole上のspend tierに依存する; Mapping decision: limit snapshot、model、team、attempt、429、backoff、wall-clockを記録し、bounded retry後は停止または能力保持routeへ送る; Required verification / UNKNOWN: current team tier/limits、header completeness、burst behaviorはUNKNOWN

• ROW: PM-C04-GROK-006; Core contract: cost observability; xAI surface and evidence: responseはrequest単位のusage.cost_in_usd_ticksを返すが会話累積ではない。streamではinclude_usage指定時のfinal chunkだけ、Vercel AI SDKでは当該metadata非公開; Mapping decision: request/tool-loop/attemptを外部ledgerで集計し、final usage chunk欠落をCOST_INCOMPLETEにする。SDK telemetry gapを0 costへ変換しない; Required verification / UNKNOWN: negotiated price、billing reconciliation、interrupted stream/tool全経路の完全性はUNKNOWN

• ROW: PM-C04-GROK-007; Core contract: error/retry envelope; xAI surface and evidence: 400/401/403/404/422/429とdeferred 202が公開され、404にはmodel not foundを含む; Mapping decision: request_id / status / error_hash / response_started / attempt / visited_route / retry_after / terminal_reasonを記録する。202を成功、429をautomatic provider switch、4xxを一律retryableにしない; Required verification / UNKNOWN: timeout、5xx、SDK retry、idempotency、stream中断後の安全な再送はlive固定版でUNKNOWN

• ROW: PM-C04-GROK-008; Core contract: retirement/migration fallback; xAI surface and evidence: retired slugが動き続けても別model・reasoning effort・価格へredirectされる。これはavailability維持でありsemantic equivalenceではない; Mapping decision: retirement feedをroute invalidation eventにし、明示migration、capability/cost/regression再検証、effective model readbackを要求する; Required verification / UNKNOWN: redirectの終了日、全legacy slug、tenant例外、behavior equivalenceはUNKNOWN

• ROW: PM-C04-GROK-009; Core contract: online/deferred/Batch route; xAI surface and evidence: deferredは202と24時間・一度限りの取得、Batchはpending/success/error/cancel/expiryを持つ; Mapping decision: online→deferred/Batchを新契約としてdeadline、interaction、ordering、partial result、retention、receipt、acceptance lossを事前評価する; Required verification / UNKNOWN: live completion、cancel race、dedupe、deadline適合はUNKNOWN

• ROW: PM-C04-GROK-010; Core contract: final route observability; xAI surface and evidence: public response metadata、service tier、usage/cost、error statusはroute evidenceの一部だがbusiness acceptanceではない; Mapping decision: route eventにrequested/effective model、endpoint、tools、requested/observed tier、limit snapshot、usage/cost、error、fallback loss、verifier、final acceptanceをjoinする; Required verification / UNKNOWN: trace retention、sampling、immutable export、organization alert/SLOはUNKNOWN

非機密synthetic fixtureと許可済みsandboxだけで実施する。今回はxAI API、team、Console、model、SDK、tool、Batch/deferred、外部systemを操作していない。

• alias、-latest、date pin、retired slugを送信し、requested/effective model、reasoning effort、price receiptを比較する。

• searchなしのfreshness要求、Batch非対応model、4.20以降のlogprobs sentinelでcapability preflightとsilent ignoreを検出する。

• Priorityを要求し、responseのobserved tierを記録してDefault fallbackを別route event化する。

• model/team別limitを固定し、429を注入してattempt/wall-clock/visited-route/error-hashで循環を停止する。

• non-stream、stream完了、final usage chunk前の切断、raw REST/OpenAI/xAI/Vercel SDKを比較しcost completenessを検査する。

• online/deferred/Batchを同一synthetic operation IDで結び、202、partial error、cancel、expiry、single retrievalを業務受入から分離する。

• retired redirectまたはmodel-not-foundをfail-closedで捕捉し、明示migration後にcapability/cost/regressionを再検証する。

既存CORE-04 local fixtures（10/10、16/16）はCOMPILER_EXPERIMENTのまま再利用し、Grok/xAIのlive品質・可用性・fallback挙動へ再分類しない。

• xAI Models: <https://docs.x.ai/developers/models> (updated 2026-08-21; accessed 2026-09-12)

• xAI Rate Limits: <https://docs.x.ai/developers/rate-limits> (updated 2026-06-20; accessed 2026-09-12)

• xAI Priority Processing: <https://docs.x.ai/developers/advanced-api-usage/priority-processing> (updated 2026-06-15; accessed 2026-09-12)

• xAI Cost Tracking: <https://docs.x.ai/developers/cost-tracking> (accessed 2026-09-12)

• xAI Debugging Errors: <https://docs.x.ai/developers/debugging> (updated 2026-05-13; accessed 2026-09-12)

• xAI Model Retirement on May 15, 2026: <https://docs.x.ai/developers/migration/may-15-retirement> (updated 2026-09-02; accessed 2026-09-12)

• EXT-G01-004/005/007 and EXT-G03-001..006 are reused for deferred/Batch/SDK/tool/compaction/WebSocket boundaries. CORE-04 provider-neutral research and LiteLLM incident evidence retains its original provenance.

公開仕様の範囲でPM-GROK-CORE-04をbounded closeとする。自動redirectやservice-tier fallbackを同値性へ昇格せず、independent xAI production evidenceは未取得のまま、live model/tier/capability、team limit、SDK telemetry、retry/idempotency、price/SLO、Organization loss budgetをUNKNOWNに残す。Core claimは不変で、Gemini/GPT/Claudeの遡及監査は不要。次はPM-GROK-CORE-05へ進み、NotebookLM補充ゲートを維持する。