AI导哈

智能体工作流

google-agents-cli-adk-code

google/agents-cli

This skill should be used when the user wants to "write agent code", "build an agent with ADK", "add a tool", "create a callback", "define an agent", "use state management" — in a project that needs ADK (Agent Development Kit) API patterns and code examples. It provides a quick reference for agent types, tool definitions, orchestration patterns, callbacks, state management, the graph Workflow API, and reference recipes to study. Do NOT use for scaffolding (use google-agents-cli-scaffold) or deployment (use google-agents-cli-deploy).

  • 52.6万 次安装
  • 6200 星标
  • 收录于

安装命令

npx skills add https://github.com/google/agents-cli --skill google-agents-cli-adk-code

要点

Quick reference for ADK Python patterns: agents, tools, callbacks, and state management.

  • Covers agent creation with model and instruction configuration, basic tool definition via FunctionTool, and callback patterns for state initialization and lifecycle hooks
  • Includes built-in tool imports, agent orchestration (SequentialAgent, ParallelAgent, LoopAgent), and state management through CallbackContext
  • ADK 2.0 Workflow API available as opt-in experimental feature for graph-based pipelines with conditional routing and parallel processing; requires Python 3.11+ and explicit user consent before use
  • Requires an existing scaffolded project; use agents-cli scaffold create or scaffold enhance before writing agent code

SKILL.md

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/recipes.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/. 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 <name> --agent adk_python --deployment-target <target> — use --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/recipes.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/ 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

相关 Skills

google-agents-cli-deploygoogle/agents-cliThis skill should be used when the user wants to "deploy an agent", "deploy my ADK agent", "set up CI/CD", "configure secrets", "troubleshoot a deployment", or needs guidance on Agent Runtime, Cloud Run, or GKE deployment targets, or binding an agent to an Agent Gateway. Covers deployment workflows, service accounts, rollback, and production infrastructure. Applies to any framework agents-cli deploys (ADK, LangChain, ...). Part of the agents-cli skills suite. Do NOT use for agent API code patterns (ADK: use google-agents-cli-adk-code), evaluation (use google-agents-cli-eval), or project scaffolding (use google-agents-cli-scaffold).部署与运维52.5万google-agents-cli-publishgoogle/agents-cliThis skill should be used when the user wants to "publish an agent", "publish my ADK agent", "register an agent with Gemini", "publish to Gemini" (formerly Gemini Enterprise), or needs guidance on the agents-cli publish gemini command. Also use when the user wants to "manage agents in Agent Registry", "list/update/delete registered agents", or "register an MCP server". Covers ADK vs A2A registration modes, programmatic and interactive usage, flag reference, auto-detection from deployment metadata, Agent Registry fleet management, and troubleshooting. Part of the agents-cli skills suite. Do NOT use for deployment (use google-agents-cli-deploy).部署与运维52.5万google-agents-cli-workflowgoogle/agents-cliThis skill should be used when the user wants to "develop an agent", "build an agent using ADK", "run the agent locally", "debug agent code", "test an agent", "deploy an agent", "publish an agent", "monitor an agent", or needs the ADK (Agent Development Kit) development lifecycle and coding guidelines. Entrypoint for building ADK agents. Always active — provides the full workflow (scaffold, build, evaluate, deploy, publish, observe), code preservation rules, model selection guidance, and troubleshooting steps for ADK or any agent development.智能体工作流52.4万google-agents-cli-evalgoogle/agents-cliThis skill should be used when the user wants to "run an evaluation", "evaluate my agent", "evaluate my ADK agent", "write an eval dataset", "analyze eval failures", "compare eval results", "optimize agent", or needs guidance on the Gemini platform eval methodology and the Quality Flywheel. Covers eval metrics, dataset schema, LLM-as-judge scoring, and common failure causes. Applies to any agents-cli project, whatever framework the agent is written in. Do NOT use for agent API code patterns (ADK: use google-agents-cli-adk-code), deployment (use google-agents-cli-deploy), or project scaffolding (use google-agents-cli-scaffold).部署与运维52.4万google-agents-cli-scaffoldgoogle/agents-cliThis skill should be used when the user wants to "create an agent project", "start a new ADK project", "build me a new agent", "add CI/CD to my project", "add deployment", "enhance my project", or "upgrade my project". Part of the agents-cli skills suite. Covers `agents-cli scaffold create`, `scaffold enhance`, and `scaffold upgrade` commands, template options, deployment targets, and the prototype-first workflow. Do NOT use for writing agent code (ADK projects: use google-agents-cli-adk-code) or deployment operations (use google-agents-cli-deploy).部署与运维52.4万google-agents-cli-observabilitygoogle/agents-cliThis skill should be used when the user wants to "set up tracing", "monitor my agent", "configure logging", "add observability", "debug production traffic", or needs guidance on monitoring deployed agents, including ADK (Agent Development Kit) agents. Covers Cloud Trace, prompt-response logging, BigQuery Agent Analytics, third-party integrations (AgentOps, Phoenix, MLflow, etc.), and troubleshooting. Part of the agents-cli skills suite. Do NOT use for deployment setup (use google-agents-cli-deploy) or API code patterns (use google-agents-cli-adk-code).部署与运维52.4万