Firebase AI Logic के लिए, Firebase कंसोल एक गाइडेड यूज़र इंटरफ़ेस (यूआई) उपलब्ध कराता है. इसकी मदद से, टेंप्लेट का कॉन्टेंट तय किया जा सकता है. हालांकि, ऐसे कई इस्तेमाल के मामले हैं जिनमें आपको टेंप्लेट सेट अप करने के लिए, ज़्यादा बेहतर तरीकों की ज़रूरत पड़ सकती है. इनमें ये शामिल हैं:
इस पेज पर बताए गए, बेहतर वर्कफ़्लो में Firebase AI Logic REST API का इस्तेमाल किया जाता है.
REST API का इस्तेमाल करने के बारे में अहम जानकारी
अगर कोई टेंप्लेट अनलॉक है, तो REST API कॉल में उसी टेंप्लेट आईडी का इस्तेमाल करके, टेंप्लेट को बदला जा सकता है. लॉक किए गए टेंप्लेट को बदला नहीं जा सकता.
REST API की मदद से सर्वर प्रॉम्प्ट टेंप्लेट बनाते समय, अगर उसकी जगह
globalपर सेट की जाती है, तो सर्वर प्रॉम्प्ट टेंप्लेट, सभी जगहों (इनमेंglobalभी शामिल है) पर अपने-आप उपलब्ध हो जाता है. साथ ही, यह both 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 AI Logicglobal
- Firebase कंसोल में गाइडेड यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके टेंप्लेट बनाना.
- REST API की मदद से टेंप्लेट बनाना और उसकी जगह
globalपर सेट करना.
इसका मतलब है कि आपके ऐप्लिकेशन के अनुरोध में, Firebase AI Logic के लिए उपलब्ध किसी भी
इलाके की जगह सेट की जा सकती है. इसके बाद, टेंप्लेट उपलब्ध हो जाएगा.
आपके ऐप्लिकेशन के अनुरोध में, जगह को global पर सेट करना ज़रूरी नहीं है.
हालांकि, अगर आपको अपना टेंप्लेट
सिर्फ़ किसी खास जगह पर उपलब्ध कराना है, तो आपको
REST API की मदद से टेंप्लेट बनाना होगा और उस खास जगह को साफ़ तौर पर सेट करना होगा. जगह को global पर सेट न करें.
projects.locations.templates.createएंडपॉइंट को कॉल करके टेंप्लेट बनाएं. टेंप्लेट काlocationतय करें (उदाहरण के लिए,europe-west4) as part of creating aPromptTemplate.अपने ऐप्लिकेशन के अनुरोध में, पक्का करें कि मॉडल को ऐक्सेस करने की जगह टेंप्लेट (
europe-west4) की जगह से मेल खाती हो.
इन बातों का ध्यान रखें:
Firebase कंसोल में टेंप्लेट की सूची में सिर्फ़ वे टेंप्लेट दिखते हैं जो कम से कम
globalजगह पर उपलब्ध हों.अगर REST API का इस्तेमाल करके, किसी खास जगह (जो
globalनहीं है) पर टेंप्लेट उपलब्ध कराया जाता है, तो आपके ऐप्लिकेशन के अनुरोध में मॉडल को ऐक्सेस करने की जगह, टेंप्लेट के लिए सेट की गई जगह से मेल खानी चाहिए. अगर जगहें मेल नहीं खाती हैं, तो इलाके के हिसाब से आइसोलेशन की नीतियों की वजह से, अनुरोध पूरा नहीं हो पाएगा.
टेंप्लेट को फ़ाइल के तौर पर उपलब्ध कराना
`
projects.locations.templates.create` एंडपॉइंट को कॉल करके, सर्वर प्रॉम्प्ट टेंप्लेट फ़ाइल का कॉन्टेंट उपलब्ध कराया जा सकता है.