google/adk-web

Agent Development Kit Web UI (ADK WEB)

简介 – 这是一个随 Google Agent Development Kit (ADK) 提供的浏览器端开发者控制台。ADK 是一个用于构建、部署与编排 AI 代理（例如聊天机器人、自动化助理或工作流程编排代理）的模块化框架。此 Web UI 提供可视化前端，让您能建立代理、检查事件、追踪执行过程、检视产出物与评估结果，并对底层的 ADK 运行时进行调试。

关键组件

• 前端 – 一个 Angular 单页应用程序（透过 npm run serve 运行）。它透过代理与 ADK 后端通讯，因此 UI 可在本地 http://localhost:4200 运行。
• 后端 – ADK 运行时本身，透过 adk web 指令运行（从 google-adk Python 或 Java 套件安装）。UI 会将 API 调用转发至此程序。
• 整合 – 开箱即用支持 Gemini 模型堆栈，但具备模型无关性；您可以将其指向任何兼容于 ADK 的代理实现。

如何开始

1. 安装 Node、npm 与 Angular CLI。
2. 安装 ADK Python 或 Java SDK (google-adk)。
3. 克隆此仓库，运行 npm install，然后运行 npm run serve。
4. 在另一个终端运行 adk web 启动后端。
5. 打开 http://localhost:4200，您将看到包含事件、追踪、产出物、评估与代理构建器的 UI 标签页。

您可以在 UI 中做什么

• 事件 – 浏览代理产生事件的时间轴。
• 追踪 – 可视化代理运行的调用图与执行流程。
• 产出物 – 检查代理产生的档案、日志或其他输出。
• 评估 – 检视代理的指标与测试结果。
• 代理构建器与助理 – 用于组装代理组件并与实时助理互动的拖放式界面。

适用对象 – 想要比原始日志更丰富调试体验的 AI 代理开发者。由于它是 ADK 生态系统的一部分，它能自然地融入以 Google 为中心的工作流程，但也可与任何兼容于 ADK 的模型搭配使用。

贡献 – 请遵循 Google 的 ADK 贡献指南；测试需要针对 Google 内部 CI 使用特殊的 initTestBed 调用。

授权 – Apache 2.0。

---

祝您代理构建愉快！