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

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

Trang này làm ví dụ, hướng dẫn bạn từng bước triển khai luồng mẫu mặc định.

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

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

  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 Node.js làm lựa chọn nền tảng triển khai (các mẫu cho Firebase Cloud Functions và Google Cloud Run cũng có sẵn).

    2. 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. Hãy đảm bảo ứng dụng này được cung cấp ở khu vực của bạn.

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

      export GOOGLE_API_KEY=<your API key>

      Gemini (AI Vertex)

      Nếu Google AI Gemini API chưa có ở khu vực của bạn, hãy cân nhắc việc sử dụng Vertex AI API (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ợ tính năng thanh toán, bật API Nền tảng AI 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.

    3. Chọn câu trả lời mặc định cho các câu hỏi còn lại. Thao tác này sẽ khởi động thư mục dự án của bạn bằng 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 đó, hãy chuyển đến http://localhost:4000/flows và chạy luồng này trong 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 mà bạn chọ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 chế độ cài đặt sau:

    Chế độ 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)