adk-dev-console

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

ADK Dev Console

ADK Dev Console

The Dev Console is a local app served at port
3001
(by default, but can be customized) during
adk dev
. It gives developers real-time visibility into their agent's behavior — conversations, execution traces, data, integrations, and configuration.
Dev Console是在
adk dev
运行期间,默认在端口
3001
(可自定义)提供服务的本地应用。它能让开发者实时查看Agent的行为——对话内容、执行追踪、数据、集成以及配置信息。

When to Use This Skill

何时使用此技能

Activate when users ask about:
  • UI concepts — "What are Agent Steps?", "What does the Observe tab show?", "What is a turn?"
  • Dev Console navigation — "What tabs are available?", "Where do I find traces?", "How do I test RAG?"
  • Reading execution data — "What do the steps mean?", "Why is my step red?", "What's the cost shown?"
  • Specific pages — "How do I use the evals page?", "Where do I configure integrations?", "How do I search knowledge?"
  • Comparing UI vs CLI — "Should I use the Dev Console or CLI for debugging?"
  • Mentions of
    localhost:3001
    , "dev console", "Dev Console", or specific tab names (Chat, Build, Components, Data, Test, Observe, Config)
当用户询问以下内容时启用:
  • UI概念——"什么是Agent Steps?"、"Observe标签页展示什么内容?"、"什么是turn?"
  • Dev Console导航——"有哪些可用标签页?"、"在哪里查看追踪信息?"、"如何测试RAG?"
  • 解读执行数据——"这些步骤是什么意思?"、"为什么我的步骤显示红色?"、"显示的成本是什么?"
  • 特定页面——"如何使用evals页面?"、"在哪里配置集成?"、"如何搜索知识库?"
  • UI与CLI对比——"调试时应该用Dev Console还是CLI?"
  • 提及
    localhost:3001
    、"dev console"、"Dev Console"或特定标签页名称(Chat、Build、Components、Data、Test、Observe、Config)

Available Documentation

可用文档

FileContents
references/agent-steps.md
Agent Steps visualization — turns, iterations, tools, messages, state mutations, cost tracking, status indicators
references/pages.md
Every page/tab in the Dev Console — what it shows, key features, layout
文件内容
references/agent-steps.md
Agent Steps可视化——turns、迭代、工具、消息、状态变更、成本追踪、状态指示器
references/pages.md
Dev Console中的每个页面/标签页——展示内容、关键功能、布局

How to Answer

回答方式

Match depth to the question:
  • "What is X?" (e.g., "What are Agent Steps?") → One sentence definition + what the user sees. Don't dump the full data model.
  • "Where do I find X?" → Name the tab group and page, give the URL path.
  • "How do I read X?" → Explain the visual hierarchy and what each element means.
  • "What does this mean?" (pointing at something in the UI) → Identify the component, explain its meaning.
根据问题的深度匹配回答:
  • "X是什么?"(例如:"什么是Agent Steps?")→ 一句话定义+用户能看到的内容。不要罗列完整的数据模型。
  • "在哪里找到X?" → 说明标签组和页面名称,给出URL路径。
  • "如何解读X?" → 解释视觉层级以及每个元素的含义。
  • "这是什么意思?"(指向UI中的某个元素)→ 识别组件,解释其含义。

Quick Reference

快速参考

Tab Groups

标签组

GroupPagesPurpose
ChatChatTest the agent via webchat + see Agent Steps
BuildStoryVisual agent flow graph (feature-flagged)
ComponentsActions, Workflows, TriggersBrowse and test bot primitives
TestRAG Search, EvalsTest knowledge search and run automated evals
DataKnowledge, Tables, FilesManage knowledge bases, tables, and files
ObserveConversations, Traces, LogsView conversation history, execution traces, runtime logs
ConfigSettings, IntegrationsAgent config, secrets, LLM settings, integration management
页面用途
ChatChat通过网页聊天测试Agent + 查看Agent Steps
BuildStoryAgent流程可视化图(功能标记控制)
ComponentsActions、Workflows、Triggers浏览并测试机器人基础组件
TestRAG Search、Evals测试知识库搜索并运行自动化评估
DataKnowledge、Tables、Files管理知识库、表格和文件
ObserveConversations、Traces、Logs查看对话历史、执行追踪、运行时日志
ConfigSettings、IntegrationsAgent配置、密钥、LLM设置、集成管理

Agent Steps (Chat Page)

Agent Steps(Chat页面)

The right panel of the Chat page shows Agent Steps — a real-time visualization of what the agent did to process each message.
Hierarchy: Turn → Iterations → Tools / Messages / State Mutations
  • Turn = one conversation exchange (user message → agent processing → response)
  • Iteration = one loop of the autonomous agent (think → decide → act)
  • Tool = a tool call within an iteration (violet card)
  • Message = a bot message sent (blue card)
  • State Mutation = a state change (teal card, shows before/after)
Status indicators: ✓ green = ok, ✗ red = error, ⟳ blue spinning = running
AI metrics per iteration: model name, input/output tokens, cost (USD)
Chat页面的右侧面板展示Agent Steps——实时可视化Agent处理每条消息的过程。
层级结构: Turn → Iterations → Tools / Messages / State Mutations
  • Turn = 一次对话交互(用户消息→Agent处理→回复)
  • Iteration = 自主Agent的一次循环(思考→决策→行动)
  • Tool = 迭代中的工具调用(紫色卡片)
  • Message = 发送的机器人消息(蓝色卡片)
  • State Mutation = 状态变更(蓝绿色卡片,显示变更前后状态)
状态指示器: ✓ 绿色=正常,✗ 红色=错误,⟳ 蓝色旋转=运行中
每轮迭代的AI指标: 模型名称、输入/输出token数量、成本(美元)

Key URLs

关键URL

PathPage
/chat
Chat + Agent Steps
/actions
Actions browser
/workflows
Workflows + run history
/search
RAG search testing
/evals
Eval definitions + runs
/knowledge
Knowledge base management
/tables
Table data management
/traces
Full trace viewer
/conversations
Conversation history
/logs
Runtime logs
/settings
Agent configuration
/integrations
Integration management
路径页面
/chat
Chat + Agent Steps
/actions
Actions浏览器
/workflows
Workflows + 运行历史
/search
RAG搜索测试
/evals
评估定义 + 运行记录
/knowledge
知识库管理
/tables
表格数据管理
/traces
完整追踪查看器
/conversations
对话历史
/logs
运行时日志
/settings
Agent配置
/integrations
集成管理