Agent Development Kit (ADK) for TypeScript

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

重要链接： 文档， 示例， Python ADK， Java ADK， Go ADK， Web ADK。

Agent Development Kit (ADK) 专为那些在构建与 Google Cloud 服务紧密结合的高级 AI Agent 时，追求精细化控制与灵活性的开发者而设计。它允许你直接在代码中定义 Agent 的行为、编排逻辑及工具使用，从而实现稳健的调试、版本控制，并支持从本地开发环境到云端的任意部署。

---

✨ 核心特性

• 丰富的工具生态：利用预置工具、自定义函数、OpenAPI 规范或集成现有工具，赋予 Agent 多元化的能力，并与 Google 生态系统深度集成。

• 代码优先开发：直接使用 TypeScript 定义 Agent 逻辑、工具和编排，以获得极致的灵活性、可测试性和版本管理能力。

• 模块化多 Agent 系统：通过将多个专业化 Agent 组合成灵活的层级结构，设计可扩展的应用程序。

🚀 安装

如果你使用 npm，请将以下包添加到你的依赖项中：

npm install @google/adk

或者使用 yarn：

yarn add @google/adk

📚 文档

如需了解如何通过 TypeScript 文档和示例来构建、评估及部署 Agent，请访问：

• 文档
• 示例

🏁 功能亮点

与其他 ADK 相同的功能和熟悉的接口：

import {LlmAgent, GOOGLE_SEARCH} from '@google/adk';

const rootAgent = new LlmAgent({
  name: 'search_assistant',
  description: 'An assistant that can search the web.',
  model: 'gemini-2.5-flash', // 或者你偏好的模型
  instruction:
    'You are a helpful assistant. Answer user questions using Google Search when needed.',
  tools: [GOOGLE_SEARCH],
});

开发 UI

与 Python 开发 UI 一致。内置开发 UI 旨在帮助你测试、评估、调试并展示你的 Agent。

评估 Agent

敬请期待……

🤖 A2A 与 ADK 集成

针对远程 Agent 到 Agent (A2A) 的通信，ADK 集成了 A2A 协议。更多示例敬请期待……

🏗️ 构建项目

要设置项目并从源码构建，请遵循以下步骤：

1. 安装依赖：

   npm install
   

2. 构建项目：本项目使用 esbuild 来编译和打包 TypeScript 源码。你可以使用以下 npm 脚本构建项目：

   • npm run build：将 TypeScript 代码编译为 dist 目录下的 CommonJS、ESM 和 Web 格式。
   • npm run build:bundle：创建打包版本，便于分发或在不支持 tree-shaking 的环境中使用。
   • npm run build:watch：监控源文件变更，并仅自动重新构建 ESM 格式的项目。

🤝 贡献指南

我们欢迎社区贡献！无论是提交 Bug 反馈、功能需求、文档优化还是代码贡献，请参考：

• 常规贡献指南和流程。
• 若要贡献代码，请阅读 代码贡献指南 以开始。

📄 许可证

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

预览版说明

本功能受 Service Specific Terms 中“Pre-GA Offerings Terms”条款约束。预览版（Pre-GA）功能按“原样”提供，且可能仅提供有限支持。更多信息请参见 产品发布阶段说明。

---

祝你构建 Agent 愉快！