ai-agents-for-beginners

कोर्स सेटअप

परिचय

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

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

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

• GitHub UI द्वारे या रेपोसाठी नवीन कोडस्पेस तयार करा.

• नव्याने तयार केलेल्या कोडस्पेसच्या टर्मिनलमध्ये, कोडस्पेस वर्कस्पेसमध्ये तुम्हाला आवश्यक असलेल्या धड्यांच्या फोल्डर्ससाठी फक्त शॅलो/स्पार्स क्लोन कमांड्स चालवा.
• पर्यायी: कोडस्पेसमध्ये क्लोन केल्यानंतर, अतिरिक्त जागा रिकामी करण्यासाठी .git काढा (वरील काढण्याच्या कमांड्स पहा).
• टीप: जर तुम्हाला रेपो थेट कोडस्पेसमध्ये उघडायचा असेल (अतिरिक्त क्लोनशिवाय), लक्षात ठेवा की कोडस्पेस डेव्हकंटेनर वातावरण तयार करेल आणि तरीही तुम्हाला आवश्यक असलेल्या गोष्टींपेक्षा अधिक प्रोव्हिजन करू शकते. नवीन कोडस्पेसमध्ये शॅलो कॉपी क्लोन करणे तुम्हाला डिस्क वापरावर अधिक नियंत्रण देते.

टिप्स

• जर तुम्हाला संपादित/कमिट करायचे असेल तर नेहमी क्लोन URL तुमच्या फोर्कने बदला.
• जर तुम्हाला नंतर अधिक इतिहास किंवा फाइल्सची आवश्यकता असेल, तर तुम्ही त्या मिळवू शकता किंवा स्पार्स-चेकआउट समायोजित करू शकता जेणेकरून अतिरिक्त फोल्डर्स समाविष्ट होतील.

कोड चालवणे

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

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

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

आवश्यकताः

• Python 3.12+

  • टीप: जर तुमच्याकडे Python3.12 स्थापित नसेल, तर ते स्थापित करा. नंतर requirements.txt फाइलमधून योग्य आवृत्त्या स्थापित करण्यासाठी python3.12 वापरून तुमचा venv तयार करा.

    उदाहरण

    Python venv डिरेक्टरी तयार करा:

    python3 -m venv venv
    

    नंतर venv वातावरण सक्रिय करा:

    macOS आणि Linux साठी

    source venv/bin/activate
    

    Windows साठी

    venv\Scripts\activate
    

• GitHub खाते - GitHub Models Marketplace मध्ये प्रवेशासाठी
• Azure सदस्यता - Azure AI Foundry मध्ये प्रवेशासाठी
• Azure AI Foundry खाते - Azure AI Agent Service मध्ये प्रवेशासाठी

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

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

pip install -r requirements.txt

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

VSCode सेटअप

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

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 निवडा.

   

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

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

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

   

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

   

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

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

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

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

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

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

cp .env.example .env

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

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

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

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

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

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

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

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

चरण 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)

• AZURE_SUBSCRIPTION_ID - तुमच्या प्रोजेक्टच्या Overview पेजवरील Project details तपासा.

• AZURE_AI_PROJECT_NAME - तुमच्या प्रोजेक्टच्या Overview पेजच्या शीर्षस्थानी पहा.

• AZURE_OPENAI_SERVICE - Overview पेजवरील Included capabilities टॅबमध्ये Azure OpenAI Service साठी शोधा.

Management Center

• AZURE_OPENAI_RESOURCE_GROUP - Management Center च्या Overview पेजवरील Project properties वर जा.

• GLOBAL_LLM_SERVICE - Connected resources अंतर्गत, Azure AI Services कनेक्शन नाव शोधा. जर सूचीबद्ध नसेल, तर Azure portal मध्ये तुमच्या रिसोर्स ग्रुप अंतर्गत AI Services रिसोर्स नाव तपासा.

Models + Endpoints Page

• AZURE_OPENAI_EMBEDDING_DEPLOYMENT_NAME - तुमचा एम्बेडिंग मॉडेल निवडा (उदा., text-embedding-ada-002) आणि मॉडेल तपशीलांमधून Deployment name लक्षात ठेवा.

• AZURE_OPENAI_CHAT_DEPLOYMENT_NAME - तुमचा चॅट मॉडेल निवडा (उदा., gpt-4o-mini) आणि मॉडेल तपशीलांमधून Deployment name लक्षात ठेवा.

Azure Portal

• 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 अंतर्गत भेट द्या.

Keyless authentication सेटअप करा

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

from azure.identity import DefaultAzureCredential, InteractiveBrowserCredential

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

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

पुढचा धडा

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

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

---

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

This site is open source. Improve this page.