diff --git a/public/docs-static/img/agent-network/clusters/agent-network-clusters-list.png b/public/docs-static/img/agent-network/clusters/agent-network-clusters-list.png new file mode 100644 index 00000000..5372d523 Binary files /dev/null and b/public/docs-static/img/agent-network/clusters/agent-network-clusters-list.png differ diff --git a/public/docs-static/img/agent-network/clusters/agent-network-setup-cluster.png b/public/docs-static/img/agent-network/clusters/agent-network-setup-cluster.png new file mode 100644 index 00000000..d837cd56 Binary files /dev/null and b/public/docs-static/img/agent-network/clusters/agent-network-setup-cluster.png differ diff --git a/src/components/NavigationDocs.jsx b/src/components/NavigationDocs.jsx index 356c16a3..da675dba 100644 --- a/src/components/NavigationDocs.jsx +++ b/src/components/NavigationDocs.jsx @@ -483,6 +483,7 @@ export const docsNavigation = [ { title: 'How It Works', href: '/agent-network/how-it-works' }, { title: 'Quickstart', href: '/agent-network/quickstart' }, { title: 'Providers', href: '/agent-network/providers' }, + { title: 'Clusters', href: '/agent-network/clusters' }, ], }, { diff --git a/src/pages/agent-network/clusters.mdx b/src/pages/agent-network/clusters.mdx new file mode 100644 index 00000000..31ab195e --- /dev/null +++ b/src/pages/agent-network/clusters.mdx @@ -0,0 +1,40 @@ +import { Note } from '@/components/mdx' + +export const description = + 'Proxy clusters serve the Agent Network endpoint, routing your agents\' traffic to LLM APIs and gateways on infrastructure you run. Add multiple clusters to scale the environment.' + +# Clusters + +A **cluster** is a set of reverse proxies that serve your [Agent Network endpoint](/agent-network/how-it-works). +Agents point at the endpoint hostname over the WireGuard tunnel; the proxy cluster terminates that +traffic, enforces identity, policies, limits, and guardrails, and forwards each request to the +upstream LLM API or gateway. + +Clusters run on **your own infrastructure**, so agent traffic terminates on machines you operate — +giving you control over the data path, geographic placement, and TLS. Add **multiple proxies and clusters** to +scale the environment: spread load across more proxy instances, place them closer to your agents or +upstreams, and keep the endpoint available if one goes down. + + + Agent Network clusters are the same mechanism as Reverse Proxy clusters, scoped to your account + (**account clusters**). See [Bring Your Own Proxy](/manage/reverse-proxy/bring-your-own-proxy) for + the full cluster model. + + +## Manage Clusters + +Go to **Agent Network → Configuration → Clusters** to see every cluster serving your account, along +with the number of connected proxies, online status, and the capabilities each proxy reports. + +

+ Agent Network clusters list under Configuration +

+ +Use **Setup Self-Hosted Cluster** to register a new one. Enter a domain for the cluster and pick a +**Deployment Method**: run it yourself with Docker, or use one of the **1-click deployments** for +popular cloud providers to stand up a proxy in a few clicks. The wizard then walks you through the +DNS records to add and starting the proxy. + +

+ Setup Cluster wizard with domain and deployment method +

\ No newline at end of file