Firebase Genkit akışlarını Cloud Run'ı kullanarak web hizmetleri olarak dağıtabilirsiniz. Bu sayfada, örnek olarak, varsayılan örneği dağıtma sürecinde size yol gösterir akışı sağlar.
Gerekli araçları yükleyin:
Node.js sürüm 20 veya üstünü kullandığınızdan emin olun (
node --version
kontrol edin).Şunu yükleyin: Google Cloud KSA.
Yeni bir Google Cloud projesi oluşturmak için Cloud console'u veya mevcut bir konsolu seçin. Proje bir faturalandırma hesabına bağlı olmalıdır.
Bir proje oluşturduktan veya seçtikten sonra, kullanılacak projeyi şunları sağlar:
gcloud init
Genkit örnek projesi için bir dizin oluşturun:
mkdir -p ~/tmp/genkit-cloud-project
cd ~/tmp/genkit-cloud-project
IDE kullanacaksanız IDE'yi bu dizinde açın.
Proje dizininizde bir Node.js projesini başlatın:
npm init -y
Node.js projenizde Genkit'i başlatın:
genkit init
Kullanmak istediğiniz model sağlayıcıyı seçin. için varsayılanları kabul edin kontrol edin.
genkit
aracı bazı örnek kaynak dosyalar oluşturur kendi yapay zeka akışlarınızı geliştirmeye başlamanıza yardımcı olur. Bu programın ancak örnek akışı dağıtmanız yeterlidir.API kimlik bilgilerini dağıtılan işleviniz için kullanılabilir hale getirin. Aşağıdakilerden birini yapın: seçtiğiniz model sağlayıcıya bağlı olarak aşağıdaki adımları uygulayın:
Gemini (Google Yapay Zeka)
Google Yapay Zeka'nın bölgenizde kullanılabilir.
Şu öğe için bir API anahtarı oluşturun: Gemini API, Google AI Studio'yu kullanıyor.
API anahtarını Cloud Run ortamında kullanın:
- Cloud Console'da Secret Manager API.
- Secret Manager sayfasında, API anahtarınızı içeren yeni bir gizli anahtar oluşturun.
- Gizli anahtarı oluşturduktan sonra aynı sayfada varsayılan anahtarınızı verin hizmet hesabının gizli anahtara erişebilmesini sağlamak için Secret Manager Gizli Anahtar Erişen rolü. (İlgili kişinin adını varsayılan Compute hizmet hesabı olduğunu unutmayın.)
Daha sonraki bir adımda, hizmetinizi dağıttığınızda bu gizli anahtarın adına referans vermelidir.
İsteğe bağlı: Akışınızı aşağıdaki gibi yerel olarak çalıştırmak istiyorsanız:
GOOGLE_GENAI_API_KEY
ortam değişkenini anahtarınıza ayarlayın:export GOOGLE_GENAI_API_KEY=<your API key>
Gemini (Vertex AI)
Cloud Console'da Vertex AI API'yi etkinleştirme belirleneceğini konuşacağız.
IAM'de sayfasında, Varsayılan Compute hizmet hesabına Vertex AI Kullanıcısı rolüne sahip olmanız gerekir.
İsteğe bağlı: Akışınızı aşağıdaki gibi yerel olarak çalıştırmak istiyorsanız: adımında, bazı ek ortam değişkenleri ayarlayın ve kurulum için
gcloud
aracı uygulama varsayılan kimlik bilgileri:export GCLOUD_PROJECT=<your project ID>
export GCLOUD_LOCATION=us-central1
gcloud auth application-default login
Bu eğitim için ayarlamanız gereken tek sır model içindir ancak genel olarak her hizmet için benzer bir işlem yapmanız gerekir. size yardımcı olur.
İsteğe bağlı: Geliştirici kullanıcı arayüzündeki adımlarınızı deneyin:
Kullanıcı arayüzünü başlatın:
genkit start
Geliştiricinin kullanıcı arayüzünde (http://localhost:4000/) akışı çalıştırın:
menuSuggestionFlow'u tıklayın.
Input JSON sekmesinde model için bir konu sağlayın:
"banana"
Çalıştır'ı tıklayın.
Şimdiye kadar her şey beklendiği gibi çalışıyorsa bir komut dosyası oluşturup akış:
Gemini (Google Yapay Zeka)
npm run build
gcloud run deploy --update-secrets=GOOGLE_GENAI_API_KEY=<your-secret-name>:latest
Gemini (Vertex AI)
npm run build
gcloud run deploy
Kimliği doğrulanmayan çağrılara izin vermek isteyip istemediğiniz sorulduğunda
N
seçeneğini belirleyin.N
yanıtını verdiğinizde, hizmetiniz IAM kimlik bilgilerini gerekli kılacak şekilde yapılandırılır. Görüntüleyin Kimlik Doğrulama inceleyin.
Dağıtım tamamlandıktan sonra araç, hizmet URL'sini yazdırır. Web sitemiz g.co/newsinitiative/labs
üzerinden
curl
ile birlikte:
curl -X POST https://<service-url>/menuSuggestionFlow \
-H "Authorization: Bearer $(gcloud auth print-identity-token)" \
-H "Content-Type: application/json" -d '{"data": "banana"}'