สร้างเอเจนต์ฝ่ายสนับสนุนลูกค้าที่ทำงานด้วยระบบ AI โดยใช้ Firebase AI Logic

1. บทนำ

ใน Codelab นี้ คุณจะได้เพิ่มวิดเจ็ตแชทฝ่ายสนับสนุนลูกค้าอัจฉริยะลงในร้านค้าอีคอมเมิร์ซอุปกรณ์สำหรับกิจกรรมกลางแจ้งชื่อ Rugged Terrain Guide คุณจะใช้ Firebase AI Logic เพื่อสร้างเอเจนต์นี้ และจะได้เรียนรู้วิธีกำหนดค่าเทมเพลตพรอมต์ฝั่งเซิร์ฟเวอร์ (product-agent) ที่จัดการลักษณะตัวตนของ AI, กฎงบประมาณค่าชดเชยที่เข้มงวด และใช้แคตตาล็อกผลิตภัณฑ์แบบไดนามิกเป็นบริบท

สิ่งที่คุณต้องดำเนินการมีดังต่อไปนี้

  • ดาวน์โหลดโค้ดเริ่มต้นสำหรับเว็บแอปของโค้ดแล็บนี้
  • ตั้งค่าโปรเจ็กต์ Firebase
  • ตั้งค่าและเริ่มต้นบริการ Firebase (เช่น Firebase AI Logic) ในเว็บแอป
  • กำหนดค่าเทมเพลตพรอมต์ฝั่งเซิร์ฟเวอร์ในคอนโซล Firebase
  • เข้าถึงเทมเพลตจากการเรียกใช้บริการ Generative AI จากฟรอนท์เอนด์ TypeScript ที่คล้าย React

สิ่งที่คุณต้องมี ได้แก่

  • เว็บเบราว์เซอร์ เช่น Chrome
  • มีความคุ้นเคยพื้นฐานกับ TypeScript และ Node.js
  • IDE หรือโปรแกรมแก้ไขข้อความที่คุณเลือก Antigravity เป็นตัวเลือกที่ดี

2. รับโค้ดเริ่มต้น

  1. ในเทอร์มินัล ให้โคลนที่เก็บเริ่มต้น
    git clone https://github.com/GoogleCloudPlatform/devrel-demos.git
    
  2. ไปที่ไดเรกทอรีโค้ดและติดตั้งการอ้างอิง
    cd devrel-demos/codelabs/firebase-server-prompt-templates-codelab
    npm install
    

3. ตั้งค่าโปรเจ็กต์ Firebase

สร้างโปรเจ็กต์ Firebase

  1. ลงชื่อเข้าใช้คอนโซล Firebase โดยใช้บัญชี Google
  2. คลิกปุ่มเพื่อสร้างโปรเจ็กต์ใหม่ แล้วป้อนชื่อโปรเจ็กต์ (เช่น rugged-terrain-ai)
  3. คลิกต่อไป
  4. หากได้รับข้อความแจ้ง ให้อ่านและยอมรับข้อกำหนดของ Firebase แล้วคลิกต่อไป
  5. (ไม่บังคับ) เปิดใช้ความช่วยเหลือจาก AI ในคอนโซล Firebase (เรียกว่า "Gemini ใน Firebase")
  6. สําหรับ Codelab นี้ คุณไม่จําเป็นต้องใช้ Google Analytics ดังนั้นปิดตัวเลือก Google Analytics
  7. คลิกสร้างโปรเจ็กต์ รอให้ระบบจัดสรรโปรเจ็กต์ แล้วคลิกต่อไป

อัปเกรดแพ็กเกจราคา Firebase

หากต้องการใช้บริการ Firebase ใน Codelab นี้ โปรเจ็กต์ Firebase ของคุณต้องอยู่ในแพ็กเกจราคาแบบจ่ายเมื่อใช้ (Blaze) ซึ่งหมายความว่าต้องลิงก์กับบัญชีสำหรับการเรียกเก็บเงินใน Cloud

หากต้องการอัปเกรดโปรเจ็กต์เป็นแพ็กเกจ Blaze ให้ทำตามขั้นตอนต่อไปนี้

  1. ในคอนโซล Firebase ให้เลือกอัปเกรดแพ็กเกจ
  2. เลือกแพ็กเกจ Blaze ทำตามวิธีการบนหน้าจอเพื่อลิงก์บัญชีสำหรับการเรียกเก็บเงินใน Cloud กับโปรเจ็กต์
    • หากคุณใช้เครดิต Google Cloud สำหรับ Codelab นี้ บัญชีสำหรับการเรียกเก็บเงินน่าจะมีชื่อว่า Google Cloud Platform Trial Billing Account หรือ My Billing Account
    • หากคุณต้องสร้างบัญชีสำหรับการเรียกเก็บเงินใน Cloud เป็นส่วนหนึ่งของการอัปเกรดนี้ คุณอาจต้องกลับไปที่ขั้นตอนการอัปเกรดในคอนโซล Firebase เพื่อทำการอัปเกรดให้เสร็จสมบูรณ์

4. ตั้งค่าบริการ Firebase และเชื่อมต่อแอป

สำหรับ Codelab นี้ คุณต้องตั้งค่า Cloud Storage for Firebase และ Firebase AI Logic ในโปรเจ็กต์ Firebase นอกจากนี้ คุณยังต้องเชื่อมต่อซอร์สโค้ดของแอปกับโปรเจ็กต์ Firebase ด้วย

ตั้งค่า Cloud Storage for Firebase

Codelab นี้ใช้ Cloud Storage for Firebase เพื่อจัดเก็บคำอธิบายผลิตภัณฑ์

  1. ในคอนโซล Firebase ให้ไปที่ฐานข้อมูลและพื้นที่เก็บข้อมูล > พื้นที่เก็บข้อมูล
  2. คลิกเริ่มต้นใช้งาน
  3. เลือกตำแหน่งสำหรับ Bucket ของ Storage เริ่มต้น
    Bucket ใน US-WEST1, US-CENTRAL1 และ US-EAST1 จะใช้ประโยชน์จากระดับ"ใช้งานฟรีเสมอ" สำหรับ Google Cloud Storage ได้ Bucket ในสถานที่อื่นๆ ทั้งหมดจะใช้การกำหนดราคาและการใช้งาน Google Cloud Storage
  4. คลิกโหมดที่ใช้งานจริง ในขั้นตอนด้านล่าง คุณจะอัปเดตกฎความปลอดภัยเหล่านี้ให้เจาะจงสำหรับโค้ดแล็บนี้
  5. คลิกสร้าง
  6. อัปเดตกฎความปลอดภัย
    1. หลังจากจัดสรรที่เก็บข้อมูลแล้ว ให้ไปที่แท็บกฎ
    2. คัดลอกแล้ววางกฎต่อไปนี้
      rules_version = '2';
      service firebase.storage {
        match /b/{bucket}/o {
          match /products.txt {
            allow read;
          }
        }
      }
      
    3. คลิกเผยแพร่
  7. อัปโหลดรายละเอียดสินค้าจากโค้ดเริ่มต้น
    1. คลิกแท็บไฟล์สำหรับที่เก็บข้อมูล
    2. คลิกอัปโหลดไฟล์ แล้วอัปโหลดไฟล์ products.txt จากโค้ดเริ่มต้น คุณดูไฟล์นี้ได้ที่ src/data/products.txt

กำหนดค่า Firebase AI Logic

Firebase AI Logic เป็นบริการหลักของ Firebase ที่คุณจะใช้ใน Codelab นี้

  1. ในคอนโซล Firebase ให้ไปที่บริการ AI > ตรรกะ AI
  2. คลิกเริ่มต้นใช้งาน
  3. ในการ์ด Agent Platform Gemini API ให้คลิกเริ่มต้นใช้งาน API นี้ แล้วทำตามวิธีการบนหน้าจอ ขั้นตอนการทำงานนี้จะเปิดใช้ API ที่จำเป็นเพื่อให้คุณใช้ Firebase AI Logic กับ Agent Platform Gemini API ได้
  4. (ไม่บังคับ) เลือกเปิดใช้การตรวจสอบ AI เพื่อให้คุณสังเกตเมตริกและการใช้งานระดับแอปต่างๆ เพื่อให้ทราบภาพรวมที่ครอบคลุมของคำขอผ่าน Firebase AI Logic

เชื่อมต่อโค้ดกับโปรเจ็กต์ Firebase

ในขั้นตอนการตั้งค่า Firebase AI Logic ระบบจะแจ้งให้คุณสร้างเว็บแอป Firebase และเพิ่มการกำหนดค่าลงในซอร์สโค้ด

  1. เมื่อได้รับข้อความแจ้งในขั้นตอนการตั้งค่า Firebase AI Logic ให้คลิกไอคอนเว็บ () เพื่อลงทะเบียนเว็บแอปใหม่
  2. ตั้งชื่อแอป (เช่น Rugged Web)
  3. คัดลอกออบเจ็กต์ firebaseConfig จากวิธีการตั้งค่า

จากนั้นอัปเดตโค้ดเริ่มต้นโดยทำดังนี้

  1. เปิด src/firebase.ts ในตัวแก้ไขโค้ด
  2. แทนที่ firebaseConfig ที่มีอยู่ด้วยรหัสที่คุณคัดลอกจากคอนโซล Firebase

ไฟล์ควรมีลักษณะดังนี้

import { getAI, getTemplateGenerativeModel, AgentPlatformBackend } from "firebase/ai";
import { initializeApp } from "firebase/app";

// Your web app's Firebase configuration
const firebaseConfig = {
    apiKey: "YOUR_API_KEY",
    authDomain: "YOUR_PROJECT_ID.firebaseapp.com",
    projectId: "YOUR_PROJECT_ID",
    storageBucket: "YOUR_PROJECT_ID.firebasestorage.app",
    messagingSenderId: "YOUR_MESSAGING_SENDER_ID",
    appId: "YOUR_APP_ID"
};

// Initialize Firebase
export const app = initializeApp(firebaseConfig);

const ai = getAI(app, { backend: new AgentPlatformBackend() });

5. สร้างเทมเพลตพรอมต์ฝั่งเซิร์ฟเวอร์

แทนที่จะเขียนพรอมต์ AI ที่ซับซ้อนลงในแอปไคลเอ็นต์ คุณจะใช้ไวยากรณ์ Dotprompt เพื่อจัดการวิธีการอย่างปลอดภัยในเซิร์ฟเวอร์

ซึ่งจะป้องกันไม่ให้ผู้ใช้ปลายทางเห็นกฎ "งบประมาณค่าชดเชย" ที่เป็นความลับ

  1. ในคอนโซล Firebase ให้ไปที่บริการ AI > ตรรกะ AI > แท็บเทมเพลตพรอมต์
  2. คลิกสร้างเทมเพลต แล้วเลือกเทมเพลตเปล่า
  3. ตั้งชื่อเทมเพลตเป็น Product Agent และรหัสเป็น product-agent
  4. ตั้งค่าโมเดลเป็น gemini-3.1-flash-lite (หรือเวอร์ชันล่าสุดที่พร้อมใช้งาน)
  5. จากโค้ดเริ่มต้นที่ให้ไว้สำหรับ Codelab นี้ ให้คัดลอกเนื้อหาของ product-agent.prompt (ค้นหาไฟล์นี้ในไดเรกทอรีราก) จากนั้นวางเนื้อหานี้ลงในช่องพรอมต์และคำสั่งของระบบ (ไม่บังคับ) ของเทมเพลตพรอมต์ของเซิร์ฟเวอร์ในคอนโซล Firebase เนื้อหานี้จะสั่งให้โมเดลทำงานในฐานะ "ผู้ปฏิบัติงานที่สมบุกสมบัน" และอ้างอิงแคตตาล็อกผลิตภัณฑ์อย่างปลอดภัย
  6. ในช่องอินพุตทดสอบ ให้กำหนดสคีมาอินพุตตามที่ระบุไว้ดังนี้
    {
      "type": "object",
      "required": [
        "query"
      ],
      "properties": {
        "query": {
          "type": "string",
          "description": "the customers ask of the robot"
        },
        "productId": {
          "type": "string",
          "description": "the product the customer is looking at right now"
        },
        "history": {
          "type": "array",
          "description": "list of previous history between the user and system",
          "items": {
            "type": "object",
            "required": [
              "role",
              "contents"
            ],
            "properties": {
              "role": {
                "type": "string"
              },
              "contents": {
                "type": "string"
              }
            }
          }
        }
      }
    }
    
  7. คลิกบันทึกเทมเพลตเพื่อบันทึกและเผยแพร่เทมเพลต product-agent

6. เรียกใช้โมเดล AI

เมื่อกำหนดเทมเพลตอย่างปลอดภัยในเซิร์ฟเวอร์แล้ว คุณก็เพียงแค่เรียกใช้จากส่วนหน้าของแอป

  1. ในตัวแก้ไขโค้ด ให้กลับไปที่ src/firebase.ts
  2. ใช้ getTemplateGenerativeModel เพื่อเชื่อมต่อกับเทมเพลตด้านล่างการเริ่มต้น
    const model = getTemplateGenerativeModel(ai);
    
    export const callCustomerSupportModel = async (query: string, productId?: string, history?: { role: string, contents: string }[]) => {
        // Generate content using the published 'product-agent' template
        const result = await model.generateContent('product-agent', {
            query,
            productId,
            history,
        });
        return result.response.text();
    }
    

7. รักษาความปลอดภัยให้กับเอเจนต์ด้วย Firebase App Check

โมเดล AI มีประสิทธิภาพ แต่ก็อาจถูกละเมิดได้เช่นกันหากปล่อยให้ปลายทางสาธารณะไม่มีการป้องกัน คุณควรใช้ Firebase App Check เสมอเพื่อให้แน่ใจว่ามีเพียงเว็บแอปจริงของคุณเท่านั้นที่สามารถส่งคำขอไปยัง Gemini API ได้สำเร็จ ซึ่งจะบล็อกบ็อตและไคลเอ็นต์ที่ไม่ได้รับอนุญาต

  1. ในคอนโซล Google Cloud ให้ไปที่ความปลอดภัย > การป้องกันการประพฤติมิชอบ
  2. คลิกสร้างคีย์ แล้วกรอกข้อมูลในช่องต่อไปนี้
    • ชื่อที่แสดง: Codelab Key
    • ประเภทแอปพลิเคชัน: เว็บ
    • รายการโดเมน: เพิ่ม localhost และ 127.0.0.1 เพื่อให้เซิร์ฟเวอร์ Vite ในเครื่องได้รับอนุญาตให้ส่งคำขอ
  3. คลิกสร้างคีย์เพื่อลงทะเบียนคีย์
  4. คัดลอกรหัสคีย์ของเว็บไซต์ไปยังคลิปบอร์ดจากด้านบนของหน้ารายละเอียดคีย์การป้องกันการประพฤติมิชอบ
  5. ในคอนโซล Firebase ให้ไปที่ความปลอดภัย > การตรวจสอบแอป
  6. คลิกแท็บแอป ขยายเว็บแอป (Rugged Web) แล้วคลิกผู้ให้บริการ reCAPTCHA Enterprise
  7. ในช่องคีย์เว็บไซต์ reCAPTCHA Enterprise ให้วางรหัสคีย์เว็บไซต์จากหน้ารายละเอียดคีย์ Fraud Defense แล้วคลิกบันทึก
  8. เปิด src/firebase.ts อีกครั้งในเครื่องมือแก้ไขโค้ด
  9. เพิ่มการนำเข้าต่อไปนี้ที่ด้านบน
    import { initializeAppCheck, ReCaptchaEnterpriseProvider } from "firebase/app-check";
    
  10. เพิ่มการเริ่มต้น App Check ทันทีหลังจากเรียกใช้ initializeApp(firebaseConfig) และวางรหัสคีย์ของเว็บไซต์ที่คุณคัดลอกไว้
    // Initialize App Check
    const appCheck = initializeAppCheck(app, {
      provider: new ReCaptchaEnterpriseProvider('YOUR_RECAPTCHA_ENTERPRISE_SITE_KEY'),
      isTokenAutoRefreshEnabled: true
    });
    
  11. อัปเดตการเรียกใช้ฟังก์ชัน getAI() เพื่อใช้โทเค็นเหล่านี้ ทำการเปลี่ยนแปลงต่อไปนี้
    const ai = getAI(app, { backend: new AgentPlatformBackend(), useLimitedUseAppCheckTokens: true });
    
    การตั้งค่า useLimitedUseAppCheckTokens เป็น true จะช่วยให้มั่นใจได้ว่าระบบจะใช้โทเค็นที่มีอายุสั้นเพื่อช่วยจำกัดการละเมิดที่แบ็กเอนด์อาจได้รับ

8. เรียกใช้แอป

เมื่อกำหนดค่า Firebase และเชื่อมต่อวิดเจ็ตแชทสนับสนุนแล้ว ก็ถึงเวลาเรียกใช้แอป

  1. ในเทอร์มินัล ให้เรียกใช้เซิร์ฟเวอร์การพัฒนา Vite ดังนี้
    npm run dev
    
  2. เปิด URL ในเครื่องที่ระบุ (โดยปกติคือ http://localhost:5173/)
  3. คลิกปุ่มการทำงานแบบลอย (FAB) การสนับสนุนทางยุทธวิธีที่มุมขวาล่าง
  4. ลองถามคำถามเกี่ยวกับผลิตภัณฑ์ เช่น
    • "ฉันกำลังมองหาเสื้อเชลล์กันลมกันฝน"
    • "หมวกไหมพรมที่อุณหภูมิต่ำกว่าศูนย์ของฉันมีข้อบกพร่อง ฉันควรทำอย่างไร"
    • พยายามต่อรองต่อไปเพื่อกระตุ้นตรรกะ "งบประมาณชดเชย" ของ AI

9. (ไม่บังคับ) ล้างข้อมูลทรัพยากรจาก Codelab

หากไม่ต้องการให้มีการเรียกเก็บเงินจากบัญชีสำหรับการเรียกเก็บเงินใน Cloud คุณสามารถลบทรัพยากรที่สร้างขึ้นระหว่าง Codelab นี้ได้

  1. ในคอนโซล Firebase ให้ไปที่การตั้งค่า > แท็บทั่วไป
  2. ตรวจสอบว่าโปรเจ็กต์ที่คุณกำลังดูคือโปรเจ็กต์ที่คุณใช้สำหรับ Codelab นี้ หากไม่ใช่โปรเจ็กต์ของโค้ดแล็บ คุณสามารถใช้เมนูแบบเลื่อนลงของเครื่องมือเลือกโปรเจ็กต์ที่มุมซ้ายบนเพื่อเปลี่ยนโปรเจ็กต์ได้
  3. ไปที่ด้านล่างของหน้า แล้วคลิกลบโปรเจ็กต์
  4. ทำตามวิธีการบนหน้าจอเพื่อยืนยันการลบ

10. ยินดีด้วย

🎊 ภารกิจสำเร็จ! คุณผสานรวมเอเจนต์ฝ่ายสนับสนุนลูกค้า AI ที่มีประสิทธิภาพและขับเคลื่อนด้วยเทมเพลตเรียบร้อยแล้ว

สิ่งที่คุณทำสำเร็จ

  • เริ่มต้น Firebase และแบ็กเอนด์แพลตฟอร์มตัวแทนในแอปไคลเอ็นต์
  • กำหนดค่าเทมเพลตพรอมต์ฝั่งเซิร์ฟเวอร์ที่ปลอดภัยโดยใช้ Handlebars และสคีมาอินพุตที่เข้มงวดเพื่อกำหนดลักษณะการทำงานที่ซับซ้อนของเอเจนต์
  • เรียกใช้ LLM แบบไดนามิกอย่างปลอดภัยโดยส่งประวัติการแชทและรหัสผลิตภัณฑ์ตามบริบทโดยไม่ต้องเปิดเผยตรรกะพรอมต์ภายในต่อไคลเอ็นต์

ต้องทำอะไรต่อ

  • Firebase App Check: รักษาความปลอดภัยของปลายทาง AI จากการละเมิด