Skip to content

Docs: lead with the agentcore_gateway backend; diagram the private Lattice path - #46

Merged
odinwang merged 1 commit into
mainfrom
docs/agentcore-gateway-litellm
Oct 1, 2026
Merged

odinwang merged 1 commit into
mainfrom
docs/agentcore-gateway-litellm

Conversation

@odinwang

@odinwang odinwang commented Oct 1, 2026

Copy link
Copy Markdown
Contributor

Summary

Follow-up to #40 and #45.

  • README. The intro and quick start described llm-edge as the way model traffic is governed. They now present both gateway modes. agentcore_gateway comes first: AgentCore Gateway sits in front of LiteLLM, the key is held in the token vault, kernels sign with per-session SigV4, the runtime reaches the gateway over PrivateLink and the gateway reaches LiteLLM over VPC Lattice. llm-edge with the fixed NAT EIP is listed as the alternative. Step 2 of the quick start now branches by backend instead of always storing a key for llm-edge.
  • New diagram docs/images/agentcore-gateway-litellm.svg (animated, light theme), with a matching architecture.md section that goes through each hop. Most of this behaviour is not written down in one place in the AgentCore docs yet:
    • what the inference provider target actually does: it matches path and model, swaps in the key, and relays the body and SSE stream verbatim, with no protocol translation; only three paths are accepted
    • provider.endpoint is the name on the publicly trusted certificate and is sent as SNI/Host; routingDomain is the internal ALB DNS that Lattice connects to
    • the 350-second Lattice resource idle timeout, after which a long non-streaming call hangs without returning an error
  • The hero diagram caption and deployment.md Option A2 now link to the new diagram and section.

Docs only, no code changes.

Test plan

  • Both SVGs pass xmllint; rendered headless and checked by eye for clipped or overlapping labels
  • Anchor #how-the-agentcore_gateway-backend-reaches-a-private-litellm matches GitHub's slug for the new heading
  • Public-repo scrub scan (internal names, account IDs, resource IDs, CJK) clean

🤖 Generated with Claude Code

README no longer describes llm-edge as the only way to keep the model key
out of containers. It now presents both gateway modes, with
agentcore_gateway (AgentCore Gateway in front of LiteLLM, key in the token
vault, per-session SigV4) first, and llm-edge plus the fixed NAT EIP as the
alternative. The quick start's step 2 branches by backend instead of always
storing a key for llm-edge.

New diagram docs/images/agentcore-gateway-litellm.svg and an architecture.md
section that walks every hop: loopback shim and per-session STS, the
gateway interface endpoint, what the inference provider target does (match
path and model, swap the key, relay verbatim, no translation), and the
managed VPC Lattice private endpoint, including what provider.endpoint and
routingDomain each do and the 350-second Lattice idle timeout that hangs
long non-streaming calls. The hero diagram caption and deployment.md Option
A2 point at it.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@odinwang
odinwang merged commit 2c53db0 into main Oct 1, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant