Dev Console overview

Understand Dev Console modes, targets, and what each surface can do.

The Dev Console is the browser UI for building and inspecting an ADK agent. It opens during adk dev, and you can also open it with adk dashboard or by running adk interactively.

The console has two independent ideas:

IdeaValuesWhat it decides
Console modeLocal or CloudWhere the console is pointed and which actions are available
Targetdev or prodWhich bot’s Cloud state the console shows or changes

Local mode

Local mode is attached to a project running with adk dev. Your agent code runs locally, while conversations, integrations, config, tables, knowledge, and other bot state still live on the selected Cloud bot.

In Local mode, you can switch between the dev and prod targets:

Dev and production target selector in the Dev Console

Use dev for everyday local development. Switch to prod when you need to inspect production bot state from the same local project context.

Cloud mode

Cloud mode opens against a deployed production bot without a local project backend. It is always prod, and actions that require local source context are unavailable.

Cloud mode relies on metadata published by adk deploy, so an ADK bot must be deployed at least once before the console can show its source-shaped definitions, such as actions, workflows, triggers, tables, knowledge, and config variables.

Console areas

This is a high-level map of the Dev Console’s top-level areas. Some items are only available in Local mode or can be hidden by feature flags.

AreaUse it forRelated docs
Agent MapVisualize how actions, workflows, triggers, and conversations connectAgent Map
ChatTest conversations and inspect agent steps during each turnSet up conversations, Agent steps
ActionsInspect actions exposed by your agentCreate actions
WorkflowsInspect workflows and workflow runsCreate workflows, Use workflow steps
TriggersInspect trigger definitions and connected eventsSet up triggers
Webchat ComponentsPreview custom UI components used in WebchatUse custom components
RAG SearchTest knowledge retrieval against your bot’s knowledge basesKnowledge bases
EvalsRun and inspect automated conversation testsWrite and run evals
KnowledgeInspect knowledge bases connected to the selected botKnowledge bases
TablesInspect structured data connected to the selected botTables
FilesInspect files available to the selected botKnowledge bases
ConversationsInspect conversation historyManage conversation lifecycle
AnalyticsReview aggregate behavior such as volume, latency, token usage, and costAnalytics
TracesDebug handlers, tool calls, LLM calls, and runtime spansDebug with logs and traces
LogsRead runtime log outputDebug with logs and traces
Agent ConfigView and update configuration valuesConfiguration
IntegrationsManage integrations and pluginsManaging dependencies

Cloud mode is more limited because there is no local project backend. Use Local mode when you need source-aware actions or live local runtime data.