TypeScript 版 Agent Development Kit (ADK)

这是一个开源的、代码优先（code-first）的 TypeScript 工具包，旨在提供灵活性和可控性，帮助开发者构建、评估和部署复杂的 AI Agent。

重要链接：文档、示例 和 ADK Web。

---

Agent Development Kit (ADK) 是一个灵活且模块化的框架，用于构建、部署和编排 AI Agent 工作流，涵盖从简单任务到复杂的多 Agent 系统。通过代码直接定义 Agent 行为、编排方式和工具使用，从而实现稳健的调试、版本控制，并支持在任何地方部署。

TypeScript 版 ADK 专为 Node.js 和浏览器生态系统打造，提供完整的类型安全、Zod schema 验证，并支持 ESM、CommonJS 和各种 Web 运行时。

✨ 核心特性

• 代码优先的 TypeScript：利用完整的类型安全定义 Agent 逻辑、工具和编排。工具参数支持 Zod v3 和 v4 schema，并提供编译时类型推断。

• 浏览器与服务器支持：提供 ESM、CommonJS 和 Web 编译包。既可在 Node.js 中运行，也可直接在浏览器中运行 Agent。

• 丰富的工具生态：内置 Google 搜索、Google 地图、Vertex AI Search 和 URL 上下文工具。支持连接 MCP 服务器、将任意函数封装为工具，或添加代码执行功能。

• 多 Agent 编排：将 Agent 组合为顺序、并行、循环和路由工作流。通过 A2A 协议委派任务给远程 Agent。

• 开发工具与 CLI：提供用于测试和调试的交互式开发 UI。支持脚手架 (adk create)、本地测试 (adk run、adk web) 和部署 (adk deploy cloud_run) 的 CLI 命令。

🚀 安装

npm install @google/adk
npm install -D @google/adk-devtools

或者使用 yarn：

yarn add @google/adk
yarn add -D @google/adk-devtools

以上命令将核心 SDK 和开发工具（CLI 和开发 UI）作为开发依赖进行安装。

快速入门

定义一个 Agent：

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],
});

在你的 Agent 项目目录下运行：

# 交互式 CLI
npx adk run agent.ts

# Web UI
npx adk web

adk web 命令会启动一个用于测试和调试 Agent 的开发 UI：

📚 文档

• 入门指南: https://adk.dev/get-started/typescript
• 示例代码: https://github.com/google/adk-samples

🤝 贡献

我们欢迎社区的贡献！无论是提交 Bug 报告、功能建议、改进文档还是提交代码，请查看 贡献指南 和 CONTRIBUTING.md 以开始你的贡献之旅。

📄 许可证

本项目采用 Apache 2.0 许可证 - 详情请参阅 LICENSE 文件。