adk-js

用 TypeScript 代码构建、评估并部署你的 AI 智能体，掌控每一个细节。

adk-js 是一个开源的、代码优先的 TypeScript 工具包，用于构建、评估和部署复杂的 AI 智能体。它解决了开发者在构建生产级 AI 应用时面临的灵活性和控制力不足的问题，提供了一套完整的开发流程支持。其核心能力包括：支持多智能体协作，允许开发者定义复杂的智能体网络；提供代码优先的配置方式，让开发者通过 TypeScript 代码精确控制智能体行为，避免繁琐的配置文件；内置评估工具，方便对智能体性能进行测试和优化；以及支持部署到多种环境，便于集成到现有系统中。adk-js 强调灵活性和可扩展性，适合需要深度定制 AI 行为的开发者。

开源 free 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1418

维护状态活跃

是否开源是

定价模式 free

项目数据

分类智能体

开发团队google

所属国家

官网地址https://adk.dev

GitHubhttps://github.com/google/adk-js

定价模式free

价格说明开源项目，Apache-2.0许可证，完全免费，无付费版本。

访问状态

是否开源是

开源协议Apache-2.0

主要语言TypeScript

技术栈/模型agent,agentic,agentic-ai,agents,agents-sdk,ai,ai-agents,aiagentframework,genai,genai-chatbot,llm,llms,multi-agent,multi-agent-systems,multi-agents,multi-agents-collaboration

GitHub 星标★ 1418

30天Star增速

HF 下载量

上线时间2025-08-14 00:00:00

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数2

使用教程

难度：入门约 10 分钟部署方式：库/依赖 5 步

环境要求

Node.js 20.19 或更新版本
npm 或 yarn 包管理器
Google AI Studio 的 API Key（或使用 Vertex AI 的凭据）
一个用于存放 agent 代码的项目目录

安装与启动步骤

1安装核心 SDK

在项目目录下安装 @google/adk 核心包，提供 LlmAgent、工具等能力。
```
npm install @google/adk
```
2安装开发工具

将 CLI 和开发 UI 作为开发依赖安装，用于本地运行与调试智能体。
```
npm install -D @google/adk-devtools
```
3配置 API Key

从 Google AI Studio 获取 API Key，写入智能体同级的 .env 文件。
```
echo "GOOGLE_GENAI_API_KEY=your-api-key-here" > .env
```
4编写智能体代码

在 agent.ts 中定义并导出 rootAgent，指定名称、模型、指令与工具。
5运行智能体

在智能体项目目录下执行 README 所示的运行命令启动本地调试。

关键配置

配置项	必填	说明	示例
`GOOGLE_GENAI_API_KEY`	是	Google AI Studio 提供的 API Key，用于调用 Gemini 模型	`GOOGLE_GENAI_API_KEY=your-api-key-here`
`GOOGLE_GENAI_USE_VERTEXAI`	否	改用 Vertex AI 时设为 1，替代 API Key 方式	`GOOGLE_GENAI_USE_VERTEXAI=1`
`GOOGLE_CLOUD_PROJECT`	否	使用 Vertex AI 时需指定的 Google Cloud 项目 ID	`my-gcp-project`
`GOOGLE_CLOUD_LOCATION`	否	使用 Vertex AI 时需指定的区域	`us-central1`

如何确认成功

运行命令后若无报错并出现智能体响应或开发界面，即表示启动成功。

常见问题

Q：使用 Vertex AI 而非 API Key 怎么配置？

A：在 .env 中设置 GOOGLE_GENAI_USE_VERTEXAI=1、GOOGLE_CLOUD_PROJECT 和 GOOGLE_CLOUD_LOCATION，并执行 gcloud auth application-default login 完成认证。

Q：安装时提示 Node 版本不符？

A：ADK for TypeScript 要求 Node.js 20.19 或更新版本，请升级 Node 后重新安装。

Q：可以用 yarn 安装吗？

A：可以，执行 yarn add @google/adk 以及 yarn add -D @google/adk-devtools 即可。

Q：能在浏览器中运行智能体吗？

A：可以，ADK 提供 ESM、CommonJS 和 web 打包，支持在 Node.js 或浏览器中运行。

注意事项

README 中运行智能体的具体命令被截断，实际启动命令请以官方文档 https://adk.dev 为准。
工具参数支持 Zod v3 和 v4 schema，可获得编译期类型推断。
更多示例可参考 https://github.com/google/adk-samples。

核心亮点

代码优先，用 TypeScript 定义智能体，灵活性和可维护性远超配置文件
内置评估工具，能对智能体性能进行系统化测试，保障生产质量
支持多智能体协作，可构建复杂的分工协作式 AI 应用

不足之处

项目较新，生态和社区资源相对有限
文档/社区待观察

适用场景

需要精细控制 AI 行为的复杂业务场景
构建多智能体协作系统，如客服、自动化流程
对智能体进行持续评估和优化的生产环境

替代项目

LangChain、AutoGen、CrewAI

项目介绍

adk-js 是智能体领域的开源项目，由 google 开发，2025 年首次发布。

在全站 13,090 个收录项目中，它的 GitHub 星标数（1,418）位列前 30%，在智能体分类中处于中上游。

近 42 天，它的 GitHub 星标从 1,340 增加到 1,418，净增 78。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。Apache-2.0许可证，完全免费，无付费版本。从国内网络环境看，可直接访问。

它主要面向的使用场景是：需要精细控制AI行为的复杂业务场景。同类可对比的替代方案包括 LangChain、AutoGen、CrewAI。

上一篇：open-multi-agent-canvas

下一篇：agent-message-queue