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