चैट में कुंजियाँ पेस्ट किए बिना सीक्रेट्स और एनवायरनमेंट वेरिएबल

ज़्यादातर असली ऐप्स को कम से कम एक सीक्रेट चाहिए होता है: पेमेंट प्रोवाइडर की कुंजी, ईमेल सेवा की कुंजी, या किसी AI API की कुंजी। Mythex में आप इन्हें प्रॉम्प्ट में पेस्ट नहीं करते। जब एजेंट को कोई कुंजी चाहिए, तो वह चैट में एक सीक्रेट अनुरोध कार्ड दिखाता है, आप वैल्यू कार्ड में टाइप करते हैं, और वह एक प्रोजेक्ट सीक्रेट के रूप में सेव हो जाती है, जिसे आपका ऐप पढ़ सकता है। इस पूरी प्रक्रिया में कुंजी बातचीत में नहीं आती।

यह क्या करता है

हर Mythex प्रोजेक्ट में एनवायरनमेंट वेरिएबल सेव किए जा सकते हैं: नाम वाली वैल्यू, जैसे STRIPE_SECRET_KEY, जिसे आपका ऐप चलते समय पढ़ता है, बजाय इसके कि वे कोड में लिखे हों। सीक्रेट वे एनवायरनमेंट वेरिएबल हैं जिनकी वैल्यू गोपनीय रहनी चाहिए।

ये वैल्यू दो जगह उपलब्ध होती हैं:

• सैंडबॉक्स, जहाँ एजेंट आपके काम के दौरान ऐप बनाता और चलाता है।
• आपके पब्लिश किए गए डिप्लॉयमेंट, जहाँ विज़िटर ऐप इस्तेमाल करते हैं।

इन्हें जोड़ने के तीन तरीके हैं:

1. सीक्रेट अनुरोध कार्ड, जिसे एजेंट चैट में तब दिखाता है जब किसी काम को पूरा करने के लिए कुंजी चाहिए।
2. प्रोजेक्ट सेटिंग्स → Secrets, जहाँ आप कभी भी वैल्यू जोड़ या बदल सकते हैं।
3. चैट में /secrets, जिससे अनुरोध पर सीक्रेट जोड़े या अपडेट किए जा सकते हैं।

यह क्यों मददगार है

AI एजेंट को कुंजी देने का सबसे आसान तरीका है उसे अपने संदेश में पेस्ट कर देना। इससे काम तो हो जाता है, लेकिन कुंजी आपकी चैट हिस्ट्री का हिस्सा बन जाती है, और आपकी बाकी बातों के बगल में साफ़ टेक्स्ट में पड़ी रहती है।

सीक्रेट कार्ड वैल्यू को ट्रांसक्रिप्ट से बाहर रखता है। आप वैल्यू कार्ड के फ़ील्ड में डालते हैं, मैसेज बॉक्स में नहीं, और वह एक प्रोजेक्ट सीक्रेट के रूप में सेव होती है। एजेंट सैंडबॉक्स में कुंजी उपलब्ध होने के साथ आगे बढ़ता है।

कोड की जगह प्रोजेक्ट सेटिंग्स में कुंजियाँ रखने के और भी फ़ायदे हैं:

• कुंजियाँ सोर्स कंट्रोल से बाहर रहती हैं। आपका कोड कुंजी को नाम से बताता है; वैल्यू प्रोजेक्ट सेटिंग्स में रहती है।
• एजेंट और आपका चलता ऐप एक ही कॉन्फ़िगरेशन देखते हैं। कोई कॉपी नहीं होती जो पुरानी पड़ जाए।
• कोड बदले बिना कुंजी बदली जा सकती है। सेटिंग्स में वैल्यू बदलें; कोड अब भी उसे नाम से पढ़ता है।

अगर एनवायरनमेंट वेरिएबल आपके लिए नए हैं, तो हमारी गाइड एनवायरनमेंट वेरिएबल और सीक्रेट्स क्या होते हैं इस विचार को शुरू से समझाती है।

सीक्रेट कार्ड कैसे इस्तेमाल करें

1. फ़ीचर माँगें — जैसे, "जब कोई साइन अप करे तो स्वागत ईमेल भेजो"।
2. जब एजेंट को कुंजी चाहिए, तो चैट में एक सीक्रेट अनुरोध कार्ड दिखता है, जिसमें वह वैल्यू लिखी होती है जो उसे चाहिए।
3. वैल्यू कार्ड के फ़ील्ड में डालें, मैसेज बॉक्स में नहीं।
4. पुष्टि करें। वैल्यू प्रोजेक्ट सीक्रेट के रूप में सेव हो जाती है।
5. एजेंट आगे बढ़ता है, सैंडबॉक्स में कुंजी उपलब्ध होने के साथ।

सीक्रेट खुद कैसे जोड़ें

1. प्रोजेक्ट सेटिंग्स खोलें, फिर Secrets।
2. STRIPE_SECRET_KEY, OPENAI_API_KEY, या अपनी सेवा की क्रेडेंशियल जैसी कुंजियाँ जोड़ें।
3. एजेंट से कहें कि उन्हें आपके फ़्रेमवर्क के सामान्य तरीके से पढ़े, जैसे Node ऐप में process.env से।
4. अगर पब्लिश किए गए ऐप को नई वैल्यू चाहिए, तो दोबारा पब्लिश करें।

आप चैट में /secrets टाइप करके भी इन्हें जोड़ या अपडेट कर सकते हैं।

पब्लिश किए गए ऐप में सीक्रेट बदलना

पब्लिश किया गया ऐप सीक्रेट उसके पब्लिश होने के समय लेता है। किसी सीक्रेट को जोड़ने या बदलने के बाद फिर से पब्लिश करें, ताकि लाइव डिप्लॉयमेंट को नई वैल्यू मिले। तब तक विज़िटर पुरानी कॉन्फ़िगरेशन वाले ऐप का इस्तेमाल करते रहेंगे।

सुरक्षा के सुझाव

• सीक्रेट कभी रिपॉज़िटरी में कमिट न करें। उन्हें प्रोजेक्ट सेटिंग्स में रखें।
• विशेषाधिकार वाले काम के लिए सर्वर-only कुंजियाँ रखें। जो कुंजी कार्ड चार्ज कर सकती है या ईमेल भेज सकती है, वह सर्वर पर चलने वाले कोड में होनी चाहिए, किसी ऐसी चीज़ में नहीं जो विज़िटर के ब्राउज़र में डाउनलोड हो।
• अगर कोई कुंजी कभी चैट हिस्ट्री में दिख जाए, तो उसे रोटेट करें। प्रोवाइडर पर नई कुंजी बनाएँ, पुरानी रद्द करें, और प्रोजेक्ट सेटिंग्स में वैल्यू अपडेट करें। चैट में पेस्ट की गई हर कुंजी को उजागर माना जाए।

सीमाएँ

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

पब्लिश से पहले ऐप को सुरक्षित रखने के बारे में और जानने के लिए, AI से बने ऐप्स के लिए सुरक्षा चेकलिस्ट देखें।

विस्तृत जानकारी डॉक्स में है: एनवायरनमेंट वेरिएबल और सीक्रेट्स और चैट में सीक्रेट्स।