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

Firebase Genkit มีการผสานรวมในตัวที่ช่วยให้คุณทำให้ขั้นตอนใช้งานได้กับ Firebase Cloud Functions และ 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> (หรือข้อมูลลับใดก็ตามที่จำเป็น)