google/adk-web

Agent Development Kit Web UI (ADK WEB)

概要 – GoogleのAgent Development Kit (ADK) に同梱されているブラウザベースの開発者コンソールです。ADKは、AIエージェント（チャットボット、自律型アシスタント、ワークフローオーケストレーションエージェントなど）を構築、デプロイ、オーケストレーションするためのモジュール式フレームワークです。このWeb UIは、エージェントの作成、イベントの検査、実行のトレース、アーティファクトや評価結果の表示、および基盤となるADKランタイムのデバッグを行うための視覚的なフロントエンドを提供します。

主要コンポーネント

• フロントエンド – Angularシングルページアプリケーション（npm run serveで実行）。プロキシ経由でADKバックエンドと通信するため、UIはローカルのhttp://localhost:4200で実行可能です。
• バックエンド – ADKランタイム本体。adk webコマンド（google-adk PythonまたはJavaパッケージからインストール）で実行します。UIはこのプロセスにAPI呼び出しを転送します。
• 統合 – Geminiモデルスタックでそのまま動作しますが、モデルに依存しません。ADK互換のエージェント実装であれば何にでも接続可能です。

開始方法

1. Node、npm、Angular CLIをインストールします。
2. ADK PythonまたはJava SDK (google-adk) をインストールします。
3. このリポジトリをクローンし、npm installを実行してからnpm run serveを実行します。
4. 別のターミナルでadk webを実行してバックエンドを起動します。
5. http://localhost:4200を開くと、イベント、トレース、アーティファクト、評価、エージェントビルダーのタブを備えたUIが表示されます。

UIでできること

• イベント – エージェントが生成したイベントのタイムラインを閲覧します。
• トレース – エージェント実行のコールグラフと実行フローを可視化します。
• アーティファクト – エージェントが生成したファイル、ログ、その他の出力を検査します。
• 評価 – エージェントのメトリクスとテスト結果を表示します。
• エージェントビルダーとアシスタント – エージェントコンポーネントを組み立て、ライブアシスタントと対話するためのドラッグ＆ドロップ形式のインターフェースです。

対象ユーザー – 生のログよりもリッチなデバッグ体験を求めるAIエージェント開発者。ADKエコシステムの一部であるため、Google中心のワークフローに自然に適合しますが、ADK互換のモデルであれば何でも使用できます。

貢献 – GoogleのADK貢献ガイドに従ってください。テストにはGoogle内部CI用の特別なinitTestBed呼び出しが必要です。

ライセンス – Apache 2.0。

---

Happy Agent Building!