任意の Node.js プラットフォームにフローをデプロイ

Firebase Genkit には、フローのデプロイに役立つインテグレーションが組み込まれています。 Firebase Cloud Functions と Google Cloud Run を使用しますが、 Express.js アプリを配信できるあらゆるプラットフォームに配信可能で、 自己ホスト型かのどちらかです

このページでは、例として、デフォルトの サンプルフローをご覧ください

  1. 必要なツールをインストールします。

    • ノードのバージョン 20 以降を使用していることを確認します(node --version を実行して、 チェック)。
  2. Genkit サンプル プロジェクトのディレクトリを作成します。

    export GENKIT_PROJECT_HOME=~/tmp/genkit-express-project
    mkdir -p $GENKIT_PROJECT_HOME
    cd $GENKIT_PROJECT_HOME
    

    IDE を使用する場合は、このディレクトリに開きます。

  3. Nodejs プロジェクトを初期化します。

    npm init -y
    
  4. Genkit プロジェクトを初期化します。

    genkit init
    
    1. モデルを選択します。

      Gemini(Google AI)

      開始する最も簡単な方法は、Google AI Gemini API を使用することです。お住まいの地域で利用可能であることを確認してください。

      Google AI Studio を使用して Gemini API の API キーを生成します。次に、そのキーを GOOGLE_API_KEY 環境変数に設定します。

      export GOOGLE_API_KEY=<your API key>
      

      Gemini(Vertex AI)

      お住まいの地域で Google AI Gemini API が利用できない場合は、Vertex AI API の使用を検討してください。Vertex AI API では、Gemini 以外のモデルも提供されています。課金が有効になっている Google Cloud プロジェクトがあり、AI Platform API を有効にし、いくつかの環境変数を設定する必要があります。

      gcloud services enable aiplatform.googleapis.com
      export GCLOUD_PROJECT=<your project ID>
      export GCLOUD_LOCATION=us-central1
      

      Vertex AI の料金については、https://cloud.google.com/vertex-ai/generative-ai/pricing をご覧ください。

    2. 残りの質問に対してデフォルトの回答を選択します。これにより、サンプルコードを使用するプロジェクト フォルダが初期化されます。

  5. サンプルコードをビルドして実行します。

    npm run build
    genkit flow:run menuSuggestionFlow "\"banana\"" -s
    
  6. 省略可: デベロッパー UI を起動します。

    genkit start
    

    次に、http://localhost:4000/flows に移動して次のコマンドを実行します。 デベロッパー UI でフローを管理できます。

    完了したら、コンソールで Ctrl+C キーを押して UI を終了します。

  7. Express エンドポイントを試してみます。

    npm run start
    

    別のウィンドウで次のように操作します。

    curl -X POST "http://127.0.0.1:3400/menuSuggestionFlow?stream=true" -H "Content-Type: application/json"  -d '{"data": "banana"}'
    
  8. すべてが想定どおりに機能している場合は、フローをプロバイダにデプロイできます。 選択できます。詳細はプロバイダによって異なりますが、通常は 次の設定を構成します。

    設定
    ランタイム Node.js 20 以降
    ビルドコマンド npm run build
    開始コマンド npm run start
    環境変数 GOOGLE_API_KEY=<your-api-key>(または必要なシークレット)