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


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 एंडपॉइंट को कॉल करके, सर्वर प्रॉम्प्ट टेंप्लेट फ़ाइल का कॉन्टेंट उपलब्ध कराया जा सकता है.