# Google Agents Cli Adk Code > Referencia rápida de patrones de la API Python de ADK: tipos de agente, definición de tools, orquestación, callbacks, manejo de estado y recetas de referencia para estudiar. Fuente: https://skillsagentes.com/skills/google/agents-cli/google-agents-cli-adk-code Markdown: https://skillsagentes.com/skills/google/agents-cli/google-agents-cli-adk-code.md Repositorio: https://github.com/google/agents-cli Autor: google Licencia: Apache-2.0 Actualizado: el mes pasado Coste de contexto: 136 tok instalada, 984 tok al activarse, 16.6k tok con todos los archivos del bundle Bundle: 4 archivos, 65 KB Permisos que pide: ninguno declarado ## Instalación Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina. ```bash # Claude Code npx -y skills add google/agents-cli --skill google-agents-cli-adk-code --agent claude-code # Cursor npx -y skills add google/agents-cli --skill google-agents-cli-adk-code --agent cursor # Codex npx -y skills add google/agents-cli --skill google-agents-cli-adk-code --agent codex # Gemini CLI npx -y skills add google/agents-cli --skill google-agents-cli-adk-code --agent gemini # Windsurf npx -y skills add google/agents-cli --skill google-agents-cli-adk-code --agent windsurf # Cline npx -y skills add google/agents-cli --skill google-agents-cli-adk-code --agent cline ``` ## Qué hace - Provee patrones de referencia de la API Python de ADK: tipos de agente, definición de tools, callbacks, orquestación y manejo de estado - Indexa recetas de referencia en references/samples.md que mapean una capacidad a código de implementación ya trabajado - Da un cheatsheet rápido de código con el patrón Agent + tools más común ## Cuándo usarla - El usuario quiere "escribir código de agente", "construir un agente con ADK", "agregar un tool", "crear un callback" o "usar state management" - Se necesita un patrón de API Python de ADK o un ejemplo de código concreto - Antes de implementar algo, para revisar si existe una receta equivalente en references/samples.md ## Cuándo no - Para scaffolding de proyectos (usar google-agents-cli-scaffold) - Para deployment (usar google-agents-cli-deploy) ## Qué la activa - "¿Cómo agrego un tool personalizado a mi agente con ADK?" - "Escribe el código de un callback de moderación para mi agente" - "¿Cómo defino un agente con estado usando ADK en Python?" - "Necesito un patrón de orquestación con SequentialAgent" ## Antes de instalar - Requiere el binario agents-cli (uv tool install google-agents-cli) y un proyecto ya escafoldado antes de escribir código de agente. ## Archivos - SKILL.md — 4 KB - references/adk-python.md — 36 KB - references/adk-workflows.md — 17 KB - references/samples.md — 8 KB ## SKILL.md Reproducido tal cual desde google/agents-cli bajo Apache-2.0. Esta sección es el documento original y está en inglés. # ADK Code Reference Activate `/google-agents-cli-workflow` first for required development phases and scaffolding steps. ## 1. Study Recipes (No Project Needed) **Python — read the topic index in `references/samples.md` before answering "how do I build X".** Worked implementations exist for: sandboxed/per-user code execution, agent-loadable `SKILL.md` skills, cross-session memory, approval gates before risky actions, tool guardrails, per-user credentials, and scheduled/event-driven runs. **Go — read the upstream [`examples/`](https://github.com/google/adk-go/tree/main/examples).** clone the repo and read the one matching the capability you need before implementing it. ## 2. Prerequisites for Writing Code Do NOT write agent code until a project is scaffolded. 1. Verify project: run `agents-cli info` (proceed if config exists). 2. New project: run `agents-cli scaffold create ` — add `--agent adk_go` for Go. 3. Existing code: run `agents-cli scaffold enhance .`. ## Quick Reference — Most Common Patterns See `references/adk-python.md` and `references/adk-go.md` for Python and Go code examples, respectively. --- ## References Use the cheatsheets for common patterns. For deep knowledge, fetch the docs index or inspect the installed package. | Reference | Language | When to read | |------|------|-------------| | `references/samples.md` | Python | **Topic-indexed catalog of ADK reference recipes.** Read in workflow Phase 1 — before scaffolding and before writing code — maps a capability to the recipe that implements it. | | `references/adk-python.md` | Python | Core ADK API: `Agent`, tools, callbacks, plugins, state, artifacts, multi-agent systems, `SequentialAgent` / `ParallelAgent` / `LoopAgent`, custom `BaseAgent`, `ManagedAgent` (server-hosted first-party agents), A2A protocol, A2UI. Default for most agents. | | `references/adk-python-workflows.md` | Python | Graph-based Workflow API (ADK Python 2.0): nodes, edges, fan-out/fan-in, HITL, parallel processing. Use when you need explicit graph topology. | | `references/adk-python-live.md` | Python | Live and voice agents: `Runner.run_live`, `LiveRequestQueue`, model and regional availability, voice/`speech_config`, VAD, session limits, `/run_live` serving. Use for real-time voice or video agents. | | `references/adk-go.md` | Go | Core ADK Go API: `llmagent`, tools, callbacks, plugins, state, artifacts, multi-agent systems, sequential/parallel/loop agents, custom agents, the runner, serving over HTTP, A2A protocol, and ambient triggers. Default for most agents. | | `references/adk-go-workflows.md` | Go | Graph-based Workflow API: nodes, edges, fan-out/fan-in, HITL, parallel processing. Use when you need explicit graph topology. | | [`examples/`](https://github.com/google/adk-go/tree/main/examples) | Go | Runnable upstream programs — the closest thing to a recipe catalog for Go. | | `curl https://adk.dev/llms.txt` | Python | Docs index (every page title + URL). Fetch it, then `WebFetch` the specific page for anything beyond the cheatsheets. | | Installed ADK package | Python | Exact signatures and symbols — inspect the source (see "Inspecting ADK Source Code" in `references/adk-python.md`). | ## Related Skills - `/google-agents-cli-workflow` — Development workflow, coding guidelines, and operational rules - `/google-agents-cli-scaffold` — Project creation and enhancement with `agents-cli scaffold create` / `scaffold enhance` - `/google-agents-cli-eval` — Evaluation methodology, dataset schema, and the eval-fix loop - `/google-agents-cli-deploy` — Deployment targets, CI/CD pipelines, and production workflows ## Dónde encaja - Categoría: [Herramientas para desarrolladores](https://skillsagentes.com/categorias/herramientas-desarrollo.md) — Skills que cambian cómo tu agente escribe, revisa y despliega código. - Creador: [google](https://skillsagentes.com/creators/google.md) — 138 skills en el directorio - [Todas las skills](https://skillsagentes.com/skills.md) - [Ranking de instalaciones](https://skillsagentes.com/ranking.md) ## Otras skills del mismo repositorio - [Google Agents Cli Workflow](https://skillsagentes.com/skills/google/agents-cli/google-agents-cli-workflow.md): Guía activa siempre para el ciclo de vida completo de desarrollo con ADK: scaffolding, construcción, evaluación, despliegue, publicación y observación de agentes, con reglas de preservación de código y selección de modelo. - [Google Agents Cli Eval](https://skillsagentes.com/skills/google/agents-cli/google-agents-cli-eval.md): Guía sobre la metodología de evaluación de Agent Platform y el Quality Flywheel: métricas, esquema de dataset, scoring LLM-as-judge y causas comunes de fallo. - [Google Agents Cli Scaffold](https://skillsagentes.com/skills/google/agents-cli/google-agents-cli-scaffold.md): Úsalo para 'crear un proyecto de agente', 'iniciar un proyecto ADK nuevo', 'añadir CI/CD' o 'mejorar/actualizar mi proyecto'. Cubre `scaffold create`, `scaffold enhance` y `scaffold upgrade`, plantillas y targets de deployment. - [Google Agents Cli Deploy](https://skillsagentes.com/skills/google/agents-cli/google-agents-cli-deploy.md): Guía para desplegar un agente ADK, configurar CI/CD, gestionar secretos o solucionar despliegues en Agent Runtime, Cloud Run o GKE, incluyendo Agent Gateway. - [Google Agents Cli Observability](https://skillsagentes.com/skills/google/agents-cli/google-agents-cli-observability.md): Úsalo para configurar tracing, monitorizar agentes ADK, configurar logging o depurar tráfico en producción; cubre Cloud Trace, prompt-response logging, BigQuery Agent Analytics e integraciones de terceros. --- Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)