Akışları tüm Node.js platformlarına dağıtma

Firebase Genkit, akışlarınızı Firebase Cloud Functions ve Google Cloud Run'a dağıtmanıza yardımcı olan yerleşik entegrasyonlara sahiptir. Bununla birlikte, akışlarınızı ister bulut hizmeti ister kendi kendine barındırılan bir Express.js uygulaması sunabilen tüm platformlara dağıtabilirsiniz.

Örnek olarak bu sayfa, varsayılan örnek akışını dağıtma sürecinde size yol gösterir.

  1. Gerekli araçları yükleyin:

    • Düğüm sürümü 20 veya sonraki bir sürümü kullandığınızdan emin olun (kontrol etmek için node --version komutunu çalıştırın).

  2. Genkit örnek projesi için bir dizin oluşturun:

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

    IDE (Entegre Geliştirme Ortamı) kullanacaksanız IDE'yi bu dizinde açın.

  3. Bir Nodejs projesini başlatın:

    npm init -y

  4. Genkit projesini başlatma:

    genkit init

    1. Dağıtım platformu seçeneği olarak Node.js'i seçin (Firebase Cloud Functions ve Google Cloud Run için de şablonlar da kullanılabilir).

    2. Modelinizi seçin:

      Gemini (Google Yapay Zeka)

      Google AI Gemini API'yi kullanmaya başlamanın en basit yolu budur. Bölgenizde kullanıma sunulduğundan emin olun.

      Google AI Studio'yu kullanarak Gemini API için API anahtarı oluşturun. Ardından GOOGLE_API_KEY ortam değişkenini anahtarınıza ayarlayın:

      export GOOGLE_API_KEY=<your API key>

      Gemini (Vertex AI)

      Google AI Gemini API bölgenizde kullanılamıyorsa Gemini ve diğer modelleri de sunan Vertex AI API'yi kullanabilirsiniz. Faturalandırmanın etkin olduğu bir Google Cloud projeniz olması, AI Platform API'yi etkinleştirmeniz ve bazı ek ortam değişkenlerini ayarlamanız gerekir:

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

      Vertex AI fiyatlandırması için https://cloud.google.com/vertex-ai/generative-ai/pricing adresini ziyaret edin.

    3. Geri kalan sorular için varsayılan yanıtları seçin. Bu işlem, proje klasörünüzü bir miktar örnek kodla başlatır.

  5. Örnek kodu derleyin ve çalıştırın:

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

  6. İsteğe bağlı: Geliştirici kullanıcı arayüzünü başlatın:

    genkit start

    Ardından http://localhost:4000/flows adresine gidin ve geliştirici arayüzünü kullanarak akışı çalıştırın.

    İşiniz bittiğinde kullanıcı arayüzünden çıkmak için konsolda Ctrl+C tuşlarına basın.

  7. Express uç noktasını deneyin:

    npm run start

    Ardından, başka bir pencerede:

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

  8. Her şey beklendiği gibi çalışıyorsa akışı istediğiniz sağlayıcıya dağıtabilirsiniz. Ayrıntılar sağlayıcıya bağlıdır ancak genellikle aşağıdaki ayarları yapılandırmanız gerekir:

    Ayar Değer
    Çalışma zamanı Node.js 20 veya daha yenisi
    Derleme komutu npm run build
    Komutu başlat npm run start
    Ortam değişkenleri GOOGLE_API_KEY=<your-api-key> (veya gerekli olan gizli anahtarlar)