Firebase AI Logic के लिए, Firebase कंसोल में आपको एक गाइडेड यूज़र इंटरफ़ेस (यूआई) मिलता है. इसकी मदद से, टेंप्लेट का कॉन्टेंट तय किया जा सकता है. हालांकि, ऐसे कई इस्तेमाल के उदाहरण हैं जहां आपको टेंप्लेट सेट अप करने के लिए, ज़्यादा बेहतर तरीकों की ज़रूरत पड़ सकती है. इनमें ये शामिल हैं:
इस पेज पर बताए गए ऐडवांस वर्कफ़्लो, Firebase AI Logic REST API का इस्तेमाल करते हैं.
REST API इस्तेमाल करने के बारे में अहम जानकारी
अगर कोई टेंप्लेट अनलॉक है, तो अपने REST API कॉल में उसी टेंप्लेट आईडी का इस्तेमाल करके, टेंप्लेट को बदला जा सकता है. लॉक किए गए टेंप्लेट को बदला नहीं जा सकता.
जब REST API के ज़रिए सर्वर प्रॉम्प्ट टेंप्लेट बनाया जाता है और उसकी जगह की जानकारी
globalपर सेट की जाती है, तो सर्वर प्रॉम्प्ट टेंप्लेट सभी जगहों (इसमेंglobalभी शामिल है) में अपने-आप उपलब्ध हो जाता है. साथ ही, इसका इस्तेमाल Gemini API की दोनों कंपनियों के साथ किया जा सकता है. हालांकि, अगर REST API के ज़रिए टेंप्लेट बनाते समय कोई दूसरी जगह सेट की जाती है, तो टेंप्लेट Vertex AI Gemini API के लिए सिर्फ़ उपलब्ध होगा. इस पेज पर आगे, किसी टेंप्लेट के लिए कोई खास जगह सेट करने के बारे में ज़्यादा जानें.ध्यान दें कि Firebase कंसोल में गाइडेड यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करने पर, टेंप्लेट सभी जगहों (इसमें
globalभी शामिल है) पर अपने-आप उपलब्ध हो जाता है. साथ ही, इसका इस्तेमाल Gemini API उपलब्ध कराने वाली दोनों कंपनियों के साथ किया जा सकता है.REST API के ज़रिए
templateGenerateContentयाtemplateStreamGenerateContentअनुरोध में सर्वर प्रॉम्प्ट टेंप्लेट को ऐक्सेस करने के लिए, आपको Gemini API सेवा देने वाली कंपनी के हिसाब से एंडपॉइंट का इस्तेमाल करना होगा (Gemini Developer API | Vertex AI Gemini API).
(Vertex AI Gemini API सिर्फ़) किसी टेंप्लेट के लिए कोई जगह सेट करना
यह सेक्शन इन स्थितियों पर लागू होता है:
आपके ऐप्लिकेशन के इस्तेमाल के उदाहरण में, जगह की जानकारी के आधार पर काम करने की ज़रूरी शर्तें हैं.
आपके ऐप्लिकेशन के अनुरोध, Vertex AI Gemini API का इस्तेमाल करते हैं. साथ ही, आपको मॉडल को ऐक्सेस करने के लिए जगह की जानकारी देनी होती है.
इस पेज पर पहले बताया गया है कि अगर आपने इनमें से कोई एक काम किया है, तो सभी Firebase AI Logic के लिए उपलब्ध इलाकों (global भी शामिल है) में, सर्वर प्रॉम्प्ट टेंप्लेट अपने-आप उपलब्ध हो जाता है:
- Firebase कंसोल में, निर्देशों के साथ दिए गए यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके टेंप्लेट बनाएं.
- REST API की मदद से टेंप्लेट बनाएं और उसकी जगह
globalपर सेट करें.
इसका मतलब है कि Firebase AI Logic के लिए उपलब्ध किसी भी इलाके के लिए, ऐप्लिकेशन के अनुरोध में जगह की जानकारी सेट की जा सकती है. इसके बाद, टेंप्लेट उपलब्ध हो जाएगा.
आपको global से किए गए अनुरोध में, अपने ऐप्लिकेशन की जगह की जानकारी सेट करने की ज़रूरत नहीं है.
हालांकि, अगर आपको अपने टेंप्लेट को सिर्फ़ किसी खास जगह पर उपलब्ध कराना है, तो आपको REST API के ज़रिए टेंप्लेट बनाना होगा और उस खास जगह को साफ़ तौर पर सेट करना होगा. जगह की जानकारी को global के तौर पर सेट न करें.
projects.locations.templates.createएंडपॉइंट को कॉल करके टेंप्लेट बनाएं.PromptTemplateबनाते समय, टेंप्लेट काlocationतय करें. उदाहरण के लिए,location.europe-west4अपने ऐप्लिकेशन के अनुरोध में, पक्का करें कि मॉडल को ऐक्सेस करने की जगह, टेंप्लेट (
europe-west4) की जगह से मेल खाती हो.
इन बातों का ध्यान रखें:
Firebase कंसोल में मौजूद टेंप्लेट की सूची में सिर्फ़ वे टेंप्लेट दिखते हैं जो
globalलोकेशन में कम से कम प्रोविज़न किए गए हैं.अगर किसी खास जगह (जो नहीं
globalहै) पर टेंप्लेट उपलब्ध कराने के लिए REST API का इस्तेमाल किया जाता है, तो आपके ऐप्लिकेशन के अनुरोध में मॉडल को ऐक्सेस करने की जगह, टेंप्लेट के लिए सेट की गई जगह से ज़रूर मेल खानी चाहिए. अगर जगहें मेल नहीं खाती हैं, तो अनुरोध पूरा नहीं किया जा सकेगा. ऐसा रीजनल आइसोलेशन की नीतियों की वजह से होगा.
टेंप्लेट को फ़ाइल के तौर पर उपलब्ध कराएं
projects.locations.templates.create एंडपॉइंट को कॉल करके, सर्वर प्रॉम्प्ट टेंप्लेट फ़ाइल का कॉन्टेंट दिया जा सकता है.