Google ADK

Google ADK with donkey.adk.model("…"), a LiteLlm model. LiteLLM calls the proxy’s /chat/completions route. It sends through the SDK’s shared HTTP client, so the credentials and the run id go on the wire, but LiteLLM raises its own errors, so there are no typed refusals. Script 02 exists to show that gap.

Both scripts need a live gateway; there is no offline ADK script.

Install

Follow the examples setup first, then:

python -m pip install -e "../donkey-development-kit/python[llm,adk]"
set -a; source .env.local; set +a

01 — An ADK agent

python "demos/human-made/adk/01 - basic-gw.py"

donkey = Donkey.from_env()
agent = Agent(name="greeter", model=donkey.adk.model("gpt-4o"), instruction="Answer in one short sentence.")
 
events = asyncio.run(InMemoryRunner(agent=agent).run_debug("Say hello in exactly three words.", quiet=True))
 
print(events[-1].content.parts[0].text)
print("total tokens", events[-1].usage_metadata.total_token_count)
print("last_call   ", donkey.last_call.status.value, donkey.last_call.surface)

You should see: a one-sentence answer, total tokens from the last event’s usage_metadata, and last_call unavailable …. The record is set in the Runner’s own task, not where the script reads it, and a cold read on this adapter reports unavailable rather than unobserved (#740 ). Read it in an after_model_callback instead, as shown under Native Gemini. LiteLLM also logs a provider-list banner, which is harmless.

02 — A refusal that is not typed

python "demos/human-made/adk/02 - refusal-live.py"

A PII prompt against a proxy with the PII policy applied. LiteLLM keeps the status code and the message but drops the response headers, so classify() has nothing to read. The script therefore catches LiteLLM’s own error:

try:
    asyncio.run(InMemoryRunner(agent=agent).run_debug(PII_PROMPT, quiet=True))
    print("NO REFUSAL")
except litellm.exceptions.APIError as err:
    print(type(err).__name__, err.status_code)
    print(str(err).splitlines()[0])

Needs: llm-pii-detection-policy with Email and action Reject. You should see: APIError 403 and the first line of the proxy’s message — not PIIDetected. Without the policy it prints NO REFUSAL.

Learn more: Google ADK

Source: demos/human-made/adk/