Multi-Agent and Proxy - Aion Docs

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

aion:
  agents:
    support:
      path: "./support.py:build_graph"
      framework: "langgraph"

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

Routing Pattern

/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

# 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