Google ADK TypeScript 开发套件
以 TypeScript 编写、编排并部署从单任务到多智能体的工作流。
按维度查看评分与理由
证据显示：仓库来自Google官方组织，有明确的Apache-2.0许可证，README中警告了npx adk可能下载无关包的风险，体现了对供应链的注意。但未发现权限最小化设计、用户确认机制、数据流透明性文档、敏感数据处理策略、依赖安全审计、外部影响控制或回滚机制。扣分原因：这些方面缺乏证据或仅部分提及。
证据显示：代码结构清晰，测试覆盖A2A协议相关功能，包括事件处理、流式聚合等，表明内部一致性良好。依赖声明在package.json中，但未提供依赖可用性保证或故障恢复机制。失败消息方面，测试中处理了错误事件，但未提供面向用户的错误消息文档。扣分原因：依赖可用性和失败消息处理证据不足。
证据显示：README明确目标受众为TypeScript开发者，支持Node.js和浏览器，提供了多种场景（搜索、地图、多智能体编排）。能力边界通过工具和模型配置体现，但未明确限制。触发精度方面，工具调用和事件处理有测试，但未提供用户自定义触发器的文档。环境适配良好，支持ESM、CommonJS和web。扣分原因：触发精度和明确的能力边界文档不足。
证据显示：README提供了安装说明、快速开始、文档链接，信息架构清晰。命名稳定，包名和版本号明确。示例代码简单，但缺少FAQ。已知限制未明确列出。许可证为Apache-2.0，完整文本存在。版本号1.6.0，但未提供变更日志。维护责任由Google承担，有贡献指南。扣分原因：缺少FAQ、已知限制和变更日志。
证据显示：输出可用性高，提供CLI和Web UI，支持多种部署方式。边际价值明显，提供了丰富的工具和编排能力。成本效益方面，开源免费，但未提供性能或资源消耗数据。扣分原因：成本效益缺乏具体数据支持。
证据显示：README中的功能声明与代码和测试部分对应，如A2A协议支持有测试验证。但未提供外部来源的佐证，且事实与推断区分不够明确。扣分原因：跨来源佐证不足。
- 静态审查，未执行代码，所有结论基于文件内容。
- 未发现恶意代码，但需注意依赖安全，建议进行依赖审计。
- 用户确认机制缺失，部署时需自行添加审批流程。
- 数据流透明性文档不足，建议查阅官方文档获取更多信息。
这个 Agent 能做什么，适合哪些场景？
Agent Development Kit（ADK）是 Google 提供的开源、代码优先 TypeScript 智能体开发工具包。开发者可在代码中定义智能体行为、工具调用和编排逻辑，示例使用 LlmAgent、GOOGLE_SEARCH 与 gemini-flash-latest。它支持顺序、并行、循环和路由式多智能体工作流，也可通过 A2A 协议委派给远程智能体。该工具包面向 Node.js 和浏览器生态，提供 ESM、CommonJS 与 Web 构建产物，并使用 Zod 提供 schema 校验和类型推导。@google/adk-devtools 提供 adk create、adk run、adk web 及 adk deploy cloud_run 等命令；材料未说明固定的最终输出格式或托管式产品服务。
开发者先在 TypeScript 文件中创建 LlmAgent，指定 name、description、model、instruction 和 tools，例如将 GOOGLE_SEARCH 放入 tools。随后可在项目目录运行 npx adk run agent.ts 进行交互式运行，或运行 npx adk web 打开用于测试和调试的开发界面。运行中的智能体可使用内置 Google Search、Google Maps、Vertex AI Search 和 URL context 工具，也可连接 MCP 服务器、将函数包装为工具或加入代码执行。多个智能体可被组合为顺序、并行、循环或路由工作流，并可借助 A2A 向远程智能体委派工作。材料没有规定统一的响应文件、报告或消息输出格式。
- TypeScript 开发者要快速验证一个可按需使用 GOOGLE_SEARCH 的问答助手时，可定义 LlmAgent 后用 npx adk run agent.ts 交互测试。
- 构建浏览器端或 Node.js 端智能体应用的团队，可利用 ESM、CommonJS 和 Web 构建产物选择目标运行环境。
- 需要把检索、地图、URL 上下文或 Vertex AI Search 接入智能体的工程团队，可使用列出的内置工具。
- 要把多个专业智能体按顺序、并行、循环或路由规则协作的开发者，可使用 ADK 的工作流编排能力。
- 需要把一部分任务交给远程智能体的系统集成团队，可评估其 A2A 协议委派路径。
- 希望在部署前使用 Web 界面调试智能体、并计划部署到 Cloud Run 的团队，可使用 adk web 和 adk deploy cloud_run。
这个 Agent 有哪些优点和局限？
- 以 TypeScript 代码直接定义智能体逻辑、工具和编排，并提供完整类型安全与 Zod v3/v4 schema 的编译期类型推导。
- 同一工具包提供 ESM、CommonJS 和 Web 构建产物，明确覆盖 Node.js 与浏览器运行环境。
- 内置工作流模型覆盖顺序、并行、循环和路由，并明确支持通过 A2A 向远程智能体委派。
- 开发工具同时包含脚手架、交互式运行、Web 调试界面和 Cloud Run 部署命令。
- 安装前提是当前 Node.js LTS 版本，浏览器与服务器目标的实际工程集成仍需由采用方完成。
- 提供的示例使用 gemini-flash-latest，材料没有说明其他模型提供商的配置或兼容路径。
- Google Search、Google Maps、Vertex AI Search、URL context 及远程 A2A 调用的凭据、费用和配额信息均未给出。
- Cloud Run 仅列出 adk deploy cloud_run 命令，材料未提供部署参数、基础设施配置或故障处理细节。
如何安装或部署这个 Agent？
前提是当前 Node.js LTS 版本。在智能体项目目录安装：
npm install @google/adk
npm install -D @google/adk-devtools提供的材料未说明模型、Google Search、Google Maps、Vertex AI Search 或其他外部服务所需凭据的配置方式。
如何使用这个 Agent？
创建 agent.ts，并导入 LlmAgent 和 GOOGLE_SEARCH：
import {LlmAgent, GOOGLE_SEARCH} from '@google/adk';
export const rootAgent = new LlmAgent({name: 'search_assistant',
description: 'An assistant that can search the web.',
model: 'gemini-flash-latest',
instruction: 'You are a helpful assistant. Answer user questions using Google Search when needed.',
tools: [GOOGLE_SEARCH],
});
在该项目目录执行 npx adk run agent.ts 进行交互式运行，或执行 npx adk web 启动开发调试界面。材料还列出了 adk create 和 adk deploy cloud_run，但没有给出其参数、配置文件或完整部署流程。