Add Agent Network Clusters (#856)

This commit is contained in:
Misha Bragin
2026-08-05 16:23:34 +02:00
committed by GitHub
parent 07b1245bcf
commit d77631a5ed
4 changed files with 41 additions and 0 deletions

Binary file not shown.

After

Width:  |  Height:  |  Size: 499 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 169 KiB

View File

@@ -487,6 +487,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' },
],
},
{

View File

@@ -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.
<Note>
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.
</Note>
## 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.
<p>
<img src="/docs-static/img/agent-network/clusters/agent-network-clusters-list.png" alt="Agent Network clusters list under Configuration" className="imagewrapper-big" />
</p>
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.
<p>
<img src="/docs-static/img/agent-network/clusters/agent-network-setup-cluster.png" alt="Setup Cluster wizard with domain and deployment method" className="imagewrapper" />
</p>