ทำให้โฟลว์ใช้งานได้ในแพลตฟอร์ม Node.js

Firebase Genkit มีการผสานรวมในตัวที่ช่วยให้คุณทำให้ขั้นตอนใช้งานได้กับ Cloud Functions for Firebase และ Google Cloud Run แต่คุณก็ทำให้ ส่งไปยังแพลตฟอร์มที่แสดงแอป Express.js ได้ ไม่ว่าจะเป็นระบบคลาวด์ บริการหรือโฮสต์ด้วยตนเอง

หน้านี้เป็นตัวอย่างที่จะแนะนำคุณตลอดขั้นตอนการทำให้ค่าเริ่มต้นใช้งานได้ ขั้นตอนการใช้งานตัวอย่าง

  1. ติดตั้งเครื่องมือที่จำเป็น

    • ตรวจสอบว่าคุณใช้โหนดเวอร์ชัน 20 ขึ้นไป (เรียกใช้ node --version เพื่อ )

  2. สร้างไดเรกทอรีสำหรับโปรเจ็กต์ตัวอย่าง Genkit ดังนี้

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

    หากคุณจะใช้ IDE ให้เปิดในไดเรกทอรีนี้

  3. เริ่มต้นโปรเจ็กต์ Nodejs

    npm init -y

  4. เริ่มต้นโปรเจ็กต์ Genkit โดยทำดังนี้

    genkit init

    1. เลือกรุ่นของคุณ:

      Gemini (AI ของ Google)

      วิธีที่ง่ายที่สุดในการเริ่มต้นใช้งานคือการใช้ Google AI Gemini API ตรวจสอบว่า คือ พร้อมให้บริการในภูมิภาคของคุณ

      สร้างคีย์ API สำหรับ Gemini API ที่ใช้ Google AI Studio จากนั้นตั้งค่า GOOGLE_API_KEY ตัวแปรสภาพแวดล้อมไปยังคีย์ของคุณ:

      export GOOGLE_API_KEY=<your API key>

      Gemini (Vertex AI)

      หาก Google AI Gemini API ไม่พร้อมให้บริการในภูมิภาคของคุณ โดยใช้ Vertex AI API ซึ่งให้บริการ Gemini และโมเดลอื่นๆ ด้วย คุณ ต้องมีโปรเจ็กต์ Google Cloud ที่เปิดใช้การเรียกเก็บเงิน, ให้เปิดใช้ AI API ของแพลตฟอร์ม และตั้งค่าตัวแปรสภาพแวดล้อมเพิ่มเติมดังนี้

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

      ดูราคาของ Vertex AI ได้ที่ https://cloud.google.com/vertex-ai/generative-ai/pricing

    2. เลือกคำตอบเริ่มต้นสำหรับคำถามที่เหลือ ซึ่งจะ เริ่มต้นโฟลเดอร์โปรเจ็กต์ด้วยโค้ดตัวอย่าง

  5. สร้างและเรียกใช้โค้ดตัวอย่างดังนี้

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

  6. ไม่บังคับ: เริ่ม UI นักพัฒนาซอฟต์แวร์โดยทำดังนี้

    genkit start

    จากนั้นไปที่ http://localhost:4000/flows แล้วเรียกใช้ ขั้นตอนโดยใช้ UI ของนักพัฒนาซอฟต์แวร์

    เมื่อเสร็จแล้ว ให้กด Ctrl+C ในคอนโซลเพื่อปิด UI

  7. ลองใช้ปลายทาง Express โดยทำดังนี้

    npm run start

    จากนั้นในหน้าต่างอื่น ให้ทำดังนี้

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

  8. หากทุกอย่างทำงานตามที่คาดไว้ คุณสามารถทำให้โฟลว์ใช้งานได้กับผู้ให้บริการ ตามที่คุณต้องการ รายละเอียดจะขึ้นอยู่กับผู้ให้บริการ แต่โดยทั่วไปคุณต้องมี เพื่อกำหนดการตั้งค่าต่อไปนี้

    การตั้งค่า ค่า
    รันไทม์ Node.js 20 ขึ้นไป
    คำสั่งบิลด์ npm run build
    คำสั่งเริ่มต้น npm run start
    ตัวแปรสภาพแวดล้อม GOOGLE_API_KEY=<your-api-key> (หรือข้อมูลลับใดก็ตามที่จำเป็น)