Customer Support Agent

ADK 2.0 graph workflow agent for a shipping company. It classifies questions as shipping-related or unrelated, then routes to an FAQ agent or a polite decline.

Prerequisites

• Python 3.11+
• uv
• agents-cli: uv tool install google-agents-cli
• Gemini API key from Google AI Studio

1. Authentication

Create a .env file in this folder (already gitignored):

GEMINI_API_KEY=your_api_key_here
GOOGLE_GENAI_USE_ENTERPRISE=FALSE

Or set in PowerShell for the current session:

$env:GEMINI_API_KEY="your_api_key_here"
$env:GOOGLE_GENAI_USE_ENTERPRISE="FALSE"

2. Install dependencies

cd customer-support-agent
agents-cli install

3. Lint (optional)

agents-cli lint

4. Run the playground

Windows: agents-cli playground can fail due to a --allow_origins bug. Use this instead:

$env:Path = "$env:USERPROFILE\.local\bin;$env:Path"
uv run adk web . --host 127.0.0.1 --port 8080 --reload_agents

Open: http://127.0.0.1:8080/dev-ui/?app=app

If port 8080 is busy, change --port 8082 and use that URL instead.

Test prompts:

• Shipping: How much is standard shipping?
• Unrelated: What is the weather like?

Attachment sample

image

Edits to app/agent.py reload automatically while the playground is running.

5. Run from the command line

agents-cli run "How long does standard delivery take?"

6. Cleanup

Stop the playground: Ctrl+C in the terminal.

Remove the project (PowerShell):

cd ..
Remove-Item -Recurse -Force customer-support-agent

Project layout

customer-support-agent/
├── app/agent.py      # Workflow graph (classify → route → FAQ or decline)
├── .env              # API key (local only, not committed)
├── pyproject.toml
└── tests/