Skip to content

🪢 Open source agent evals & observability: Trace, evaluate, and improve LLM applications with one open platform.

fix(ai-gateway): point docs links at the restructured AI Gateway docs (#19632)

Tobias Wochinger250c7abdfb9d
diff --git a/web/src/features/ai-gateway/components/GatewayApiKeysPage/components/SetupInstructions/fns/agentSetupInstructions/AGENTS.md b/web/src/features/ai-gateway/components/GatewayApiKeysPage/components/SetupInstructions/fns/agentSetupInstructions/AGENTS.md
index 7d3b8c831c..c3ff57aff6 100644
--- a/web/src/features/ai-gateway/components/GatewayApiKeysPage/components/SetupInstructions/fns/agentSetupInstructions/AGENTS.md
+++ b/web/src/features/ai-gateway/components/GatewayApiKeysPage/components/SetupInstructions/fns/agentSetupInstructions/AGENTS.md
@@ -7,10 +7,10 @@ Snippets shown after a gateway API key is created, one builder per tab.
The Langfuse docs own this content. These builders are a condensed copy:
- API: https://langfuse.com/docs/ai-gateway/get-started/first-request
-- Claude Code: https://langfuse.com/docs/ai-gateway/coding-agents/claude-code
-- Codex: https://langfuse.com/docs/ai-gateway/coding-agents/codex
-- OpenCode: https://langfuse.com/docs/ai-gateway/coding-agents/opencode
-- GitHub Copilot CLI and app: https://langfuse.com/docs/ai-gateway/coding-agents/github-copilot
+- Claude Code: https://langfuse.com/docs/ai-gateway/integrations/claude-code
+- Codex: https://langfuse.com/docs/ai-gateway/integrations/codex
+- OpenCode: https://langfuse.com/docs/ai-gateway/integrations/opencode
+- GitHub Copilot CLI and app: https://langfuse.com/docs/ai-gateway/integrations/github-copilot
Change the docs first (`langfuse/langfuse-docs`), then mirror the change here.
Do not add steps, paths or env vars that the docs do not describe.
@@ -19,7 +19,6 @@ Do not add steps, paths or env vars that the docs do not describe.
- Builders never receive the secret key; they emit `GATEWAY_KEY_PLACEHOLDER`. Right after creation, `StepCodeSection` swaps it for the key at render time (masked until revealed, copied in full). Without a key, `AgentSetupSteps` adds a replace-the-placeholder hint, so step descriptions must not mention the placeholder themselves. "Copy for agent" keeps the placeholder.
- Prefix shell lines that set or write the key (`export`, the Codex heredoc) with a space so shells with `ignorespace` / `HIST_IGNORE_SPACE` skip them in history. Also prefix the first line of every key-bearing snippet: a bracketed multi-line paste is saved as one history entry, and only its first character counts.
-- Paths differ per tool (`/anthropic` vs `/anthropic/v1`); keep them as the
- docs list them under "Base URLs at a glance".
+- Paths differ per tool (`/anthropic` vs `/anthropic/v1`); keep them as each integration page lists them.
- Builders are pure: `(context: AgentSetupContext) => AgentSetupInstructions`.
`formatAgentSetupMarkdown` renders the same data for "Copy for agent".
diff --git a/web/src/features/ai-gateway/components/GatewayLaunch/GatewayLaunchDialog.tsx b/web/src/features/ai-gateway/components/GatewayLaunch/GatewayLaunchDialog.tsx
index e646e7eac3..2ed9083cf5 100644
--- a/web/src/features/ai-gateway/components/GatewayLaunch/GatewayLaunchDialog.tsx
+++ b/web/src/features/ai-gateway/components/GatewayLaunch/GatewayLaunchDialog.tsx
@@ -15,7 +15,7 @@ import {
} from "@/src/features/ai-gateway/hooks/useGatewayLaunchEligibility";
import { usePostHogClientCapture } from "@/src/features/posthog-analytics/usePostHogClientCapture";
import { GatewayHero } from "@/src/features/ai-gateway/components/GatewayLaunch/GatewayHero";
-import { GATEWAY_DOCS_URL } from "@/src/features/ai-gateway/constants/gatewayDocsUrls";
+import { GATEWAY_OVERVIEW_DOCS_URL } from "@/src/features/ai-gateway/constants/gatewayDocsUrls";
const copy = {
admin: {
@@ -93,7 +93,7 @@ export function GatewayLaunchDialog({
</div>
<div className="flex shrink-0 items-center justify-between border-t px-8 py-4">
<Link
- href={GATEWAY_DOCS_URL}
+ href={GATEWAY_OVERVIEW_DOCS_URL}
target="_blank"
rel="noopener noreferrer"
onClick={() =>
diff --git a/web/src/features/ai-gateway/constants/agentSetupInstructions.ts b/web/src/features/ai-gateway/constants/agentSetupInstructions.ts
index b2b0fd7c41..888ea5e691 100644
--- a/web/src/features/ai-gateway/constants/agentSetupInstructions.ts
+++ b/web/src/features/ai-gateway/constants/agentSetupInstructions.ts
@@ -1,5 +1,5 @@
import {
- GATEWAY_CODING_AGENTS_DOCS_URL,
+ GATEWAY_INTEGRATIONS_DOCS_URL,
GATEWAY_FIRST_REQUEST_DOCS_URL,
} from "./gatewayDocsUrls";
@@ -7,10 +7,10 @@ export const GATEWAY_KEY_PLACEHOLDER = "<your-gateway-key>";
export const AGENT_SETUP_DOCS_URLS = {
api: GATEWAY_FIRST_REQUEST_DOCS_URL,
- "claude-desktop": `${GATEWAY_CODING_AGENTS_DOCS_URL}/claude-code#claude-desktop`,
- "claude-code": `${GATEWAY_CODING_AGENTS_DOCS_URL}/claude-code#claude-code-cli`,
- codex: `${GATEWAY_CODING_AGENTS_DOCS_URL}/codex`,
- opencode: `${GATEWAY_CODING_AGENTS_DOCS_URL}/opencode`,
- "copilot-cli": `${GATEWAY_CODING_AGENTS_DOCS_URL}/github-copilot#cli`,
- "copilot-desktop": `${GATEWAY_CODING_AGENTS_DOCS_URL}/github-copilot#app`,
+ "claude-desktop": `${GATEWAY_INTEGRATIONS_DOCS_URL}/claude-code#claude-desktop`,
+ "claude-code": `${GATEWAY_INTEGRATIONS_DOCS_URL}/claude-code#claude-code-cli`,
+ codex: `${GATEWAY_INTEGRATIONS_DOCS_URL}/codex`,
+ opencode: `${GATEWAY_INTEGRATIONS_DOCS_URL}/opencode`,
+ "copilot-cli": `${GATEWAY_INTEGRATIONS_DOCS_URL}/github-copilot#cli`,
+ "copilot-desktop": `${GATEWAY_INTEGRATIONS_DOCS_URL}/github-copilot#app`,
} as const;
diff --git a/web/src/features/ai-gateway/constants/gatewayDocsUrls.ts b/web/src/features/ai-gateway/constants/gatewayDocsUrls.ts
index 6939bf111f..208e7898b4 100644
--- a/web/src/features/ai-gateway/constants/gatewayDocsUrls.ts
+++ b/web/src/features/ai-gateway/constants/gatewayDocsUrls.ts
@@ -1,11 +1,12 @@
-export const GATEWAY_DOCS_URL = "https://langfuse.com/docs/ai-gateway";
+const GATEWAY_DOCS_BASE_URL = "https://langfuse.com/docs/ai-gateway";
-export const GATEWAY_SETUP_DOCS_URL = `${GATEWAY_DOCS_URL}/get-started/admin-setup`;
-export const GATEWAY_FIRST_REQUEST_DOCS_URL = `${GATEWAY_DOCS_URL}/get-started/first-request`;
-export const GATEWAY_MODELS_DOCS_URL = `${GATEWAY_DOCS_URL}/features/models`;
-export const GATEWAY_API_KEYS_DOCS_URL = `${GATEWAY_DOCS_URL}/features/api-keys`;
-export const GATEWAY_ANALYTICS_DOCS_URL = `${GATEWAY_DOCS_URL}/features/analytics`;
-export const GATEWAY_CODING_AGENTS_DOCS_URL = `${GATEWAY_DOCS_URL}/coding-agents`;
+export const GATEWAY_OVERVIEW_DOCS_URL = `${GATEWAY_DOCS_BASE_URL}/overview`;
+export const GATEWAY_SETUP_DOCS_URL = `${GATEWAY_DOCS_BASE_URL}/get-started/admin-setup`;
+export const GATEWAY_FIRST_REQUEST_DOCS_URL = `${GATEWAY_DOCS_BASE_URL}/get-started/first-request`;
+export const GATEWAY_MODELS_DOCS_URL = `${GATEWAY_DOCS_BASE_URL}/features/models`;
+export const GATEWAY_API_KEYS_DOCS_URL = `${GATEWAY_DOCS_BASE_URL}/features/api-keys`;
+export const GATEWAY_ANALYTICS_DOCS_URL = `${GATEWAY_DOCS_BASE_URL}/features/analytics`;
+export const GATEWAY_INTEGRATIONS_DOCS_URL = `${GATEWAY_DOCS_BASE_URL}/integrations`;
export const GATEWAY_SELF_HOSTING_DOCS_URL =
"https://langfuse.com/self-hosting/configuration/ai-gateway";