Skip to content

Python SDK इंस्टॉल करके पहला रिक्वेस्ट भेजें: 10 मिनट में चलाएँ ​

Key पिछले पाठ में मिल चुका है। इस पाठ में उसे उपयोग करें: typesafe-sdk इंस्टॉलेशन पूरा करें, ऑफिशियल उदाहरण चलाएँ—एक कस्टमर टिकट, एक ही रिक्वेस्ट में तीन सवाल, और तीन जवाब: «किस ग्रुप को भेजें, कस्टमर कितना निराश है, क्या अत्यावश्यक है»। पूरा 10 मिनट।

सीखने के बाद आप क्या कर सकते हैं ​

  • एक अलग वर्चुअल एनवायरनमेंट में typesafe-sdk इंस्टॉलेशन पूरा करें (Python 3.10+)
  • ऑफिशियल टिकट तीन-सवाल उदाहरण चलाएँ, technical / 0.67 / 0.99 तीन लाइन आउटपुट देखें
  • लौटे JSON में choice, score, noul और साथ ही confidence, probabilities पढ़ना समझें
  • जानें कि SDK एनवायरनमेंट वेरिएबल अपने आप पढ़ता है, रेट लिमिट रीट्राय अपने आप संभालता है, कोड में कुंजी नहीं लिखी जाती
  • चल न पाने पर पता हो कि आगे किस पाठ में जाकर जाँच करें

आपकी मौजूदा दिक्कत ​

  • Key मिल गया, लेकिन pip से इंस्टॉल के बाद import पर एरर आता है, समझ नहीं आता कि Python संस्करण की समस्या है या एनवायरनमेंट की
  • उदाहरण चल गया, लेकिन आउटपुट JSON का ढेर है, पता नहीं कौन सा फ़ील्ड «जवाब» है
  • पहले चलाकर देखना चाहते हैं, शुरू में ही पूरा API दस्तावेज़ पढ़ना नहीं चाहते

यह तरीका कब उपयोग करें ​

जब आपको चाहिए:

  • अपने कंप्यूटर पर Python से Jev कॉल करना, पहला वास्तविक रिक्वेस्ट चलाना
  • एक साफ़ तरीका जो सिस्टम Python को प्रदूषित न करे

और नहीं चाहते:

  • SDK को सिस्टम Python में इंस्टॉल करना, जो अन्य प्रोजेक्ट से टकराए
  • शुरू में ही HTTP रिक्वेस्ट, ऑथेंटिकेशन हेडर और रीट्राय लॉजिक हाथ से लिखना

🎒 शुरू करने से पहले की तैयारी ​

  • पिछले पाठ की Key एनवायरनमेंट वेरिएबल में सहेजी गई है TYPESAFE_API_KEY
  • Python 3.10 या उससे ऊपर (ऑफिशियल SDK की संस्करण आवश्यकता; टर्मिनल में python3 --version से देखें)
  • pip इंस्टॉल है (ऑफिशियल दस्तावेज़ pip के ऑफिशियल इंस्टॉलेशन पेज से लिंक करता है, इंस्टॉल न हो तो पहले इंस्टॉल करें)
  • कमांड लाइन Bash (macOS / Linux / Windows WSL—ऑफिशियल क्विक स्टार्ट के कमांड इसी एनवायरनमेंट के लिए लिखे गए हैं)

मुख्य विचार ​

क्या इंस्टॉल करें। ऑफिशियल Python SDK का pip पैकेज नाम typesafe-sdk है, import नाम typesafe_sdk है। यह «HTTP रिक्वेस्ट जोड़ना, ऑथेंटिकेशन जोड़ना, कंप्रेशन, रेट लिमिट रीट्राय» सब संभाल लेता है, आप केवल state और सवाल लिखें।

venv क्यों। ऑफिशियल क्विक स्टार्ट का pip रास्ता ही «venv + pip» है: वर्चुअल एनवायरनमेंट SDK को प्रोजेक्ट डायरेक्टरी के .venv में इंस्टॉल करता है, सिस्टम Python को नहीं छूता, फ़ोल्डर मिटाना ही साफ़ अनइंस्टॉल है।

पहला रिक्वेस्ट कैसा दिखता है। ऑफिशियल उदाहरण एक कस्टमर टिकट को state बनाता है, एक ही रिक्वेस्ट में तीन सवाल पूछता है:

सवालप्रश्न-प्रकारलौटा फ़ील्ड
यह टिकट किस ग्रुप के पास जाएChoicechoice + हर विकल्प का probabilities + confidence
कस्टमर कितना निराश लगता हैScorescore(0–2, दो स्तरों के बीच भी आ सकता है) + confidence
क्या अत्यावश्यक हैNoulnoul(0–1 की प्रोबेबिलिटी)

तीनों सवाल एक ही state पर समानांतर मूल्यांकन होते हैं, एक बार में सब लौटते हैं—यही Jev का मुख्य काम करने का तरीका है, आगे समानांतर प्रश्न पाठ इसे चरम पर उपयोग करेगा।

SDK आपके लिए तीन काम करता है।

कामSDK का तरीका
ऑथेंटिकेशनएनवायरनमेंट वेरिएबल अपने आप पढ़ता है TYPESAFE_API_KEY
मॉडल चुननाmodel="jev-latest"; न बताएँ तो SDK का डिफ़ॉल्ट भी jev-latest है (अभी Jev 1.14 की ओर)
रेट लिमिट रीट्राय429 मिलने पर डिफ़ॉल्ट रूप से अपने आप रीट्राय, प्रतीक्षा समय हर बार बढ़ता है, और retry-after का पालन करता है

सफलता का मापदंड। ऑफिशियल उदाहरण का अपेक्षित आउटपुट तीन लाइन है:

text
technical
0.67
0.99

ऑफिशियल तौर पर यह भी कहा गया है: ये उदाहरण के नतीजे हैं, संख्याएँ Jev संस्करण के साथ बदल सकती हैं।

मेरे साथ करें ​

चरण 1: प्रोजेक्ट डायरेक्टरी बनाएँ और एनवायरनमेंट वेरिएबल की पुष्टि करें ​

क्यों: ऑफिशियल क्विक स्टार्ट एक साफ़ डायरेक्टरी से शुरू होता है; Key पर्यावरण चर (environment variable) में होनी चाहिए, तभी SDK उसे स्वतः पढ़ पाएगा।

bash
mkdir typesafe-quickstart
cd typesafe-quickstart
export TYPESAFE_API_KEY="your-api-key"

your-api-key को अपनी Key से बदलें (अगर आपने पिछले पाठ में सेव की थी, तो नए खोले गए टर्मिनल में एक बार फिर export करना होगा)।

आपको यह दिखना चाहिए: तीनों कमांड बिना किसी त्रुटि के चलें; echo $TYPESAFE_API_KEY आपकी Key प्रिंट कर सके।

चरण 2: typesafe-sdk इंस्टॉलेशन पूरा करें (venv + pip) ​

क्यों: venv SDK को प्रोजेक्ट की अपनी .venv डायरेक्टरी में इंस्टॉल करता है, सिस्टम Python को प्रदूषित नहीं करता——यही आधिकारिक pip मार्ग का मानक तरीका है।

bash
python3 -m venv .venv
.venv/bin/pip install typesafe-sdk

आपको यह दिखना चाहिए: pip इंस्टॉल होने वाले पैकेजों की सूची दिखाता है और सफल इंस्टॉलेशन दर्शाता है, पैकेज सूची में typesafe-sdk हो।

  • प्रोजेक्ट फ़ोल्डर में .venv डायरेक्टरी दिखने लगी

💡 uv के अभ्यस्त साथी

आधिकारिक रूप से uv मार्ग भी समर्थित है: uv init --bare के बाद uv add typesafe-sdk। uv, npm और curl सीधे कनेक्शन का पूरा तरीका इंस्टॉल वैकल्पिक तरीके पाठ में है।

चरण 3: आधिकारिक उदाहरण route_ticket.py लिखें ​

क्यों: पहले आधिकारिक उदाहरण को जस-का-तस चलाएँ, फिर उसे अपनी सामग्री में बदलें——इस तरह त्रुटि निवारण के समय हमेशा एक “ज्ञात सही” बेसलाइन उपलब्ध रहती है।

एडिटर से प्रोजेक्ट डायरेक्टरी में route_ticket.py बनाएँ और आधिकारिक quick start का पूरा उदाहरण पेस्ट करें:

python
from typesafe_sdk import Choice, Noul, Score, TypeSafeClient

ticket = "Our API integration started returning 500 errors on every request about 20 minutes ago, and we can't process any customer orders until this is fixed."

with TypeSafeClient(model="jev-latest") as client:  # Reads TYPESAFE_API_KEY.
    response = client.system_one(
        state=ticket,
        questions={
            "department": Choice(
                instructions="Which team should handle this",
                criteria={
                    "billing": "Payment or subscription issues",
                    "technical": "Bugs or integration problems",
                    "sales": "Pricing or account questions",
                },
            ),
            "frustration": Score(
                instructions="How frustrated the customer appears",
                criteria=[
                    "Calm, just stating facts",
                    "Frustrated but civil",
                    "Very angry, strong language",
                ],
            ),
            "is_urgent": Noul(
                instructions="The message conveys urgency or time-sensitivity",
            ),
        },
    )

print(response.choices["department"].choice)
print(response.scores["frustration"].score)
print(response.nouls["is_urgent"].noul)

आपको यह दिखना चाहिए: फ़ाइल typesafe-quickstart/route_ticket.py में सेव हो गई।

चरण 4: इसे चलाएँ, तीन उत्तर पाएँ ​

क्यों: यह चरण पूरे पाठ का लक्ष्य है——आपका पहला वास्तविक Jev कॉल।

bash
.venv/bin/python route_ticket.py

.venv/bin/python का उपयोग करें, सिस्टम के python का नहीं, ताकि उसी वातावरण का उपयोग हो जिसमें SDK अभी इंस्टॉल हुआ है।

आपको यह दिखना चाहिए: तीन पंक्तियों का आउटपुट——

text
technical
0.67
0.99
  • मुझे तीन पंक्तियों का आउटपुट दिखा, पहली पंक्ति technical है (टिकट तकनीकी टीम को आवंटित)

चरण 5: पूरा रिटर्न समझें ​

क्यों: print केवल तीन मान छापता है; वास्तविक प्रोजेक्ट में आप संभवतः probabilities और confidence से शाखा (branch) लॉजिक लिखेंगे।

आधिकारिक quick start द्वारा दिया गया पूरा JSON रिटर्न (उदाहरण मान, संस्करण के साथ बदल सकते हैं):

आधिकारिक उदाहरण का पूरा JSON रिटर्न
json
{
  "model": "jev-1.13.0",
  "answers": {
    "department": {
      "type": "choice",
      "choice": "technical",
      "confidence": 1.0,
      "probabilities": {
        "technical": 1.0,
        "billing": 0.0,
        "sales": 0.0
      }
    },
    "frustration": {
      "type": "score",
      "score": 0.67,
      "confidence": 0.5,
      "legend": {
        "0": "Calm, just stating facts",
        "1": "Frustrated but civil",
        "2": "Very angry, strong language"
      },
      "probabilities": {
        "0": 0.33,
        "1": 0.67,
        "2": 0.0
      }
    },
    "is_urgent": {
      "type": "noul",
      "noul": 0.99
    }
  },
  "usage": {
    "input_tokens": 428,
    "output_tokens": 73
  }
}

तीन ध्यान देने योग्य बातें:

फ़ील्डकहाँअर्थ
confidenceChoice / Score के उत्तर मेंमॉडल का इस उत्तर पर भरोसा (Noul उत्तर में यह फ़ील्ड नहीं होती)
probabilitiesहर उत्तर मेंपूरा प्रायिकता वितरण: department 100% technical पर
usageशीर्ष स्तरइस बार की खपत: इनपुट 428 token, आउटपुट 73 token (बिलिंग इनपुट पर होती है, आउटपुट मुफ़्त)

उदाहरण JSON में "model": "jev-1.13.0" वह मान है जो आधिकारिक दस्तावेज़ का उदाहरण रिकॉर्ड करते समय था; अब आप jev-latest चलाएँगे तो लौटाया गया model फ़ील्ड वर्तमान मॉडल संस्करण पर निर्भर करेगा। confidence से शाखा लॉजिक कैसे लिखें, यह Confidence भरोसा स्तर पाठ में विस्तार से बताया गया है।

चेकपॉइंट ✅ ​

  • typesafe-sdk .venv में इंस्टॉल है, सिस्टम Python में नहीं
  • मेरे कोड में API Key कहीं नहीं आई (SDK पर्यावरण चर स्वतः पढ़ता है)
  • मुझे तीन पंक्तियों का आउटपुट मिला, और मैं जानता/जानती हूँ कि वे क्रमशः Choice / Score / Noul के उत्तर हैं
  • मैं जानता/जानती हूँ कि उत्तर प्रश्न ID के अनुसार response.choices / .scores / .nouls में संग्रहीत होते हैं
  • मैं जानता/जानती हूँ कि उदाहरण के मान संस्करण के साथ बदल सकते हैं, 0.67 या 0.66 पर परेशान होने की ज़रूरत नहीं

आम गलतियों की चेतावनी ​

❌ ModuleNotFoundError: No module named 'typesafe_sdk' ​

पैकेज उस Python में इंस्टॉल नहीं हुआ जिसे आप अभी उपयोग कर रहे हैं। सबसे आम कारण: सिस्टम python से .venv में इंस्टॉल प्रोजेक्ट चलाया गया। सही तरीका: आधिकारिक उदाहरण की तरह .venv/bin/python route_ticket.py से चलाएँ; पहले वातावरण सक्रिय करने के अभ्यस्त साथी source .venv/bin/activate के बाद python से भी चला सकते हैं (सामान्य venv उपयोग, आधिकारिक उदाहरण में यह चरण नहीं है)।

❌ Python संस्करण 3.10 से कम ​

आधिकारिक SDK को Python 3.10 या उससे ऊपर चाहिए। python3 --version से जाँचें; संस्करण कम हो तो पहले Python अपग्रेड करें, या 3.10+ इंटरप्रेटर से venv फिर से बनाएँ।

❌ चल गया, लेकिन मान 0.67 / 0.99 से मेल नहीं खाते ​

कुछ खराब नहीं हुआ——आधिकारिक रूप से स्पष्ट कहा गया है कि उदाहरण के परिणाम Jev संस्करण के साथ बदलते हैं। देखें कि संरचना सही है या नहीं: पहली पंक्ति billing / technical / sales में से एक, दूसरी पंक्ति 0–2 की संख्या, तीसरी पंक्ति 0–1 की संख्या। संरचना सही है तो यह चल गया।

❌ उदाहरण बदलने के बाद नहीं चलता, पता नहीं क्या गड़बड़ हुआ ​

बेसलाइन पर लौटें: पहले आधिकारिक उदाहरण को जस-का-तस चलाएँ, फिर एक-एक छोटा कदम बदलें——पहले state टेक्स्ट, फिर प्रश्न, अंत में प्रश्न का प्रकार, हर बदलाव के बाद एक बार चलाएँ। सच में अटक जाएँ तो शुरुआती त्रुटि निवारण पाठ में हर त्रुटि अलग-अलग समझाई गई है।

उन्नत तरीके (वैकल्पिक) ​

सिंक्रोनस और असिंक्रोनस दो क्लाइंट। SDK एक साथ TypeSafeClient (सिंक्रोनस, इस पाठ में उपयोग किया गया) और AsyncTypeSafeClient (असिंक्रोनस) देता है, इंटरफ़ेस के नाम एक जैसे हैं (system_one); उच्च concurrency वाले मामलों में असिंक्रोनस संस्करण चुनें।

SDK में वैकल्पिक ऐड-ऑन हैं। इंस्टॉल करते समय extras जोड़े जा सकते हैं: http2 HTTP/2 समर्थन चालू करता है, pil Pillow इमेज भेजता है, zstd Python 3.13 और उससे पुराने संस्करणों पर रिक्वेस्ट बॉडी कंप्रेस करता है। इमेज से जुड़े उपयोग Box और इमेज पाठ में हैं।

Python उपयोग नहीं करना चाहते? JavaScript / TypeScript SDK और curl से सीधे API कनेक्शन का तरीका, सब इंस्टॉल वैकल्पिक तरीके पाठ में हैं।

पाठ का सारांश ​

✅ typesafe-sdk इंस्टॉल पूरा: venv + pip, प्रोजेक्ट के .venv में इंस्टॉल, Python 3.10+।

✅ पहला रिक्वेस्ट सफल: एक टिकट, तीन सवाल, एक बार में रिटर्न — technical / 0.67 / 0.99।

✅ अब आप रिटर्न पढ़ सकते हैं: जवाब सवाल ID के हिसाब से choices / scores / nouls में हैं, probability और confidence दोनों मौजूद हैं।

मुख्य कॉन्फ़िगरेशन फ़ील्ड की समीक्षा:

फ़ील्डअनुशंसित मानविवरण
पैकेज नामtypesafe-sdkpip इंस्टॉल नाम; import नाम typesafe_sdk है
modeljev-latestउपनाम, फ़िलहाल Jev 1.14 की ओर इशारा करता है; निर्दिष्ट न करने पर SDK का डिफ़ॉल्ट भी यही है
stateस्ट्रिंग / JSON ऑब्जेक्ट / टेक्स्ट ऐरेइस पाठ में एक टिकट स्ट्रिंग इस्तेमाल हुई
questions{ID: Choice/Score/Noul(...)}ID अपनी मर्ज़ी से; जवाब ID के अनुसार choices / scores / nouls से लिए जाते हैं
एनवायरनमेंट वेरिएबलTYPESAFE_API_KEYSDK स्वतः पढ़ता है, कोड में कुंजी नहीं लिखी जाती

अगले पाठ की झलक ​

Python ही एकमात्र रास्ता नहीं है: इंस्टॉल के वैकल्पिक तरीके: uv, npm और curl से सीधे API।

आप सीखेंगे:

  • uv से दो-तीन कमांड में वही SDK इंस्टॉल करना
  • Node.js 20+ पर @typesafe-ai/sdk से वही उदाहरण चलाना
  • curl 7.76+ से सीधे API, देखें कि रॉ JSON कैसा दिखता है
  • अपने प्रोजेक्ट के हिसाब से कौन-सा रास्ता चुनें
gaodong.aiAboutPrivacyContact

Independent tutorials, not affiliated with any product mentioned. Product names and trademarks belong to their owners. Check official pages for prices and policies.