Firebase Genkit デベロッパー ツール

Firebase Genkit には、次の 2 つの重要なデベロッパー ツールが用意されています。

  • コマンドライン オペレーション用の Node.js CLI
  • デベロッパー UI と呼ばれるオプションのローカル ウェブアプリ。インタラクティブなテストと開発のために Genkit 構成とインターフェースを形成します。

コマンドライン インターフェース（CLI）

次のコマンドを使用して、プロジェクトに CLI をインストールします。

npm install -D genkit-cli

CLI は、Genkit プロジェクトの操作を容易にするためのさまざまなコマンドをサポートしています。

  • genkit start -- <command to run your code>: デベロッパー UI を起動し、実行中のコードプロセスに接続します。
  • genkit flow:run <flowName>: 指定されたフローを実行します。
  • genkit eval:flow <flowName>: 特定のフローを評価します。

すべてのコマンドの一覧を表示するには、次のコマンドを使用します。

npx genkit --help

Genkit デベロッパー UI

Genkit デベロッパー UI は、Genkit プロジェクト内のモデル、フロー、プロンプトなどの要素をインタラクティブに操作できるローカル ウェブアプリです。

デベロッパー UI は、実行中のコードプロセスにアタッチすることで、コードで定義した Genkit コンポーネントを特定できます。

UI を開始するには、次のコマンドを実行します。

npx genkit start -- <command to run your code>

<command to run your code> は、プロジェクトの設定と実行するファイルによって異なります。次に例を示します。

# Running a typical development server
npx genkit start -- npm run dev
# Running a TypeScript file directly
npx genkit start -- npx tsx --watch src/index.ts
# Running a JavaScript file directly
npx genkit start -- node --watch src/index.js

--watch オプションを含めると、デベロッパー UI は、コードを再起動することなく、保存された変更を認識してコードに反映できます。

コマンドを実行すると、次のような出力が表示されます。

Telemetry API running on http://localhost:4033
Genkit Developer UI: http://localhost:4000

ブラウザで Genkit デベロッパー UI のローカルホスト アドレスを開いて表示します。VS Code のシンプルなブラウザで開いて、コードと一緒に表示することもできます。

または、起動コマンドに -o オプションを追加して、デフォルトのブラウザタブでデベロッパー UI を自動的に開くこともできます。

npx genkit start -o -- <command to run your code>

Genkit デベロッパー UI へようこそ

デベロッパー UI には、コードで定義したコンポーネントに基づいて、flow、prompt、model、tool、retriever、indexer、embedder、evaluator のアクション ランナーがあります。

猫の GIF で簡単にご紹介します。

Genkit デベロッパー UI の概要（GIF）

アナリティクス

Genkit CLI とデベロッパー UI では、高品質なサービスの提供とトラフィックの分析のために、Google の Cookie や同様の技術が使用されています。詳細

アナリティクスをオプトアウトするには、次のコマンドを実行します。

npx genkit config set analyticsOptOut true

現在の設定を表示するには、次のコマンドを実行します。

npx genkit config get analyticsOptOut