veadk web 在 Google ADK 的 adk web 之上封装了一层，启动一个可视化的调试界面：无需编写任何前端代码，即可在浏览器中与智能体对话并观察其执行过程。相比直接使用 adk web，它额外提供了 VeADK 记忆能力的自动集成、工作流智能体的记忆告警、可选的 VeIdentity SSO 登录，并默认关闭 OpenAPI 文档路由与冗余日志。它适合本地开发与排查。
veadk web 会透传 adk web 的选项，因此 adk web 的用法在此同样适用，本页仅在其基础上说明 VeADK 增加的行为与选项。
启动
在智能体目录的上层目录中执行命令。每个包含agent.py 并暴露 root_agent 的子目录都会成为界面中可选择的一个应用。
常用透传选项
以下选项由底层的adk web 提供，veadk web 原样透传。
完整的透传选项以
adk web --help 为准。上表列出的是与本界面最常配合使用的几项。自有 OAuth2 选项
veadk web 额外提供三个用于 VeIdentity 单点登录的选项。仅当同时提供用户池与客户端名称时才会启用登录中间件。
启用 SSO 需要进程能够读取到火山引擎凭证。此模式下的 Cookie 未强制
Secure 标志，以便在本地 HTTP 环境下正常工作。记忆能力自动集成
这是veadk web 相较于原生 adk web 的核心增强。命令会挂钩 ADK Web 服务的运行器获取过程，在为某个应用创建运行器之前，先加载对应的智能体并检查其记忆配置：
- 若智能体配置了短期记忆，则将其会话服务接入为该应用的会话服务。
- 若智能体配置了长期记忆，则将其接入为该应用的记忆服务，并在日志中打印所使用的长期记忆后端。
关闭 OpenAPI 与日志默认级别
veadk web 在启动时对 ADK Web 服务做了两处调整：
- 关闭 OpenAPI 文档路由。 从服务中移除
/openapi.json、/docs、/redoc三个路由，以简化界面并收敛暴露面。 - 收敛日志默认级别。 若未显式传入
--log_level，则将日志级别默认设为ERROR，以抑制 Google ADK 与 LiteLLM 的冗余输出；显式传入--log_level时以传入值为准。
智能体构建图序列化
veadk web 启动时会调整 ADK 开发服务器中智能体构建图的序列化行为。该端点用于在调试界面中展示智能体拓扑与配置，原序列化会将 VeADK 智能体的模型字段输出为包含运行时客户端对象的复杂结构，导致界面无法正确解析。
调整后，构建图 JSON 中的模型字段以「提供方/模型名称」的字符串形式呈现，运行时客户端对象不再出现在输出中，包含嵌套子智能体在内的整棵智能体树均可正常序列化。