docs(cookbook): update Kimi-K3 GB200 recipes from measured 4x4 runs (#32592)

Co-authored-by: Lee Nau <lnau@nvidia.com>

docs_new/src/snippets/configs/moonshotai/kimi-k3.jsx

@@ -1274,9 +1274,82 @@ export const config = {
       ],
     },
 
+    {
+      // PP16 x TP1 spans all 16 ranks. Prefill tok/s/GPU at ISL 8192,
+      // concurrency 32: 4550 here vs 3596 (PP8 x TP2), 2407 (TEP16), 1652 (TP16);
+      // flat past 32. Below concurrency ~8 the pipeline cannot fill and TEP16
+      // leads instead (1947 vs 1227) — use `--tp-size 16 --ep-size 16` there.
+      // That four-way comparison was measured aggregated at OSL 1; the shape
+      // itself is as-run in this PD role. Pairs with the Balanced and
+      // High-Throughput decode cells; the Low-Latency decode cell runs pp=2 and
+      // needs a PP2 x TP8 prefill instead.
+      match: { hw: "gb200", pdMode: "prefill", strategy: "default" },
+      nnodes: 4,
+      verified: false,
+      verificationStatus: "in-progress",
+      env: [
+        "SGLANG_ENABLE_TP_MEMORY_INBALANCE_CHECK=0",
+      ],
+      flags: [
+        "--trust-remote-code",
+        "--model-path {{MODEL_NAME}}",
+        "--tp-size 1",
+        "--pp-size 16",
+        "--mem-fraction-static 0.85",
+        "--chunked-prefill-size 16384",
+        "--max-prefill-tokens 16384",
+        "--disable-flashinfer-autotune",
+        "--weight-loader-prefetch-checkpoints",
+        "--reasoning-parser kimi_k3",
+        "--tool-call-parser kimi_k3",
+        "--disaggregation-mode prefill",
+        "--disaggregation-transfer-backend nixl",
+        "--disaggregation-bootstrap-port 8998",
+        "--host {{HOST_IP}}",
+        "--port {{PORT}}",
+      ],
+    },
+    {
+      // Same chunked-PP shape as the Default cell, with mem-fraction raised to
+      // 0.90 for KV headroom — the B300/GB300 Long-Context recipes make the same
+      // trade. Keeping TP at 1 is what buys the context length here: with TP > 1
+      // the MLA KV is replicated across the TP ranks, so TP2 x PP8 would hold
+      // roughly half the tokens of TP1 x PP16 for the same memory.
+      // Not yet benchmarked on long-context workloads.
+      match: { hw: "gb200", pdMode: "prefill", strategy: "long-context" },
+      nnodes: 4,
+      verified: false,
+      verificationStatus: "in-progress",
+      env: [
+        "SGLANG_ENABLE_TP_MEMORY_INBALANCE_CHECK=0",
+      ],
+      flags: [
+        "--trust-remote-code",
+        "--model-path {{MODEL_NAME}}",
+        "--tp-size 1",
+        "--pp-size 16",
+        "--mem-fraction-static 0.90",
+        "--chunked-prefill-size 16384",
+        "--max-prefill-tokens 16384",
+        "--disable-flashinfer-autotune",
+        "--weight-loader-prefetch-checkpoints",
+        "--reasoning-parser kimi_k3",
+        "--tool-call-parser kimi_k3",
+        "--disaggregation-mode prefill",
+        "--disaggregation-transfer-backend nixl",
+        "--disaggregation-bootstrap-port 8998",
+        "--host {{HOST_IP}}",
+        "--port {{PORT}}",
+      ],
+    },
+
     // ----- Decode role: the unified cell for the same hw and strategy, plus
     // the PD role and transport flags, and re-sized KDA state.
     //
+    // GB200 decode figures below: ISL 8192 / OSL 1024, 16 GPU decode, behind a
+    // shared PP2 x TP8 prefill. Comparisons hold; absolutes would be higher
+    // behind the PP16 x TP1 prefill cell above.
+    //
     // Decode runs the KV cache as a chunk cache, so the unified 5-slots-per-
     // request reservation (1 state + ping-pong copies for radix reuse) drops to
     // a single slot, and --mamba-radix-cache-strategy stops having any effect.
@@ -1722,18 +1795,25 @@ export const config = {
       ],
     },
     {
+      // PP2 x TP8 is the fastest decode shape below concurrency ~100:
+      // 13.3 out tok/s/GPU @ 57.7 out tok/s/user at concurrency 8, against
+      // 9.5 @ 40.7 (TP16), 9.3 @ 39.9 (DCP16) and 9.3 @ 39.7 (DCP16+EP16) —
+      // +40% throughput and +45% interactivity over the best pp=1 shape. It
+      // stays ahead through concurrency 64 and is overtaken by DCP16+EP16 at 128.
+      // Measured without --enable-symm-mem.
       match: { hw: "gb200", pdMode: "decode", strategy: "low-latency" },
       nnodes: 4,
       verified: false,
       verificationStatus: "in-progress",
+      warn: "SGLang requires `decode pp_size == prefill pp_size or 1`, so this cell must be paired with a PP2 x TP8 prefill (`--tp-size 8 --pp-size 2`) rather than the PP16 x TP1 Prefill recipe. That prefill delivers 2919 prefill tok/s/GPU against PP16's 4550, which is the trade for the decode-side latency.",
       env: [
         "SGLANG_ENABLE_TP_MEMORY_INBALANCE_CHECK=0",
       ],
       flags: [
         "--trust-remote-code",
         "--model-path {{MODEL_NAME}}",
-        "--tp-size 16",
-        "--enable-symm-mem",
+        "--tp-size 8",
+        "--pp-size 2",
         "--mem-fraction-static 0.85",
         "--disaggregation-decode-extra-slots 16",
         "--reasoning-parser kimi_k3",
@@ -1745,6 +1825,9 @@ export const config = {
       ],
     },
     {
+      // EP16 on top of DCP16 is +6% to +10% out tok/s/GPU at every concurrency
+      // measured, at the same batch size: 56.2 vs 52.4 (c64), 92.7 vs 84.5
+      // (c128), 136.1 vs 126.1 (c256), 153.5 vs 144.2 (c512).
       match: { hw: "gb200", pdMode: "decode", strategy: "balanced" },
       nnodes: 4,
       verified: false,
@@ -1757,6 +1840,7 @@ export const config = {
         "--model-path {{MODEL_NAME}}",
         "--tp-size 16",
         "--dcp-size 16",
+        "--ep-size 16",
         "--mem-fraction-static 0.85",
         "--disaggregation-decode-extra-slots 16",
         "--reasoning-parser kimi_k3",
@@ -1768,6 +1852,16 @@ export const config = {
       ],
     },
     {
+      // Grouping DCP as 8 x dp2 rather than a flat DCP16 is what makes MegaMoE
+      // pay off here. out tok/s/GPU @ out tok/s/user, concurrency 256 / 512:
+      //   DCP8 x dp2 + EP16   145.5 @ 25.4   157.5 @ 25.2   <- this cell
+      //   DCP16 + EP16        136.1 @ 20.6   153.5 @ 17.5
+      //   DCP16               126.1 @ 18.7   144.2 @ 16.1
+      //   TP16                 87.4 @ 23.9    90.2 @ 23.9   (batch caps at ~125)
+      // Pair this cell with MegaMoE in the MoE Parallelism card: +8.3% / +10.0% /
+      // +11.0% over FlashInfer MXFP4 at concurrency 64 / 128 / 256, and the
+      // combination validated to concurrency 512. The gain needs dp > 1 — on the
+      // flat DCP16 cell MegaMoE is the slower of the two below concurrency 256.
       match: { hw: "gb200", pdMode: "decode", strategy: "high-throughput" },
       nnodes: 4,
       verified: false,
@@ -1779,8 +1873,11 @@ export const config = {
         "--trust-remote-code",
         "--model-path {{MODEL_NAME}}",
         "--tp-size 16",
-        "--dcp-size 16",
-        "--mem-fraction-static 0.92",
+        "--dcp-size 8",
+        "--dp-size 2",
+        "--enable-dp-attention",
+        "--ep-size 16",
+        "--mem-fraction-static 0.85",
         "--disaggregation-decode-extra-slots 16",
         "--reasoning-parser kimi_k3",
         "--tool-call-parser kimi_k3",
@@ -1802,6 +1899,15 @@ export const config = {
       "  SGLANG_HOST_IP=<this-node-ip>",
       "  NCCL_IB_HCA=<hca0,hca1,...>     # RDMA fabrics only",
     ],
+    gb200: [
+      "Allocate all four nodes within a single NVL72 domain.",
+      "MNNVL is off by default — set on every rank:",
+      "  NCCL_MNNVL_ENABLE=1",
+      "  NCCL_CUMEM_ENABLE=1",
+      "Point the JIT caches at GB200-only paths; GB200 is SM100 and GB300 is SM103,",
+      "so the two architectures need separate caches:",
+      "  TORCH_EXTENSIONS_DIR / TRITON_CACHE_DIR / TVM_FFI_CACHE_DIR",
+    ],
     h100: [
       "Set This node IP separately on each node; use the same cross-node NIC name on all four nodes.",
     ],