संगठन और भूमिकाएँ - Entity Enricher दस्तावेज़ीकरण

संगठन और भूमिकाएँ

Entity Enricher संगठन-आधारित मल्टी-टेनेंसी का उपयोग करता है। प्रत्येक उपयोगकर्ता एक संगठन से संबंधित होता है, और सभी डेटा — रिकॉर्ड, स्कीमा, API keys — प्रति संगठन पृथक रहता है।

मल्टी-टेनेंसी

संगठन डेटा आइसोलेशन के लिए शीर्ष-स्तरीय सीमा हैं। जब आप साइन अप करते हैं, तो आप एक नया संगठन बनाते हैं या किसी मौजूदा में शामिल होते हैं। सभी एनरिचमेंट रिकॉर्ड, स्कीमा और API कुंजियाँ आपके संगठन की होती हैं और टीम सदस्यों को उनकी भूमिका के आधार पर सुलभ होती हैं।

संगठन में क्या शामिल होता है

Enrichment रिकॉर्डसभी एनरिचमेंट परिणाम, प्रॉम्प्ट और लागत डेटा
सेव किए गए स्कीमाटीम सदस्यों द्वारा बनाए या जनरेट किए गए JSON schemas
API कुंजियाँप्रोग्रामेटिक इंटीग्रेशन के लिए संगठन एक्सेस कीज़
प्रोवाइडर कीज़प्रति-ऑर्गनाइज़ेशन बिलिंग के लिए LLM प्रोवाइडर API की
उपयोगकर्ताभूमिका-आधारित अनुमतियों वाले टीम सदस्य
सेटिंग्ससंगठन प्राथमिकताएँ और उपयोग सीमाएँ
सिमैंटिक कॉन्सेप्टस्थिर एंटिटी पहचानों की वह शब्दावली जिसके विरुद्ध आपके एनरिचमेंट रिज़ॉल्व होते हैं
Database Syncsरजिस्टर किए गए कंज़्यूमर डेटाबेस और उनके कतारबद्ध डेल्टा
बेंचमार्क परिदृश्यसेव किए गए मॉडल टेस्ट और उनके परिणाम, उन सहित जिनका उपयोग मॉडल चयन को स्कोर करने में होता है
क्रेडिट और बिलिंगप्लान, क्रेडिट बैलेंस, और उस पर हुआ हर लेन-देन

भूमिका पदानुक्रम

Entity Enricher 4-स्तरीय भूमिका पदानुक्रम का उपयोग करता है। प्रत्येक भूमिका में उसके नीचे की भूमिकाओं की सभी अनुमतियाँ शामिल होती हैं:

सिस्टम एडमिनस्तर 5 · सिस्टम-व्यापी
  • सिस्टम भर के सभी organizations और उपयोगकर्ताओं का प्रबंधन करें
  • क्रॉस-organization डेटा एक्सेस और रिपोर्टिंग
  • इंटरैक्टिव API दस्तावेज़ीकरण तक पहुँच (Swagger UI, ReDoc)
  • पूरा सिस्टम कॉन्फ़िगरेशन नियंत्रण
स्वामीस्तर 4 · संगठन
  • organization पर पूर्ण नियंत्रण
  • टीम सदस्यों का प्रबंधन करें: आमंत्रित करें, स्वीकृत करें, भूमिकाएँ बदलें, निष्क्रिय करें
  • API की बनाएँ और प्रबंधित करें (organization एक्सेस की सहित)
  • ऑर्गनाइज़ेशन सेटिंग्स और प्रोवाइडर API कीज़ कॉन्फ़िगर करें
  • बिलिंग प्रबंधित करें: प्लान, क्रेडिट खरीद और इनवॉइस इतिहास
  • संगठन-व्यापी डिफ़ॉल्ट सेट करें: प्रति कार्य पसंदीदा मॉडल, बेंचमार्क स्कोर वेट, एम्बेडिंग मॉडल
  • organization हटाएँ (अंतिम मालिक के रूप में)
एडिटरस्तर 2 · संगठन
  • एनरिचमेंट रन करें (सिंगल और बैच)
  • schemas बनाएँ, संपादित करें और हटाएँ
  • AI स्कीमा जनरेशन और एडिटिंग का उपयोग करें
  • सभी organization records और लागत देखें
ऑपरेटरस्तर 1 · संगठन
  • मौजूदा स्कीमा का उपयोग करके एनरिचमेंट रन करें (रीड-ओनली स्कीमा एक्सेस)
  • records और लागत डैशबोर्ड देखें
  • models चुनें और enrichment विकल्प कॉन्फ़िगर करें

इंडिविजुअल और बिज़नेस अकाउंट

हर संगठन दो प्रकारों में से एक होता है, और इस पेज पर आगे जो कुछ बताया गया है — जॉइन करना, अप्रूव करना, रोल्स — वह ज़्यादातर सिर्फ़ दूसरे प्रकार पर लागू होता है।

इंडिविजुअल — एक व्यक्तिगत वर्कस्पेस

साइन अप करते समय आपके लिए अपने आप बनाया जाता है, आपके अकाउंट के नाम पर। इसमें ठीक एक ही सदस्य होता है, यह जॉइन सर्च से छिपा रहता है और डायरेक्ट लिंक से भी जॉइन रिक्वेस्ट स्वीकार नहीं करता, और जहाँ बिज़नेस अकाउंट अपना Users पेज दिखाता है वहाँ यह अपग्रेड प्रॉम्प्ट दिखाता है। इसके अलावा कुछ भी कम नहीं है: स्कीमा, एनरिचमेंट, database syncs और बिलिंग सब एक जैसे ही काम करते हैं।

Business — एक साझा टेनेंट

बहु-उपयोगकर्ता संगठन: जॉइन सर्च में खोजा जा सकने वाला, जॉइन अनुरोध, भूमिकाओं और स्वामी की स्वीकृति के साथ। स्वामी संगठन सेटिंग्स से किसी भी दिशा में बदलाव कर सकता है — हालाँकि जब तक अन्य सदस्य मौजूद हैं, व्यक्तिगत पर लौटना अस्वीकार कर दिया जाता है, क्योंकि इससे वे अधर में रह जाएँगे।

पंजीकरण

Firebase authentication के ज़रिए Google, GitHub या ईमेल से साइन अप करें। आपको तुरंत एक व्यक्तिगत वर्कस्पेस मिल जाता है; वहाँ से आप एक बिज़नेस संगठन बना सकते हैं या किसी में शामिल होने का अनुरोध कर सकते हैं। नीचे दी गई खोज में केवल बिज़नेस संगठन दिखाई देते हैं।

Organization बनाएँ

  1. अपने identity provider से साइन अप करें
  2. एक ऑर्गनाइजेशन नाम और URL-सुरक्षित slug चुनें
  3. आप नए organization के owner बन जाते हैं
  4. यदि अभी तक कोई सिस्टम एडमिन मौजूद नहीं है, तो आप सिस्टम एडमिन बन जाते हैं

Organization में शामिल हों

  1. नाम या slug से संगठन खोजें
  2. जॉइन अनुरोध सबमिट करें
  3. यदि संगठन के पास कोई सक्रिय owner नहीं है, तो आपको स्वतः owner के रूप में स्वीकृत कर दिया जाता है
  4. अन्यथा, आपका अनुरोध तब तक लंबित रहता है जब तक कोई स्वामी इसे स्वीकृत नहीं कर देता

उपयोगकर्ता स्थितियाँ

किसी organization में शामिल होते समय उपयोगकर्ता एक अनुमोदन वर्कफ़्लो से गुज़रते हैं:

स्थितिअर्थलॉग इन कर सकते हैं?
सक्रियनिर्दिष्ट भूमिका के आधार पर सिस्टम तक पूर्ण पहुँचहाँ
लंबितशामिल होने का अनुरोध सबमिट किया गया, owner की स्वीकृति की प्रतीक्षा हैनहीं
अस्वीकृतशामिल होने का अनुरोध किसी owner द्वारा अस्वीकार कर दिया गयानहीं
निष्क्रिय किया गयाखाता अक्षम कर दिया गया था (सॉफ़्ट डिलीट, ऑडिट ट्रेल को संरक्षित रखता है)नहीं

संगठन छोड़ना

कोई भी उपयोगकर्ता अपने ऑर्गनाइज़ेशन को छोड़ सकता है। व्यवहार स्वामित्व पर निर्भर करता है:

नियमित सदस्य

आपका खाता निष्क्रिय कर दिया गया है और आप साइन आउट हो गए हैं। ऑडिट उद्देश्यों के लिए आपके enrichment record organization में बने रहते हैं।

अंतिम स्वामी

यदि आप एकमात्र शेष owner हैं, तो आपको organization हटाने की पुष्टि करनी होगी। Enrichment record और schema अलग कर दिए जाते हैं (हटाए नहीं जाते), जबकि users, API keys, और provider keys organization के साथ हटा दिए जाते हैं।

उपयोगकर्ता प्रबंधन

स्वामी अपनी टीम प्रबंधित करने के लिए यूज़र मैनेजमेंट पेज खोलते हैं, और सिस्टम एडमिन को एक टैब अधिक दिखता है:

सक्रिय उपयोगकर्तासभी सक्रिय टीम सदस्यों को देखें, भूमिकाएँ बदलें, खाते निष्क्रिय करें, या उन्हें स्थायी रूप से विलोपित करें
लंबित अनुरोधनए उपयोगकर्ताओं के जॉइन अनुरोधों की समीक्षा करें और स्वीकृत या अस्वीकृत करें
संगठनकेवल सिस्टम एडमिन के लिए: प्लेटफ़ॉर्म का हर संगठन, उसके प्लान और क्रेडिट बैलेंस के साथ — प्लान असाइन करें, क्रेडिट दें, या किसी उपयोगकर्ता को दूसरे संगठन में ले जाएँ

सुरक्षा नियम:

  • उपयोगकर्ता स्वयं को निष्क्रिय या विलोपित नहीं कर सकते
  • स्थायी विलोपन खाते और उसकी साइन-इन पहचान को हमेशा के लिए हटा देता है; enrichment record और schema रखे जाते हैं लेकिन उनका लेखक हट जाता है
  • उपयोगकर्ता स्वयं को अपनी वर्तमान भूमिका से नीचे नहीं कर सकते
  • किसी संगठन के भीतर केवल स्वामी ही अन्य सदस्यों को प्रमोट या डिमोट कर सकते हैं; सिस्टम-एडमिन भूमिका देना केवल मौजूदा सिस्टम एडमिन के लिए आरक्षित है

संगठन सेटिंग्स

Settings पेज वह जगह है जहाँ owner खुद ऑर्गनाइज़ेशन को कॉन्फ़िगर करता है, दो हिस्सों में:

पहचान और संपर्क

संगठन का प्रदर्शित नाम, संपर्क विवरण और डाक पता, तथा उसका खाता प्रकार (व्यक्तिगत या व्यावसायिक)। URL slug एक बार बन जाने के बाद तय हो जाता है, क्योंकि लिंक और इंटीग्रेशन उसी पर आधारित होते हैं।

डिफ़ॉल्ट

ऐसे विकल्प जो किसी एक रन पर नहीं, बल्कि संगठन के सभी लोगों पर लागू होते हैं: हर टास्क के लिए एक पसंदीदा मॉडल (जब भी रिक्वेस्ट में कोई मॉडल नहीं बताया जाता, तब इस्तेमाल होता है), मॉडलों की रैंकिंग में क्वालिटी, स्पीड और लागत को कितना महत्व दिया जाए, और वह एम्बेडिंग मॉडल जिसके सापेक्ष सिमेंटिक ID रिज़ॉल्व होती हैं। डिफ़ॉल्ट एक प्लान फ़ीचर हैं — जिन प्लान में यह नहीं है, वहाँ यह सेक्शन केवल-पढ़ने योग्य रहता है।

प्रमाणीकरण

Entity Enricher कई प्रमाणीकरण विधियों का समर्थन करता है:

सोशल लॉगिन

Firebase के माध्यम से Google या GitHub से साइन इन करें। कोई पासवर्ड ज़रूरी नहीं।

ईमेल + पासवर्ड

Firebase के माध्यम से पारंपरिक ईमेल और पासवर्ड प्रमाणीकरण।

API कुंजियाँ

CI/CD और सर्विस इंटीग्रेशन के लिए प्रोग्रामैटिक एक्सेस कीज़।

प्रमाणीकरण के बाद, बैकएंड अल्पकालिक JWT एक्सेस टोकन (15 मिनट) और दीर्घकालिक रिफ्रेश टोकन (7 दिन) जारी करता है। प्रोग्रामेटिक एक्सेस के बारे में API Keys गाइड में और जानें।

अगले चरण