feat(agentx): publish the AgentX optimizations pages / 发布 AgentX 优化专题页面

packages/app/cypress/e2e/agentx-optimizations.cy.ts

@@ -0,0 +1,148 @@
+import { unlockAgenticGate } from '../support/e2e';
+
+const FRAMEWORK_SLUGS = [
+  'vllm',
+  'sglang',
+  'tensorrt-llm',
+  'atom',
+  'aiter',
+  'dynamo',
+  'lmcache',
+  'mooncake',
+];
+
+describe('AgentX optimizations', () => {
+  beforeEach(() => {
+    cy.intercept('GET', '/api/v1/datasets', { statusCode: 200, body: [] });
+  });
+
+  it('links from /agentx to the optimizations index and to each project', () => {
+    cy.visit('/agentx', { onBeforeLoad: unlockAgenticGate });
+
+    cy.get('[data-testid="agentx-optimizations-callout"]').within(() => {
+      cy.contains('h2', 'Optimizations for Agentic Workloads').should('be.visible');
+      cy.contains('50+ upstream pull requests').should('be.visible');
+      cy.get('[data-testid="agentx-optimizations-framework-link"]').should(
+        'have.length',
+        FRAMEWORK_SLUGS.length,
+      );
+      // Direct route into one project, for a reader who knows which engine they run.
+      cy.get('[data-testid="agentx-optimizations-framework-link"][data-framework="sglang"]').should(
+        'have.attr',
+        'href',
+        '/agentx/optimizations/sglang',
+      );
+      cy.get('[data-testid="agentx-optimizations-cta"]')
+        .should('contain.text', 'Read the optimizations')
+        .click();
+    });
+
+    cy.location('pathname').should('eq', '/agentx/optimizations');
+  });
+
+  it('publishes the index with the ecosystem primer, every project, and sourced PRs', () => {
+    cy.visit('/agentx/optimizations', { onBeforeLoad: unlockAgenticGate });
+
+    cy.get('[data-testid="agentx-optimizations-index"]').within(() => {
+      cy.get('h1').should('have.text', 'Optimizations for Agentic Workloads');
+      cy.get('[data-testid="agentx-optimizations-card"]').should(
+        'have.length',
+        FRAMEWORK_SLUGS.length,
+      );
+      cy.get('[data-testid="agentx-optimizations-section-ecosystem"]').should(
+        'contain.text',
+        'A brief introduction to the distributed inference ecosystem',
+      );
+      cy.get('[data-testid="agentx-optimizations-figure-servingStack"] img').should('be.visible');
+      // The day-zero section keeps its own upstream references.
+      cy.get('[data-testid="agentx-optimizations-section-other"]')
+        .find('[data-testid="agentx-optimizations-pr"]')
+        .first()
+        .should('have.attr', 'href')
+        .and('match', /^https:\/\/github\.com\/vllm-project\/vllm\/pull\/\d+$/u);
+      cy.get('[data-testid="agentx-optimizations-card"][data-framework="vllm"]').click();
+    });
+
+    cy.location('pathname').should('eq', '/agentx/optimizations/vllm');
+  });
+
+  it('renders a project page with its measurements, figures, and PR links', () => {
+    cy.visit('/agentx/optimizations/vllm', { onBeforeLoad: unlockAgenticGate });
+
+    cy.get('[data-testid="agentx-optimizations-article"]')
+      .should('have.attr', 'data-framework', 'vllm')
+      .within(() => {
+        cy.get('h1').should('have.text', 'vLLM');
+        cy.contains('prefix-cache hit rate above 95%').should('be.visible');
+        cy.contains('81.7% higher output throughput').should('be.visible');
+        cy.get('[data-testid="agentx-optimizations-figure-vllmSelectiveRetention"] img').should(
+          'be.visible',
+        );
+        cy.get('[data-testid="agentx-optimizations-pr"]')
+          .should('have.length.greaterThan', 20)
+          .first()
+          .should('have.attr', 'href', 'https://github.com/vllm-project/vllm/pull/43447')
+          .and('contain.text', 'vLLM #43447');
+        // Sibling projects stay one click away.
+        cy.get('[data-testid="agentx-optimizations-card"]').should(
+          'have.length',
+          FRAMEWORK_SLUGS.length - 1,
+        );
+      });
+  });
+
+  it('serves every project page and pairs each with its Chinese sibling', () => {
+    for (const slug of FRAMEWORK_SLUGS) {
+      cy.request(`/agentx/optimizations/${slug}`).its('status').should('eq', 200);
+      cy.request(`/zh/agentx/optimizations/${slug}`).its('status').should('eq', 200);
+    }
+  });
+
+  it('returns 404 for a project that does not exist', () => {
+    cy.request({ url: '/agentx/optimizations/not-a-framework', failOnStatusCode: false })
+      .its('status')
+      .should('eq', 404);
+  });
+
+  it('ships the Simplified Chinese index and project pages', () => {
+    cy.visit('/zh/agentx', { onBeforeLoad: unlockAgenticGate });
+    cy.get('[data-testid="agentx-optimizations-callout"]').within(() => {
+      cy.contains('h2', '面向智能体负载的优化').should('be.visible');
+      cy.get('[data-testid="agentx-optimizations-cta"]')
+        .should('contain.text', '查看优化详情')
+        .and('have.attr', 'href', '/zh/agentx/optimizations');
+    });
+
+    cy.visit('/zh/agentx/optimizations', { onBeforeLoad: unlockAgenticGate });
+    cy.get('[data-testid="agentx-optimizations-index"]').within(() => {
+      cy.get('h1').should('have.text', '面向智能体负载的优化');
+      cy.contains('分布式推理生态简介').should('be.visible');
+      cy.get('[data-testid="agentx-optimizations-card"]').should(
+        'have.length',
+        FRAMEWORK_SLUGS.length,
+      );
+      cy.get('[data-testid="agentx-optimizations-card"][data-framework="lmcache"]').should(
+        'have.attr',
+        'href',
+        '/zh/agentx/optimizations/lmcache',
+      );
+    });
+    cy.get('link[rel="alternate"][hreflang="en"]').should(
+      'have.attr',
+      'href',
+      'https://inferencex.semianalysis.com/agentx/optimizations',
+    );
+
+    cy.visit('/zh/agentx/optimizations/sglang', { onBeforeLoad: unlockAgenticGate });
+    cy.get('[data-testid="agentx-optimizations-article"]').within(() => {
+      // Product names stay English; the prose around them is translated.
+      cy.get('h1').should('have.text', 'SGLang');
+      cy.contains('HiCache offload').should('be.visible');
+      cy.contains('并发 384 下输出吞吐量提升 26.75%').should('be.visible');
+      cy.get('[data-testid="agentx-optimizations-pr"]')
+        .first()
+        .should('have.attr', 'href')
+        .and('match', /^https:\/\/github\.com\/sgl-project\/sglang\/pull\/\d+$/u);
+    });
+  });
+});

packages/app/src/app/agentx/optimizations/[framework]/page.tsx

@@ -0,0 +1,64 @@
+import type { Metadata } from 'next';
+import { notFound } from 'next/navigation';
+
+import { AgentXOptimizationsArticle } from '@/components/datasets/agentx-optimizations-article';
+import { JsonLd } from '@/components/json-ld';
+import {
+  AGENTX_OPTIMIZATION_FRAMEWORKS,
+  getOptimizationFramework,
+} from '@/lib/agentx-optimizations';
+import { enAlternates } from '@/lib/i18n';
+import { SITE_URL } from '@semianalysisai/inferencex-constants';
+
+interface Props {
+  params: Promise<{ framework: string }>;
+}
+
+export function generateStaticParams() {
+  return AGENTX_OPTIMIZATION_FRAMEWORKS.map((entry) => ({ framework: entry.slug }));
+}
+
+export const dynamicParams = false;
+
+export async function generateMetadata({ params }: Props): Promise<Metadata> {
+  const { framework: slug } = await params;
+  const framework = getOptimizationFramework(slug);
+  if (!framework) return {};
+  const title = `${framework.name} Agentic Optimizations`;
+  return {
+    title,
+    description: framework.summary,
+    alternates: enAlternates(`/agentx/optimizations/${slug}`),
+    openGraph: {
+      title: `${title} | InferenceX`,
+      description: framework.summary,
+      url: `${SITE_URL}/agentx/optimizations/${slug}`,
+    },
+    twitter: { title: `${title} | InferenceX`, description: framework.summary },
+  };
+}
+
+export default async function AgentXOptimizationsFrameworkPage({ params }: Props) {
+  const { framework: slug } = await params;
+  const framework = getOptimizationFramework(slug);
+  if (!framework) notFound();
+
+  const jsonLd = {
+    '@context': 'https://schema.org',
+    '@type': 'TechArticle',
+    headline: `${framework.name} Agentic Optimizations`,
+    description: framework.summary,
+    url: `${SITE_URL}/agentx/optimizations/${slug}`,
+    inLanguage: 'en',
+    isPartOf: { '@type': 'WebSite', name: 'InferenceX', url: SITE_URL },
+  };
+
+  return (
+    <main className="relative">
+      <JsonLd data={jsonLd} />
+      <div className="container mx-auto max-w-6xl px-4 pb-12 lg:px-8">
+        <AgentXOptimizationsArticle slug={slug} locale="en" />
+      </div>
+    </main>
+  );
+}

packages/app/src/app/agentx/optimizations/page.tsx

@@ -0,0 +1,45 @@
+import type { Metadata } from 'next';
+
+import { AgentXOptimizationsIndex } from '@/components/datasets/agentx-optimizations-article';
+import { JsonLd } from '@/components/json-ld';
+import { OPTIMIZATIONS_OVERVIEW } from '@/lib/agentx-optimizations';
+import { enAlternates } from '@/lib/i18n';
+import { SITE_URL } from '@semianalysisai/inferencex-constants';
+
+const TITLE = 'AgentX Industry Impact: Optimizations for Agentic Workloads';
+const DESCRIPTION =
+  'The 50+ upstream pull requests AgentX drove across vLLM, SGLang, TensorRT-LLM, ATOM, AITER, Dynamo, LMCache, and Mooncake.';
+
+export const metadata: Metadata = {
+  title: 'AgentX Industry Impact',
+  description: DESCRIPTION,
+  alternates: enAlternates('/agentx/optimizations'),
+  openGraph: {
+    title: `${TITLE} | InferenceX`,
+    description: DESCRIPTION,
+    url: `${SITE_URL}/agentx/optimizations`,
+  },
+  twitter: { title: `${TITLE} | InferenceX`, description: DESCRIPTION },
+};
+
+const jsonLd = {
+  '@context': 'https://schema.org',
+  '@type': 'TechArticle',
+  headline: TITLE,
+  description: DESCRIPTION,
+  url: `${SITE_URL}/agentx/optimizations`,
+  inLanguage: 'en',
+  about: OPTIMIZATIONS_OVERVIEW.title,
+  isPartOf: { '@type': 'WebSite', name: 'InferenceX', url: SITE_URL },
+};
+
+export default function AgentXOptimizationsPage() {
+  return (
+    <main className="relative">
+      <JsonLd data={jsonLd} />
+      <div className="container mx-auto max-w-6xl px-4 pb-12 lg:px-8">
+        <AgentXOptimizationsIndex locale="en" />
+      </div>
+    </main>
+  );
+}

packages/app/src/app/agentx/page.tsx

@@ -1,6 +1,7 @@
 import type { Metadata } from 'next';
 
 import { AgentXMethodology } from '@/components/datasets/agentx-methodology';
+import { AgentXOptimizationsCallout } from '@/components/datasets/agentx-optimizations-callout';
 import { DatasetList } from '@/components/datasets/dataset-list';
 import { JsonLd } from '@/components/json-ld';
 import { enAlternates } from '@/lib/i18n';
@@ -38,6 +39,10 @@ export default function AgentXPage() {
           <AgentXMethodology locale="en" />
         </section>
 
+        <section>
+          <AgentXOptimizationsCallout locale="en" />
+        </section>
+
         <section className="flex flex-col gap-3">
           <h2 className="text-lg font-semibold text-foreground">Datasets</h2>
           <DatasetList />

packages/app/src/app/sitemap.ts

@@ -1,5 +1,6 @@
 import type { MetadataRoute } from 'next';
 
+import { AGENTX_OPTIMIZATION_SLUGS } from '@/lib/agentx-optimizations';
 import { getAllPosts } from '@/lib/blog';
 import { getAllComparableCompareSlugs } from '@/lib/compare-availability';
 import { canonicalCompareSlug } from '@/lib/compare-slug';
@@ -100,6 +101,18 @@ export default async function sitemap(): Promise<MetadataRoute.Sitemap> {
       changeFrequency: 'monthly',
       priority: 0.6,
     }),
+    ...localizedPair('/agentx/optimizations', {
+      lastModified: now,
+      changeFrequency: 'monthly',
+      priority: 0.7,
+    }),
+    ...AGENTX_OPTIMIZATION_SLUGS.flatMap((slug) =>
+      localizedPair(`/agentx/optimizations/${slug}`, {
+        lastModified: now,
+        changeFrequency: 'monthly' as const,
+        priority: 0.6,
+      }),
+    ),
     ...localizedPair('/api', { lastModified: now, changeFrequency: 'monthly', priority: 0.7 }),
     ...localizedPair('/blog', { lastModified: now, changeFrequency: 'weekly', priority: 0.8 }),
     ...localizedPair('/glossary', {

packages/app/src/app/zh/agentx/optimizations/[framework]/page.tsx

@@ -0,0 +1,68 @@
+import type { Metadata } from 'next';
+import { notFound } from 'next/navigation';
+
+import { AgentXOptimizationsArticle } from '@/components/datasets/agentx-optimizations-article';
+import { JsonLd } from '@/components/json-ld';
+import {
+  AGENTX_OPTIMIZATION_FRAMEWORKS,
+  getOptimizationFramework,
+} from '@/lib/agentx-optimizations';
+import { getLocalizedFramework } from '@/lib/agentx-optimizations-zh';
+import { zhAlternates, ZH_LANG_TAG, ZH_OG_LOCALE } from '@/lib/i18n';
+import { SITE_URL } from '@semianalysisai/inferencex-constants';
+
+interface Props {
+  params: Promise<{ framework: string }>;
+}
+
+export function generateStaticParams() {
+  return AGENTX_OPTIMIZATION_FRAMEWORKS.map((entry) => ({ framework: entry.slug }));
+}
+
+export const dynamicParams = false;
+
+export async function generateMetadata({ params }: Props): Promise<Metadata> {
+  const { framework: slug } = await params;
+  const framework = getOptimizationFramework(slug);
+  if (!framework) return {};
+  const localized = getLocalizedFramework(framework, 'zh');
+  const title = `${framework.name} 智能体负载优化`;
+  return {
+    title,
+    description: localized.summary,
+    alternates: zhAlternates(`/agentx/optimizations/${slug}`),
+    openGraph: {
+      title: `${title} | InferenceX`,
+      description: localized.summary,
+      url: `${SITE_URL}/zh/agentx/optimizations/${slug}`,
+      locale: ZH_OG_LOCALE,
+    },
+    twitter: { title: `${title} | InferenceX`, description: localized.summary },
+  };
+}
+
+export default async function AgentXOptimizationsFrameworkPageZh({ params }: Props) {
+  const { framework: slug } = await params;
+  const framework = getOptimizationFramework(slug);
+  if (!framework) notFound();
+
+  const localized = getLocalizedFramework(framework, 'zh');
+  const jsonLd = {
+    '@context': 'https://schema.org',
+    '@type': 'TechArticle',
+    headline: `${framework.name} 智能体负载优化`,
+    description: localized.summary,
+    url: `${SITE_URL}/zh/agentx/optimizations/${slug}`,
+    inLanguage: ZH_LANG_TAG,
+    isPartOf: { '@type': 'WebSite', name: 'InferenceX', url: SITE_URL },
+  };
+
+  return (
+    <main className="relative">
+      <JsonLd data={jsonLd} />
+      <div className="container mx-auto max-w-6xl px-4 pb-12 lg:px-8">
+        <AgentXOptimizationsArticle slug={slug} locale="zh" />
+      </div>
+    </main>
+  );
+}