Triển khai luồng cho bất kỳ nền tảng Node.js nào

Firebase Genkit có các công cụ tích hợp sẵn giúp bạn triển khai quy trình của mình đến Cloud Functions cho Firebase và Google Cloud Run, nhưng bạn cũng có thể triển khai chuyển sang bất kỳ nền tảng nào có thể phân phát ứng dụng Express.js, cho dù đó là đám mây hoặc tự lưu trữ.

Trang này làm ví dụ, hướng dẫn bạn qua quy trình triển khai luồng mẫu.

  1. Cài đặt các công cụ cần thiết:

    • Đảm bảo bạn đang sử dụng nút phiên bản 20 trở lên (chạy node --version để ).

  2. Tạo thư mục cho dự án mẫu Genkit:

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

    Nếu bạn định dùng một IDE, hãy mở IDE vào thư mục này.

  3. Khởi chạy dự ánNodejs:

    npm init -y

  4. Khởi chạy dự án Genkit:

    genkit init

    1. Chọn mô hình của bạn:

      Gemini (AI của Google)

      Cách đơn giản nhất để bắt đầu là sử dụng Gemini API của Google AI. Đảm bảo đó là hoạt động ở khu vực của bạn.

      Tạo khoá API cho Gemini API thông qua Google AI Studio. Sau đó, đặt giá trị GOOGLE_API_KEY biến môi trường vào khoá của bạn:

      export GOOGLE_API_KEY=<your API key>

      Gemini (AI Vertex)

      Nếu Gemini API của Google AI không có ở khu vực của bạn, hãy cân nhắc dùng Vertex AI API, vốn cũng cung cấp Gemini và các mô hình khác. Bạn sẽ cần có một dự án Google Cloud có hỗ trợ thanh toán, bật AI API Nền tảng và đặt một số biến môi trường bổ sung:

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

      Xem tại https://cloud.google.com/vertex-ai/generative-ai/pricing để biết giá của Vertex AI.

    2. Chọn câu trả lời mặc định cho các câu hỏi còn lại. Điều này sẽ khởi chạy thư mục dự án của bạn với một số mã mẫu.

  5. Tạo và chạy mã mẫu:

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

  6. Không bắt buộc: Khởi động giao diện người dùng dành cho nhà phát triển:

    genkit start

    Sau đó, truy cập http://localhost:4000/flows rồi chạy quy trình này bằng giao diện người dùng dành cho nhà phát triển.

    Khi bạn hoàn tất, nhấn Ctrl+C trong bảng điều khiển để thoát khỏi giao diện người dùng.

  7. Dùng thử điểm cuối Express:

    npm run start

    Sau đó, trong một cửa sổ khác:

    curl -X POST "http://127.0.0.1:3400/menuSuggestionFlow?stream=true" -H "Content-Type: application/json"  -d '{"data": "banana"}'

  8. Nếu mọi thứ hoạt động như mong đợi, bạn có thể triển khai luồng cho nhà cung cấp theo lựa chọn của bạn. Thông tin chi tiết sẽ phụ thuộc vào nhà cung cấp, nhưng nhìn chung, bạn cần để định cấu hình các cài đặt sau:

    Cài đặt Giá trị
    Thời gian chạy Node.js 20 trở lên
    Tạo lệnh npm run build
    Lệnh bắt đầu npm run start
    Biến môi trường GOOGLE_API_KEY=<your-api-key> (hoặc bất kỳ khoá bí mật nào được yêu cầu)