Firebase AI Logic का इस्तेमाल करके, एआई की मदद से काम करने वाला ग्राहक सहायता एजेंट बनाना

1. शुरुआती जानकारी

इस कोडलैब में, आपको रग्ड टेरेन गाइड नाम की आउटडोर गियर ई-कॉमर्स शॉप में, स्मार्ट ग्राहक सहायता चैट विजेट जोड़ने का तरीका बताया जाएगा. इस एजेंट को बनाने के लिए, Firebase AI Logic का इस्तेमाल किया जाएगा. साथ ही, आपको सर्वर-साइड प्रॉम्प्ट टेंप्लेट (product-agent) को कॉन्फ़िगर करने का तरीका बताया जाएगा. यह टेंप्लेट, एआई के पर्सोना और बजट के रियायती नियमों को मैनेज करता है. साथ ही, प्रॉडक्ट कैटलॉग को कॉन्टेक्स्ट के तौर पर डाइनैमिक तरीके से इस्तेमाल करता है.

आपको क्या करना होगा:

  • इस कोडलैब के वेब ऐप्लिकेशन के लिए, स्टार्टर कोड पाएं.
  • Firebase प्रोजेक्ट सेट अप करें.
  • वेब ऐप्लिकेशन में Firebase की सेवाओं (जैसे, Firebase AI Logic) को सेट अप और शुरू करना.
  • Firebase कंसोल में, सर्वर-साइड प्रॉम्प्ट टेंप्लेट कॉन्फ़िगर करें.
  • React जैसे TypeScript फ़्रंटएंड से जनरेटिव एआई सेवा को किए गए कॉल से टेंप्लेट को ऐक्सेस करें.

आपको क्या चाहिए:

  • कोई वेब ब्राउज़र, जैसे कि Chrome.
  • TypeScript और Node.js की बुनियादी जानकारी.
  • आपकी पसंद का आईडीई या टेक्स्ट एडिटर. ऐंटीग्रैविटी एक अच्छा विकल्प है.

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. अपने Google खाते का इस्तेमाल करके, Firebase कंसोल में साइन इन करें.
  2. नया प्रोजेक्ट बनाने के लिए, बटन पर क्लिक करें. इसके बाद, प्रोजेक्ट का नाम डालें. उदाहरण के लिए, rugged-terrain-ai.
  3. जारी रखें पर क्लिक करें.
  4. अगर कहा जाए, तो Firebase की शर्तें पढ़ें और स्वीकार करें. इसके बाद, जारी रखें पर क्लिक करें.
  5. (ज़रूरी नहीं) Firebase कंसोल में एआई की मदद पाने की सुविधा चालू करें. इसे "Firebase में Gemini" कहा जाता है.
  6. इस कोडलैब के लिए, आपको Google Analytics की ज़रूरत नहीं है. इसलिए, Google Analytics के विकल्प को टॉगल करके बंद करें.
  7. प्रोजेक्ट बनाएं पर क्लिक करें. इसके बाद, प्रोजेक्ट के प्रोविज़न होने का इंतज़ार करें. इसके बाद, जारी रखें पर क्लिक करें.

Firebase का बिलिंग प्लान अपग्रेड करना

इस कोडलैब में Firebase सेवाओं का इस्तेमाल करने के लिए, आपका Firebase प्रोजेक्ट इस्तेमाल के हिसाब से शुल्क चुकाने वाले (Blaze) प्लान पर होना चाहिए. इसका मतलब है कि यह Cloud बिलिंग खाते से लिंक होना चाहिए.

  • Cloud Billing खाते के लिए, पेमेंट का कोई तरीका जोड़ना ज़रूरी है. जैसे, क्रेडिट कार्ड.
  • खास प्रमोशन के दौरान या किसी इवेंट के हिस्से के तौर पर इस कोडलैब को करने पर, Google Cloud क्रेडिट उपलब्ध हो सकते हैं.
  • अगर आपने हाल ही में Firebase और Google Cloud का इस्तेमाल शुरू किया है, तो देखें कि आपको 300 डॉलर का क्रेडिट और मुफ़्त में आज़माने के लिए Cloud Billing खाता मिल सकता है या नहीं.

अपने प्रोजेक्ट को Blaze प्लान पर अपग्रेड करने के लिए, यह तरीका अपनाएं:

  1. Firebase कंसोल में जाकर, अपने प्लान को अपग्रेड करें को चुनें.
  2. Blaze प्लान चुनें. अपने प्रोजेक्ट से Cloud Billing खाता लिंक करने के लिए, स्क्रीन पर दिए गए निर्देशों का पालन करें.
    • अगर इस कोडलैब के लिए Google Cloud क्रेडिट का इस्तेमाल किया जा रहा है, तो बिलिंग खाते का नाम Google Cloud Platform Trial Billing Account या My Billing Account हो सकता है.
    • अगर आपको इस अपग्रेड के दौरान Cloud Billing खाता बनाना पड़ा है, तो अपग्रेड पूरा करने के लिए, आपको Firebase कंसोल में अपग्रेड करने की प्रोसेस पर वापस जाना पड़ सकता है.

4. Firebase की सेवाएं सेट अप करना और अपने ऐप्लिकेशन को कनेक्ट करना

इस कोडलैब के लिए, आपको अपने Firebase प्रोजेक्ट में Cloud Storage for Firebase और Firebase AI Logic सेट अप करना होगा. आपको अपने ऐप्लिकेशन के सोर्स कोड को Firebase प्रोजेक्ट से भी कनेक्ट करना होगा.

Firebase के लिए Cloud Storage सेट अप करना

इस कोडलैब में, Cloud Storage for Firebase का इस्तेमाल करके, प्रॉडक्ट के ब्यौरे सेव किए जाते हैं.

  1. Firebase कंसोल में, डेटाबेस और स्टोरेज > Storage पर जाएं.
  2. शुरू करें पर क्लिक करें.
  3. अपने डिफ़ॉल्ट स्टोरेज बकेट के लिए कोई जगह चुनें.
    US-WEST1, US-CENTRAL1, और US-EAST1 में मौजूद बकेट, Google Cloud Storage के लिए "हमेशा के लिए मुफ़्त" टियर का फ़ायदा ले सकते हैं. अन्य सभी जगहों पर मौजूद बकेट के लिए, 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 की मुख्य सेवा है. इस कोडलैब में इसका इस्तेमाल किया जाएगा.

  1. Firebase कंसोल में, एआई सेवाएं > एआई लॉजिक पर जाएं.
  2. शुरू करें पर क्लिक करें.
  3. Agent Platform Gemini API कार्ड पर, इस एपीआई का इस्तेमाल शुरू करें पर क्लिक करें. इसके बाद, स्क्रीन पर दिए गए निर्देशों का पालन करें. इस फ़्लो से, ज़रूरी एपीआई चालू हो जाएंगे. इनकी मदद से, Agent Platform Gemini API के साथ Firebase AI Logic का इस्तेमाल किया जा सकेगा.
  4. (ज़रूरी नहीं) एआई मॉनिटरिंग की सुविधा चालू करें, ताकि आपको ऐप्लिकेशन लेवल की अलग-अलग मेट्रिक और इस्तेमाल के बारे में जानकारी मिल सके. इससे, 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. सर्वर-साइड प्रॉम्प्ट टेंप्लेट बनाना

क्लाइंट ऐप्लिकेशन में मुश्किल एआई प्रॉम्प्ट को हार्डकोड करने के बजाय, सर्वर पर निर्देशों को सुरक्षित तरीके से मैनेज करने के लिए, Dotprompt सिंटैक्स का इस्तेमाल किया जाएगा.

इससे, असली उपयोगकर्ताओं को "Appeasement Budget" के सीक्रेट नियम नहीं दिखते.

  1. Firebase कंसोल में, एआई सेवाएं > एआई लॉजिक > प्रॉम्प्ट टेंप्लेट टैब पर जाएं.
  2. टेंप्लेट बनाएं पर क्लिक करें और ब्लैंक टेंप्लेट चुनें.
  3. टेंप्लेट का नाम Product Agent और आईडी product-agent पर सेट करें.
  4. मॉडल को gemini-3.1-flash-lite (या उपलब्ध सबसे नए वर्शन) पर सेट करें.
  5. इस कोडलैब के लिए दिए गए स्टार्टर कोड से, 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. एआई मॉडल को कॉल करना

अब सर्वर पर टेंप्लेट को सुरक्षित तरीके से तय कर दिया गया है. आपको सिर्फ़ अपने ऐप्लिकेशन के फ़्रंटएंड से इसे कॉल करना होगा.

  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 की मदद से एजेंट को सुरक्षित करना

एआई मॉडल काफ़ी शक्तिशाली होते हैं. हालांकि, अगर सार्वजनिक एंडपॉइंट को सुरक्षित नहीं रखा जाता है, तो उनका गलत इस्तेमाल भी किया जा सकता है. आपको हमेशा Firebase App Check का इस्तेमाल करना चाहिए. इससे यह पक्का किया जा सकता है कि सिर्फ़ आपका असली वेब ऐप्लिकेशन, Gemini API से अनुरोध कर सके. साथ ही, बॉट और बिना अनुमति वाले क्लाइंट को ब्लॉक किया जा सके.

  1. Google Cloud Console में, सुरक्षा > धोखाधड़ी से बचाव पर जाएं
  2. कुंजी बनाएं पर क्लिक करें और फ़ील्ड भरें:
    • दिखने वाला नाम: Codelab Key
    • ऐप्लिकेशन टाइप: वेब
    • डोमेन की सूची: localhost और 127.0.0.1 जोड़ें, ताकि आपके लोकल Vite सर्वर को अनुरोध करने की अनुमति मिल सके.
  3. कुंजी रजिस्टर करने के लिए, कुंजी बनाएं पर क्लिक करें.
  4. 'धोखाधड़ी से बचाव करने वाली कुंजी की ज़्यादा जानकारी वाला पेज' पर सबसे ऊपर मौजूद, साइट कुंजी आईडी को अपने क्लिपबोर्ड पर कॉपी करें.
  5. Firebase कंसोल में, सुरक्षा > App Check पर जाएं.
  6. ऐप्लिकेशन टैब पर क्लिक करें. इसके बाद, अपने वेब ऐप्लिकेशन (Rugged Web) को बड़ा करें और reCAPTCHA Enterprise प्रोवाइडर पर क्लिक करें.
  7. reCAPTCHA Enterprise साइट कुंजी फ़ील्ड में, धोखाधड़ी से बचाव करने वाली कुंजी की ज़्यादा जानकारी वाले पेज से साइट कुंजी आईडी चिपकाएं. इसके बाद, सेव करें पर क्लिक करें.
  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. दिए गए स्थानीय यूआरएल (आम तौर पर http://localhost:5173/) को खोलें.
  3. सबसे नीचे दाएं कोने में मौजूद, टेक्टिकल सपोर्ट फ़्लोटिंग ऐक्शन बटन (एफ़एबी) पर क्लिक करें.
  4. प्रॉडक्ट के बारे में सवाल पूछें. जैसे:
    • "मुझे हर मौसम में पहनने के लिए एक शेल जैकेट चाहिए"
    • "मेरी सब-ज़ीरो बीनी में खराबी है. मुझे क्या करना चाहिए?"
    • एआई के "Appeasement Budget" लॉजिक को ट्रिगर करने के लिए, लगातार जवाब देते रहें!

9. (वैकल्पिक) कोडलैब से संसाधन हटाना

अपने Google Cloud Billing खाते पर संभावित शुल्क से बचने के लिए, इस कोडलैब के दौरान बनाए गए संसाधनों को मिटाया जा सकता है.

  1. Firebase कंसोल में, सेटिंग > सामान्य टैब पर जाएं.
  2. पक्का करें कि आपने उसी प्रोजेक्ट को चुना हो जिसका इस्तेमाल आपने इस कोडलैब के लिए किया था. अगर यह आपके कोडलैब का प्रोजेक्ट नहीं है, तो प्रोजेक्ट बदलने के लिए सबसे ऊपर बाएं कोने में मौजूद, प्रोजेक्ट चुनने वाले ड्रॉपडाउन का इस्तेमाल करें.
  3. पेज पर सबसे नीचे जाएं. इसके बाद, प्रोजेक्ट मिटाएं पर क्लिक करें.
  4. मिटाने की पुष्टि करने के लिए, स्क्रीन पर दिए गए निर्देशों का पालन करें.

10. बधाई हो!

🎊 मिशन पूरा हुआ! आपने टेंप्लेट पर आधारित, एआई की मदद से काम करने वाले ग्राहक सहायता एजेंट को इंटिग्रेट कर लिया है.

आपको क्या मिला:

  • क्लाइंट ऐप्लिकेशन पर, Firebase को शुरू किया गया हो और एजेंट प्लैटफ़ॉर्म का बैकएंड चालू हो.
  • Handlebars और स्ट्रिक्ट इनपुट स्कीमा का इस्तेमाल करके, सुरक्षित सर्वर साइड प्रॉम्प्ट टेंप्लेट कॉन्फ़िगर किया गया है. इससे एजेंट के जटिल व्यवहार को तय किया जा सकता है.
  • एलएलएम को डाइनैमिक तरीके से कॉल किया जाता है, ताकि चैट के इतिहास और कॉन्टेक्स्ट के हिसाब से प्रॉडक्ट आईडी को सुरक्षित तरीके से पास किया जा सके. साथ ही, क्लाइंट को इंटरनल प्रॉम्प्ट लॉजिक के बारे में पता न चले.

आगे क्या करना है?

  • Firebase App Check: अपने एआई एंडपॉइंट को गलत इस्तेमाल से सुरक्षित रखें.