From 997082a2319d072160a506796b7d64406f9f952b Mon Sep 17 00:00:00 2001 From: Abhinav Gupta Date: Mon, 9 Mar 2026 16:21:58 +0530 Subject: [PATCH] docs: add Google ADK examples to README index Add trimmed READMEs and index entries for the two Google ADK examples (callbacks and decorator) introduced in #69. --- README.md | 2 ++ examples/README.md | 2 ++ examples/google_adk_callbacks/README.md | 24 ++++++++++++++++++++++++ examples/google_adk_decorator/README.md | 24 ++++++++++++++++++++++++ 4 files changed, 52 insertions(+) create mode 100644 examples/google_adk_callbacks/README.md create mode 100644 examples/google_adk_decorator/README.md diff --git a/README.md b/README.md index 15a4023a..fe21be0a 100644 --- a/README.md +++ b/README.md @@ -54,6 +54,8 @@ Explore real-world integrations with popular agent frameworks, or jump to [Quick - **[Galileo Luna-2 Integration](examples/galileo/)** — Toxicity detection and content moderation with Galileo Protect ### Framework integrations +- **[Google ADK Callbacks](examples/google_adk_callbacks/)** — Model and tool guardrails via ADK's native callback hooks +- **[Google ADK Decorator](examples/google_adk_decorator/)** — `@control()` decorator pattern for ADK tool protection - **[LangChain](examples/langchain/)** — Protect a SQL agent from dangerous queries with server-side controls - **[CrewAI](examples/crewai/)** — Combine Agent Control security controls with CrewAI guardrails for customer support - **[AWS Strands](examples/strands_agents/)** — Guardrails for AWS Strands agent workflows and tool calls diff --git a/examples/README.md b/examples/README.md index 548f28d4..ee0d64d8 100644 --- a/examples/README.md +++ b/examples/README.md @@ -8,6 +8,8 @@ This directory contains runnable examples for Agent Control. Each example has it |:--------|:--------|:-----| | Agent Control Demo | End-to-end workflow: create controls, run a controlled agent, update controls dynamically. | https://docs.agentcontrol.dev/examples/agent-control-demo | | CrewAI | Combine Agent Control security controls with CrewAI guardrails for customer support. | https://docs.agentcontrol.dev/examples/crewai | +| Google ADK Callbacks | Model and tool guardrails via ADK's native callback hooks. | https://docs.agentcontrol.dev/examples/google-adk-callbacks | +| Google ADK Decorator | `@control()` decorator pattern for ADK tool protection. | https://docs.agentcontrol.dev/examples/google-adk-decorator | | Customer Support Agent | Enterprise scenario with PII protection, prompt-injection defense, and multiple tools. | https://docs.agentcontrol.dev/examples/customer-support | | DeepEval | Build a custom evaluator using DeepEval GEval metrics. | https://docs.agentcontrol.dev/examples/deepeval | | Galileo Luna-2 | Toxicity detection and content moderation with Galileo Protect. | https://docs.agentcontrol.dev/examples/galileo-luna2 | diff --git a/examples/google_adk_callbacks/README.md b/examples/google_adk_callbacks/README.md new file mode 100644 index 00000000..02134dac --- /dev/null +++ b/examples/google_adk_callbacks/README.md @@ -0,0 +1,24 @@ +# Google ADK Callbacks + +Model and tool guardrails via ADK's native callback hooks. + +## What this example shows + +- Pre-model prompt injection blocking +- Pre-tool and post-tool output filtering +- Fail-closed behavior on server errors + +## Quick run + +```bash +# From repo root +make server-run +export GOOGLE_API_KEY="your-key-here" + +cd examples/google_adk_callbacks +uv pip install -e . --upgrade +uv run python setup_controls.py +uv run adk run my_agent +``` + +Full walkthrough: https://docs.agentcontrol.dev/examples/google-adk-callbacks diff --git a/examples/google_adk_decorator/README.md b/examples/google_adk_decorator/README.md new file mode 100644 index 00000000..f83d87a7 --- /dev/null +++ b/examples/google_adk_decorator/README.md @@ -0,0 +1,24 @@ +# Google ADK Decorator + +`@control()` decorator pattern for tool protection inside a Google ADK app. + +## What this example shows + +- `@control()` on ADK tool functions +- Automatic step registration from decorators +- Optional sdk-local execution mode + +## Quick run + +```bash +# From repo root +make server-run +export GOOGLE_API_KEY="your-key-here" + +cd examples/google_adk_decorator +uv pip install -e . --upgrade +uv run python setup_controls.py +uv run adk run my_agent +``` + +Full walkthrough: https://docs.agentcontrol.dev/examples/google-adk-decorator