Making a request

Anthropic API के साथ कोड लिखने के लिए मुख्य अध्ययन नोट्स

**I. सेटअप और सुरक्षा (Setup and Security)**

• आवश्यक पैकेज: Anthropic API का उपयोग करने के लिए Jupyter Notebook में Anthropic Python SDK और python. env पैकेज इंस्टॉल करें।
• कमांड: % pip install Anthropic python. env
• API Key प्रबंधन: API कुंजी को सुरक्षित रूप से स्टोर करने के लिए python. env पैकेज का उपयोग करें।
• एक फ़ाइल बनाएं जिसका नाम . env हो।
• इस फ़ाइल में API कुंजी को इस प्रारूप में स्टोर करें: Anthropic_API_key = "आपकी_कुंजी"।
• संस्करण नियंत्रण (Version Control): सुरक्षा के लिए, . env फ़ाइल को Git जैसे संस्करण नियंत्रण सिस्टम में अनदेखा (ignore) करना अनिवार्य है ताकि कुंजी सार्वजनिक न हो।

**II. API क्लाइंट और अनुरोध (API Client and Request)**

• क्लाइंट बनाना: Anthropic पैकेज का उपयोग करके API क्लाइंट बनाएं।
• create फ़ंक्शन: API से अनुरोध करने के लिए create फ़ंक्शन का उपयोग किया जाता है। इसे तीन मुख्य कीवर्ड आर्गुमेंट्स की आवश्यकता होती है:
• model: वह मॉडल जिसका उपयोग करना है (उदाहरण के लिए, Claude Sonnet)।
• max_tokens: यह एक सुरक्षा तंत्र (safety mechanism) है जो आउटपुट की अधिकतम सीमा निर्धारित करता है। यह सुनिश्चित करता है कि प्रतिक्रिया एक निश्चित संख्या (जैसे 1000) से अधिक न हो।
• messages: यह वह इनपुट है जो मॉडल को दिया जाता है, जो एक चैट एक्सचेंज का प्रतिनिधित्व करता है।

**III. संदेश संरचना (Message Structure)**

• संदेश का उद्देश्य: messages वह एक्सचेंज (जैसे चैट) को दर्शाते हैं जो उपयोगकर्ता और मॉडल के बीच होता है।
• संदेश के प्रकार (Roles):
• user: वह पाठ जो उपयोगकर्ता या डेवलपर द्वारा प्रदान किया जाता है (इनपुट)।
• assistant: वह पाठ जो मॉडल द्वारा उत्पन्न किया जाता है (आउटपुट)।
• संदेश का प्रारूप: प्रत्येक संदेश एक डिक्शनरी होता है जिसमें दो मुख्य तत्व होते हैं:
• role: संदेश का प्रकार (user या assistant)।
• content: संदेश का वास्तविक पाठ (string)।

**IV. प्रतिक्रिया को समझना (Understanding the Response)**

• नेस्टेड डेटा: API से प्राप्त प्रतिक्रिया (response) बहुत गहराई से नेस्टेड होती है।
• पाठ तक पहुँचना: केवल मॉडल द्वारा उत्पन्न पाठ (generated text) को निकालने के लिए, आपको इस पथ का उपयोग करना होगा: message. content[0]. text।

Takeaways

• API कुंजी को सुरक्षित रखने के लिए . env फ़ाइल का उपयोग करें और इसे Git में अनदेखा (ignore) करना अनिवार्य है।
• API से अनुरोध करने के लिए create फ़ंक्शन का उपयोग करें, जिसमें model, max_tokens (आउटपुट सीमा), और messages (इनपुट) शामिल हों।
• संदेश (messages) उपयोगकर्ता (user) और मॉडल (assistant) के बीच के संवाद को दर्शाते हैं, और प्रत्येक संदेश में role और content होता है।
• API से प्राप्त नेस्टेड प्रतिक्रिया में मॉडल द्वारा उत्पन्न पाठ तक पहुँचने के लिए message. content[0]. text पथ का उपयोग करें।