docs(aigw): restore the screenshots the top-40 triage cleared by vrv-panw · Pull Request #1091 · Portkey-AI/docs-core

vrv-panw · 2026-09-21T08:39:04Z

Phase 1 of the Prisma AIRS migration stripped every image reference out of aigw/ and left the assets on disk, because the Latest version still uses them. This puts back the ones that were cleared to come back as-is.

135 references were cleared by opening all 40 of the most-referenced image files and judging each one. This PR restores 135 of them across 59 pages — additions only, no deletions, no prose changes.

How the three commits split up

b1ca2bea — 108 references placed by script. Placement is by anchor, not by diff: Phase 2 rewrote the prose and links around these blocks, so a line-level diff against the Latest twin returns almost every hunk as a replace whose start is nowhere near the image. Instead each block is pinned to the nearest preceding line that is identical in both copies and unique in both, and that anchor has to be adjacent. An earlier version allowed a 30-line gap and carried the gap with it, dragging un-rebranded prose and Latest-version links onto the pages; that run was reverted before anything was committed.
e9b6d295 — 25 placed by hand, on pages where Phase 2 rewrote the line directly above the image and left no common anchor.
0f72a7ee — the last two, each needing a judgement the script cannot make. llama-agents.mdx had lost its whole ## Integration Guide section, so the Colab badge came back with the two lines around it, matching the four sibling agent pages that still have theirs. model-provisioning-page.png moved house: Phase 2 split Model Provisioning out of model-catalog/integrations.mdx into its own page, so it now sits under ## Setting Up Model Provisioning there.

What is deliberately not here

Six card-grid logos. A grid is all-or-nothing — four illustrated cards among sixteen bare ones reads as breakage. They unblock when the rest of their logos are classified.
67 files that need a tenant, 14 that need a redaction, 8 diagram redraws, and 4 that document retired surfaces and should be dropped rather than re-shot. All judged and recorded, none of it applied here.
The whole tail below two references — classified, but applying it is deferred by choice. Scope here stops at the top 40.

Checks

mint validate green. No cross-links added, so mint broken-links is not implicated. Every restored path was confirmed present on disk.

Worth knowing, separately from this PR

The triage turned up published screenshots carrying data that is not ours to publish — a real client IP and sec-websocket-key, an OAuth identity token, an API-key-shaped literal, and seven identifiable customers. None of those files are touched here; they are re-captures or redactions, and they are live on the Latest version regardless of what this PR does.

🤖 Generated with Claude Code

The top-40 image triage classified 40 files; 26 of them were clear to restore as-is or with a caveat, worth 135 references. This restores 108 of those 135. Nothing was captured and no image was edited -- Phase 1 stripped the references and left the assets on disk, so this is the references coming back. Placement is by anchor, not by diff. A line diff against the Latest twin is useless here: Phase 2 rewrote the prose and relinked every route around these blocks, so nearly every hunk comes back as a `replace` whose start is nowhere near the image -- on the card grids, the top of the <CardGroup>. Instead each block is anchored to the nearest preceding line that is identical and unique in both files, and the anchor has to be adjacent, with nothing but blank lines between it and the image. That adjacency rule is the whole safety margin, and it was learned the hard way. The first pass allowed a 30-line gap and carried the gap along with the block -- which dragged back paragraphs of un-rebranded Portkey copy and Latest-version links alongside the screenshots. Reverted and rewritten. 27 references now fail the rule and are left for a person; that is the right trade. Two captions came back reading "Portkey Analytics Dashboard" and were rewritten by hand. Six more are inside card grids, held back deliberately: four illustrated cards among sixteen bare ones reads as breakage where sixteen bare ones reads as a choice, so those wait for the rest of the tail. mint validate green, mint broken-links reports nothing under aigw/, and every restored path was checked to exist on disk -- which no tool does for us yet. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

The anchor rule left 27 references unplaced. This lands 25 of them, and shows what the other two actually are. Five came back from a fix to the script rather than by hand. Its idea of an image block only understood a one-line <img>, so on a multi-line one -- `<img`, `src=` and `width=` on separate lines, which is how claude-cowork.mdx and cursor.mdx write them -- the block started at the `src` line and the anchor it found was the bare `<img` above it. Widened to take in the open tag, the attribute lines and the closer. The remaining twenty were hand-placed, and they all failed for the same reason: the line directly above the image is a step instruction, and Phase 2 rewrote the link inside it from app.portkey.ai to Strata Cloud Manager. The anchor is still there to a reader; it is not there to a string comparison. Teaching norm() about each rewrite would have made the script quietly clever, which is not what it is for -- it earns its keep by being obviously right. Two are not image problems at all, and stay out: llama-agents.mdx and product/model-catalog/integrations.mdx are missing the whole section the image sat in -- "Integration Guide" and "Setting Up Model Provisioning". Putting the picture back means writing the section back, which is a content decision and not one to slip into an asset pass. Six card-grid logos are still held, unchanged in reasoning: a grid is all-or-nothing and the rest of its logos are in the untriaged tail. One alt text came back reading "Add Provider page in Portkey Model Catalog" and was rewritten. mint validate green, no broken links under aigw/, anchors green. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

Closes out the top-40 restore pass. Both needed a judgement the anchor script cannot make. llama-agents.mdx had lost its whole "Integration Guide" section, so the Colab badge came back with the two lines around it, matching the four sibling agent pages that still have theirs. model-provisioning-page.png moved house: Phase 2 split Model Provisioning out of model-catalog/integrations.mdx into its own page, so the image now sits under "Setting Up Model Provisioning" there. The script still reports it as NO ANCHOR against integrations.mdx because it compares each page to its twin and cannot see that the content moved. Six card-grid logos stay held back; a grid is all-or-nothing and the rest of its logos are in the unclassified supported-llm tail. mint validate green. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

Your call: the Prisma AIRS UI differs enough from Portkey's that legacy captures work as substitutes, and the branding has moved on since they were taken. So the 25 files the re-triage cleared as branding-only go back in, and every page carrying one that also shows retired navigation says so at the top. 51 references across 44 pages. Twenty placed by restore_images.py once APPROVED was widened; the other thirty-one by hand, because Phase 2 had rewritten the anchor line itself -- "Portkey dashboard" became "Strata Cloud Manager" in the very sentence the image hung from, leaving nothing that matched in both copies. The note is a snippet on 27 pages, not all 44. A wordmark in a screenshot is a branding lag a reader can ignore; a Prompts or Virtual Keys item in the sidebar is something they might go looking for. Only the second kind gets a warning. Alt text and captions rebranded on the way in -- a reader reads them, so the naming rule applies. Additions only. mint validate green; every restored src confirmed on disk. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

mintlify · 2026-09-21T09:17:00Z

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated
portkey-docs	🟢 Ready	View Preview	Sep 23, 2026, 6:20 PM

Phase 2 replaced the brand name without reading the sentence around it, so "Portkey's fast AI gateway" became "The AI Gateway's fast AI gateway" and "Portkey's AI gateway" became "Prisma AIRS AI Gateway's AI gateway". Eleven occurrences across eleven files: two in body prose, eight in frontmatter descriptions, and gcp.mdx offering "the AI Gateway Gateway's Load Balancer". Two of the same shape are left alone on purpose. prometheus-metrics.mdx says "The AI Gateway Enterprise Gateway" five times and agent-gateway/quickstart.mdx says "the AI Gateway Agent Gateway" -- in both, the second Gateway may be an actual product name, which is a product question rather than a copy-edit. mint validate green. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

PrivateLink / Private Service Connect is not an option we document for Prisma AIRS, so the five hybrid-deployment guides now describe a single inbound path (IP whitelisting) and a single outbound path (over the internet). Removed: the PrivateLink, Private Link and Private Service Connect sections in eks, ecs, aks, aca and gcp, together with the PrivateLink basepaths in the aks and gcp values.yaml samples and the PrivateLink row in the ecs load-balancer table. The one-item bullet lists the removals left behind are now prose, and architecture.mdx no longer describes the inter-plane hop as "a private link". The three hardcoded Management Plane IPs are gone with them -- the whitelisting instructions now point at the Palo Alto Networks team for the current list, and the ecs `allowed_lb_cidrs` sample uses RFC 5737 documentation addresses. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

A hybrid gateway on EC2/Docker could not reach an internal MCP server even after its IP was added to TRUSTED_CUSTOM_HOSTS. The allowlist matches the hostname in the URL, not the resolved IP, and the SSRF error names the IP, which points people the wrong way. New page covers where to set the variable per deployment type (Helm, ECS/ACA Terraform, Docker Compose with the setup script), how to verify it inside the container, and a troubleshooting table. Custom hosts and internal MCP servers pages now link to it. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Copilot

Copilot review overview

🟡 Changes recommended

Unresolved critical/moderate findings cover connectivity removals and commands, alongside Colab, anchor, alt-text, and scope findings.

Get a fresh assessment by requesting another Copilot review.

Review effort: Lite
Findings: 1 · 6 · 3

Open (10)

Restore removed ECS PrivateLink documentation · New
Restore removed AWS PrivateLink documentation · New
Restore removed ACA Private Link documentation · New
Restore removed Azure Private Link documentation · New
Restore removed GCP Private Service Connect documentation · New
Target the gateway deployment explicitly · New
Include the required MCP route prefix · New
Fix inaccurate alt text for analytics screenshot · New
Update PR description for added cross-links · New
Fix misspelling of load-balancer listener · New

What changed in this PR

Restores triaged AI Gateway screenshots and Colab references, while adding private-network guidance and revising hybrid connectivity documentation.

Changes:

Restores 135 screenshots across AI Gateway documentation.
Adds legacy screenshot notes and private-network navigation/guidance.
Updates hybrid connectivity documentation, with unresolved findings involving PrivateLink/PSC removals, commands, links, Colab targeting, and alt text.

File	Reviewed change
`snippets/aigw/legacy-screenshot-note.mdx`	Adds reusable legacy screenshot note.
`docs.json`	Adds private-network page navigation.
`aigw/self-hosting/private-network-access.mdx`	Adds private-service guidance; command and anchor findings remain.
`aigw/self-hosting/hybrid-deployments/gcp.mdx`	Updates connectivity guidance; PSC and typo findings remain.
`aigw/self-hosting/hybrid-deployments/azure/aks.mdx`	Updates connectivity guidance; Private Link removal finding remains.
`aigw/self-hosting/hybrid-deployments/azure/aca.mdx`	Updates connectivity guidance; Private Link removal finding remains.
`aigw/self-hosting/hybrid-deployments/aws/eks.mdx`	Updates connectivity guidance; PrivateLink removal finding remains.
`aigw/self-hosting/hybrid-deployments/aws/ecs.mdx`	Updates connectivity guidance; critical PrivateLink removal finding remains.
`aigw/self-hosting/hybrid-deployments/architecture.mdx`	Updates connectivity architecture wording.
`aigw/product/observability/traces.mdx`	Restores tracing screenshot.
`aigw/product/observability/opentelemetry.mdx`	Restores OpenTelemetry screenshot.
`aigw/product/observability/metadata.mdx`	Restores metadata screenshots.
`aigw/product/observability/auto-instrumentation.mdx`	Restores instrumentation screenshot.
`aigw/product/observability/analytics.mdx`	Restores analytics screenshot.
`aigw/product/observability.mdx`	Restores observability screenshot.
`aigw/product/model-catalog/model-provisioning.mdx`	Restores provisioning screenshot.
`aigw/product/model-catalog/integrations.mdx`	Restores catalog screenshots.
`aigw/product/mcp-gateway/internal-mcp-servers.mdx`	Adds private-service guidance.
`aigw/product/guardrails/pii-redaction.mdx`	Restores regex screenshot.
`aigw/product/guardrails/embedding-guardrails.mdx`	Restores guardrail screenshot.
`aigw/product/guardrails.mdx`	Restores guardrail screenshot.
`aigw/product/enterprise-offering/secret-references.mdx`	Adds legacy note and screenshot.
`aigw/product/enterprise-offering/org-management/scim/azure-ad.mdx`	Adds legacy note and screenshot.
`aigw/product/ai-gateway/remote-mcp.mdx`	Cleans page description.
`aigw/product/ai-gateway/multimodal-capabilities/vision.mdx`	Cleans description and restores screenshot.
`aigw/product/ai-gateway/multimodal-capabilities/text-to-speech.mdx`	Cleans page description.
`aigw/product/ai-gateway/multimodal-capabilities/speech-to-text.mdx`	Cleans page description.
`aigw/product/ai-gateway/multimodal-capabilities/image-generation.mdx`	Cleans description and restores screenshot.
`aigw/product/ai-gateway/multimodal-capabilities/function-calling.mdx`	Restores function-calling screenshot.
`aigw/product/ai-gateway/custom-hosts.mdx`	Adds internal-service guidance; scope finding remains.
`aigw/product/ai-gateway/canary-testing.mdx`	Cleans page description.
`aigw/product/agent-gateway/registry.mdx`	Restores capabilities screenshot.
`aigw/product/agent-gateway/quickstart.mdx`	Restores setup screenshots.
`aigw/product/administration/enforce-budget-and-rate-limit.mdx`	Adds legacy note and screenshot.
`aigw/integrations/tracing-providers/traceloop.mdx`	Restores tracing screenshot.
`aigw/integrations/tracing-providers/phoenix.mdx`	Restores tracing screenshot.
`aigw/integrations/tracing-providers/opentelemetry-python-sdk.mdx`	Restores tracing screenshot.
`aigw/integrations/tracing-providers/openlit.mdx`	Restores tracing screenshot.
`aigw/integrations/tracing-providers/ml-flow.mdx`	Restores tracing screenshot.
`aigw/integrations/tracing-providers/logfire.mdx`	Restores tracing screenshot.
`aigw/integrations/tracing-providers/langsmith.mdx`	Cleans page description.
`aigw/integrations/tracing-providers/langfuse.mdx`	Adds legacy note and screenshot.
`aigw/integrations/tracing-providers/honeyhive.mdx`	Adds legacy note and screenshot.
`aigw/integrations/tracing-providers/future-agi.mdx`	Adds legacy note and screenshot.
`aigw/integrations/plugins/exa.mdx`	Restores Exa screenshots.
`aigw/integrations/llms/openai.mdx`	Restores image-generation screenshot; alt-text finding remains.
`aigw/integrations/llms/byollm.mdx`	Restores dashboard screenshot.
`aigw/integrations/llms/azure-openai/azure-openai.mdx`	Restores Azure screenshots.
`aigw/integrations/llms/azure-foundry.mdx`	Restores Azure Foundry screenshots.
`aigw/integrations/libraries/zed.mdx`	Restores provider screenshot.
`aigw/integrations/libraries/vercel.mdx`	Restores dashboard screenshot.
`aigw/integrations/libraries/roo-code.mdx`	Restores provider screenshot.
`aigw/integrations/libraries/pi-agent.mdx`	Restores provider and limits screenshots.
`aigw/integrations/libraries/openwebui.mdx`	Restores catalog screenshots.
`aigw/integrations/libraries/openai-compatible.mdx`	Adds legacy note and screenshot.
`aigw/integrations/libraries/openai-agent-builder.mdx`	Restores Agent Builder screenshots.
`aigw/integrations/libraries/openai-agent-builder-python.mdx`	Restores Agent Builder screenshots.
`aigw/integrations/libraries/n8n.mdx`	Restores provider and API-key screenshots.
`aigw/integrations/libraries/llama-index-python.mdx`	Adds legacy note and screenshot.
`aigw/integrations/libraries/librechat.mdx`	Adds legacy note and setup screenshots.
`aigw/integrations/libraries/langflow.mdx`	Restores provider and API-key screenshots.
`aigw/integrations/libraries/langchain-python.mdx`	Adds legacy note and tracing screenshots.
`aigw/integrations/libraries/langchain-js.mdx`	Adds legacy note and tracing screenshots.
`aigw/integrations/libraries/janhq.mdx`	Restores provider screenshot.
`aigw/integrations/libraries/hermes-agent.mdx`	Restores provider and limits screenshots.
`aigw/integrations/libraries/goose.mdx`	Restores provider screenshot.
`aigw/integrations/libraries/github-copilot.mdx`	Restores catalog screenshots.
`aigw/integrations/libraries/dspy.mdx`	Adds legacy note and observability screenshots.
`aigw/integrations/libraries/cursor.mdx`	Restores provider screenshot.
`aigw/integrations/libraries/continue-dev.mdx`	Restores provider screenshot.
`aigw/integrations/libraries/conductor.mdx`	Restores provider screenshot.
`aigw/integrations/libraries/codex.mdx`	Restores provider screenshot.
`aigw/integrations/libraries/cline.mdx`	Restores provider screenshot.
`aigw/integrations/libraries/claude-desktop-platform-admins.mdx`	Restores provider screenshot.
`aigw/integrations/libraries/claude-desktop-developers.mdx`	Restores Claude Desktop screenshots.
`aigw/integrations/libraries/claude-cowork.mdx`	Restores Claude Cowork screenshots.
`aigw/integrations/libraries/claude-code-vertex.mdx`	Restores provider and limits screenshots.
`aigw/integrations/libraries/claude-code-bedrock.mdx`	Restores provider and limits screenshots.
`aigw/integrations/libraries/claude-code-anthropic.mdx`	Restores provider and limits screenshots.
`aigw/integrations/libraries/autogen.mdx`	Restores observability screenshot.
`aigw/integrations/libraries/anythingllm.mdx`	Restores provider screenshot.
`aigw/integrations/libraries/anthropic-computer-use.mdx`	Adds legacy note and observability screenshot.
`aigw/integrations/libraries/android-studio.mdx`	Restores provider screenshot.
`aigw/integrations/guardrails/regex.mdx`	Restores regex screenshot.
`aigw/integrations/guardrails/azure-guardrails.mdx`	Restores guardrail screenshot.
`aigw/integrations/agents/strands.mdx`	Restores tracing screenshot.
`aigw/integrations/agents/pydantic-ai.mdx`	Adds legacy note and observability screenshots.
`aigw/integrations/agents/phidata.mdx`	Adds legacy note, badge, and logs screenshot.
`aigw/integrations/agents/openai-swarm.mdx`	Adds legacy note and observability screenshots.
`aigw/integrations/agents/openai-agents.mdx`	Adds legacy note and observability screenshots.
`aigw/integrations/agents/openai-agents-ts.mdx`	Adds legacy note and observability screenshots.
`aigw/integrations/agents/mastra-agents.mdx`	Adds legacy note and observability screenshots.
`aigw/integrations/agents/llama-agents.mdx`	Restores guide badge and logs screenshot.
`aigw/integrations/agents/livekit.mdx`	Adds legacy note and setup screenshots.
`aigw/integrations/agents/langgraph.mdx`	Adds legacy note and observability screenshots.
`aigw/integrations/agents/langchain-agents.mdx`	Adds legacy note and badge; Colab-target finding remains.
`aigw/integrations/agents/crewai.mdx`	Adds legacy note and observability screenshots.
`aigw/integrations/agents/control-flow.mdx`	Adds legacy note, badge, and logs screenshot.
`aigw/integrations/agents/claude-agent-sdk.mdx`	Restores provider screenshot.
`aigw/integrations/agents/bring-your-own-agents.mdx`	Adds legacy note, badge, and logs screenshot.
`aigw/integrations/agents/autogen.mdx`	Restores observability and catalog screenshots.
`aigw/integrations/agents/agno-ai.mdx`	Restores provisioning, observability, and catalog screenshots.
`aigw/integrations/agents.mdx`	Adds legacy note and analytics screenshot; alt-text finding remains.
`aigw/guides/use-cases/librechat-web-search.mdx`	Restores Exa screenshots.
`aigw/api-reference/inference-api/authentication.mdx`	Adds legacy note and API-key screenshot.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

vrv-panw and others added 4 commits September 21, 2026 11:54

mintlify Bot deployed to staging September 21, 2026 09:16 View deployment

mintlify Bot deployed to staging September 21, 2026 09:28 View deployment

mintlify Bot deployed to staging September 22, 2026 11:36 View deployment

Copilot AI lite review requested due to automatic review settings September 23, 2026 18:18

Copilot started reviewing on behalf of vrv-panw September 23, 2026 18:19 View session

mintlify Bot deployed to staging September 23, 2026 18:20 View deployment

Copilot AI reviewed Sep 23, 2026

View reviewed changes

roh26it approved these changes Sep 24, 2026

View reviewed changes

vrv-panw merged commit fe61d3d into main Sep 24, 2026
4 checks passed

Navigation Menu

docs(aigw): restore the screenshots the top-40 triage cleared - #1091

docs(aigw): restore the screenshots the top-40 triage cleared#1091
vrv-panw merged 7 commits into
mainfrom
docs/prisma-airs-updates

vrv-panw commented Sep 21, 2026

Uh oh!

mintlify Bot commented Sep 21, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

This branch was successfully deployed

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

vrv-panw commented Sep 21, 2026

How the three commits split up

What is deliberately not here

Checks

Worth knowing, separately from this PR

Uh oh!

mintlify Bot commented Sep 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Copilot review overview

🟡 Changes recommended

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

This branch was successfully deployed

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

mintlify Bot commented Sep 21, 2026 •

edited

Loading