Skip to main content

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