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

​
Configuration Settings

SettingLocationDescription
aion.agentsaion.yamlDefines the set of agent IDs available behind the proxy.
aion.agents.<agent_id>.pathaion.yamlRequired import target for each routed agent.
aion.agents.<agent_id>.frameworkaion.yamlFramework adapter per agent (langgraph or adk).
--portaion serveSets fixed proxy port.
--port-range-startaion serveStart of dynamic assignment range.
--port-range-endaion serveEnd of dynamic assignment range.
--agent-idaion chatTargets 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