Skip to content

docs(integrations): add Agent Threat Rules (ATR) guardrail plugin#1850

Open
eeee2345 wants to merge 2 commits into
google:mainfrom
eeee2345:integrations/add-atr-guardrail
Open

docs(integrations): add Agent Threat Rules (ATR) guardrail plugin#1850
eeee2345 wants to merge 2 commits into
google:mainfrom
eeee2345:integrations/add-atr-guardrail

Conversation

@eeee2345

Copy link
Copy Markdown

This adds an integrations catalog page for adk-atr-guardrail, a standalone, in-process security guardrail plugin for ADK backed by the open-source Agent Threat Rules (ATR) ruleset.

This is the follow-up requested in google/adk-python#6130: that PR added the guardrail as an ADK sample, and the maintainer recommended shipping it instead as a standalone package listed in the integrations catalog. The package is now published, so the page documents installing and using it.

What it provides

  • A BasePlugin that enforces ATR detection at three fail-closed Runner callbacks: before_run (halts the run on a malicious user message), before_model (skips the model call when the assembled prompt still carries a threat), and before_tool (returns an error instead of executing a tool whose arguments match a rule).
  • Detection is deterministic, in-process via the pyatr engine -- no model call, no network, no API key.

Details

  • Page: docs/integrations/atr-guardrail.md (+ icon at docs/integrations/assets/atr-guardrail.png), tagged resilience, mirroring the structure of the existing cisco-ai-defense page.
  • Package on PyPI: https://pypi.org/project/adk-atr-guardrail/ (pip install adk-atr-guardrail)
  • Package source: https://github.com/eeee2345/adk-atr-guardrail
  • The code example is complete and runnable; the rule count is read at runtime rather than hard-coded.
  • Verified locally with mkdocs build (page renders and the catalog card appears under Resilience).

Disclosure: I maintain the open-source ATR ruleset referenced here.

Adds docs/integrations/atr-guardrail.md (+ icon) for the adk-atr-guardrail
package -- an in-process, deterministic security guardrail that enforces the
open-source Agent Threat Rules ruleset at three fail-closed Runner callbacks
(before_run / before_model / before_tool). Tagged 'resilience'. Created per
maintainer guidance on google/adk-python#6130 to ship as a standalone package
listed in the integrations catalog. Verified locally with mkdocs build.
@netlify

netlify Bot commented Jun 18, 2026

Copy link
Copy Markdown

Deploy Preview for adk-docs-preview ready!

Name Link
🔨 Latest commit cb9fe77
🔍 Latest deploy log https://app.netlify.com/projects/adk-docs-preview/deploys/6a3531f341d7470008c2a4ca
😎 Deploy Preview https://deploy-preview-1850--adk-docs-preview.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

@eeee2345

Copy link
Copy Markdown
Author

Context for reviewers: this page was created at the request of @rohityan, who closed the original adk-python sample PR (google/adk-python#6130) with the guidance to "release the feature as a standalone package that we will then share through" the integrations catalog. The package is now published on PyPI (pip install adk-atr-guardrail), so this page documents installing and using it.

It follows the same structure as the existing Cisco AI Defense integration page (#1672) — a guardrail plugin tagged resilience — and was verified locally with mkdocs build. Happy to adjust anything to fit catalog conventions.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants