Wdrażanie przepływów na dowolnej platformie Node.js

Firebase Genkit ma wbudowane integracje, które ułatwiają wdrażanie przepływów w Firebase Cloud Functions i Google Cloud Run, ale możesz je też wdrażać na dowolnej platformie, która może obsługiwać aplikację Express.js – zarówno w chmurze, jak i lokalnie.

Ta strona przeprowadzi Cię przez proces wdrażania domyślnego przykładowego przepływu.

  1. Zainstaluj wymagane narzędzia:

    • Sprawdź, czy używasz węzła w wersji 20 lub nowszej (aby to sprawdzić, uruchom polecenie node --version).

  2. Utwórz katalog dla przykładowego projektu Genkit:

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

    Jeśli będziesz używać IDE, otwórz je w tym katalogu.

  3. Zainicjuj projekt nodejs:

    npm init -y

  4. Zainicjuj projekt Genkit:

    genkit init

    1. Wybierz Node.js jako opcję platformy wdrożenia (dostępne są również szablony dla Firebase Cloud Functions i Google Cloud Run).

    2. Wybierz model:

      Gemini (AI od Google)

      Najprostszym sposobem na rozpoczęcie jest korzystanie z interfejsu Google AI Gemini API. Upewnij się, że jest ona dostępna w Twoim regionie.

      Wygeneruj klucz interfejsu API dla interfejsu API Gemini za pomocą Google AI Studio. Następnie ustaw zmienną środowiskową GOOGLE_API_KEY na swój klucz:

      export GOOGLE_API_KEY=<your API key>

      Gemini (Vertex AI)

      Jeśli interfejs Google AI Gemini API nie jest dostępny w Twoim regionie, rozważ skorzystanie z interfejsu Vertex AI API, który oferuje również Gemini i inne modele. Musisz mieć projekt Google Cloud obsługujący płatności, włączyć interfejs AI Platform API i ustawić dodatkowe zmienne środowiskowe:

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

      Sprawdź cennik Vertex AI na stronie https://cloud.google.com/vertex-ai/generative-ai/pricing.

    3. Wybierz domyślne odpowiedzi na pozostałe pytania. Spowoduje to zainicjowanie folderu projektu z przykładowym kodem.

  5. Skompiluj i uruchom przykładowy kod:

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

  6. Opcjonalnie: uruchom interfejs programisty:

    genkit start

    Następnie przejdź na stronę http://localhost:4000/flows i uruchom proces za pomocą interfejsu użytkownika dla programistów.

    Kiedy skończysz, naciśnij Ctrl+C w konsoli, aby zamknąć interfejs.

  7. Wypróbuj punkt końcowy usługi Express:

    npm run start

    Następnie w innym oknie:

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

  8. Jeśli wszystko działa zgodnie z oczekiwaniami, możesz wdrożyć proces u wybranego dostawcy. Szczegóły będą zależeć od dostawcy, ale zasadniczo musisz skonfigurować te ustawienia:

    Ustawienie Wartość
    Środowisko wykonawcze Node.js w wersji 20 lub nowszej
    Polecenie kompilacji npm run build
    Uruchom polecenie npm run start
    Zmienne środowiskowe GOOGLE_API_KEY=<your-api-key> (lub dowolne obiekty tajne są wymagane)