← 返回全部情报
Google 把 adk-samples 收成 adk-recipes 三层仓库:core 参考 harness、plugins 垂直技能、contrib 可部署服务,专供编码助手消费 的封面

·Blog·工程博客收录 2026-10-17

Google 把 adk-samples 收成 adk-recipes 三层仓库:core 参考 harness、plugins 垂直技能、contrib 可部署服务,专供编码助手消费

adk-recipesHorizonAgent PluginsAgents CLI零售技能

一句话结论

Google 用 google/adk-recipes 取代 adk-samples,按 core / plugins / contrib 三层组织:Horizon 长程 harness、符合 Agent Plugins 规范的零售等垂直技能,以及多语言可部署示例;manifest、AGENTS.md 与技能都以编码助手可读为先,并接到 Agents CLI、Agent Garden 与 npx skills。

打开原文 Google Developers Blog:Three layers, one repo: a tour of google/adk-recipes

背景与理念

只给参考 harness、或只给垂直技能、或只给可部署原型,都很难从「我想做 X agent」走到可重复的生产形态。adk-recipes 把三层放进同一棵源码树,并让 Agents CLI、Agent Garden 与外部编码助手读同一份真源。作者强调每份配方都以机器可读为第一考虑:manifest.yaml、给助手看的 AGENTS.md,以及(contrib/plugins)Dockerfile 与可运行性测试。

具体做法

  1. 三层目录。`core/` 放 Agents CLI 与 DevRel 策展的参考模式;`plugins/` 放符合 Agent Plugins v1.0.0 的可安装垂直技能;`contrib/` 放跨五种语言的端到端可部署服务。
  2. Horizon 长程参考。位于 `core/python/long-horizon-harness`,覆盖跨会话记忆、按用户沙箱执行工具、密钥、防失控护栏与可恢复编排;可用 sparse checkout + `make dev-local` 本地起,或 `make deploy` 上 Cloud Run。评测在 `tests/eval/evalsets/`,约十八套行为量规(记忆召回、注入外泄、对抗护栏、工具选择等),用 `uv run pytest tests/eval` 跑。
  3. 零售 Plugin Recipe。`plugins/retail/` 含 product-search 与 virtual-tryon:前者走 BigQuery + Vector Search 2.0 + 单 agent 检索;后者用 Gemini 图像与 Veo 3.1 Reference-to-Video。安装示例:`npx skills add google/adk-recipes --skill retail-product-search --full-depth`,技能用 Q-MODE 访谈写 `design-spec.md` 并跑 setup;EVAL.yaml 低于约 80% 通过目标会停并亮出失败项。
  4. contrib 对齐插件。例如 `contrib/python/retail-product-search` 是插件一次性建库之后的长跑服务,可用五种部署角色开关;README 要求先跑插件 setup。
  5. 平台接线。Agents CLI 的 `create` 可按 core 配方脚手架;Agent Garden 再从中编辑精选;Claude Code、Cursor 等也可经 npx skills 安装插件。

关键数据/例子

结构与命令可核:三层根目录;Horizon 评测量规约 18 套;零售插件安装后可对演示目录跑 setup,文中示例加载 5 条商品记录并创建 Vector Search collection;检索示例返回 Sony Wireless Headphones $199.99 等目录行。`npx skills add ... --full-depth` 会装到 `~/.agents/skills/` 并软链到本机检测到的多种助手。作者写明 recipes 用于演示与起点,不是官方支持的生产产品。

创新点

第一,用同一仓库同时交付「参考 harness + 垂直技能 + 可部署服务」,让人与助手能上下游走通。第二,把 AGENTS.md / manifest / SKILL.md 写成给编码助手的一等接口,而不是事后补文档。第三,垂直技能走开放 Agent Plugins 规范与统一安装流,降低跨助手分发成本。

可否复用

  1. 自建 agent 示例库时按「模式 / 技能 / 可部署服务」分目录,并强制每份带 manifest 与给助手读的说明。
  2. 长程 agent 先复用或对照 Horizon 一类 harness(记忆、沙箱、护栏、可恢复),再用评测量规锁行为。
  3. 垂直能力做成可 `npx skills add` 的插件,安装后用访谈生成 design-spec,并用 EVAL 门槛挡住不合格环境。
  4. contrib 与 plugin 由同一团队同步:插件负责一次性数据/环境,contrib 负责服务形态,避免两套真相。

笔记会在输入时自动保存。