Quickstart (ADK) - Aion Docs

ADK Object Requirements

The ADK adapter expects your configured path to resolve to one of these:

A BaseAgent instance
A factory function that returns a BaseAgent instance

1. Define an ADK Agent Module

Create agent_adk.py:

from google.adk.agents import BaseAgent
from your_project.agents import support_agent


def create_agent() -> BaseAgent:
    return support_agent

2. Configure `aion.yaml`

aion:
  agents:
    support_adk:
      path: "./agent_adk.py:create_agent"
      framework: "adk"
      name: "Support ADK Agent"

3. Optional: Add Control Plane Credentials to `.env`

# .env
AION_CLIENT_ID=your_client_id
AION_CLIENT_SECRET=your_client_secret

For Aion-hosted deployments, these are provided by the control plane. Add them to .env only when running outside Aion-hosted deployments or when testing local control plane connectivity. For more information, see Environment Variables.

4. Start and Test

aion serve
aion chat --host http://localhost:10000 --agent-id support_adk

Next Steps

Session Storage — database-backed or in-memory sessions
Artifact Storage — file artifact backends
Message Mapping — how A2A maps to ADK and back
Streaming API — real-time text streaming and file artifacts
Events Reference — A2A events emitted during execution