GuidesOneMux

ग्राहक सहायता ट्रायेज के लिए OpenAI API कुंजियाँ सुरक्षित रखें

ग्राहक सहायता ट्रायेज में OpenAI के सुरक्षित उपयोग की व्यावहारिक प्रक्रिया: API कुंजियों की सुरक्षा करें, लॉग से संवेदनशील जानकारी हटाएँ, अनुमतियाँ सीमित रखें, क्रेडेंशियल बदलें और मानव अनुमोदन अनिवार्य करें।

AI

सारांश · TL;DR

ग्राहक सहायता ट्रायेज के लिए OpenAI एप्लिकेशन कुंजी को किसी विश्वसनीय सर्वर-साइड घटक में रखें, केवल न्यूनतम और संवेदनशील जानकारी से मुक्त केस विवरण भेजें, रहस्यों या पूरी बातचीत के बजाय फ़ैसलों का लॉग रखें और ग्राहक को प्रभावित करने वाली कार्रवाइयों के लिए मानव अनुमोदन अनिवार्य करें। अलग-अलग वर्कलोड के लिए पृथक, न्यूनतम-अधिकार वाले क्रेडेंशियल इस्तेमाल करें और उन्हें बदलने या रद्द करने की प्रक्रिया दर्ज करें।

मुख्य बातें

  • एप्लिकेशन API कुंजी को एजेंट-जनरेट किए गए कोड, ब्राउज़र, कंटेनर इमेज, सोर्स कंट्रोल या लॉग में न रखें।
  • सपोर्ट केस मॉडल को भेजने से पहले निजी और गोपनीय जानकारी हटाएँ; बाद में आप जो डेटा रखते हैं, उसे भी न्यूनतम करें।
  • मॉडल को श्रेणी, प्राथमिकता और ड्राफ़्ट सुझाने दें—मानव अनुमोदन के बिना केस बंद न करें, रिफ़ंड जारी न करें या जवाब न भेजें।
  • वर्कलोड के अनुसार क्रेडेंशियल अलग रखें, केवल ज़रूरी API अनुमतियाँ दें और कुंजी बदलने व रद्द करने की प्रक्रिया का अभ्यास करें।
इस पृष्ठ पर (7)

सबसे सुरक्षित तरीका: मॉडल से सलाह लें, कार्रवाई नहीं

ग्राहक सहायता ट्रायेज में आम तौर पर पहला उपयोगी कदम वर्गीकरण और सारांश बनाना होता है—स्वचालित रूप से समस्या हल करना नहीं। मॉडल कतार, तात्कालिकता और संक्षिप्त सारांश सुझा सकता है, जबकि सपोर्ट एजेंट साक्ष्यों की जाँच करके आगे की कार्रवाई तय करता है।

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

नीचे दिए गए उदाहरण केवल समझाने के लिए हैं; इनका कॉन्फ़िगरेशन जाँचा हुआ नहीं है। इन्हें अपने API क्लाइंट, गोपनीयता संबंधी ज़रूरतों और सपोर्ट सिस्टम के अनुसार ढालें।

ट्रायेज का एक न्यूनतम फ़्लो

  1. आपका सपोर्ट सिस्टम केस प्राप्त करता है और ट्रायेज के लिए गैर-ज़रूरी फ़ील्ड हटाता है।
  2. विश्वसनीय बैकएंड संवेदनशील मानों को हटाकर बचा हुआ टेक्स्ट सर्वर-साइड क्रेडेंशियल से OpenAI को भेजता है।
  3. मॉडल प्रस्तावित श्रेणी, प्राथमिकता और छोटा सारांश लौटाता है।
  4. आपका एप्लिकेशन यह प्रस्ताव किसी अधिकृत सपोर्ट एजेंट को दिखाता है। एजेंट अगली कार्रवाई को मंज़ूर या संपादित करता है।
  5. आपका सिस्टम रहस्य या पूरी बातचीत को अनावश्यक रूप से दोबारा सहेजे बिना फ़ैसले और ज़रूरी ऑडिट मेटाडेटा दर्ज करता है।

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

# Illustrative pseudocode: provide an already-redacted case to your API client.
# Keep credential loading and the API call in a trusted backend service.

def propose_triage(api_client, redacted_case):
    response = api_client.create_response(
        instructions=(
            "Suggest a support category, priority, and concise summary. "
            "Do not claim to have resolved the case or send a reply. "
            "If information is insufficient, say what is missing."
        ),
        input=redacted_case,
    )
    return response

यह उदाहरण OpenAI SDK में सीधे इस्तेमाल करने योग्य नहीं है: मेथड के नाम और अनुरोध फ़ील्ड आपके क्लाइंट और इस्तेमाल किए जाने वाले API endpoint पर निर्भर करते हैं। लागू करने से पहले endpoint, समर्थित पैरामीटर और प्रतिक्रिया फ़ॉर्मैट के लिए मौजूदा API संदर्भ देखें। मॉडल के आउटपुट को सपोर्ट कार्रवाई करने की अनुमति न मानें।

कुंजियाँ और अनुमतियाँ अलग रखें

जहाँ व्यावहारिक हो, अलग-अलग एप्लिकेशन या वर्कलोड के लिए अलग क्रेडेंशियल इस्तेमाल करें। इससे गलती का दायरा सीमित रहता है और असंबंधित सेवाओं को बाधित किए बिना किसी एक क्रेडेंशियल को रद्द करना आसान होता है। कुंजी तक पहुँच केवल उस सिस्टम को दें जिसे इसकी ज़रूरत है; इसे प्रबंधित secrets store या ऐसे ही सुरक्षित सर्वर-साइड साधन में रखें और केवल अनुरोध करने वाले विश्वसनीय घटक को उपलब्ध कराएँ।

OpenAI के मार्गदर्शन में बताए गए Agents API परिवेश के लिए, sessions हेतु एप्लिकेशन कुंजी को api.agents.read और api.agents.write, तथा inference के लिए api.responses.write की ज़रूरत होती है। Vault प्रबंधन के लिए api.vaults.read और api.vaults.write आवश्यक हैं। मार्गदर्शिका environment key और application key में अंतर बताती है: environment key से परिवेशों को कनेक्ट किया जा सकता है, लेकिन इससे अन्य API कार्रवाइयों की अनुमति नहीं मिलती। जिन API सुविधाओं का आप वास्तव में इस्तेमाल करते हैं, उन्हीं के लिए आवश्यक अनुमतियाँ दें; जो ट्रायेज सेवा vault प्रबंधित नहीं करती, उसे vault अनुमतियाँ न दें।

अगर agent environment या sandbox का इस्तेमाल हो रहा है, तो उसमें उपलब्ध किसी भी चीज़ को एजेंट-जनरेट कोड के लिए सुलभ मानें। तीसरे पक्ष के क्रेडेंशियल के लिए मार्गदर्शन उन्हें परिवेश से बाहर रखने और ज़रूरत के अनुसार विश्वसनीय proxy या vault-आधारित तरीके का इस्तेमाल करने की सलाह देता है। परिवेश में inject किया गया secret भी वहाँ चल रहे कोड की पहुँच में रहता है।

ऑडिट की उपयोगिता बनाए रखते हुए लॉग से संवेदनशील जानकारी हटाएँ

गलत वर्गीकरण, पहुँच संबंधी समस्याओं और घटनाओं की जाँच में लॉग मददगार होते हैं, लेकिन उन्हें सपोर्ट इनबॉक्स की दूसरी कॉपी नहीं बनना चाहिए। API कुंजियाँ, authorization headers, पूरे प्रॉम्प्ट, ग्राहकों के मूल संदेश या ऐसे मॉडल जवाब लॉग करने से बचें जिनमें संवेदनशील विवरण दोहराए जा सकते हैं।

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

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

कुंजी बदलने और रद्द करने की प्रक्रिया तय करें

कुंजी बदलने की योजना में एक ज़िम्मेदार व्यक्ति का नाम हो और यह बताया गया हो कि क्रेडेंशियल कहाँ रखा है, कौन-सी सेवाएँ इसका इस्तेमाल करती हैं, इसे कौन बदल सकता है और बदलाव की पुष्टि कैसे होगी। एक व्यावहारिक प्रक्रिया यह है:

  1. केवल आवश्यक अनुमतियों वाला नया क्रेडेंशियल बनाएँ।
  2. विश्वसनीय सेवा के secrets store को अपडेट करें और अपनी सामान्य बदलाव प्रक्रिया के ज़रिए उसे deploy या reload करें।
  3. पुष्टि करें कि कोई हानिरहित ट्रायेज अनुरोध सफल होता है और निदान लॉग में क्रेडेंशियल उजागर नहीं होता।
  4. पुराना क्रेडेंशियल रद्द करें और पुष्टि करें कि सेवा अब उस पर निर्भर नहीं है।
  5. तारीख, ज़िम्मेदार व्यक्ति, प्रभावित वर्कलोड और नतीजा दर्ज करें—secret का मान कभी नहीं।

अपने संगठन के जोखिम और परिचालन आवश्यकताओं के अनुरूप नियमित समीक्षा का अंतराल तय करें। अगर कुंजी उजागर होने का संदेह हो, तो उसे तुरंत रद्द करें; अगली निर्धारित रोटेशन तक इंतज़ार न करें। OpenAI का मार्गदर्शन स्पष्ट रूप से ज़रूरत पड़ने पर कुंजियाँ बदलने या रद्द करने और उजागर होने का संदेह होने पर क्रेडेंशियल तुरंत रद्द करने की सलाह देता है।

मानव अनुमोदन और विफलता प्रबंधन

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

अगर API उपलब्ध न हो, प्रतिक्रिया का फ़ॉर्मैट गलत हो या संवेदनशील जानकारी हटाने की प्रक्रिया विफल हो, तो केस को मौजूदा मैन्युअल कतार में भेजें। अनिश्चित वर्गीकरण को चुपचाप स्वचालित कार्रवाई में न बदलें।

चेकलिस्ट

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

मुख्य डिज़ाइन फ़ैसला यह है कि क्रेडेंशियल और महत्वपूर्ण कार्रवाइयाँ मॉडल की पहुँच से बाहर रहें। सपोर्ट काम व्यवस्थित करने के लिए मॉडल का इस्तेमाल करें, उसे दिखाया जाने वाला डेटा न्यूनतम रखें और अंतिम चरण के रूप में मानव अनुमोदन अनिवार्य करें।

सामान्य प्रश्न

क्या मैं OpenAI API कुंजी agent sandbox में रख सकता हूँ?

एप्लिकेशन कुंजी को agent environment में रखने से बचें। OpenAI की sandbox सुरक्षा मार्गदर्शिका कहती है कि एजेंट-जनरेट किया गया कोड परिवेश की फ़ाइलों, क्रेडेंशियल और नेटवर्क तक पहुँच सकता है और एप्लिकेशन कुंजी को इससे बाहर रखने की सलाह देती है। API अनुरोध करने के लिए विश्वसनीय बैकएंड इस्तेमाल करें।

ग्राहक सहायता ट्रायेज लॉग में क्या शामिल होना चाहिए?

केवल संचालन और ऑडिट के लिए ज़रूरी मेटाडेटा रखें—जैसे आंतरिक केस संदर्भ, टाइमस्टैम्प, संवेदनशील जानकारी हटाने की स्थिति, प्रस्तावित श्रेणी, मानव का फ़ैसला और त्रुटि वर्ग। API कुंजियाँ, authorization headers, ग्राहकों के पूरे संदेश और मॉडल के संवेदनशील आउटपुट लॉग न करें।

क्या मॉडल को सपोर्ट जवाब अपने-आप भेजना चाहिए?

मानव-अनुमोदित ट्रायेज वर्कफ़्लो में नहीं। मॉडल आउटपुट को सुझाव मानें और ग्राहक-सामना करने वाली या खाते में बदलाव करने वाली कार्रवाइयों के लिए अधिकृत सपोर्ट एजेंट से समीक्षा और अनुमोदन लें।

OpenAI API कुंजी कब बदलनी चाहिए?

अपने जोखिम और परिचालन आवश्यकताओं के अनुसार नियमित समीक्षा का अंतराल तय करें और ज़रूरत पड़ने पर क्रेडेंशियल बदलें। उजागर होने का संदेह हो तो क्रेडेंशियल तुरंत रद्द करें और उसे बदलने व बदलाव की पुष्टि करने की प्रक्रिया अपनाएँ।

संबंधित लेख

Guides

क्रेडेंशियल उजागर किए बिना OpenAI API की घटनाओं की जाँच

API keys की सुरक्षा, अनुमतियों को सीमित रखने और क्रेडेंशियल बदलने की योजना बनाने के साथ OpenAI API विफलताओं की जाँच के लिए व्यावहारिक मार्गदर्शिका।

阅读全文 →

Guides

मानवीय अनुमोदन वाले सपोर्ट ट्रायेज़ वर्कफ़्लो में OpenAI API विफलताओं का निदान

ग्राहकों तक विफल ट्रायेज़ पहुँचने से रोकते हुए authentication errors, rate limits, timeouts और malformed model responses को संभालने की व्यावहारिक मार्गदर्शिका।

阅读全文 →

Guides

Document-Q&A वर्कफ़्लो में OpenAI API Keys को सुरक्षित रखें

OpenAI के साथ document question answering के लिए एक व्यावहारिक सुरक्षा तरीका: क्रेडेंशियल अलग रखें, अनुमतियाँ सीमित करें, लॉग से संवेदनशील जानकारी हटाएँ और स्रोत attribution बनाए रखते हुए keys को सुरक्षित रूप से rotate करें।

阅读全文 →

Guides

OpenAI API के प्रमाणीकरण, रेट-लिमिट, टाइमआउट और गलत फ़ॉर्मैट वाले रिस्पॉन्स की सुरक्षित जाँच कैसे करें

OpenAI API के प्रमाणीकरण, थ्रॉटलिंग, टाइमआउट और गलत फ़ॉर्मैट वाले रिस्पॉन्स की समस्याओं की जाँच करने की व्यावहारिक, गोपनीयता-सचेत गाइड—बिना क्रेडेंशियल या उपयोगकर्ता डेटा उजागर किए।

阅读全文 →