使用 ADK Dev Console 调试智能体时…

当你在 localhost:3001 使用 ADK Dev Console 调试智能体，需要弄清各页面含义、执行步骤、组件注册表、多智能体切换或相关 CLI 命令时使用。

适用场景

解决思路

1. 按问题类型控制回答深度：问「X 是什么」时给一句话定义加用户所见内容，不要倾倒完整数据模型；问「在哪里找到 X」时给出标签组、页面名和 URL 路径；问「如何阅读 X」时解释视觉层级和各元素含义；问「这是什么意思」时识别组件并解释其含义。
2. 记住 Dev Console 是单例共享面板：每个用户一个 UI 服务器，多个 adk dev 智能体动态注册和注销，可在侧边栏切换运行中的智能体、切换 dev/prod 目标、连接已部署的 Cloud bot。
3. 按标签组导航：Chat 组含 Chat 页（通过 webchat 测试智能体并查看 Agent Steps）；Build 组含 Agent Map（交互式智能体架构图，实验性，由 enable_agent_forge 特性开关控制）；Components 组含 Webchat Components、Actions、Workflows、Triggers（浏览组件注册表、测试 bot 原语）；Test 组含 RAG Search、Evals（测试知识搜索、运行自动化评估）；Data 组含 Knowledge、Tables、Files（管理知识库、表格和文件）；Observe 组含 Conversations、Traces、Logs（查看对话历史、执行轨迹、运行时日志）；Config 组含 Settings、Integrations（智能体配置、密钥、LLM 设置、集成管理）。
4. 阅读 Agent(0) Task Dock：当 Agent(0) 使用 todo 工具时，面板显示紧凑的 Tasks 停靠栏，含已完成/总数、当前任务和可展开的任务列表；状态图标对应 pending、in progress、completed、cancelled；优先级以 low/medium/high 标签显示。
5. 使用多智能体侧边栏：侧边栏头部显示当前选中的智能体及状态指示器和模式标签（dev/prod/cloud）；点击打开 Agent Selector 下拉菜单，其中 Active agents 列出所有运行中的本地智能体（状态点、名称、项目路径、关闭按钮），Cloud Dev Console 可切换到已部署的 Botpress Cloud bot（工作区 + bot 选择器），Recent projects 列出之前打开但当前未运行的项目，底部操作含 Create new project、Open existing、Switch environment（dev↔prod）、About。
6. 阅读 Chat 页的 Agent Steps：右侧面板实时可视化智能体处理每条消息的过程，层级为 Turn → Iterations → Tools / Messages / State Mutations；Turn 是一次对话交换（用户消息 → 智能体处理 → 响应），Iteration 是自主智能体的一次循环（思考 → 决策 → 行动），Tool 是迭代内的工具调用（紫色卡片），Message 是发出的 bot 消息（蓝色卡片），State Mutation 是状态变更（青色卡片，显示前后值）。
7. 识别 Agent Steps 状态指示器：✓ 绿色表示成功，✗ 红色表示错误，⟳ 蓝色旋转表示运行中；每次迭代显示 AI 指标：模型名、输入/输出 token 数、成本（USD）。
8. 按 URL 路径定位页面：/chat 为 Chat + Agent Steps，/agent-map 为 Agent Map（实验性交互式架构图），/components 为组件注册表 + 已安装组件，/actions 为 Actions 浏览器，/workflows 为 Workflows + 运行历史，/search 为 RAG 搜索测试，/evals 为评估定义 + 运行，/knowledge 为知识库管理，/tables 为表格数据管理，/traces 为完整轨迹查看器，/conversations 为对话历史，/logs 为运行时日志，/settings 为智能体配置，/integrations 为集成管理。
9. 使用多智能体 CLI 命令：adk ps 列出运行中的智能体和进程及 PID、端口、运行时长（支持 --watch）；adk dashboard 以独立模式打开 DevConsole（无需智能体）；adk kill 停止智能体或整个 DevConsole（--all、--current、--pid 或按名称）；adk status 显示项目健康状态和状态信息。

适用边界 · 注意事项

• 不适用于不使用 ADK 或 Botpress 生态的开发者，因为该控制台是 ADK 专属工具。
• 不适用于未运行 adk dev 或无法访问 localhost:3001 的场景。
• 不适用于需要修改智能体代码或配置本身的问题，本技能只解释 UI 和命令的含义与用法。