adk-dev-console

ADK 開発者コンソール

開発者コンソールは、adk dev の実行中にポート 3001 で提供されるローカルアプリです（デフォルト。カスタマイズ可能）。エージェントの動作（会話、実行トレース、データ、インテグレーション、設定）をリアルタイムで確認できます。

開発者コンソールは単一インスタンスの共有ダッシュボードです。ユーザーごとに UI サーバーが 1 つあり、複数の adk dev エージェントが動的に登録・登録解除されます。開発者は、同じブラウザータブから実行中のエージェントをサイドバーで切り替えたり、開発環境と本番環境のターゲットを切り替えたり、デプロイ済みの Cloud ボットに接続したりできます。

このスキルを使用する場面

ユーザーから次のような質問があった場合に有効化します。

• UI の概念 — 「Agent Steps とは何ですか？」「Observe タブには何が表示されますか？」「ターンとは何ですか？」「コンポーネントレジストリとは何ですか？」「Agent Map とは何ですか？」
• Agent(0) の UI — 「Agent(0) の下にある Tasks とは何ですか？」「ToDo リストはどこから来たのですか？」「Agent(0) にタスクの進行状況が表示されるのはなぜですか？」
• 開発者コンソールの操作 — 「どのタブが利用できますか？」「トレースはどこで確認できますか？」「RAG をテストするにはどうすればよいですか？」
• 実行データの確認 — 「各ステップは何を意味していますか？」「ステップが赤色なのはなぜですか？」「表示されているコストは何ですか？」
• コンポーネントレジストリ — 「カスタムコンポーネントはどこで確認できますか？」「コンポーネントをインストールするにはどうすればよいですか？」「どのコンポーネントを利用できますか？」
• マルチエージェントダッシュボード — 「エージェントを切り替えるにはどうすればよいですか？」「複数のエージェントを実行するにはどうすればよいですか？」「エージェントセレクターには何が表示されますか？」「実行中のエージェントを確認するにはどうすればよいですか？」
• コンソールのモードとターゲット — 「開発環境と本番環境の違いは何ですか？」「Cloud ボットに接続するにはどうすればよいですか？」「Cloud 開発者コンソールとは何ですか？」
• エージェント管理 CLI — 「実行中のエージェントを一覧表示するにはどうすればよいですか？」「エージェントを停止するにはどうすればよいですか？」「adk ps には何が表示されますか？」「ダッシュボードを開くにはどうすればよいですか？」
• 特定のページ — 「evals ページを使用するにはどうすればよいですか？」「インテグレーションはどこで設定できますか？」「ナレッジを検索するにはどうすればよいですか？」
• UI と CLI の比較 — 「デバッグには開発者コンソールと CLI のどちらを使うべきですか？」
• localhost:3001、「dev console」、「Dev Console」、「component registry」、「agent selector」、「agent picker」、「agent map」、「Cloud Dev Console」、または特定のタブ名（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	マルチエージェントのアーキテクチャ、エージェントセレクター、コンソールのモード（ローカル／クラウド）、開発／本番環境のターゲット、CLI コマンド（adk ps、adk kill、adk dashboard、adk status）

回答方法

質問に合わせて説明の詳しさを調整します。

• 「X とは何ですか？」（例：「Agent Steps とは何ですか？」）→ 1 文で定義し、ユーザーに何が見えるかを説明します。データモデル全体を並べる必要はありません。
• 「X はどこにありますか？」 → タブグループとページを示し、URL パスを伝えます。
• 「X の読み方を教えてください」 → 視覚的な階層と各要素の意味を説明します。
• 「これは何を意味していますか？」（UI 上の項目を指している場合）→ コンポーネントを特定し、その意味を説明します。

クイックリファレンス

タブグループ

グループ	ページ	目的
チャット	チャット	Web チャットでエージェントをテストし、エージェントのステップを確認します
ビルド	エージェントマップ	インタラクティブなエージェントアーキテクチャのグラフ（実験的機能。enable_agent_forge でフラグ管理されています）
コンポーネント	Web チャットコンポーネント、アクション、ワークフロー、トリガー	コンポーネントレジストリを閲覧し、ボットの基本機能をテストします
テスト	RAG 検索、評価	ナレッジ検索をテストし、自動評価を実行します
データ	ナレッジ、テーブル、ファイル	ナレッジベース、テーブル、ファイルを管理します
監視	会話、トレース、ログ	会話履歴、実行トレース、ランタイムログを表示します
設定	設定、インテグレーション	エージェントの設定、シークレット、LLM の設定、インテグレーションを管理します

Agent(0) のタスクドック

Agent(0) が todo ツールを使用すると、パネルに完了数／合計数、現在のタスク、展開可能なタスクリストを備えたコンパクトな タスク ドックが表示されます。ステータスアイコンは保留中、進行中、完了、キャンセルを示し、優先度は低／中／高のチップで表示されます。

マルチエージェントサイドバー

サイドバーのヘッダーには、現在選択されているエージェントとステータスインジケーター、モードピル（dev/prod/cloud）が表示されます。クリックすると エージェントセレクター のドロップダウンが開きます。

• アクティブなエージェント — 実行中のすべてのローカルエージェントを、ステータスドット、名前、プロジェクトパス、閉じるボタンとともに表示します
• Cloud Dev Console — デプロイ済みの Botpress Cloud ボットに切り替えます（ワークスペースとボットの選択）
• 最近のプロジェクト — 以前に開いた、現在は実行されていないプロジェクト
• フッターのアクション — 新しいプロジェクトを作成、既存のプロジェクトを開く、環境を切り替える（dev↔prod）、詳細

エージェントのステップ（チャットページ）

チャットページの右側のパネルには エージェントのステップ が表示され、各メッセージを処理するためにエージェントが行ったことをリアルタイムで視覚化します。

階層： ターン → イテレーション → ツール／メッセージ／状態の変更

• ターン = 1 回の会話のやり取り（ユーザーメッセージ → エージェントの処理 → 応答）
• イテレーション = 自律型エージェントの 1 ループ（思考 → 判断 → 実行）
• ツール = イテレーション内のツール呼び出し（紫色のカード）
• メッセージ = 送信されたボットメッセージ（青色のカード）
• 状態の変更 = 状態の変更（変更前／変更後を表示する青緑色のカード）

ステータスインジケーター： ✓ 緑色 = 正常、✗ 赤色 = エラー、⟳ 青色の回転アイコン = 実行中

イテレーションごとの AI 指標： モデル名、入力／出力トークン数、コスト（USD）

主要な URL

パス	ページ
/chat	チャット＋エージェントのステップ
/agent-map	エージェントマップ — インタラクティブなアーキテクチャグラフ（実験的機能）
/components	コンポーネントレジストリ＋インストール済みコンポーネント
/actions	アクションブラウザー
/workflows	ワークフロー＋実行履歴
/search	RAG 検索テスト
/evals	評価の定義＋実行
/knowledge	ナレッジベース管理
/tables	テーブルデータ管理
/traces	トレース全体のビューアー
/conversations	会話履歴
/logs	実行時ログ
/settings	エージェント設定
/integrations	インテグレーション管理

マルチエージェント CLI コマンド

コマンド	目的
adk ps	PID、ポート、稼働時間を含む、実行中のエージェントとプロセスの一覧を表示します（--watch に対応）
adk dashboard	DevConsole をスタンドアロンモードで開きます（エージェントは不要です）
adk kill	エージェントまたは DevConsole 全体を停止します（--all、--current、--pid、または名前で指定）
adk status	プロジェクトの健全性とステータス情報を表示します