diff --git a/public/docs-static/img/agent-network/how-it-works/agent-network-diagram-2.png b/public/docs-static/img/agent-network/how-it-works/agent-network-diagram-internal-resources.png similarity index 70% rename from public/docs-static/img/agent-network/how-it-works/agent-network-diagram-2.png rename to public/docs-static/img/agent-network/how-it-works/agent-network-diagram-internal-resources.png index c2e195ca..c14dec52 100644 Binary files a/public/docs-static/img/agent-network/how-it-works/agent-network-diagram-2.png and b/public/docs-static/img/agent-network/how-it-works/agent-network-diagram-internal-resources.png differ diff --git a/public/docs-static/img/agent-network/how-it-works/agent-network-diagram.png b/public/docs-static/img/agent-network/how-it-works/agent-network-diagram-llm-apis.png similarity index 100% rename from public/docs-static/img/agent-network/how-it-works/agent-network-diagram.png rename to public/docs-static/img/agent-network/how-it-works/agent-network-diagram-llm-apis.png diff --git a/src/pages/agent-network/how-it-works.mdx b/src/pages/agent-network/how-it-works.mdx index f43840bb..cc060a4a 100644 --- a/src/pages/agent-network/how-it-works.mdx +++ b/src/pages/agent-network/how-it-works.mdx @@ -40,12 +40,12 @@ into `metadata.tags` and its identity into the `x-litellm-end-user-id` header, s can apply tag budgets and per-user attribution.

- agent network LLM request path through the NetBird proxy + agent network LLM request path through the NetBird proxy

- **NetBird client** — the agent's device joins the overlay as a peer. Its requests to the endpoint are routed through the WireGuard tunnel, not the public internet. -- **Proxy peer** — handles **LLM traffic only**. It terminates the request, establishes +- **Proxy peer** — handles LLM traffic only. It terminates the request, establishes the caller's identity, runs the routing and policy pipeline, injects the provider key, and forwards to the upstream API or gateway. - **Management service** — the control plane. It holds providers, policies, guardrails, @@ -71,10 +71,12 @@ access policies, so it can reach only the resources it is authorized for. Becaus traffic never passes through the proxy, this path has no agent network endpoint, no provider-key injection, and no token, budget, or per-request LLM logging — it is governed like standard NetBird peer-to-peer access. This keeps internal traffic fast and private, -flowing straight between the two peers. +flowing straight between the two peers. Because NetBird is a peer-to-peer network, this +also works in reverse, so a resource can reach back to an agent when needed, such as to +deliver a callback or webhook.

- agent network internal resource request path through WireGuard overlay

@@ -88,8 +90,8 @@ request through an ordered pipeline. Conceptually: ```text request ─▶ identity ─▶ parse model ─▶ route to provider ─▶ policy & limits │ - allow │ deny → 403 - ▼ + allow │ deny → 403 + ▼ response ◀─ meter tokens & cost ◀─ upstream call ◀─ inject provider key │ ▼