Firebase Genkit 內建整合功能,可協助您將流程部署至 Firebase Cloud Functions 和 Google Cloud Run,但您也可以將流程部署到可提供 Express.js 應用程式的任何平台 (無論是雲端服務或自行託管)。
本頁將以範例為例,說明如何部署預設範例流程。
安裝必要工具:
- 請確保您使用的是 20 以上版本的節點 (執行
node --version
即可確認)。
- 請確保您使用的是 20 以上版本的節點 (執行
為 Genkit 範例專案建立目錄:
export GENKIT_PROJECT_HOME=~/tmp/genkit-express-project
mkdir -p $GENKIT_PROJECT_HOME
cd $GENKIT_PROJECT_HOME
如果您要使用 IDE,請將其開啟至這個目錄。
初始化 nodejs 專案:
npm init -y
初始化 Genkit 專案:
genkit init
選取
Node.js
做為部署平台選項 (您也可以使用 Firebase Cloud Functions 和 Google Cloud Run 的範本)。選取模型:
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。
選擇其餘問題的預設答案,使用一些程式碼範例初始化專案資料夾。
建構並執行程式碼範例:
npm run build
genkit flow:run menuSuggestionFlow "\"banana\"" -s
選用:啟動開發人員 UI:
genkit start
接著前往 http://localhost:4000/flows,然後使用開發人員 UI 執行流程。
完成後,按下控制台中的 Ctrl+C 鍵即可關閉使用者介面。
試用 Express 端點:
npm run start
然後,在另一個視窗中:
curl -X POST "http://127.0.0.1:3400/menuSuggestionFlow?stream=true" -H "Content-Type: application/json" -d '{"data": "banana"}'
如果一切都如預期運作,您可以將流程部署至所選的供應商。詳細資料會因提供者而異,但一般而言,您需要進行下列設定:
設定 價值 執行時長 Node.js 20 以上版本 建構指令 npm run build
開始指令 npm run start
環境變數 GOOGLE_API_KEY=<your-api-key>
(或任何必要密鑰)