adk-js

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

开源 🏷️完全免费 ✅ 目前可打开智能体 🍴 复刻 248 🐛 待处理 135 👀 关注 14

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 1471

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源项目，Apache-2.0许可证，完全免费，无付费版本。

项目预览

项目数据

分类智能体

开发团队google

官网地址https://adk.dev

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

定价模式🏷️完全免费

价格说明开源项目，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 星标★ 1471

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

代码更新2026-11-06

仓库体积9.5 MB

本站数据更新2026-11-09

维护状态活跃

收录时间2026-08-09

浏览次数3

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1471

技术标签

agent agentic agentic-ai agents agents-sdk

使用教程

难度：入门约 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`