यो पाठले यस कोर्सका कोड नमूनाहरू कसरी चलाउने भन्ने बारेमा चर्चा गर्नेछ।
तपाईंको रिपोजिटरी क्लोन गर्न सुरु गर्नु अघि, AI Agents For Beginners Discord च्यानल मा सामेल हुनुहोस्। यहाँ तपाईं सेटअपमा सहयोग प्राप्त गर्न, कोर्सका बारेमा कुनै प्रश्न सोध्न, वा अन्य सिक्नेहरूसँग जडान गर्न सक्नुहुन्छ।
सुरु गर्नको लागि, कृपया GitHub रिपोजिटरी क्लोन वा फोर्क गर्नुहोस्। यसले तपाईंलाई कोर्स सामग्रीको आफ्नै संस्करण बनाउनेछ ताकि तपाईं कोड चलाउन, परीक्षण गर्न, र परिमार्जन गर्न सक्नुहुन्छ!
यो गर्नको लागि रिपोजिटरी फोर्क गर्नुहोस् लिंकमा क्लिक गर्नुहोस्।
अब तपाईंको कोर्सको फोर्क गरिएको संस्करण निम्न लिंकमा उपलब्ध हुनेछ:

पूर्ण रिपोजिटरी ठूलो (~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
रिपोजिटरी फोल्डरमा जानुहोस्:
bash का लागि:
cd ai-agents-for-beginners
Powershell का लागि:
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 मार्फत यस रिपोजिटरीको लागि नयाँ Codespace सिर्जना गर्नुहोस्।
यो कोर्सले Jupyter Notebooks को एक श्रृंखला प्रदान गर्दछ जसले तपाईंलाई AI एजेन्टहरू निर्माण गर्न व्यावहारिक अनुभव प्राप्त गर्न अनुमति दिन्छ।
कोड नमूनाहरू निम्न प्रयोग गर्दछ:
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) लेबल गरिएको।
हामी तपाईंलाई तीन प्रकारका उदाहरणहरू प्रयास गर्न प्रोत्साहित गर्दछौं ताकि कुन तपाईंको लागि उत्तम काम गर्दछ भनेर थाहा पाउन सक्नुहुन्छ।
तपाईंले जुन विकल्प चयन गर्नुहुन्छ, त्यसले तलका सेटअप चरणहरू निर्धारण गर्नेछ:
NOTE: यदि तपाईंले 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 भर्चुअल वातावरण सिर्जना गर्न सिफारिस गर्दछौं।
सुनिश्चित गर्नुहोस् कि तपाईं VSCode मा सही संस्करणको Python प्रयोग गर्दै हुनुहुन्छ।
यो कोर्सले GitHub Models Marketplace प्रयोग गर्दछ, जसले तपाईंलाई AI एजेन्टहरू निर्माण गर्न प्रयोग गरिने Large Language Models (LLMs) को निःशुल्क पहुँच प्रदान गर्दछ।
GitHub Models प्रयोग गर्नको लागि, तपाईंले GitHub Personal Access Token सिर्जना गर्न आवश्यक छ।
यो तपाईंको GitHub खाताको Personal Access Tokens settings मा गएर गर्न सकिन्छ।
कृपया टोकन सिर्जना गर्दा Principle of Least Privilege पालना गर्नुहोस्। यसको मतलब तपाईंले टोकनलाई यस कोर्सका कोड नमूनाहरू चलाउन आवश्यक अनुमतिहरू मात्र दिनुपर्छ।
Developer settings मा गएर स्क्रिनको बायाँपट्टि रहेको Fine-grained tokens विकल्प चयन गर्नुहोस्।

त्यसपछि Generate new token चयन गर्नुहोस्।

टोकनको उद्देश्यलाई प्रतिबिम्बित गर्ने वर्णनात्मक नाम प्रविष्ट गर्नुहोस् ताकि पछि सजिलै चिन्ह लगाउन सकियोस्।
🔐 टोकन अवधि सिफारिस
सिफारिस गरिएको अवधि: ३० दिन अधिक सुरक्षित स्थिति प्राप्त गर्न, तपाईं छोटो अवधि चयन गर्न सक्नुहुन्छ—जस्तै ७ दिन 🛡️ यो व्यक्तिगत लक्ष्य सेट गर्न र कोर्स पूरा गर्नको लागि राम्रो तरिका हो जब तपाईंको सिक्ने गति उच्च छ 🚀।

टोकनको स्कोपलाई यस रिपोजिटरीको फोर्कमा सीमित गर्नुहोस्।

टोकनको अनुमतिहरू सीमित गर्नुहोस्: 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 फिल्डमा टोकन पेस्ट गर्नुहोस्।
सुरक्षाको उत्तम अभ्यासको रूपमा, हामी keyless authentication प्रयोग गर्नेछौं Microsoft Entra ID सँग Azure OpenAI मा प्रमाणित गर्न।
अर्को, टर्मिनल खोल्नुहोस् र az login --use-device-code चलाएर Azure खातामा साइन इन गर्नुहोस्।
एक पटक तपाईं साइन इन गरेपछि, टर्मिनलमा आफ्नो सदस्यता चयन गर्नुहोस्।
Agentic RAG पाठ - पाठ ५ - मा नमूनाहरू छन् जसले 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 - तपाईंको embedding मोडेल चयन गर्नुहोस् (जस्तै, 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 प्रयोग गरेर अनुवाद गरिएको छ। हामी शुद्धताको लागि प्रयास गर्छौं, तर कृपया ध्यान दिनुहोस् कि स्वचालित अनुवादहरूमा त्रुटिहरू वा अशुद्धताहरू हुन सक्छ। यसको मूल भाषा मा रहेको दस्तावेज़लाई आधिकारिक स्रोत मानिनुपर्छ। महत्वपूर्ण जानकारीको लागि, व्यावसायिक मानव अनुवाद सिफारिस गरिन्छ। यस अनुवादको प्रयोगबाट उत्पन्न हुने कुनै पनि गलतफहमी वा गलत व्याख्याको लागि हामी जिम्मेवार हुने छैनौं।