Google Adk

Cursor-Regel für Googles Agent Development Kit, hält Agenten- und Tool-Code ADK-konform.

Original-Beschreibung der Autoren: Google Agent Development Kit rules for agents, tools, sessions, memory, artifacts, evaluation, and deployment

Die Regel

---
description: Google Agent Development Kit rules for agents, tools, sessions, memory, artifacts, evaluation, and deployment
globs: ["**/*.py", "**/*.ts", "**/*.tsx", "**/*.go", "**/*.java", "pyproject.toml", "package.json"]
alwaysApply: false
---

# Google ADK Rules

## Agent Design

- Keep each agent focused on a clear goal, persona, and tool set.
- Use LLM agents for flexible reasoning and workflow agents for deterministic orchestration.
- Write instructions that define task boundaries, tool-use rules, and escalation behavior.
- Split multi-agent systems by responsibility rather than by implementation convenience.
- Keep model choices configurable.

## Tools

- Give tools narrow, typed inputs and outputs.
- Validate tool arguments before performing side effects.
- Keep secrets, credentials, and privileged APIs out of agent prompts.
- Handle tool errors explicitly and return actionable failure messages.
- Be aware of ADK tool limitations; some built-in tools cannot be combined with other tools on the same agent.

## Sessions, State, and Memory

- Use session state for current-conversation data.
- Use memory for cross-session recall and retrieval.
- Keep state small and serializable.
- Do not store large files or binary payloads in session state.
- Make state keys stable and documented.

## Artifacts

- Use artifacts for generated files, uploaded files, reports, images, audio, and other binary data.
- Configure an artifact service in the runner before relying on artifact operations.
- Version artifact filenames intentionally and avoid overwriting semantically different outputs.
- Store only references or summaries in state when full content belongs in artifacts.

## Evaluation and Deployment

- Add tests for tool behavior, agent routing, prompt regressions, and unsafe tool calls.
- Use trace or event logs to debug agent decisions.
- Keep local development, staging, and production configuration separate.
- Add observability for latency, tool failures, token use, and handoff failures.

## Common Mistakes

- Do not make one agent responsible for every workflow.
- Do not let tools accept arbitrary shell, SQL, or HTTP input without validation.
- Do not rely on prompt text for access control.
- Do not hide important side effects behind generic tool names.

So nutzt du sie

Die Regel kopieren (Button oben) oder als Datei herunterladen und im Projekt unter .cursor/rules/ ablegen — Cursor lädt sie beim nächsten Start automatisch. Ältere Cursor-Versionen lesen alternativ eine einzelne .cursorrules-Datei im Projektstamm; dort einfach den Regel-Text ohne den Kopfblock zwischen den ----Zeilen einfügen.

Der Regel-Text ist englisch — Cursor versteht ihn unabhängig von der Sprache, in der Sie mit dem Editor chatten.

Im Detail

Das Agent Development Kit (ADK) ist Googles Framework zum Bauen von KI-Agenten mit Tools, Sessions und Orchestrierung. Die Regel sorgt dafür, dass Cursor beim Generieren von Agenten- und Tool-Definitionen die ADK-typischen Muster einhält – etwa korrekte Tool-Signaturen, Agent-Konfiguration und Session-Handling – statt generischen, inkompatiblen Agent-Code zu produzieren. Praktisch für alle, die bereits im Google-Ökosystem, etwa mit Vertex AI, Agenten bauen und Fehler durch falsch geratene APIs vermeiden wollen. Wer stattdessen LangChain, CrewAI oder ein eigenes Agent-Framework nutzt, hat von dieser Regel nichts.

Praxis-Tipp

Nutzen Sie sie, wenn Sie Cursor bitten „Erstelle einen ADK-Agenten mit einem Such-Tool“ – die Regel verhindert, dass er stattdessen LangChain-Syntax vorschlägt.

Siehe auch

• AI Agent Specialist

Lizenz & Quelle

• Lizenz: CC0 1.0
• Quelle: PatrickJS/awesome-cursorrules (GitHub)

Lade …