將流程部署至任何 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. 選取 Node.js 做為部署平台選項 (您也可以使用 Firebase Cloud Functions 和 Google Cloud Run 的範本)。

    2. 選取模型：

      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，其亦提供 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。

    3. 選擇其餘問題的預設答案，使用一些程式碼範例初始化專案資料夾。

  5. 建構並執行程式碼範例：

    npm run build
genkit flow:run menuSuggestionFlow "\"banana\"" -s

  6. 選用：啟動開發人員 UI：

    genkit start

    接著前往 http://localhost:4000/flows，然後使用開發人員 UI 執行流程。

    完成後，按下控制台中的 Ctrl+C 鍵即可關閉使用者介面。

  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> (或任何必要密鑰)