या धड्यात तुम्हाला या कोर्सचे कोड नमुने कसे चालवायचे ते शिकवले जाईल.
तुमचा रेपो क्लोन करण्यापूर्वी, AI Agents For Beginners Discord channel मध्ये सामील व्हा. तुम्हाला सेटअपसाठी मदत हवी असल्यास, कोर्सबद्दल काही प्रश्न असल्यास किंवा इतर शिकणाऱ्यांशी संपर्क साधायचा असल्यास तुम्ही येथे मदत मिळवू शकता.
सुरुवात करण्यासाठी, कृपया GitHub Repository क्लोन किंवा फोर्क करा. यामुळे तुम्हाला कोर्स मटेरियलची स्वतःची आवृत्ती मिळेल ज्यामुळे तुम्ही कोड चालवू, चाचणी करू आणि बदल करू शकाल!
हे करण्यासाठी रेपो फोर्क करण्यासाठी लिंकवर क्लिक करा.
आता तुम्हाला या कोर्सची स्वतःची फोर्क केलेली आवृत्ती खालील लिंकवर मिळेल:

संपूर्ण रेपो मोठा (~3 GB) असू शकतो जेव्हा तुम्ही संपूर्ण इतिहास आणि सर्व फाइल्स डाउनलोड करता. जर तुम्ही फक्त वर्कशॉपमध्ये सहभागी होत असाल किंवा फक्त काही धड्यांच्या फोल्डर्सची आवश्यकता असेल, तर शॅलो क्लोन (किंवा स्पार्स क्लोन) इतिहास कमी करून आणि/किंवा ब्लॉब्स वगळून बहुतेक डाउनलोड टाळतो.
खालील कमांड्समध्ये <your-username> ला तुमच्या फोर्क URL ने बदला (किंवा तुम्हाला हवे असल्यास अपस्ट्रीम URL).
फक्त नवीनतम कमिट इतिहास क्लोन करण्यासाठी (लहान डाउनलोड):
git clone --depth 1 https://github.com/<your-username>/ai-agents-for-beginners.git
विशिष्ट ब्रँच क्लोन करण्यासाठी:
git clone --depth 1 --branch <branch-name> https://github.com/<your-username>/ai-agents-for-beginners.git
हे अंशतः क्लोन आणि स्पार्स-चेकआउट वापरते (Git 2.25+ आवश्यक आहे आणि अंशतः क्लोन समर्थनासह आधुनिक Git शिफारस केली जाते):
git clone --depth 1 --filter=blob:none --sparse https://github.com/<your-username>/ai-agents-for-beginners.git
रेपो फोल्डरमध्ये जा:
बॅशसाठी:
cd ai-agents-for-beginners
पॉवरशेलसाठी:
Set-Location ai-agents-for-beginners
त्यानंतर तुम्हाला हवे असलेले फोल्डर्स निर्दिष्ट करा (खालील उदाहरण दोन फोल्डर्स दर्शवते):
git sparse-checkout set 00-course-setup 01-intro-to-ai-agents
फाइल्स क्लोन आणि सत्यापित केल्यानंतर, जर तुम्हाला फक्त फाइल्सची आवश्यकता असेल आणि जागा मोकळी करायची असेल (कोणताही git इतिहास नाही), तर कृपया रेपो मेटाडेटा हटवा (💀अपरिवर्तनीय — तुम्ही सर्व Git कार्यक्षमता गमवाल: कोणतेही कमिट्स, पुल्स, पुशेस किंवा इतिहास प्रवेश).
Linux/macOS साठी:
rm -rf .git
Windows साठी:
Remove-Item -Recurse -Force .git
GitHub UI द्वारे या रेपोसाठी नवीन कोडस्पेस तयार करा.
हा कोर्स Jupyter Notebooks ची मालिका ऑफर करतो ज्याद्वारे तुम्ही AI Agents तयार करण्याचा प्रत्यक्ष अनुभव घेऊ शकता.
कोड नमुने खालीलपैकी कोणत्याहीचा वापर करतात:
GitHub खाते आवश्यक - मोफत:
1) Semantic Kernel Agent Framework + GitHub Models Marketplace. (semantic-kernel.ipynb) म्हणून लेबल केलेले 2) AutoGen Framework + GitHub Models Marketplace. (autogen.ipynb) म्हणून लेबल केलेले
Azure सदस्यता आवश्यक: 3) Azure AI Foundry + Azure AI Agent Service. (azureaiagent.ipynb) म्हणून लेबल केलेले
आम्ही तुम्हाला सर्व तीन प्रकारचे उदाहरणे वापरून पाहण्याची शिफारस करतो जेणेकरून तुमच्यासाठी कोणते सर्वोत्तम कार्य करते ते तुम्हाला समजेल.
तुम्ही कोणताही पर्याय निवडला तरी, खाली दिलेल्या सेटअप चरणांनुसार तुम्हाला पुढे जावे लागेल:
टीप: जर तुमच्याकडे Python3.12 स्थापित नसेल, तर ते स्थापित करा. नंतर requirements.txt फाइलमधून योग्य आवृत्त्या स्थापित करण्यासाठी python3.12 वापरून तुमचा venv तयार करा.
उदाहरण
Python venv डिरेक्टरी तयार करा:
python3 -m venv venv
नंतर venv वातावरण सक्रिय करा:
macOS आणि Linux साठी
source venv/bin/activate
Windows साठी
venv\Scripts\activate
आम्ही या रेपोच्या मूळ फोल्डरमध्ये एक requirements.txt फाइल समाविष्ट केली आहे ज्यामध्ये कोड नमुने चालवण्यासाठी आवश्यक असलेल्या सर्व Python पॅकेजेस आहेत.
तुम्ही खालील कमांड चालवून ती स्थापित करू शकता:
pip install -r requirements.txt
आम्ही कोणत्याही संघर्ष आणि समस्यांपासून बचाव करण्यासाठी Python virtual environment तयार करण्याची शिफारस करतो.
VSCode मध्ये योग्य Python आवृत्ती वापरत असल्याची खात्री करा.
हा कोर्स GitHub Models Marketplace चा उपयोग करतो, जो तुम्हाला मोठ्या भाषा मॉडेल्स (LLMs) साठी मोफत प्रवेश प्रदान करतो, ज्याचा उपयोग तुम्ही AI Agents तयार करण्यासाठी करू शकता.
GitHub Models वापरण्यासाठी, तुम्हाला GitHub Personal Access Token तयार करणे आवश्यक आहे.
हे तुमच्या GitHub खात्यातील Personal Access Tokens settings वर जाऊन करता येईल.
कृपया तुमचा टोकन तयार करताना Principle of Least Privilege चे अनुसरण करा. याचा अर्थ असा की तुम्ही टोकनला फक्त कोर्समधील कोड नमुने चालवण्यासाठी आवश्यक असलेल्या परवानग्या द्याव्यात.
Developer settings मध्ये जाऊन डाव्या बाजूला Fine-grained tokens पर्याय निवडा.

नंतर Generate new token निवडा.

टोकनसाठी त्याच्या उद्देशाचे प्रतिबिंबित करणारे वर्णनात्मक नाव प्रविष्ट करा, जे नंतर ओळखणे सोपे होईल.
🔐 टोकन कालावधी शिफारस
शिफारस केलेला कालावधी: 30 दिवस अधिक सुरक्षितता सुनिश्चित करण्यासाठी, तुम्ही कमी कालावधी निवडू शकता—उदाहरणार्थ, 7 दिवस 🛡️ हे वैयक्तिक लक्ष्य सेट करण्याचा आणि कोर्स पूर्ण करण्याचा उत्तम मार्ग आहे जेव्हा तुमची शिकण्याची गती जास्त असते 🚀.

टोकनचा स्कोप या रेपोच्या फोर्कपुरता मर्यादित करा.

टोकनच्या परवानग्या मर्यादित करा: Permissions अंतर्गत, Account टॅबवर क्लिक करा आणि “+ Add permissions” बटणावर क्लिक करा. एक ड्रॉपडाउन दिसेल. कृपया Models शोधा आणि त्यासाठी बॉक्स तपासा.

टोकन तयार करण्यापूर्वी आवश्यक परवानग्या सत्यापित करा. 
टोकन तयार करण्यापूर्वी, तुम्ही टोकन सुरक्षित ठिकाणी जसे की पासवर्ड मॅनेजर व्हॉल्टमध्ये संग्रहित करण्यास तयार आहात याची खात्री करा, कारण ते तयार केल्यानंतर पुन्हा दर्शवले जाणार नाही. 
तुम्ही नुकतेच तयार केलेले तुमचे नवीन टोकन कॉपी करा. आता तुम्ही ते या कोर्समध्ये समाविष्ट केलेल्या .env फाइलमध्ये जोडाल.
.env फाइल तयार करातुमच्या टर्मिनलमध्ये खालील कमांड चालवून तुमची .env फाइल तयार करा.
cp .env.example .env
हे उदाहरण फाइल कॉपी करेल आणि तुमच्या डिरेक्टरीमध्ये .env तयार करेल जिथे तुम्ही पर्यावरणीय व्हेरिएबल्ससाठी मूल्ये भरण्यासाठी.
तुमचे टोकन कॉपी करून, तुमच्या आवडत्या टेक्स्ट एडिटरमध्ये .env फाइल उघडा आणि GITHUB_TOKEN फील्डमध्ये तुमचे टोकन पेस्ट करा.

आता तुम्ही या कोर्सचे कोड नमुने चालवू शकता.
Azure AI Foundry मध्ये हब आणि प्रोजेक्ट तयार करण्यासाठी चरणांचे अनुसरण करा: Hub resources overview
तुम्ही तुमचा प्रोजेक्ट तयार केल्यानंतर, तुम्हाला तुमच्या प्रोजेक्टसाठी कनेक्शन स्ट्रिंग मिळवणे आवश्यक आहे.
हे Azure AI Foundry पोर्टलमधील तुमच्या प्रोजेक्टच्या Overview पेजवर जाऊन करता येईल.

.env फाइल तयार करातुमच्या टर्मिनलमध्ये खालील कमांड चालवून तुमची .env फाइल तयार करा.
cp .env.example .env
हे उदाहरण फाइल कॉपी करेल आणि तुमच्या डिरेक्टरीमध्ये .env तयार करेल जिथे तुम्ही पर्यावरणीय व्हेरिएबल्ससाठी मूल्ये भरण्यासाठी.
तुमचे टोकन कॉपी करून, तुमच्या आवडत्या टेक्स्ट एडिटरमध्ये .env फाइल उघडा आणि PROJECT_ENDPOINT फील्डमध्ये तुमचे टोकन पेस्ट करा.
सुरक्षिततेच्या सर्वोत्तम पद्धती म्हणून, आपण Microsoft Entra ID सह Azure OpenAI मध्ये प्रमाणीकरण करण्यासाठी keyless authentication वापरू.
पुढे, टर्मिनल उघडा आणि az login --use-device-code चालवून तुमच्या Azure खात्यात साइन इन करा.
तुम्ही लॉग इन केल्यानंतर, टर्मिनलमध्ये तुमची सदस्यता निवडा.
Agentic RAG Lesson - Lesson 5 साठी - काही नमुने आहेत जे Azure Search आणि Azure OpenAI वापरतात.
जर तुम्हाला हे नमुने चालवायचे असतील, तर तुम्हाला तुमच्या .env फाइलमध्ये खालील पर्यावरणीय व्हेरिएबल्स जोडणे आवश्यक आहे:
AZURE_SUBSCRIPTION_ID - तुमच्या प्रोजेक्टच्या Overview पेजवरील Project details तपासा.
AZURE_AI_PROJECT_NAME - तुमच्या प्रोजेक्टच्या Overview पेजच्या शीर्षस्थानी पहा.
AZURE_OPENAI_SERVICE - Overview पेजवरील Included capabilities टॅबमध्ये Azure OpenAI Service साठी शोधा.
AZURE_OPENAI_RESOURCE_GROUP - Management Center च्या Overview पेजवरील Project properties वर जा.
GLOBAL_LLM_SERVICE - Connected resources अंतर्गत, Azure AI Services कनेक्शन नाव शोधा. जर सूचीबद्ध नसेल, तर Azure portal मध्ये तुमच्या रिसोर्स ग्रुप अंतर्गत AI Services रिसोर्स नाव तपासा.
AZURE_OPENAI_EMBEDDING_DEPLOYMENT_NAME - तुमचा एम्बेडिंग मॉडेल निवडा (उदा., text-embedding-ada-002) आणि मॉडेल तपशीलांमधून Deployment name लक्षात ठेवा.
AZURE_OPENAI_CHAT_DEPLOYMENT_NAME - तुमचा चॅट मॉडेल निवडा (उदा., gpt-4o-mini) आणि मॉडेल तपशीलांमधून Deployment name लक्षात ठेवा.
AZURE_OPENAI_ENDPOINT - Azure AI services शोधा, त्यावर क्लिक करा, नंतर Resource Management, Keys and Endpoint वर जा, “Azure OpenAI endpoints” पर्यंत स्क्रोल करा आणि “Language APIs” म्हणणारे कॉपी करा.
AZURE_OPENAI_API_KEY - त्याच स्क्रीनवरून, KEY 1 किंवा KEY 2 कॉपी करा.
AZURE_SEARCH_SERVICE_ENDPOINT - तुमचा Azure AI Search रिसोर्स शोधा, त्यावर क्लिक करा आणि Overview पहा.
AZURE_SEARCH_API_KEY - नंतर Settings आणि Keys वर जा आणि प्राथमिक किंवा दुय्यम प्रशासकीय की कॉपी करा.
AZURE_OPENAI_API_VERSION - API version lifecycle पेजवर Latest GA API release अंतर्गत भेट द्या.तुमचे क्रेडेन्शियल्स हार्डकोड करण्याऐवजी, आपण Azure OpenAI सह keyless कनेक्शन वापरू. असे करण्यासाठी, आपण DefaultAzureCredential आयात करू आणि नंतर क्रेडेन्शियल मिळवण्यासाठी DefaultAzureCredential फंक्शन कॉल करू.
from azure.identity import DefaultAzureCredential, InteractiveBrowserCredential
जर तुम्हाला या सेटअपसह काही समस्या आल्यास, आमच्या Azure AI Community Discord मध्ये सामील व्हा किंवा तक्रार नोंदवा.
तुम्ही आता या कोर्ससाठी कोड चालवण्यासाठी तयार आहात. AI एजंट्सच्या जगाबद्दल अधिक शिकण्याचा आनंद घ्या!
AI एजंट्स आणि एजंट वापर प्रकरणांची ओळख
अस्वीकरण:
हा दस्तऐवज AI भाषांतर सेवा Co-op Translator वापरून भाषांतरित करण्यात आला आहे. आम्ही अचूकतेसाठी प्रयत्नशील असलो तरी, कृपयास लक्षात ठेवा की स्वयंचलित भाषांतरे त्रुटी किंवा अचूकतेच्या अभावाने युक्त असू शकतात. मूळ भाषेतील दस्तऐवज हा अधिकृत स्रोत मानला जावा. महत्त्वाच्या माहितीसाठी, व्यावसायिक मानवी भाषांतराची शिफारस केली जाते. या भाषांतराचा वापर करून उद्भवलेल्या कोणत्याही गैरसमज किंवा चुकीच्या अर्थासाठी आम्ही जबाबदार राहणार नाही.