ai-agents-for-beginners

कोर्स सेटअप

परिचय

या धड्यात तुम्हाला या कोर्सचे कोड नमुने कसे चालवायचे ते शिकवले जाईल.

इतर शिकणाऱ्यांमध्ये सामील व्हा आणि मदत मिळवा

तुमचा रेपो क्लोन करण्यापूर्वी, AI Agents For Beginners Discord channel मध्ये सामील व्हा. तुम्हाला सेटअपसाठी मदत हवी असल्यास, कोर्सबद्दल काही प्रश्न असल्यास किंवा इतर शिकणाऱ्यांशी संपर्क साधायचा असल्यास तुम्ही येथे मदत मिळवू शकता.

हा रेपो क्लोन किंवा फोर्क करा

सुरुवात करण्यासाठी, कृपया GitHub Repository क्लोन किंवा फोर्क करा. यामुळे तुम्हाला कोर्स मटेरियलची स्वतःची आवृत्ती मिळेल ज्यामुळे तुम्ही कोड चालवू, चाचणी करू आणि बदल करू शकाल!

हे करण्यासाठी रेपो फोर्क करण्यासाठी लिंकवर क्लिक करा.

आता तुम्हाला या कोर्सची स्वतःची फोर्क केलेली आवृत्ती खालील लिंकवर मिळेल:

Forked Repo

शॅलो क्लोन (वर्कशॉप / कोडस्पेससाठी शिफारस केलेले)

संपूर्ण रेपो मोठा (~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 Codespaces वापरणे (स्थानिक मोठ्या डाउनलोड्स टाळण्यासाठी शिफारस केलेले)

टिप्स

कोड चालवणे

हा कोर्स 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) म्हणून लेबल केलेले

आम्ही तुम्हाला सर्व तीन प्रकारचे उदाहरणे वापरून पाहण्याची शिफारस करतो जेणेकरून तुमच्यासाठी कोणते सर्वोत्तम कार्य करते ते तुम्हाला समजेल.

तुम्ही कोणताही पर्याय निवडला तरी, खाली दिलेल्या सेटअप चरणांनुसार तुम्हाला पुढे जावे लागेल:

आवश्यकताः

आम्ही या रेपोच्या मूळ फोल्डरमध्ये एक requirements.txt फाइल समाविष्ट केली आहे ज्यामध्ये कोड नमुने चालवण्यासाठी आवश्यक असलेल्या सर्व Python पॅकेजेस आहेत.

तुम्ही खालील कमांड चालवून ती स्थापित करू शकता:

pip install -r requirements.txt

आम्ही कोणत्याही संघर्ष आणि समस्यांपासून बचाव करण्यासाठी Python virtual environment तयार करण्याची शिफारस करतो.

VSCode सेटअप

VSCode मध्ये योग्य Python आवृत्ती वापरत असल्याची खात्री करा.

image

GitHub Models वापरून नमुन्यांसाठी सेटअप करा

चरण 1: तुमचा GitHub Personal Access Token (PAT) मिळवा

हा कोर्स GitHub Models Marketplace चा उपयोग करतो, जो तुम्हाला मोठ्या भाषा मॉडेल्स (LLMs) साठी मोफत प्रवेश प्रदान करतो, ज्याचा उपयोग तुम्ही AI Agents तयार करण्यासाठी करू शकता.

GitHub Models वापरण्यासाठी, तुम्हाला GitHub Personal Access Token तयार करणे आवश्यक आहे.

हे तुमच्या GitHub खात्यातील Personal Access Tokens settings वर जाऊन करता येईल.

कृपया तुमचा टोकन तयार करताना Principle of Least Privilege चे अनुसरण करा. याचा अर्थ असा की तुम्ही टोकनला फक्त कोर्समधील कोड नमुने चालवण्यासाठी आवश्यक असलेल्या परवानग्या द्याव्यात.

  1. Developer settings मध्ये जाऊन डाव्या बाजूला Fine-grained tokens पर्याय निवडा.

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

    Generate Token

  2. टोकनसाठी त्याच्या उद्देशाचे प्रतिबिंबित करणारे वर्णनात्मक नाव प्रविष्ट करा, जे नंतर ओळखणे सोपे होईल.

    🔐 टोकन कालावधी शिफारस

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

    Token Name and Expiration

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

    Limit scope to fork repository

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

  5. टोकन तयार करण्यापूर्वी आवश्यक परवानग्या सत्यापित करा. Verify Permissions

  6. टोकन तयार करण्यापूर्वी, तुम्ही टोकन सुरक्षित ठिकाणी जसे की पासवर्ड मॅनेजर व्हॉल्टमध्ये संग्रहित करण्यास तयार आहात याची खात्री करा, कारण ते तयार केल्यानंतर पुन्हा दर्शवले जाणार नाही. Store Token Securely

तुम्ही नुकतेच तयार केलेले तुमचे नवीन टोकन कॉपी करा. आता तुम्ही ते या कोर्समध्ये समाविष्ट केलेल्या .env फाइलमध्ये जोडाल.

चरण 2: तुमची .env फाइल तयार करा

तुमच्या टर्मिनलमध्ये खालील कमांड चालवून तुमची .env फाइल तयार करा.

cp .env.example .env

हे उदाहरण फाइल कॉपी करेल आणि तुमच्या डिरेक्टरीमध्ये .env तयार करेल जिथे तुम्ही पर्यावरणीय व्हेरिएबल्ससाठी मूल्ये भरण्यासाठी.

तुमचे टोकन कॉपी करून, तुमच्या आवडत्या टेक्स्ट एडिटरमध्ये .env फाइल उघडा आणि GITHUB_TOKEN फील्डमध्ये तुमचे टोकन पेस्ट करा. GitHub Token Field

आता तुम्ही या कोर्सचे कोड नमुने चालवू शकता.

Azure AI Foundry आणि Azure AI Agent Service वापरून नमुन्यांसाठी सेटअप करा

चरण 1: तुमचा Azure प्रोजेक्ट एंडपॉइंट मिळवा

Azure AI Foundry मध्ये हब आणि प्रोजेक्ट तयार करण्यासाठी चरणांचे अनुसरण करा: Hub resources overview

तुम्ही तुमचा प्रोजेक्ट तयार केल्यानंतर, तुम्हाला तुमच्या प्रोजेक्टसाठी कनेक्शन स्ट्रिंग मिळवणे आवश्यक आहे.

हे Azure AI Foundry पोर्टलमधील तुमच्या प्रोजेक्टच्या Overview पेजवर जाऊन करता येईल.

Project Connection String

चरण 2: तुमची .env फाइल तयार करा

तुमच्या टर्मिनलमध्ये खालील कमांड चालवून तुमची .env फाइल तयार करा.

cp .env.example .env

हे उदाहरण फाइल कॉपी करेल आणि तुमच्या डिरेक्टरीमध्ये .env तयार करेल जिथे तुम्ही पर्यावरणीय व्हेरिएबल्ससाठी मूल्ये भरण्यासाठी.

तुमचे टोकन कॉपी करून, तुमच्या आवडत्या टेक्स्ट एडिटरमध्ये .env फाइल उघडा आणि PROJECT_ENDPOINT फील्डमध्ये तुमचे टोकन पेस्ट करा.

चरण 3: Azure मध्ये साइन इन करा

सुरक्षिततेच्या सर्वोत्तम पद्धती म्हणून, आपण Microsoft Entra ID सह Azure OpenAI मध्ये प्रमाणीकरण करण्यासाठी keyless authentication वापरू.

पुढे, टर्मिनल उघडा आणि az login --use-device-code चालवून तुमच्या Azure खात्यात साइन इन करा.

तुम्ही लॉग इन केल्यानंतर, टर्मिनलमध्ये तुमची सदस्यता निवडा.

अतिरिक्त पर्यावरणीय व्हेरिएबल्स - Azure Search आणि Azure OpenAI

Agentic RAG Lesson - Lesson 5 साठी - काही नमुने आहेत जे Azure Search आणि Azure OpenAI वापरतात.

जर तुम्हाला हे नमुने चालवायचे असतील, तर तुम्हाला तुमच्या .env फाइलमध्ये खालील पर्यावरणीय व्हेरिएबल्स जोडणे आवश्यक आहे:

Overview Page (Project)

Management Center

Models + Endpoints Page

Azure Portal

बाह्य वेबपेज

Keyless authentication सेटअप करा

तुमचे क्रेडेन्शियल्स हार्डकोड करण्याऐवजी, आपण Azure OpenAI सह keyless कनेक्शन वापरू. असे करण्यासाठी, आपण DefaultAzureCredential आयात करू आणि नंतर क्रेडेन्शियल मिळवण्यासाठी DefaultAzureCredential फंक्शन कॉल करू.

from azure.identity import DefaultAzureCredential, InteractiveBrowserCredential

कुठे अडले आहात?

जर तुम्हाला या सेटअपसह काही समस्या आल्यास, आमच्या Azure AI Community Discord मध्ये सामील व्हा किंवा तक्रार नोंदवा.

पुढचा धडा

तुम्ही आता या कोर्ससाठी कोड चालवण्यासाठी तयार आहात. AI एजंट्सच्या जगाबद्दल अधिक शिकण्याचा आनंद घ्या!

AI एजंट्स आणि एजंट वापर प्रकरणांची ओळख


अस्वीकरण:
हा दस्तऐवज AI भाषांतर सेवा Co-op Translator वापरून भाषांतरित करण्यात आला आहे. आम्ही अचूकतेसाठी प्रयत्नशील असलो तरी, कृपयास लक्षात ठेवा की स्वयंचलित भाषांतरे त्रुटी किंवा अचूकतेच्या अभावाने युक्त असू शकतात. मूळ भाषेतील दस्तऐवज हा अधिकृत स्रोत मानला जावा. महत्त्वाच्या माहितीसाठी, व्यावसायिक मानवी भाषांतराची शिफारस केली जाते. या भाषांतराचा वापर करून उद्भवलेल्या कोणत्याही गैरसमज किंवा चुकीच्या अर्थासाठी आम्ही जबाबदार राहणार नाही.