ai-agents-for-beginners

कोर्स सेटअप

परिचय

यो पाठले यस कोर्सका कोड नमूनाहरू कसरी चलाउने भन्ने बारेमा चर्चा गर्नेछ।

अन्य सिक्नेहरूमा सामेल हुनुहोस् र सहयोग प्राप्त गर्नुहोस्

तपाईंको रिपोजिटरी क्लोन गर्न सुरु गर्नु अघि, AI Agents For Beginners Discord च्यानल मा सामेल हुनुहोस्। यहाँ तपाईं सेटअपमा सहयोग प्राप्त गर्न, कोर्सका बारेमा कुनै प्रश्न सोध्न, वा अन्य सिक्नेहरूसँग जडान गर्न सक्नुहुन्छ।

यो रिपोजिटरी क्लोन वा फोर्क गर्नुहोस्

सुरु गर्नको लागि, कृपया GitHub रिपोजिटरी क्लोन वा फोर्क गर्नुहोस्। यसले तपाईंलाई कोर्स सामग्रीको आफ्नै संस्करण बनाउनेछ ताकि तपाईं कोड चलाउन, परीक्षण गर्न, र परिमार्जन गर्न सक्नुहुन्छ!

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

अब तपाईंको कोर्सको फोर्क गरिएको संस्करण निम्न लिंकमा उपलब्ध हुनेछ:

Forked Repo

शालो क्लोन (वर्कशप / Codespaces का लागि सिफारिस गरिएको)

पूर्ण रिपोजिटरी ठूलो (~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 Codespaces प्रयोग गर्दै (स्थानीय ठूलो डाउनलोडहरू रोक्न सिफारिस गरिएको)

सुझावहरू

कोड चलाउने

यो कोर्सले 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) लेबल गरिएको।

हामी तपाईंलाई तीन प्रकारका उदाहरणहरू प्रयास गर्न प्रोत्साहित गर्दछौं ताकि कुन तपाईंको लागि उत्तम काम गर्दछ भनेर थाहा पाउन सक्नुहुन्छ।

तपाईंले जुन विकल्प चयन गर्नुहुन्छ, त्यसले तलका सेटअप चरणहरू निर्धारण गर्नेछ:

आवश्यकताहरू

हामीले यस रिपोजिटरीको मूलमा requirements.txt फाइल समावेश गरेका छौं जसमा कोड नमूनाहरू चलाउन आवश्यक सबै Python प्याकेजहरू समावेश छन्।

तपाईं यसलाई निम्न आदेश चलाएर स्थापना गर्न सक्नुहुन्छ:

pip install -r requirements.txt

हामी कुनै पनि द्वन्द्व र समस्याहरूबाट बच्न Python भर्चुअल वातावरण सिर्जना गर्न सिफारिस गर्दछौं।

VSCode सेटअप

सुनिश्चित गर्नुहोस् कि तपाईं VSCode मा सही संस्करणको Python प्रयोग गर्दै हुनुहुन्छ।

image

GitHub Models प्रयोग गरेर नमूनाहरूको सेटअप

चरण 1: तपाईंको GitHub व्यक्तिगत पहुँच टोकन (PAT) प्राप्त गर्नुहोस्

यो कोर्सले GitHub Models Marketplace प्रयोग गर्दछ, जसले तपाईंलाई AI एजेन्टहरू निर्माण गर्न प्रयोग गरिने Large Language Models (LLMs) को निःशुल्क पहुँच प्रदान गर्दछ।

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. टोकनको उद्देश्यलाई प्रतिबिम्बित गर्ने वर्णनात्मक नाम प्रविष्ट गर्नुहोस् ताकि पछि सजिलै चिन्ह लगाउन सकियोस्।

    🔐 टोकन अवधि सिफारिस

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

    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 मा साइन इन गर्नुहोस्

सुरक्षाको उत्तम अभ्यासको रूपमा, हामी keyless authentication प्रयोग गर्नेछौं Microsoft Entra ID सँग Azure OpenAI मा प्रमाणित गर्न।

अर्को, टर्मिनल खोल्नुहोस् र az login --use-device-code चलाएर Azure खातामा साइन इन गर्नुहोस्।

एक पटक तपाईं साइन इन गरेपछि, टर्मिनलमा आफ्नो सदस्यता चयन गर्नुहोस्।

अतिरिक्त वातावरण चरहरू - Azure Search र Azure OpenAI

Agentic RAG पाठ - पाठ ५ - मा नमूनाहरू छन् जसले Azure Search र Azure OpenAI प्रयोग गर्दछ।

यदि तपाईं यी नमूनाहरू चलाउन चाहनुहुन्छ भने, तपाईंले आफ्नो .env फाइलमा निम्न वातावरण चरहरू थप्न आवश्यक छ:

ओभरभ्यू पृष्ठ (प्रोजेक्ट)

व्यवस्थापन केन्द्र

मोडेलहरू + अन्त बिन्दु पृष्ठ

Azure पोर्टल

बाह्य वेबपेज

Keyless authentication सेटअप गर्नुहोस्

तपाईंको प्रमाणहरू हार्डकोड नगर्ने, हामी Azure OpenAI सँग keyless कनेक्शन प्रयोग गर्नेछौं। यसका लागि, हामी DefaultAzureCredential आयात गर्नेछौं र पछि DefaultAzureCredential फङ्सनलाई प्रमाण प्राप्त गर्न कल गर्नेछौं।

from azure.identity import DefaultAzureCredential, InteractiveBrowserCredential

कतै अड्किनुभयो?

यदि तपाईंलाई यो सेटअप चलाउन कुनै समस्या छ भने, हाम्रो Azure AI Community Discord मा सामेल हुनुहोस् वा समस्या सिर्जना गर्नुहोस्

अर्को पाठ

अब तपाईं यस पाठ्यक्रमको कोड चलाउन तयार हुनुहुन्छ। AI एजेन्टहरूको संसारबारे थप सिक्न शुभकामना!

AI एजेन्टहरू र एजेन्ट प्रयोग केसहरूको परिचय


अस्वीकरण:
यो दस्तावेज़ AI अनुवाद सेवा Co-op Translator प्रयोग गरेर अनुवाद गरिएको छ। हामी शुद्धताको लागि प्रयास गर्छौं, तर कृपया ध्यान दिनुहोस् कि स्वचालित अनुवादहरूमा त्रुटिहरू वा अशुद्धताहरू हुन सक्छ। यसको मूल भाषा मा रहेको दस्तावेज़लाई आधिकारिक स्रोत मानिनुपर्छ। महत्वपूर्ण जानकारीको लागि, व्यावसायिक मानव अनुवाद सिफारिस गरिन्छ। यस अनुवादको प्रयोगबाट उत्पन्न हुने कुनै पनि गलतफहमी वा गलत व्याख्याको लागि हामी जिम्मेवार हुने छैनौं।