# एक्ट 1: अपने AI रिसर्च असिस्टेंट से मिलें 🤖

![lab1](../../../../translated_images/hi/lab1.1dd5210a7d114e2e.webp)

## चुनौती

आप "Future Bytes" नामक अपना नया टेक पॉडकास्ट लॉन्च कर रहे हैं। एपिसोड 1 नवीनतम AI प्रगति के बारे में है, लेकिन आपके पास 24 घंटे हैं:
1. विषय पर शोध करें
2. विश्वसनीय स्रोत खोजें
3. एक प्रभावशाली स्क्रिप्ट लिखें
4. इसे प्राकृतिक रूप से सुनाने लायक बनाएं

**प्लॉट ट्विस्ट**: आपको यह अकेले करना नहीं है। आप अपना पहला AI असिस्टेंट बनाने जा रहे हैं जो इन सब में मदद कर सके। चलिए उसे Alex कहते हैं — आपका अथक रिसर्च साथी जिसे नींद की जरूरत नहीं।

## छोटे भाषा मॉडल क्यों? (स्पॉइलर: ये शानदार हैं)

छोटे भाषा मॉडल (SLMs) को अपने व्यक्तिगत AI के रूप में सोचें जो *आपके* कंप्यूटर पर रहता है। न तो क्लाउड, न मासिक शुल्क, न संदिग्ध डेटा साझा करना।

**SLMs क्यों 🔥 हैं:**
- **🏠 आपके उपकरण पर चलता है**: लैपटॉप, डेस्कटॉप, यहां तक कि एक दमदार Raspberry Pi
- **💸 कोई चल रही लागत नहीं**: कोई API फीस अपने खाने के पैसे से ना कटें
- **🔒 प्राइवेसी पहले**: आपका डेटा आपके डिवाइस से बाहर नहीं निकलता
- **⚡ बिजली की गति से तेज**: कोई इंटरनेट लॉग नहीं, त्वरित उत्तर
- **🪦 हल्का**: 1B-10B पैरामीटर्स बनाम बड़े मॉडल्स के 100B+ पैरामीटर्स

**लोकप्रिय SLMs**: Qwen 3, Phi-4, Gemma 3 (इस वर्कशॉप के लिए हम Qwen का उपयोग कर रहे हैं)

## आपका टूलकिट

### Ollama: आपका AI मॉडल प्रबंधक

[Ollama](https://ollama.com/) AI मॉडलों के लिए Steam की तरह है। सरल कमांड के जरिए मॉडल डाउनलोड, चलाएं और प्रबंधित करें।

**क्यों यह शानदार है:**
- किसी भी मॉडल को डाउनलोड और चलाने के लिए एक कमांड
- Mac, Windows, Linux पर काम करता है
- अगर आपके पास GPU है तो स्वचालित रूप से उसका उपयोग करता है
- सुपर मेमोरी-कुशल

### Microsoft Agent Framework: जहाँ जादू होता है

[Microsoft Agent Framework](https://github.com/microsoft/agent-framework) आपका खेल का मैदान है AI एजेंट बनाने के लिए जो:

- 💬 चैट कर सकते हैं और आपकी बात याद रख सकते हैं
- 🛠️ कस्टम टूल्स का उपयोग कर सकते हैं (जैसे वेब सर्च या मौसम जांच)
- 🧠 जटिल समस्याओं को कदम दर कदम सोच सकते हैं
- 🤝 टीम के रूप में अन्य एजेंट्स के साथ काम कर सकते हैं
- 🔌 अलग-अलग AI प्रदाताओं से जुड़ सकते हैं (OpenAI, Ollama, Azure)

**निर्माण के पहरेदार:**
- **एजेंट्स**: आपके विशिष्ट कार्य वाले AI सहायक
- **टूल्स**: विशेष क्षमताएं जो आप उन्हें देते हैं
- **मेमोरी**: ताकि वे आपकी बातचीत भूलें नहीं
- **तर्क**: उन्हें सोचने की कला सिखाना, केवल जवाब नहीं देना

## आपका प्रशिक्षण मोंटाज: 4 मिशन

### मिशन 1: अपना पहला एजेंट बनाएं

📓 [Open Notebook](../code/01.BasicAgent/00.BasicAgent-agent.ipynb)

**मिशन**: Alex बनाएं, आपका पॉडकास्ट स्क्रिप्ट लेखक AI। Alex को दो होस्ट्स के बीच टेक टॉपिक्स पर बातचीत उत्पन्न करनी है।

**आप क्या सीखेंगे**:
- AI एजेंट को "जागृत" कैसे करें (यह सोमवार को जागने से आसान है)
- इसे व्यक्तित्व और निर्देश कैसे दें
- इसे वास्तविक पॉडकास्ट स्क्रिप्ट उत्पन्न करने दें
- समझें कि यह आपको क्या जवाब दे रहा है

**जीत की शर्त**: Alex आपका "Future Bytes" पायलट एपिसोड AI के बारे में स्क्रिप्ट बनाए! 🎯

### मिशन 2: Alex को सुपरपावर्स दें (टूल्स!)

📓 [Open Notebook](../code/01.BasicAgent/01.BasicAgent-tools.ipynb)

**मिशन**: Alex स्मार्ट है, लेकिन इसे आज का मौसम या समय नहीं पता। चलिए इसे टूल्स देकर यह ठीक करते हैं!

**आप क्या सीखेंगे**:
- कस्टम Python फंक्शंस "टूल्स" के रूप में बनाना
- Alex को यह निर्णय लेने दें *कब* कौन सा टूल इस्तेमाल करना है
- देखें कि यह स्वतंत्र रूप से समस्याएं हल करता है
- जटिल कार्यों के लिए कई टूल्स को संयोजित करें

**जीत की शर्त**: "टोक्यो में मौसम कैसा है?" पूछें और Alex खुद ही पता लगा ले! ☁️

### मिशन 3: Alex को सोचने सिखाएं

📓 [Open Notebook](../code/01.BasicAgent/02.BasicAgent-reasoning.ipynb)

**मिशन**: Alex को अपना काम दिखाने दें। जब समस्या हल करता है, आप देखना चाहते हैं कि यह *कैसे* सोचता है, केवल उत्तर नहीं।

**आप क्या सीखेंगे**:
- "तर्क मोड" सक्रिय करें (जैसे गणित क्लास में अपना काम दिखाएं)
- Alex का कदम-दर-कदम सोचने का तरीका देखें
- चेन-ऑफ़-थॉट प्रॉम्प्टिंग समझें
- जब Alex भ्रमित हो जाए तो उसे ठीक करें

**जीत की शर्त**: मुश्किल गणित प्रश्न पूछें और देखें कि Alex इसे कैसे सोचता है! 🧠

### मिशन 4: Alex को इंटरनेट से जोड़ें

📓 [Open Notebook](../code/01.BasicAgent/03.BasicAgent-websearch.ipynb)

**मिशन**: Alex का ज्ञान एक कटऑफ़ डेट तक सीमित है। चलिए इसे रियल-टाइम जानकारी के लिए वेब से जोड़ते हैं!

**आप क्या सीखेंगे**:
- कस्टम वेब सर्च टूल बनाएं
- बाहरी API एकीकृत करें
- नेटवर्क त्रुटियों को सावधानी से संभालें
- Alex के प्रशिक्षण डेटा से परे जानकारी प्राप्त करें

**जीत की शर्त**: आज की टेक न्यूज के बारे में पूछें और ताज़ा परिणाम पाएँ! 📰

## शुरू करने से पहले 🚀

**जरूरी उपकरण:**
- Python 3.10+ इंस्टॉल हो
- Ollama चल रही हो (जांचें `ollama --version` से)
- VS Code जिसमें Python एक्सटेंशन हो
- कम से कम 8GB RAM (16GB अगर स्मूथ एक्सपीरियंस चाहिए)

## मिशन क्रम

पूरी कहानी के लिए नोटबुक को क्रम में फॉलो करें:

1. [00.BasicAgent-agent.ipynb](../code/01.BasicAgent/00.BasicAgent-agent.ipynb) — Alex से मिलें (आपका पहला एजेंट)
2. [01.BasicAgent-tools.ipynb](../code/01.BasicAgent/01.BasicAgent-tools.ipynb) — पावर-अप का समय!
3. [02.BasicAgent-reasoning.ipynb](../code/01.BasicAgent/02.BasicAgent-reasoning.ipynb) — Alex को सोचना सिखाएं
4. [03.BasicAgent-websearch.ipynb](../code/01.BasicAgent/03.BasicAgent-websearch.ipynb) — इंटरनेट एक्सेस अनलॉक!

## आप क्या मास्टर करेंगे

एक्ट 1 के बाद, आप कर पाएंगे:

- ✅ अपने खुद के हार्डवेयर पर AI मॉडल चलाना (कोई क्लाउड नहीं!)
- ✅ व्यक्तिगत व्यक्तित्व और कौशल के साथ एजेंट बनाना
- ✅ एजेंट्स को असली दुनिया की समस्याएँ हल करने के लिए टूल्स देना
- ✅ एजेंट्स को उनका तर्क प्रक्रिया दिखाने देना
- ✅ एजेंट्स को बाहरी डेटा स्रोतों से जोड़ना
- ✅ जब कुछ गलत हो तो डिबग करना

## जब चीजें टूटें (और उन्हें कैसे ठीक करें) 🔧

### "Alex लोड नहीं हो रहा! मेमोरी खत्म!"
**समाधान**: आपके कंप्यूटर को परेशानी हो रही है। अन्य ऐप्स बंद करने की कोशिश करें, या छोटा मॉडल इस्तेमाल करें। 8GB RAM न्यूनतम है।

### "Alex बहुत धीमा है"
**समाधान**: Ollama सेटिंग्स में GPU एक्सेलेरेशन सक्रिय करें। या कॉन्टेक्स्ट विंडो साइज कम करें। स्पीड डेमन मोड सक्रिय! 🏎️

### "टूल्स काम नहीं कर रहे!"
**समाधान**: अपने फंक्शन सिग्नेचर्स दोबारा जांचें। Alex को यह समझने के लिए कि टूल क्या करता है, सही टाइप संकेतों की जरूरत है। इसे स्पष्ट निर्देश देने जैसा सोचें।

## मददगार लिंक 🔗

- [Agent Framework Docs](https://github.com/microsoft/agent-framework) — आधिकारिक गाइड्स और उदाहरण
- [Ollama Model Library](https://ollama.com/library) — उपलब्ध सभी मॉडल ब्राउज़ करें
- [Qwen Model](https://ollama.com/library/qwen3) — अपने AI के दिमाग से मिलें
- [Code Examples](https://github.com/microsoft/agent-framework/tree/main/python/samples) — यहां से आइडियाज चुराएं

## अगला: एक्ट 2 🎬

आपके पास एक एजेंट है। लेकिन अगर आपके पास एजेंट्स की *टीम* हो जो साथ मिलकर काम करें? एक्ट 2 में, आप अपना पूरा पॉडकास्ट प्रोडक्शन क्रू बनाएंगे:
- **रिसर्चर एजेंट**: सबसे अच्छे स्रोत ढूंढता है
- **राइटर एजेंट**: परफेक्ट स्क्रिप्ट बनाता है  
- **एडिटर (आप!)**: मंजूरी देता है या बदलाव मांगता है

चलो AI जादू का आयोजन करें! → [Act 2: अपनी प्रोडक्शन टीम को एक साथ लाएं](02.AIAgentOrchestrationAndWorkflows.md)

---

**फंसे हैं?** वर्कशॉप के दौरान सवाल पूछें। हम सब मिलकर सीख रहे हैं! 🙌

---

<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**अस्वीकरण**:
इस दस्तावेज़ का अनुवाद AI अनुवाद सेवा [Co-op Translator](https://github.com/Azure/co-op-translator) का उपयोग करके किया गया है। जबकि हम सटीकता के लिए प्रयासरत हैं, कृपया ध्यान दें कि स्वचालित अनुवाद में त्रुटियाँ या अशुद्धियाँ हो सकती हैं। मूल दस्तावेज़ को उसकी मूल भाषा में मौलिक स्रोत माना जाना चाहिए। महत्वपूर्ण जानकारी के लिए पेशेवर मानव अनुवाद की सलाह दी जाती है। इस अनुवाद के उपयोग से उत्पन्न किसी भी गलतफहमी या गलत व्याख्या के लिए हम जिम्मेदार नहीं हैं।
<!-- CO-OP TRANSLATOR DISCLAIMER END -->