टेम्प्लेट के लिए बेहतर वर्कफ़्लो


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

इस पेज पर बताए गए ऐडवांस वर्कफ़्लो, Firebase AI Logic REST API का इस्तेमाल करते हैं.

REST API इस्तेमाल करने के बारे में अहम जानकारी

  • अगर कोई टेंप्लेट अनलॉक है, तो अपने REST API कॉल में उसी टेंप्लेट आईडी का इस्तेमाल करके, टेंप्लेट को बदला जा सकता है. लॉक किए गए टेंप्लेट को बदला नहीं जा सकता.

  • जब REST API के ज़रिए सर्वर प्रॉम्प्ट टेंप्लेट बनाया जाता है और उसकी जगह की जानकारी global पर सेट की जाती है, तो सर्वर प्रॉम्प्ट टेंप्लेट सभी जगहों (इसमें global भी शामिल है) में अपने-आप उपलब्ध हो जाता है. साथ ही, इसका इस्तेमाल Gemini API की दोनों कंपनियों के साथ किया जा सकता है. हालांकि, अगर REST API के ज़रिए टेंप्लेट बनाते समय कोई दूसरी जगह सेट की जाती है, तो टेंप्लेट Agent Platform Gemini API (formerly Vertex AI) के लिए सिर्फ़ उपलब्ध होगा. इस पेज पर आगे, किसी टेंप्लेट के लिए कोई खास जगह सेट करने के बारे में ज़्यादा जानें.

    ध्यान दें कि Firebase कंसोल में गाइडेड यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करने पर, टेंप्लेट सभी जगहों (इसमें global भी शामिल है) पर अपने-आप उपलब्ध हो जाता है. साथ ही, इसका इस्तेमाल Gemini API उपलब्ध कराने वाली दोनों कंपनियों के साथ किया जा सकता है.

  • REST API के ज़रिए templateGenerateContent या templateStreamGenerateContent अनुरोध में सर्वर प्रॉम्प्ट टेंप्लेट को ऐक्सेस करने के लिए, आपको Gemini API सेवा देने वाली कंपनी (Gemini Developer API | Agent Platform Gemini API (formerly Vertex AI)) के लिए तय किया गया एंडपॉइंट इस्तेमाल करना होगा.

(सिर्फ़ Agent Platform Gemini API (formerly Vertex AI) के लिए) किसी टेंप्लेट के लिए कोई खास जगह सेट करना

यह सेक्शन इन स्थितियों पर लागू होता है:

  • आपके ऐप्लिकेशन के इस्तेमाल के उदाहरण में, जगह की जानकारी के आधार पर ज़रूरी शर्तें शामिल हैं.

  • आपके ऐप्लिकेशन के अनुरोध, Agent Platform Gemini API (formerly Vertex AI) का इस्तेमाल करते हैं. साथ ही, आपको मॉडल को ऐक्सेस करने के लिए जगह की जानकारी देनी होती है.

इस पेज पर पहले बताया गया है कि अगर आपने इनमें से कोई एक काम किया है, तो सभी Firebase AI Logic के लिए उपलब्धता वाले देश या इलाकों (global भी शामिल है) के लिए, सर्वर प्रॉम्प्ट टेंप्लेट अपने-आप उपलब्ध हो जाता है:

  • Firebase कंसोल में, गाइड किए गए यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके टेंप्लेट बनाएं.
  • REST API की मदद से टेंप्लेट बनाएं और उसकी जगह global पर सेट करें.

इसका मतलब है कि Firebase AI Logic के लिए उपलब्ध किसी भी इलाके के लिए, ऐप्लिकेशन के अनुरोध में जगह की जानकारी सेट की जा सकती है. इसके बाद, टेंप्लेट उपलब्ध हो जाएगा. global के लिए, ऐप्लिकेशन के अनुरोध में जगह की जानकारी सेट करने की ज़रूरत नहीं है.

हालांकि, अगर आपको अपने टेंप्लेट को सिर्फ़ किसी खास जगह पर उपलब्ध कराना है, तो आपको REST API के ज़रिए टेंप्लेट बनाना होगा और उस खास जगह को साफ़ तौर पर सेट करना होगा. जगह की जानकारी को global के तौर पर सेट न करें.

  1. projects.locations.templates.create एंडपॉइंट को कॉल करके टेंप्लेट बनाएं. PromptTemplate बनाते समय , टेंप्लेट के location (उदाहरण के लिए, europe-west4) के बारे में बताएं.

  2. अपने ऐप्लिकेशन के अनुरोध में, पक्का करें कि मॉडल को ऐक्सेस करने की जगह, टेंप्लेट (eu) की जगह से मेल खाती हो.

इन बातों का ध्यान रखें:

  • Firebase कंसोल में टेंप्लेट की सूची में सिर्फ़ वे टेंप्लेट दिखते हैं जो कम से कम global लोकेशन में उपलब्ध हैं.

  • अगर किसी खास जगह (जो नहीं global है) पर टेंप्लेट उपलब्ध कराने के लिए REST API का इस्तेमाल किया जाता है, तो आपके ऐप्लिकेशन के अनुरोध में मॉडल को ऐक्सेस करने की जगह, टेंप्लेट के लिए सेट की गई जगह से ज़रूर मेल खानी चाहिए. अगर जगह की जानकारी मेल नहीं खाती है, तो अनुरोध पूरा नहीं किया जा सकेगा. ऐसा, क्षेत्र के हिसाब से डेटा को अलग रखने की नीतियों की वजह से होगा.

टेंप्लेट को फ़ाइल के तौर पर उपलब्ध कराएं

projects.locations.templates.create एंडपॉइंट को कॉल करके, सर्वर प्रॉम्प्ट टेंप्लेट फ़ाइल का कॉन्टेंट दिया जा सकता है.