> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aion.to/llms.txt
> Use this file to discover all available pages before exploring further.

# Multi-Agent and Proxy

> Run multiple agents with a single proxy entrypoint.

The SDK can run multiple agents simultaneously. The proxy server provides path-based routing to each
agent.

## Configuration Settings

| Setting                            | Location     | Description                                              |
| ---------------------------------- | ------------ | -------------------------------------------------------- |
| `aion.agents`                      | `aion.yaml`  | Defines the set of agent IDs available behind the proxy. |
| `aion.agents.<agent_id>.path`      | `aion.yaml`  | Required import target for each routed agent.            |
| `aion.agents.<agent_id>.framework` | `aion.yaml`  | Framework adapter per agent (`langgraph` or `adk`).      |
| `--port`                           | `aion serve` | Sets fixed proxy port.                                   |
| `--port-range-start`               | `aion serve` | Start of dynamic assignment range.                       |
| `--port-range-end`                 | `aion serve` | End of dynamic assignment range.                         |
| `--agent-id`                       | `aion chat`  | Targets a specific agent when connecting through proxy.  |

## Configuration Example

```yaml theme={null}
aion:
  agents:
    support:
      path: "./support.py:build_graph"
      framework: "langgraph"

    onboarding:
      path: "./adk_agent.py:create_agent"
      framework: "adk"
```

## Routing Pattern

```text theme={null}
/agents/{agent_id}/{path}
```

Examples:

* `/agents/support/`
* `/agents/support/.well-known/agent-card.json`
* `/agents/onboarding/health/`

## Proxy Endpoints

* `GET /health/`
* `GET /health/system/`
* `GET /.well-known/manifest.json`
* `ANY /agents/{agent_id}/{path}`

## Chat Targeting

```bash theme={null}
# Default agent selected by chat flow
aion chat --host http://localhost:10000

# Explicit agent behind proxy
aion chat --host http://localhost:10000 --agent-id onboarding
```