Skip to content

使用 Web 界面

Supported in ADKPython v0.1.0TypeScript v0.2.0Go v0.1.0Java v0.1.0

ADK Web 界面让你可以直接在浏览器中测试你的智能体。此工具提供了一种简单的方式来交互式地开发和调试你的智能体。

ADK Web Interface

注意:ADK Web 仅用于开发

ADK Web 不适用于生产部署。你应仅将 ADK Web 用于开发和调试目的。

ADK Web 界面的主要功能包括：

  • 聊天界面：向你的智能体发送消息并实时查看响应
  • 会话管理：创建和切换会话
  • 状态检查：在开发过程中查看和修改会话状态
  • 事件历史：检查智能体执行期间生成的所有事件
  • 可视化构建器：通过拖拽工作流编辑器和 AI 助手可视化设计智能体（仅限 Python，了解更多）

启动 Web 界面

使用以下命令启动 ADK Web 界面：

adk web

npx adk web

go run agent.go web api webui

确保更新端口号。

使用 Maven,编译并运行 ADK Web 服务器: 

mvn compile exec:java \
 -Dexec.args="--adk.agents.source-dir=src/main/java/agents --server.port=8000"

使用 Gradle,build.gradle 或 build.gradle.kts 构建文件的 plugins 部分应包含以下 Java 插件:

plugins {
    id('java')
    // 其他插件
}
然后,在构建文件的其他地方,在顶层创建一个新任务:

tasks.register('runADKWebServer', JavaExec) {
    dependsOn classes
    classpath = sourceSets.main.runtimeClasspath
    mainClass = 'com.google.adk.web.AdkWebServer'
    args '--adk.agents.source-dir=src/main/java/agents', '--server.port=8000'
}

最后,在命令行上运行以下命令: 

gradle runADKWebServer

在 Java 中，Web 界面和 API 服务器是打包在一起的。

启动后，服务器会将访问 URL 打印到控制台。在浏览器中打开它以使用 Web 界面：

+-----------------------------------------------------------------------------+
| ADK Web Server started                                                      |
|                                                                             |
| For local testing, access at http://localhost:8000.                         |
+-----------------------------------------------------------------------------+

常用选项

以下是 adk web 命令的一些常用选项。运行 adk web --help 查看所有可用选项。

选项 描述 默认值
--port 服务器运行端口 8000
--host 主机绑定地址 127.0.0.1
--session_service_uri 自定义会话存储 URI 内存
--artifact_service_uri 自定义产物存储 URI 本地 .adk/artifacts
--reload/--no-reload 代码更改时启用自动重载 true

例如：

adk web --port 3000 --session_service_uri "sqlite:///sessions.db"