adk-dev-console

ADK 开发控制台

开发控制台是在运行 adk dev 时通过 3001 端口提供服务的本地应用（默认端口，可自定义）。它让开发者能够实时查看 Agent 的行为，包括对话、执行轨迹、数据、集成和配置。

开发控制台是一个单例共享仪表板：每位用户运行一个 UI 服务，多个 adk dev Agent 可以动态注册和注销。开发者可以在侧边栏中切换正在运行的 Agent，在开发和生产目标之间切换，还可以连接已部署的 Cloud 机器人——这一切都可以在同一个浏览器标签页中完成。

何时使用此技能

当用户询问以下内容时启用：

• UI 概念——“什么是 Agent Steps？”，“Observe 标签页会显示什么？”，“什么是轮次？”，“什么是组件注册表？”，“什么是 Agent Map？”
• Agent(0) UI——“Agent(0) 下的任务是什么？”，“待办列表是从哪里来的？”，“为什么 Agent(0) 会显示任务进度？”
• 开发控制台导航——“有哪些标签页？”，“在哪里可以找到轨迹？”，“如何测试 RAG？”
• 读取执行数据——“这些步骤是什么意思？”，“为什么我的步骤是红色的？”，“显示的费用是多少？”
• 组件注册表——“在哪里可以找到自定义组件？”，“如何安装组件？”，“有哪些可用组件？”
• 多 Agent 仪表板——“如何在 Agent 之间切换？”，“如何运行多个 Agent？”，“Agent 选择器会显示什么？”，“如何查看哪些 Agent 正在运行？”
• 控制台模式和目标——“开发和生产有什么区别？”，“如何连接到 Cloud 机器人？”，“什么是 Cloud 开发控制台？”
• Agent 管理 CLI——“如何列出正在运行的 Agent？”，“如何停止 Agent？”，“adk ps 会显示什么？”，“如何打开仪表板？”
• 特定页面——“如何使用评估页面？”，“在哪里配置集成？”，“如何搜索知识？”
• 比较 UI 和 CLI——“调试时应该使用开发控制台还是 CLI？”
• 提及 localhost:3001、“dev console”、“开发控制台”、“组件注册表”、“Agent 选择器”、“Agent picker”、“Agent Map”、“Cloud 开发控制台”，或特定标签页名称（Chat、Build、Components、Data、Test、Observe、Config）

可用文档

文件	内容
references/agent-steps.md	Agent Steps 可视化——轮次、迭代、工具、消息、状态变更、费用跟踪、状态指示器
references/pages.md	开发控制台中的所有页面/标签页——显示内容、主要功能、布局
references/component-registry.md	组件注册表——已安装和注册表标签页、组件生命周期、运行时注册表内部机制、UI 功能
references/multi-agent-dashboard.md	多 Agent 架构、Agent 选择器、控制台模式（本地/云端）、开发/生产目标、CLI 命令（adk ps、adk kill、adk dashboard、adk status）

如何回答

根据问题调整回答深度：

• “X 是什么？”（例如，“什么是 Agent Steps？”）→ 用一句话定义，并说明用户会看到什么。不要倾倒完整的数据模型。
• “在哪里可以找到 X？” → 指出标签页组和页面，并提供 URL 路径。
• “如何阅读 X？” → 说明视觉层级，以及每个元素的含义。
• “这是什么意思？”（用户指着 UI 中的某项内容提问）→ 识别该组件并解释其含义。

快速参考

标签页分组

分组	页面	用途
聊天	Chat	通过网页聊天测试 Agent，并查看 Agent 步骤
构建	Agent Map	交互式 Agent 架构图（实验性功能，需通过 enable_agent_forge 功能标志启用）
组件	Webchat Components, Actions, Workflows, Triggers	浏览组件注册表，测试机器人基础组件
测试	RAG Search, Evals	测试知识搜索并运行自动化评估
数据	Knowledge, Tables, Files	管理知识库、表格和文件
观测	Conversations, Traces, Logs	查看对话历史、执行跟踪和运行时日志
配置	Settings, Integrations	Agent 配置、密钥、大模型设置和集成管理

Agent(0) 任务栏

当 Agent(0) 使用其待办事项工具时，面板会显示一个紧凑的 任务 栏，其中包含已完成/总数、当前任务以及可展开的任务列表。状态图标对应待处理、进行中、已完成和已取消；优先级以低/中/高标签显示。

多 Agent 侧边栏

侧边栏标题显示当前选中的 Agent，以及状态指示器和模式标签（dev/prod/cloud）。点击后会打开 Agent 选择器下拉菜单：

• 活跃 Agent — 所有正在运行的本地 Agent，显示状态圆点、名称、项目路径和关闭按钮
• 云端开发控制台 — 切换到已部署的 Botpress Cloud 机器人（工作区 + 机器人选择器）
• 最近项目 — 之前打开但当前未运行的项目
• 页脚操作 — 创建新项目、打开现有项目、切换环境（dev↔prod）、关于

Agent 步骤（聊天页面）

聊天页面的右侧面板会显示 Agent 步骤，实时展示 Agent 为处理每条消息执行的操作。

层级： 对话轮次 → 迭代 → 工具 / 消息 / 状态变更

• 对话轮次 = 一次对话交互（用户消息 → Agent 处理 → 响应）
• 迭代 = 自主 Agent 的一次循环（思考 → 决策 → 行动）
• 工具 = 迭代中的一次工具调用（紫色卡片）
• 消息 = 发送的一条机器人消息（蓝色卡片）
• 状态变更 = 一次状态变化（青绿色卡片，显示变更前后）

状态指示器： ✓ 绿色 = 正常，✗ 红色 = 错误，⟳ 蓝色旋转 = 运行中

每次迭代的 AI 指标： 模型名称、输入/输出令牌数、费用（USD）

关键 URL

路径	页面
/chat	聊天 + Agent 步骤
/agent-map	Agent 地图 — 交互式架构图（实验性）
/components	组件注册表 + 已安装的组件
/actions	操作浏览器
/workflows	工作流 + 运行历史
/search	RAG 搜索测试
/evals	评估定义 + 运行
/knowledge	知识库管理
/tables	表格数据管理
/traces	完整追踪查看器
/conversations	对话历史
/logs	运行时日志
/settings	Agent 配置
/integrations	集成管理

多 Agent 命令行命令

命令	用途
adk ps	列出运行中的 Agent 和进程及其 PID、端口、运行时间（支持 --watch）
adk dashboard	以独立模式打开 DevConsole（无需 Agent）
adk kill	停止 Agent 或整个 DevConsole（使用 --all、--current、--pid 或按名称）
adk status	显示项目健康状况和状态信息