Genkit デベロッパー ツール

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

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

どちらのツールにも Node.js 20 以降が必要です。

インストール

  1. システムに Node 20 以降がインストールされていない場合は、今すぐインストールします。

    推奨: nvm ツールと nvm-windows ツールは、まだシステムにインストールされていない場合に、Node の特定のバージョンをインストールする便利な方法です。これらのツールはユーザーごとに Node をインストールするため、システム全体に変更を加える必要はありません。

    nvm をインストールするには:

    Linux、macOS など

    次のコマンドを実行します。

    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

    Windows

    nvm-windows ドキュメントに記載されている手順に沿って、インストーラをダウンロードして実行します。

    Node と npm をインストールするには、新しいシェルを開いて次のコマンドを実行します。

    nvm install 20

  2. 次のコマンドを実行して、Genkit CLI をインストールします。

    npm i -g genkit-cli

    このコマンドは、Genkit CLI を Node インストール ディレクトリにインストールし、Node プロジェクトの外部で使用できるようにします。

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

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

  • genkit start -- <command to run your code>: デベロッパー UI を起動し、実行中のコードプロセスに接続します。
  • genkit flow:run <flowName>: 指定されたフローを実行します。ランタイムは、GENKIT_ENV=dev 環境変数が設定された別のターミナルですでに実行されている必要があります。
  • genkit eval:flow <flowName>: 特定のフローを評価します。ランタイムは、GENKIT_ENV=dev 環境変数が設定された別のターミナルですでに実行されている必要があります。

すべてのコマンドの一覧については、以下を使用してください。

genkit --help

Genkit デベロッパー UI

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

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

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

genkit start -- <command to run your code>

<command to run your code> はプロジェクトの設定によって異なりますが、ほとんどのアプリでは次のようになります。

genkit start -- go run .

デベロッパー UI は、ロジックが完了しても Go アプリが引き続き実行されることを前提としています。これから始める段階で、Genkit が広範なアプリの一部でない場合は、main() の最後の行に select {} を追加して、アプリがシャットダウンしないようにして、UI で検査できるようにします。

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

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

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

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

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 や同様の技術が使用されています。 詳細。

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

genkit config set analyticsOptOut true

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

genkit config get analyticsOptOut