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 用于开发和调试目的。

启动 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=8080"

使用 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=8080'
}

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

gradle runADKWebServer

在 Java 中,Web 界面和 API 服务器捆绑在一起。

服务器默认在 http://localhost:8000 上启动:

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

功能

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

  • 聊天界面: 向你的智能体发送消息并实时查看响应
  • 会话管理: 创建和切换会话
  • 状态检查: 在开发过程中查看和修改会话状态
  • 事件历史记录: 检查智能体执行期间生成的所有事件

常用选项

选项 描述 默认值
--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"