Google के ईकोसिस्टम की मदद से एआई ऐप्लिकेशन बनाना

1. शुरू करने से पहले

सॉफ़्टवेयर डेवलपमेंट में काफ़ी बदलाव आया है. सबसे सफल डेवलपर सिर्फ़ कोड नहीं लिखते, बल्कि वे एआई टूल और एजेंट का इस्तेमाल करके, बेहतर और तेज़ी से कोड लिखते हैं. Google के टूल का नेटवर्क, पूरे लाइफ़साइकल के लिए एक सुइट उपलब्ध कराता है: यूज़र इंटरफ़ेस (यूआई) जनरेट करना, ऐप्लिकेशन का प्रोटोटाइप बनाना और उसे डिप्लॉय करना, एआई की सुविधा डेवलप करना, और सुरक्षित और बढ़ाए जा सकने वाले बैकएंड इंटिग्रेशन. इस कोडलैब में, यूज़र इंटरफ़ेस (यूआई) डिज़ाइन करने के लिए Google Stitch का इस्तेमाल किया जाएगा. साथ ही, वाइब कोड करने और ऐप्लिकेशन को डिप्लॉय करने के लिए Google AI Studio का इस्तेमाल किया जाएगा. इसके अलावा, एआई की सुविधाएं डेवलप करने और जानकारी को सुरक्षित और ज़रूरत के हिसाब से बढ़ाए जा सकने वाले बैकएंड में सेव करने के लिए, Firebase का इस्तेमाल किया जाएगा.

इस कोडलैब में आपको जो ऐप्लिकेशन बनाना है उसका नाम Decide For Me है. यह ऐप्लिकेशन, फ़ैसले लेने में मदद करने वाला असिस्टेंट है. यह उन लोगों के लिए है जो ज़िंदगी से जुड़े फ़ैसले लेने में हिचकिचाते हैं. जैसे, अपार्टमेंट बदलना, करियर बदलना या कोई हॉबी चुनना. उपयोगकर्ता अपनी दुविधा और जीवन में अपनी प्राथमिकताओं के बारे में बताता है. इसके बाद, ऐप्लिकेशन एआई का इस्तेमाल करके, उपयोगकर्ता को ऐसा फ़ैसला लेने में मदद करता है जिससे उसे लंबे समय तक निराशा न हो. यह ऐप्लिकेशन, उपयोगकर्ता को पहला कदम उठाने में भी मदद करता है. आपके ऐप्लिकेशन का फ़ाइनल वर्शन कुछ ऐसा दिखना चाहिए:

Decide For Me ऐप्लिकेशन का स्क्रीनशॉट, जिसमें चैट इंटरफ़ेस और प्राथमिकताओं वाला पैनल दिख रहा है

आपको क्या सीखने को मिलेगा

  • Google Stitch की मदद से यूज़र इंटरफ़ेस (यूआई) डिज़ाइन करना.
  • Google AI Studio की मदद से, किसी वेब ऐप्लिकेशन के लिए वाइब कोड जनरेट करना.
  • एआई की सुविधाएं डेवलप करने और क्लाउड में जानकारी सेव करने के लिए, Firebase का इस्तेमाल करें.
  • Google AI Studio (Cloud Run की मदद से काम करता है) का इस्तेमाल करके, किसी वेब ऐप्लिकेशन को प्रोडक्शन के लिए डिप्लॉय करना.

2. Stitch की मदद से यूज़र इंटरफ़ेस (यूआई) डिज़ाइन करना

  1. मॉकअप इमेज (DecideForMeScreen.jpeg) डाउनलोड करें. इसे किसी ऐसे लोकल फ़ोल्डर में सेव करें जहां इसे आसानी से ढूंढा जा सके.
  2. Stitch पर जाएं, इनपुट फ़ील्ड ढूंढें, और Web विकल्प चुनें. (इस कोडलैब के लिए, वेब अनुभव पर फ़ोकस किया जाएगा. हालांकि, मोबाइल स्क्रीन जनरेट करने के लिए, Stitch का भी इस्तेमाल किया जा सकता है.)
  3. मॉकअप इमेज अपलोड करें:
    1. + (जोड़ें बटन) पर क्लिक करें.
    2. फ़ाइलें अपलोड करें को चुनें.
    3. सेटअप के चरण (DecideForMeScreen.jpeg) में डाउनलोड की गई इमेज अटैच करें. हाथ से बनाए गए इस मॉकअप की मदद से, Stitch की मल्टीमॉडल क्षमताओं को टेस्ट किया जा सकता है.
  4. यहां दिया गया प्रॉम्प्ट कॉपी करें और उसे इनपुट फ़ील्ड में चिपकाएं:
    # General Guidance
    Create a modern, clean, and highly polished UI for a web application called
    "Decide For Me" - a hyper-rational decision assistant.
    
    CRITICAL: Replicate the exact layout, structure, and element placement shown in
    the hand-drawn mockup file DecideForMeScreen.jpeg. Do not add any extra menus,
    sidebars, buttons, or top/bottom navigation bars that are not explicitly drawn
    in the file. Stick strictly to the skeleton provided in the mockup.
    
    # Layout & Structure
    - Two-Column Split Screen:
      - Left Side (Main Chat Area): Takes up roughly 70-75% of the screen width. It
        should feel like a premium, focused workspace.
      - Right Side (Configuration Panel): A sidebar taking up 25-30% of the screen
        width with a distinct, subtle background color to separate it from the
        chat.
    
    # Right Panel: Configuration Screen
    - Header: Title it "My Priorities" with a clean, minimalist typography.
    - Content Card: A styled card containing a text box or paragraph area
      showcasing the user's priorities.
    - Interactions: Include a clear "Edit Priorities" button. When clicked, this
      area should visually toggle into an editable textarea or input field.
    
    # Left Panel: Chat & Dilemma Decision Screen
    - Chat History: A clean vertical flow of message bubbles.
      - The first message bubble must be aligned to the left (system message) and
        say: "Tell me your dilemma". Use a friendly, neutral background color for
        this bubble.
    - Bottom Input Area: Instead of a traditional single-line chat bar, create a
      unified, beautiful "Decision Submission" layout positioned at the bottom:
      - Dual Input Fields: Place two horizontal or cleanly stacked input fields.
        - Input 1 label: "Option A"
        - Input 2 label: "Option B"
      - Action Button: A prominent, styled "Go" action button to trigger the
        reasoning loop.
    
    # Theme & Aesthetic
    - Vibe: Hyper-rational, clean, trustworthy, and modern. Use a sophisticated
      color palette (e.g., deep slates, clean whites/grays, and a sharp accent
      color like a subtle indigo or teal for active states and buttons).
    - Spacing & Typography: Use generous whitespace, soft rounded corners
      (border-radius) for cards and buttons, and a highly legible sans-serif font.
    
  5. इनपुट फ़ील्ड के सबसे नीचे दाएं कोने में मौजूद, जनरेट ऐरो पर क्लिक करें. Stitch, स्क्रीन और पूरा डिज़ाइन सिस्टम जनरेट करता है. इसमें कलर पैलेट, फ़ॉन्ट के विकल्प, आइकॉनोग्राफ़ी, और यूज़र इंटरफ़ेस (यूआई) एलिमेंट का सामान्य लुक शामिल है:

Stitch इंटरफ़ेस, जिसमें जनरेट किया गया Decide For Me यूआई डिज़ाइन और डिज़ाइन सिस्टम दिखाया गया है

3. Google AI Studio की मदद से ऐप्लिकेशन बनाना

  1. Firebase प्रोजेक्ट बनाना:
    1. Stitch के लिए इस्तेमाल किए गए Google खाते से, Firebase कंसोल में साइन इन करें.
    2. नया प्रोजेक्ट बनाने के लिए, बटन पर क्लिक करें. इसके बाद, प्रोजेक्ट का नाम डालें (उदाहरण के लिए, Decider App).
    3. जारी रखें पर क्लिक करें.
    4. अगर कहा जाए, तो Firebase की शर्तें पढ़ें और उन्हें स्वीकार करें. इसके बाद, जारी रखें पर क्लिक करें.
    5. (ज़रूरी नहीं) Firebase कंसोल में एआई असिस्टेंस की सुविधा चालू करें. इसे "Firebase में Gemini" कहा जाता है.
    6. इस कोडलैब के लिए, आपको Google Analytics की ज़रूरत नहीं है. इसलिए, Google Analytics के विकल्प को टॉगल करके बंद करें.
    7. प्रोजेक्ट बनाएं पर क्लिक करें. इसके बाद, प्रोजेक्ट के तैयार होने का इंतज़ार करें और फिर जारी रखें पर क्लिक करें.
  2. Stitch में बनाई गई स्क्रीन को Google AI Studio में एक्सपोर्ट करें:
    1. Stitch में जनरेट किए गए डिज़ाइन पर क्लिक करें.
    2. स्क्रीन के सबसे ऊपर दाएं कोने में मौजूद, एक्सपोर्ट करें पर क्लिक करें.
    3. पुष्टि करें कि चुना गया विकल्प Google AI Studio है.
    4. नीचे की ओर स्क्रोल करके, ब्यौरा फ़ील्ड पर जाएं.
  3. इस प्रॉम्प्ट को कॉपी करें और जानकारी फ़ील्ड में चिपकाएं. [FIREBASE_PROJECT_ID] को पहले चरण में मिले असल प्रोजेक्ट आईडी से बदलें. अगर आपको अपना प्रोजेक्ट आईडी याद नहीं है, तो उसे प्रोजेक्ट सेटिंग में जाकर ढूंढा जा सकता है:
    # General Guidance
    Build the "Decide For Me" app: A hyper-rational decision assistant for
    chronically indecisive people facing life choices (moving apartments, changing
    careers, picking a hobby). The user enters a dilemma and their top priorities
    in life. The app will help with the decision. Follow the instructions below to
    build it:
    
    # UI Instructions
    Using the design artifacts exported from Stitch (the PNG image and HTML file),
    build a fully functional web application that accurately mirrors the design and
    layout.
    
    # App Architecture & Initialization Instructions
    - Initialize the latest Firebase JS SDK for client-side services. Use the
      Firebase project with ID [FIREBASE_PROJECT_ID].
    - Enable Firebase Authentication in this project using the Google provider.
      If a user is not logged in, show a clean, minimalist sign-in state. If the
      user is logged in, take them directly to the dilemma decision screen.
    - Initialize Firebase App Check in debug mode with the following code:
      `self.FIREBASE_APPCHECK_DEBUG_TOKEN = true;`
      `initializeAppCheck(app, { /* App Check options */ });`
    
    
    # State & Database Management Instructions
    - User Priorities:
      - Once authenticated, pull the user's saved priorities from Firebase
        Firestore at the path: `users/{userId}`. Each document should contain one
        string field: 'priorities'.
      - Bind this data to the Right Panel ("My Priorities").
      - When the user clicks the "Edit" button, toggle the view to a textarea, with
        a 'save' button. When saved, write the updated string back to
        `users/{userId}`.
      - Make sure to implement and deploy strong Security Rules for Firestore.
    
    # UI Stream Update & Display Instructions
    - Once the user submits option A and option B in the dilemma decision screen,
      display both options as a single message on the user side of the chat. Then,
      display a sleek loading state in the main chat panel. Leave the app in this
      "loading" state and do nothing else, we will process both options and build
      the server-side thinking later.
    
  4. Google AI Studio की मदद से बनाएं पर क्लिक करें. इससे Google AI Studio एक नए टैब में खुल जाएगा. साथ ही, आपकी डिज़ाइन फ़ाइलें और प्रॉम्प्ट भी उसमें ट्रांसफ़र हो जाएंगे:
    1. पुष्टि करें कि प्रॉम्प्ट पूरी तरह से ट्रांसफ़र हो गया है.
    2. अगर आपको प्रॉम्प्ट का सिर्फ़ कुछ हिस्सा दिखता है, तो पूरा प्रॉम्प्ट फिर से चिपकाएं.
  5. बनाएं पर क्लिक करें. Google AI Studio, आपके प्रॉम्प्ट और यूआई डिज़ाइन के हिसाब से Decide For Me ऐप्लिकेशन जनरेट करना शुरू कर देता है:
    1. कोड जनरेट होने के दौरान, यह यूआई के लिए अन्य डिज़ाइन भी सुझाता है. इस कोडलैब के लिए, इन डिज़ाइन को अनदेखा करें. हालांकि, आने वाले समय में आपके पास अलग-अलग डिज़ाइन चुनने का विकल्प होगा.
    2. जब Firebase को चालू करने के लिए कहा जाए, तब चालू करें पर क्लिक करें.
  6. जनरेट किए गए ऐप्लिकेशन की जांच और पुष्टि करना:
    1. झलक टैब में जाकर, ऐप्लिकेशन की जांच करें.
    2. जनरेट की गई सभी फ़ाइलें और कोड देखने के लिए, कोड टैब पर स्विच करें.
    3. Google AI Studio ने एक Firebase प्रोजेक्ट भी बनाया है. साथ ही, Firebase से पुष्टि करने की सुविधा और Firestore को चालू किया है. इसके अलावा, आपके कोड बेस में Firebase को कॉन्फ़िगर किया है. इस कोडलैब के अगले चरण में, इस Firebase प्रोजेक्ट को ऐक्सेस किया जा सकेगा और इस पर काम किया जा सकेगा.

4. App Check का डीबग टोकन रजिस्टर करना

जब Google AI Studio ऐप्लिकेशन जनरेट करता है, तो यह एक Firebase प्रोजेक्ट बनाता है और आपके ऐप्लिकेशन को उससे कनेक्ट करता है. आपको इस Firebase प्रोजेक्ट को ऐक्सेस करना होगा और अपने डेवलपमेंट एनवायरमेंट को Firebase App Check नाम की एक अहम सुरक्षा सेवा के साथ रजिस्टर करना होगा.

अपना Firebase प्रोजेक्ट ऐक्सेस करें

  1. Google AI Studio से बनाए गए Firebase प्रोजेक्ट का प्रोजेक्ट आईडी ढूंढें:
    1. Google AI Studio में कोड टैब पर स्विच करें.
    2. firebase-applet-config.json फ़ाइल खोलें.
    3. projectId फ़ील्ड की वैल्यू कॉपी करें.
  2. Firebase कंसोल पर जाएं और इस आईडी का इस्तेमाल करके प्रोजेक्ट खोजें.

डीबग टोकन रजिस्टर करना

आपका ऐप्लिकेशन, Firebase App Check का इस्तेमाल करके, बैकएंड सेवाओं और एआई मॉडल को गलत इस्तेमाल से बचा सकता है. इसके लिए, यह पक्का किया जाता है कि आने वाला ट्रैफ़िक सिर्फ़ मान्य ऐप्लिकेशन से आ रहा हो.

आपका ऐप्लिकेशन, Google AI Studio के झलक वाले एनवायरमेंट में चल रहा है. इसलिए, यह App Check के डीबग प्रोवाइडर (self.FIREBASE_APPCHECK_DEBUG_TOKEN = true) का इस्तेमाल करता है. वेब ऐप्लिकेशन लोड होने पर, Firebase आपके ब्राउज़र के डेवलपर कंसोल में अपने-आप एक डीबग टोकन जनरेट करता है.

  1. अपना डीबग टोकन ढूंढें:
    1. Google AI Studio में, ऐप्लिकेशन की झलक देखते समय अपने ब्राउज़र के डेवलपर टूल खोलें:
      • Chrome, Edge या Firefox: F12 दबाएं या झलक में कहीं भी राइट क्लिक करें और जांच करें को चुनें. इसके बाद, कंसोल टैब को चुनें.
      • macOS: Cmd+Option+I दबाएं. इसके बाद, Console टैब चुनें.
    2. कंसोल लॉग में, App Check का डीबग मैसेज ढूंढें:
      AppCheck debug token: "123a4567-b89c-12d3-e456-789012345678".
      You will need to safelist it in the Firebase console for it to work.
      
    3. टोकन स्ट्रिंग को कॉपी करें (कोटेशन मार्क के बिना).
  2. अपना डीबग टोकन रजिस्टर करें:
    1. Firebase कंसोल में, सुरक्षा > App Check > ऐप्लिकेशन टैब पर जाएं.
    2. सूची में अपना वेब ऐप्लिकेशन ढूंढें, तीन बिंदु वाले मेन्यू (⋮) पर क्लिक करें, और डीबग टोकन मैनेज करें को चुनें.
    3. डीबग टोकन जोड़ें पर क्लिक करें. इसके बाद, कॉपी किया गया टोकन चिपकाएं और Google AI Studio Preview जैसा कोई नाम डालें. इसके बाद, सेव करें पर क्लिक करें.
    Firebase कंसोल में, 'डीबग टोकन मैनेज करें' मेन्यू आइटम का स्क्रीनशॉट

5. ऐप्लिकेशन को टेस्ट करना

अब आपका प्रोजेक्ट कनेक्ट हो गया है और डीबग टोकन, App Check के साथ रजिस्टर हो गया है. इसलिए, बुनियादी सुविधाओं को टेस्ट करें: Authentication और Firestore.

  1. उपयोगकर्ता की पुष्टि करने की सुविधा को टेस्ट करना और प्राथमिकताओं को सेव करना:
    1. Google AI Studio में Decide For Me ऐप्लिकेशन की झलक में, Google खाते से साइन इन करके, पुष्टि करने वाली स्क्रीन की जांच करें.
    2. दाईं ओर मौजूद पैनल (मेरी प्राथमिकताएं) का इस्तेमाल करके, अपनी ज़िंदगी की प्राथमिकताएं सेव करें.
  2. Firebase कंसोल में पुष्टि करने की सुविधा की जांच करें:
    1. Firebase कंसोल पर जाएं और Authentication खोलें.
    2. पुष्टि करें कि Decide For Me ऐप्लिकेशन में पुष्टि करने के लिए इस्तेमाल किया गया Google खाता, वहां मौजूद है:
    Firebase कंसोल के पुष्टि करने वाले पेज पर, पुष्टि किया गया Google खाता दिख रहा है
  3. Firestore डेटा स्टोरेज की पुष्टि करना:
    1. Firebase कंसोल में Firestore खोलें.
    2. पुष्टि करें कि आपकी प्राथमिकताएं, users/{userId} पाथ में मौजूद किसी दस्तावेज़ में सेव की गई हैं:
    Firebase कंसोल के Firestore डेटाबेस में, users/{userId} के तहत सेव की गई प्राथमिकताएं दिख रही हैं

6. Firebase का इस्तेमाल करके, एआई की मदद से काम करने वाला Decider फ़्लो बनाना

आपका ऐप्लिकेशन, मेरे लिए फ़ैसला लें कार्रवाइयों को बेहतर बनाने के लिए, एआई का इस्तेमाल करेगा. एआई की मदद से काम करने वाले इस Decider फ़्लो को बनाने के लिए, Firebase का इस्तेमाल किया जा सकता है.

Firebase AI Logic सेट अप करना

  1. Firebase AI Logic में Gemini Developer API को चालू करें:
    1. Firebase कंसोल में Firebase AI Logic खोलें. इसके बाद, शुरू करें पर क्लिक करें.
    2. Gemini Developer API को चुनें. इसके बाद, एपीआई को चालू करने के लिए कंसोल में दिए गए निर्देशों का पालन करें.
  2. Firebase AI Logic की सेटिंग कॉन्फ़िगर करें:
    1. सेटिंग टैब पर जाएं.
    2. सिर्फ़ टेंप्लेट मोड लागू करें विकल्प को लागू किया गया पर टॉगल करें.
    3. पुष्टि किए गए उपयोगकर्ताओं के लिए मोड लागू करें विकल्प को लागू किया गया पर टॉगल करें.

सर्वर प्रॉम्प्ट का टेंप्लेट बनाना

इस कोडलैब में, Firebase AI Logic के ज़रिए Gemini API के साथ इंटरैक्ट करने के लिए, सर्वर प्रॉम्प्ट टेंप्लेट इस्तेमाल करने का तरीका बताया गया है.

टेंप्लेट का इस्तेमाल करने से पहले, यहां दी गई जानकारी पढ़ें. इससे आपको यह समझने में मदद मिलेगी कि मॉडल कॉन्फ़िगरेशन, सिस्टम के निर्देशों, और प्रॉम्प्ट को सर्वर-साइड पर सेव करना क्यों ज़रूरी है:

  • बौद्धिक संपत्ति की सुरक्षा करना: यह क्लाइंट के डिवाइस से प्रॉम्प्ट हटाता है और उन्हें बैकएंड पर सुरक्षित रखता है.
  • प्रॉम्प्ट इंजेक्शन अटैक से बचाव: क्लाइंट, बैकएंड स्कीमा की पुष्टि के साथ सिर्फ़ कुछ वैरिएबल भर सकता है.
  • ऐप्लिकेशन रिलीज़ किए बिना अपडेट करना: ऐप्लिकेशन का नया वर्शन रिलीज़ किए बिना, कंसोल में प्रॉम्प्ट, सिस्टम के निर्देश, और मॉडल कॉन्फ़िगरेशन अपडेट किए जा सकते हैं.

सर्वर प्रॉम्प्ट टेंप्लेट बनाने और उसे टेस्ट करने का तरीका यहां बताया गया है:

  1. सर्वर प्रॉम्प्ट टेंप्लेट बनाएं:
    1. प्रॉम्प्ट टेंप्लेट टैब पर जाएं.
    2. टेंप्लेट बनाएं पर क्लिक करें.
    3. खाली टेंप्लेट को चुनें.
    4. यहां दी गई जानकारी का इस्तेमाल करके, अपना पहला टेंप्लेट बनाएं:
      • Template name: Decider Flow
      • टेंप्लेट आईडी: decider-flow
      • कॉन्फ़िगरेशन (फ़्रंटमैटर)
        model: "gemini-3.5-flash-lite"
        input:
          schema:
            priorities: "string, user's core priorities"
            optionA: "string, option A under consideration"
            optionB: "string, option B under consideration"
        output:
          format: json
          schema:
            verdict: string
            justification: string
            firstStep: string
        
      • प्रॉम्प्ट और सिस्टम से जुड़े निर्देश (ज़रूरी नहीं)
        {role "system"}
        You are the Decider Agent, a multi-stage reasoning engine that
        combines the roles of an honest and polite behavioral economist, a
        long-term strategic forecaster, and an executive decision coach.
        Your job is to take a user's dilemma and their core priorities, run
        them through a rigorous, adversarial 3-phase thinking process, and
        output a highly analytical, reasoning-backed final verdict. You must be
        direct, sharp, and realistic. Do not give generic platitudes or claim
        that "both options are great." You must force a clear choice.
        
        {role "user"}
        # Context & Inputs
        You are analyzing a critical life decision for the user. Base your
        entire multi-phase reasoning flow strictly on these three specific
        inputs:
        - User's Core Priorities: {{priorities}}
        - Option A under consideration: {{optionA}}
        - Option B under consideration: {{optionB}}
        
        Execute your reasoning flow through the following three phases:
        
        # Phase 1: Cynical Breakdown (Input-Driven Analysis)
        Analyze {{optionA}} and {{optionB}} strictly through the lens of the
        user's explicit {{priorities}}. Do not evaluate them in a vacuum.
        - Identify the hidden flaws, compromises, and psychological costs
          embedded in both choices.
        - Pinpoint exactly how {{optionA}} could directly conflict with or
          undermine their {{priorities}}.
        - Pinpoint exactly how {{optionB}} could directly conflict with or
          undermine their {{priorities}}.
        - Uncover any cognitive biases (like status quo bias or loss aversion)
          the user might be falling for in either option.
        
        # Phase 2: Long-Term Regret Projection
        Project the user 5 years into the future. Apply the Regret Minimization
        Framework to both paths:
        - The {{optionA}} Timeline: Quantify the absolute worst-case, deep,
          structural 5-year regret of choosing this path. Focus heavily on
          failures of courage vs. failures of action based on their
          {{priorities}}.
        - The {{optionB}} Timeline: Quantify the matching 5-year regret for
          this path.
        - Contrast these two timelines. Which option carries the kind of regret
          that fundamentally breaks the user's {{priorities}}?
        
        # Phase 3: Final Recommendation & Action Step
        Synthesize the cynical critiques and long-term regret scores.
        Weigh them against the user's {{priorities}} to determine which
        choice minimizes long-term disappointment.
        - Verdict: You must declare either {{optionA}} or {{optionB}} as the
          definitive winner. No compromise, no "it depends," and no hybrid
          options.
        - Justification: Provide a sharp, reasoning-backed explanation showing why
          the losing option was eliminated based on the Phase 1 and Phase 2
          analysis.
        - First Step: Give one microscopic, low-friction task the user can
          execute within the next 15 minutes to commit to or move toward the
          chosen verdict.
        
        सिस्टम के निर्देश और प्रॉम्प्ट को सही सिंटैक्स में लिखने के लिए, {role "system"} और {role "user"} के आस-पास एक और {} जोड़ें: 9db2a4f2c5cf2ec7.png
      • इनपुट की जांच करना
        {
          "priorities": "Be financially stable, have a good work-life balance where I can travel twice a year",
          "optionA": "Buy a house for 615000 British pounds with a mortgage of 2800 per month for the next 35 years",
          "optionB": "Keep renting for 2400 per month for the foreseeable"
        }
        
  2. टेंप्लेट सेव करें पर क्लिक करें.
  3. टेंप्लेट की जांच करना:
    1. प्रॉम्प्ट टेस्ट चलाएं पर क्लिक करें.
    2. टेस्ट रिस्पॉन्स ढूंढें और देखें कि इसमें वे सभी फ़ील्ड मौजूद हैं या नहीं जो आपने प्रॉम्प्ट (verdict, justification, और firstStep) में बताए थे.
    3. अगर सब कुछ उम्मीद के मुताबिक है, तो टेंप्लेट के सबसे ऊपर दाएं कोने में मौजूद लॉक आइकॉन का इस्तेमाल करके टेंप्लेट को लॉक करें. इससे वर्शन में कोई बदलाव नहीं होगा और गलती से होने वाले बदलावों को रोका जा सकेगा.

आपका टेंप्लेट, ऐप्लिकेशन में इस्तेमाल करने के लिए तैयार है!

7. ऐप्लिकेशन में, Decider प्रॉम्प्ट टेंप्लेट का इस्तेमाल करना

अपने वेब ऐप्लिकेशन में टेंप्लेट का इस्तेमाल करने के लिए:

  1. Google AI Studio में अपने ऐप्लिकेशन पर वापस जाएं.
  2. Google AI Studio एजेंट से, मेरे लिए फ़ैसला लें कार्रवाई लागू करने के लिए कहें:
    1. इस प्रॉम्प्ट को कॉपी करें:
      Now let's implement the "Decide For Me" button action. When clicked, it
      should call the Firebase AI Logic SDK using a Template Generative Model.
      The prompt is stored in a prompt template with the id "decider-flow". When
      calling the API, pass the following variables as the input payload object:
      - priorities
      - optionA
      - optionB
      
      The API will return a JSON object. Handle the response asynchronously and
      extract:
      - verdict
      - justification
      - firstStep
      
      Once the data is received, update the UI state to append a new message to
      the chat array. Ensure it renders as a system chat bubble positioned on
      the left side of the chat screen, mapping these three fields clearly into
      the bubble's layout.
      
      Please provide the necessary front-end component state updates and the
      Firebase SDK call.
      
    2. प्रॉम्प्ट को Google AI Studio के चैट इनपुट में चिपकाएं और भेजें पर क्लिक करें.
  3. कॉन्फ़िगरेशन की पुष्टि करें और फ़ैसले लेने में मदद करने वाले असिस्टेंट की जांच करें:
    1. Google AI Studio को आपके ऐप्लिकेशन में Firebase AI Logic जोड़ने दें.
    2. कोड टैब पर जाएं और पक्का करें कि आपकी firebase-applet-config.json फ़ाइल में एपीआई पासकोड मौजूद हो. अगर Firebase एपीआई पासकोड, कॉन्फ़िगरेशन फ़ाइल में मौजूद नहीं है, तो Google AI Studio से इसे इंपोर्ट करने के लिए कहें.
    3. झलक टैब पर स्विच करें
    4. विकल्प A और B सबमिट करें. साथ ही, पुष्टि करें कि एआई, फ़ैसले का नतीजा, वजह, और पहला चरण दिखाता है.

रेफ़रंस के लिए, Google AI Studio से जनरेट किया गया कोड कुछ ऐसा दिखना चाहिए:

const aiInstance = getAI(app);
const templateModel = getTemplateGenerativeModel(aiInstance);

const result = await templateModel.generateContent('decider-flow', {
  priorities: priorities,
  optionA: optA,
  optionB: optB
});

const rawText = result.response.text();

// Parse response text to extract fields
const cleaned = rawText.replace(/```json|```/g, '').trim();
const parsedData: { verdict?: string; justification?: string; firstStep?: string } = JSON.parse(cleaned);

const verdict = parsedData.verdict;
const justification = parsedData.justification;
const firstStep = parsedData.firstStep;

अनुरोधों को डीबग और मॉनिटर करना

अगर आपके ऐप्लिकेशन में गड़बड़ियां आती हैं, वह जवाब जनरेट नहीं कर पाता है या आपको एपीआई ट्रैफ़िक की बारीकी से जांच करनी है, तो Firebase AI Logic में पहले से मौजूद आंकड़ों और निगरानी वाले टूल का इस्तेमाल करें:

  1. Firebase कंसोल में, एआई सेवाएं > एआई लॉजिक > एआई मॉनिटरिंग टैब पर जाएं.
  2. डैशबोर्ड पर संख्यात्मक मेट्रिक देखें:
    • अनुरोधों की संख्या और स्थिति: पुष्टि करें कि आने वाले अनुरोध, बैकएंड तक पहुंच रहे हैं और 200 OK दिखा रहे हैं या क्लाइंट या सर्वर की गड़बड़ियों की वजह से फ़ेल हो रहे हैं.
    • लेटेंसी: एंड-टू-एंड रिस्पॉन्स टाइम देखने के लिए, लेटेंसी ग्राफ़ की जांच करें.
    • टोकन की संख्या: हर अनुरोध के लिए, इनपुट और आउटपुट टोकन के इस्तेमाल को मॉनिटर करें.
  3. गहराई से डीबग करने के लिए, अनुरोध के अलग-अलग ट्रेस की जांच करें:ट्रेस टेबल में किसी अनुरोध के ट्रेस पर क्लिक करके, उसके पेलोड की जांच करें.
    • इनपुट: पुष्टि करें कि वैरिएबल (priorities, optionA, और optionB) क्लाइंट ऐप्लिकेशन से सही तरीके से पास किए गए थे.
    • आउटपुट: मॉडल से जनरेट किया गया रॉ टेक्स्ट देखें. इससे यह पुष्टि की जा सकेगी कि उसने स्कीमा से मैच करने वाला मान्य JSON दिखाया है या नहीं.
    • गड़बड़ी की जानकारी: अगर कोई अनुरोध पूरा नहीं हो पाता है, तो गड़बड़ी की वजह जानने के लिए ट्रेस एरर लॉग देखें. जैसे, अमान्य App Check टोकन, पुष्टि न होना, कोटा की सीमाएं या प्रॉम्प्ट की पुष्टि से जुड़ी गड़बड़ियां.
  4. Google AI Studio से जुड़ी समस्याएं हल करना:
    • अगर आपको ट्रेस में कोई गड़बड़ी मिलती है, जैसे कि गलत तरीके से बनाए गए JSON रिस्पॉन्स को पार्स करना या पैरामीटर मौजूद न होना, तो गड़बड़ी का मैसेज या पेलोड कॉपी करें.
    • Google AI Studio पर वापस जाएं और असिस्टेंट को ऐप्लिकेशन के कोड में मौजूद समस्या को ठीक करने के लिए कहें.

8. ज़रूरी नहीं: ऐप्लिकेशन को डिप्लॉय करना

अब आपका ऐप्लिकेशन झलक मोड में काम कर रहा है, इसलिए इसे प्रोडक्शन में डिप्लॉय करें.

प्रोडक्शन में अपने Firebase एंडपॉइंट को सुरक्षित रखने के लिए, प्रोडक्शन अटेस्टेशन प्रोवाइडर को कॉन्फ़िगर करें, ताकि उसे Firebase App Check के साथ इस्तेमाल किया जा सके. इस कोडलैब में, reCAPTCHA वर्शन 3 का इस्तेमाल किया जाएगा.

आपको अपने ऐप्लिकेशन का लाइव यूआरएल पाने के लिए, पहले उसे डिप्लॉय करना होगा. इससे, सभी ai.studio ऐप्लिकेशन को अनुमति देने के बजाय, किसी खास डोमेन को reCAPTCHA के साथ रजिस्टर किया जा सकेगा.

अपना ऐप्लिकेशन डिप्लॉय करें और reCAPTCHA को कॉन्फ़िगर करें:

  1. Google AI Studio की मदद से वेब ऐप्लिकेशन को डिप्लॉय करना:
    1. Google AI Studio में, सबसे ऊपर मौजूद नेविगेशन बार में जाकर, पब्लिश करें पर क्लिक करें.
    2. शुरू करें पर क्लिक करें. इसके बाद, ऐप्लिकेशन के नाम और ब्यौरे की समीक्षा करें या उसे पसंद के मुताबिक बनाएं. इसके बाद, अपना ऐप्लिकेशन पब्लिश करें पर क्लिक करें.
    3. Google AI Studio को आपका ऐप्लिकेशन बनाने और डिप्लॉय करने दें. आम तौर पर, इसमें एक से दो मिनट लगते हैं.
    4. जनरेट किए गए लाइव वैनिटी यूआरएल (उदाहरण के लिए, https://decide-for-me-123.ai.studio) को कॉपी करें और उसके डोमेन (उदाहरण के लिए, decide-for-me-123.ai.studio) को नोट करें.
  2. Google reCAPTCHA में reCAPTCHA वर्शन 3 की कुंजियां बनाएं:
    1. Google reCAPTCHA Admin Console पर जाएं.
    2. कोई लेबल डालें (उदाहरण के लिए, Decide For Me - Production).
    3. reCAPTCHA का टाइप > reCAPTCHA वर्शन 3 (स्कोर के आधार पर) को चुनें.
    4. डोमेन सेक्शन में, अपने ऐप्लिकेशन का डिप्लॉय किया गया सटीक डोमेन जोड़ें. उदाहरण के लिए, decide-for-me-123.ai.studio. इसमें https:// और कोई भी पाथ शामिल न करें. इसके अलावा, अगर आपको कस्टम डोमेन का इस्तेमाल करना है, तो उसे जोड़ें.
    5. सेवा की शर्तें स्वीकार करें और सबमिट करें पर क्लिक करें.
    6. इस टैब को खुला रखें: आपको साइट पासकोड (सार्वजनिक क्लाइंट पासकोड) और सीक्रेट पासकोड (निजी सर्वर पासकोड), दोनों की ज़रूरत होगी.
  3. Firebase कंसोल में अपनी सीक्रेट कुंजी रजिस्टर करें:
    1. Firebase कंसोल में App Check पर जाएं.
    2. ऐप्लिकेशन टैब पर जाएं.
    3. सूची में अपना वेब ऐप्लिकेशन ढूंढें और उस पर क्लिक करें. इसके अलावा, तीन बिंदु वाले मेन्यू ⋮ पर क्लिक करके, reCAPTCHA वर्शन 3 को चुनें.
    4. फ़ील्ड में अपनी reCAPTCHA सीक्रेट कुंजी चिपकाएं और सेव करें पर क्लिक करें.
  4. क्लाइंट ऐप्लिकेशन को ReCaptchaV3Provider का इस्तेमाल करने के लिए कॉन्फ़िगर करें:
    1. Google AI Studio में, चैट पैनल पर जाएं और असिस्टेंट को प्रोडक्शन के लिए App Check कॉन्फ़िगरेशन अपडेट करने के लिए कहें:
      Please update our Firebase App Check initialization to use
      ReCaptchaV3Provider with the reCAPTCHA site key "YOUR_RECAPTCHA_SITE_KEY",
      while retaining support for debug tokens in non-production environments.
      
    2. अगर कोड की समीक्षा सीधे कोड टैब में की जाती है, तो पक्का करें कि App Check को शुरू करने का तरीका इस स्ट्रक्चर से मेल खाता हो:
      import { initializeAppCheck, ReCaptchaV3Provider } from "firebase/app-check";
      
      const appCheck = initializeAppCheck(app, {
        provider: new ReCaptchaV3Provider("YOUR_RECAPTCHA_SITE_KEY"),
        isTokenAutoRefreshEnabled: true
      });
      
    3. कोड अपडेट करने के बाद, Google AI Studio में अपना ऐप्लिकेशन फिर से पब्लिश करें. इससे, App Check का अपडेट किया गया कॉन्फ़िगरेशन आपकी लाइव साइट पर लागू हो जाएगा.
  5. प्रोडक्शन ट्रैफ़िक की पुष्टि करना और App Check की निगरानी करना:
    1. अपने लाइव ऐप्लिकेशन का यूआरएल, ब्राउज़र की गुप्त विंडो में खोलें. इसके बाद, Google से साइन इन करें और कोई सवाल सबमिट करके देखें.
    2. Firebase कंसोल में App Check पर वापस जाएं. इसके बाद, एपीआई और मॉनिटरिंग टैब की जांच करके पुष्टि करें कि Firestore और Firebase AI Logic के लिए अनुरोधों को रजिस्टर कर लिया गया है.

9. नतीजा

बधाई हो! आपने Google के बिल्डर स्टैक में मौजूद टूल का इस्तेमाल करके, एआई की सुविधाओं वाला एक काम का ऐप्लिकेशन बनाया है. यह तो बस शुरुआत है. Google के टूल की मदद से, और भी बहुत कुछ किया जा सकता है. अब आपके पास Firebase + Google Cloud प्रोजेक्ट है. आपके लिए उपलब्ध सभी सेवाओं को एक्सप्लोर करें!

Completed Builder Journey बैज पर दावा करने के लिए, इस लिंक पर जाएं!

अपनी यात्रा जारी रखने के लिए, अगली लैब पर जाएं. इसके लिए, goo.gle/builders पर जाएं.

अगर पहले से ही Antigravity 2.0 का इस्तेमाल किया जा रहा है, तो Google AI Studio से अपने प्रोजेक्ट को तुरंत एक्सपोर्ट किया जा सकता है. इसके बाद, उसे Antigravity में इंपोर्ट करके, लोकल लेवल पर उस पर काम जारी रखा जा सकता है. Antigravity, Google का एक खास प्लैटफ़ॉर्म है. इसका इस्तेमाल, एक साथ कई ऑटोनॉमस एजेंट को मैनेज करने के लिए किया जाता है. Antigravity में Firebase के लिए एजेंट स्किल उपलब्ध हैं. इन्हें एक क्लिक में इंस्टॉल किया जा सकता है. इन स्किल से मोबाइल डेवलपमेंट में भी मदद मिलती है. इससे, इस ऐप्लिकेशन को Android और iOS, दोनों प्लैटफ़ॉर्म पर बनाया जा सकता है.