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

जब तपाइँ सम्पूर्ण इतिहास र सबै फाइलहरू डाउनलोड गर्नुहुन्छ, पूरै रिपोजिटरी ठूलो (~3 GB) हुन सक्छ। यदि तपाइँ केवल कार्यशालामा सहभागी हुनुभएको छ वा केवल केही पाठ फोल्डरहरू चाहिन्छ भने, शैलो क्लोन (वा sparse clone) ले इतिहासलाई छोट्याएर र/वा ब्लोबहरू छोडेर अधिकांश डाउनलोडबाट बचाउँछ।
तलका आदेशहरूमा <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
यसले आंशिक क्लोन र sparse-checkout प्रयोग गर्छ (Git 2.25+ र partial clone समर्थन सहितको आधुनिक Git सिफारिस गरिएको):
git clone --depth 1 --filter=blob:none --sparse https://github.com/<your-username>/ai-agents-for-beginners.git
रिपो फोल्डरमा जानुहोस्:
cd ai-agents-for-beginners
त्यसपछि कुन फोल्डरहरू चाहिन्छ भनेर निर्दिष्ट गर्नुहोस् (तलको उदाहरणले दुई फोल्डर देखाउँछ):
git sparse-checkout set 00-course-setup 01-intro-to-ai-agents
क्लोन र फाइलहरू प्रमाणित गरेपछि, यदि तपाइँलाई केवल फाइलहरू चाहिन्छ र स्थान खाली गर्न चाहनुहुन्छ (गिट इतिहास बिना), कृपया रिपोजिटरी मेटाडाटा मेटाउनुहोस् (💀अप्रतिवर्ती — तपाइँ सबै Git कार्यक्षमता गुमाउनुहुनेछ: कुनै कमिट, पुल, पुश, वा इतिहास पहुँच छैन)।
# zsh/bash
rm -rf .git
# पावरशेल
Remove-Item -Recurse -Force .git
यस रिपोको लागि GitHub UI मार्फत नयाँ Codespace सिर्जना गर्नुहोस्।
यस कोर्सले AI एजेन्टहरू निर्माण गर्ने व्यावहारिक अनुभवका लागि जुपिटर नोटबुकहरूको श्रृंखला प्रस्ताव गर्दछ ।
कोड नमुनाहरूले Microsoft Agent Framework (MAF) प्रयोग गर्छन् FoundryChatClient सँग, जुन Microsoft Foundry Agent Service V2 (Responses API) मा Microsoft Foundry मार्फत जडित हुन्छ।
सबै Python नोटबुकहरू *-python-agent-framework.ipynb नामले लेबल गरिएका छन्।
नोट: यदि तपाइँसँग Python3.12 इन्स्टल छैन भने, कृपया इन्स्टल गर्नुहोस्। त्यसपछि python3.12 प्रयोग गरेर आफ्नो venv बनाउनुहोस् ताकि requirements.txt फाइलबाट सहि संस्करणहरू इन्स्टल होस्।
उदाहरण
Python venv निर्देशिका बनाउनुहोस्:
python -m venv venv
त्यसपछि venv वातावरण एक्टिभेट गर्नुहोस्:
# zsh/bash
source venv/bin/activate
# Command Prompt for Windows
venv\Scripts\activate
.NET 10+: .NET प्रयोग गरियो भने, सुनिश्चित गर्नुहोस् कि .NET 10 SDK वा पछि भर्सन इन्स्टल छ। त्यसपछि तपाइँको इन्स्टल गरिएको .NET SDK संस्करण जाँच गर्नुहोस्:
dotnet --list-sdks
gpt-4.1-mini)। हेर्नुहोस् चरण 1 तल।हामीले यस रिपोजिटरीको रुटमा requirements.txt फाइल समावेश गरेका छौँ जुन कोड नमुनाहरू चलाउन आवश्यक सबै Python प्याकेजहरू समावेश गर्दछ।
तपाइँले यसलाई रिपोजिटरीको रुटमा टर्मिनलमा निम्न आदेश चलाएर इन्स्टल गर्न सक्नुहुन्छ:
pip install -r requirements.txt
हामी सिफारिस गर्छौं कि कुनै पनि द्विविधा र समस्या टार्न Python भर्चुअल वातावरण सिर्जना गर्नुहोस्।
सुनिश्चित गर्नुहोस् कि तपाइँ VSCode मा सहि Python संस्करण प्रयोग गर्दै हुनुहुन्छ।
नोटबुकहरू चलाउन तपाइँलाई Microsoft Foundry hub र तैनाथ गरिएको मोडेल सहितको project आवश्यक छ।
gpt-4.1-mini)।Microsoft Foundry पोर्टलमा आफ्नो प्रोजेक्टबाट:

gpt-4.1-mini)।az login मार्फत साइन इन गर्नुहोस्सबै नोटबुकहरूले प्रमाणीकरणका लागि AzureCliCredential प्रयोग गर्छन् — कुनै API कुञ्जीहरू व्यवस्थापन गर्न हुँदैन। यसले तपाइँले Azure CLI मार्फत साइन इन गर्न आवश्यक पर्छ।
Azure CLI इन्स्टल गर्नुहोस् यदि पहिले गरेको छैन भने: aka.ms/installazurecli
साइन इन गर्न यो चलाउनुहोस्:
az login
वा यदि तपाइँ ब्राउजर बिना रिमोट/Codespace वातावरणमा हुनुहुन्छ भने:
az login --use-device-code
आवश्यक भएमा आफ्नो सदस्यता चयन गर्नुहोस् — आफ्नो Foundry प्रोजेक्ट भएको सदस्यता छनौट गर्नुहोस्।
सत्यापन गर्नुहोस् तपाईँ साइन इन हुनुहुन्छ:
az account show
किन
az login? नोटबुकहरूलेazure-identityप्याकेजबाटAzureCliCredentialप्रयोग गर्छन्। यसको मतलब तपाइँको Azure CLI सत्रले प्रमाणीकरण प्रदान गर्छ — तपाइँको.envफाइलमा कुनै API कुञ्जी वा गोप्य जानकारी हुँदैन। यो सुरक्षा राम्रो अभ्यास हो।
.env फाइल सिर्जना गर्नुहोस्उदाहरण फाइल कपी गर्नुहोस्:
# zsh/bash
cp .env.example .env
# पावरशेल
Copy-Item .env.example .env
.env खोल्नुहोस् र यी दुई मानहरू भर्नुहोस्:
AZURE_AI_PROJECT_ENDPOINT=https://<your-project>.services.ai.azure.com/api/projects/<your-project-id>
AZURE_AI_MODEL_DEPLOYMENT_NAME=gpt-4.1-mini
| चर | कहाँ फेला पार्ने |
|---|---|
AZURE_AI_PROJECT_ENDPOINT |
Foundry पोर्टल → तपाइँको प्रोजेक्ट → Overview पृष्ठ |
AZURE_AI_MODEL_DEPLOYMENT_NAME |
Foundry पोर्टल → Models + Endpoints → तपाइँको तैनाथ गरिएको मोडेलको नाम |
त्यति नै अधिकांश पाठहरूको लागि! नोटबुकहरूले अपनेआप तपाइँको az login सत्रमार्फत प्रमाणीकरण गर्नेछ।
pip install -r requirements.txt
हामी सिफारिस गर्छौं कि तपाइँले यसलाई पहिले सिर्जना गरेको भर्चुअल वातावरण भित्र चलाउनुहोस्।
पाठ 5 ले Azure AI Search प्रयोग गर्छ retrieval-augmented generation का लागि। यदि तपाइँ यो पाठ चलाउन योजना बनाउनु भएको छ भने, यी चरहरू आफ्नो .env फाइलमा थप्नुहोस्:
| चर | कहाँ फेला पार्ने |
|---|---|
AZURE_SEARCH_SERVICE_ENDPOINT |
Azure पोर्टल → तपाइँको Azure AI Search स्रोत → Overview → URL |
AZURE_SEARCH_API_KEY |
Azure पोर्टल → तपाइँको Azure AI Search स्रोत → Settings → Keys → प्राथमिक प्रशासक कुञ्जी |
पाठ 6 र 8 का केही नोटबुकहरू Microsoft Foundry प्रोजेक्ट मार्फत नजाई सिधै Azure OpenAI (Responses API प्रयोग गरेर) लाई कल गर्छन्। यी नमुनाहरू पहिले GitHub Models प्रयोग गर्थे, जुन अब अवसाद भईरहेको छ (जुलाई 2026 मा अवसान हुँदैछ) र Responses API समर्थन गर्दैन। यदि तपाइँ ती नमुनाहरू चलाउन योजना बनाउनु भएको छ भने, यी चरहरू आफ्नो .env फाइलमा थप्नुहोस्:
| चर | कहाँ फेला पार्ने |
|---|---|
AZURE_OPENAI_ENDPOINT |
Azure पोर्टल → तपाइँको Azure OpenAI स्रोत → Keys and Endpoint → Endpoint (जस्तै https://<your-resource>.openai.azure.com) |
AZURE_OPENAI_DEPLOYMENT |
तपाइँको तैनाथ गरिएको मोडेलको नाम (जस्तै gpt-4.1-mini) जुन Responses API समर्थन गर्छ |
AZURE_OPENAI_API_KEY |
वैकल्पिक — केवल यदि तपाइँ az login / Entra ID को सट्टा कुञ्जी आधारित प्रमाणीकरण प्रयोग गर्नुहुन्छ भने |
Responses API स्थिर
/openai/v1/endpoint प्रयोग गर्छ, त्यसैले कुनैapi-versionआवश्यक छैन। कुञ्जी रहित Entra ID प्रमाणीकरण प्रयोग गर्नaz loginमार्फत साइन इन गर्नुहोस्।
MiniMax ले ठूलो सन्दर्भ मोडेलहरू (अधिकतम 204K टोकन्स) OpenAI अनुकूल API मार्फत प्रदान गर्दछ। Microsoft Agent Framework को OpenAIChatClient कुनै पनि OpenAI अनुकूल endpoint मा काम गर्छ, त्यसैले तपाइँ MiniMax लाई Azure OpenAI वा OpenAI को सट्टामा सजिलै प्रयोग गर्न सक्नुहुन्छ।
यी चरहरू आफ्नो .env फाइलमा थप्नुहोस्:
| चर | कहाँ फेला पार्ने |
|---|---|
MINIMAX_API_KEY |
MiniMax Platform → API कुञ्जीहरू |
MINIMAX_BASE_URL |
https://api.minimax.io/v1 (पूर्वनिर्धारित मान) प्रयोग गर्नुहोस् |
MINIMAX_MODEL_ID |
प्रयोग गर्न मोडेल नाम (जस्तै, MiniMax-M3) |
उदाहरण मोडेलहरू: MiniMax-M3 (सिफारिस गरिएको), MiniMax-M2.7, MiniMax-M2.7-highspeed (छिटो प्रतिक्रिया दिने)। मोडेल नाम र उपलब्धता समयसँग परिवर्तन हुन सक्छ, र तपाइँको खाता वा क्षेत्र अनुसार विभिन्न हुन सक्छ — हालको सूचीका लागि MiniMax Platform हेर्नुहोस्। यदि MiniMax-M3 तपाइँको खातामा उपलब्ध छैन भने, तपाइँले पहुँच भएको कुनै मोडेल चयन गर्नुहोस् (जस्तै MiniMax-M2.7)।
OpenAIChatClient प्रयोग गर्ने कोड नमुनाहरू (जस्तै, पाठ 14 होटल बुकिंग कार्यप्रवाह) स्वचालित रूपमा तपाइँको MiniMax कन्फिगर देखेर MINIMAX_API_KEY सेट हुँदा त्यसलाई प्रयोग गर्नेछन्।
Foundry Local एक हलुका रनटाइम हो जुन भाषिक मोडेलहरू पूर्ण रूपमा आफ्नो मेसिनमा डाउनलोड, व्यवस्थापन, र सेवा गर्छ OpenAI-अनुकूल API मार्फत — कुनै क्लाउड, Azure सदस्यता, वा API कुञ्जीहरू बिना। यो अफलाइन विकास, क्लाउड खर्च बिना प्रयोग, वा डाटा डिभाइसमै राख्नको लागि उत्कृष्ट विकल्प हो।
किनभने Microsoft Agent Framework को OpenAIChatClient कुनै पनि OpenAI-अनुकूल endpoint सँग काम गर्छ, Foundry Local Azure OpenAI को लागि स्थानीय विकल्प हो।
1. Foundry Local इन्स्टल गर्नुहोस्
# विन्डोज
winget install Microsoft.FoundryLocal
# म्याकओएस
brew install foundrylocal
2. मोडेल डाउनलोड र चलाउनुहोस् (यसले स्थानीय सेवा पनि सुरु गर्छ):
foundry model list # उपलब्ध मोडेलहरू हेर्नुहोस्
foundry model run phi-4-mini
3. Python SDK इन्स्टल गर्नुहोस् जुन स्थानीय endpoint पत्ता लगाउन प्रयोग हुन्छ:
pip install foundry-local-sdk
4. Microsoft Agent Framework लाई तपाइँको स्थानीय मोडेल तर्फ निर्देशित गर्नुहोस्:
from foundry_local import FoundryLocalManager
from agent_framework.openai import OpenAIChatClient
# मोडेललाई आवश्यक परे डाउनलोड गरी स्थानीय रूपमा सेवा गर्छ, त्यसपछि अन्त बिन्दु/पोर्ट पत्ता लगाउँछ।
manager = FoundryLocalManager("phi-4-mini")
chat_client = OpenAIChatClient(
base_url=manager.endpoint, # जस्तै http://localhost:<port>/v1
api_key=manager.api_key, # Foundry Local का लागि सधैं "आवश्यक छैन" ।
model_id=manager.get_model_info("phi-4-mini").id,
)
agent = chat_client.as_agent(
name="LocalAgent",
instructions="You are a helpful assistant running fully on-device.",
)
नोट: Foundry Local ले OpenAI-अनुकूल Chat Completions endpoint खुला गर्दछ। यो स्थानीय विकास र अफलाइन केसहरूका लागि प्रयोग गर्नुहोस्। पूर्ण Responses API सुविधाका लागि (स्टेटफुल कुराकानीहरू, गहिरो उपकरण आयोजन, एजेन्ट-शैली विकास), Azure OpenAI वा Microsoft Foundry प्रोजेक्टलाई निशाना बनाउनुहोस् जस्तो कि पाठहरूमा देखाइएको छ। हालको मोडेल सूची र प्लेटफर्म समर्थनका लागि Foundry Local documentation हेर्नुहोस्।
पाठ ८ मा रहेको सर्तसापेक्ष वर्कफ्लो नोटबुकले माइक्रोसफ्ट फाउन्ड्रीमार्फत बिंग ग्राउन्डिङ् प्रयोग गर्दछ। यदि तपाईं त्यो नमुना चलाउने योजना बनाउनु भएको छ भने, आफ्नो .env फाइलमा यो चर थप्नुहोस्:
| चर | कहाँ पाउने |
|---|---|
BING_CONNECTION_ID |
माइक्रोसफ्ट फाउन्ड्री पोर्टल → तपाईंको परियोजना → Management → Connected resources → तपाईंको बिंग कनेक्सन → कनेक्सन आईडी कपी गर्नुहोस् |
यदि तपाईं macOS मा हुनुहुन्छ र यस्तो त्रुटि आउँछ भने:
ssl.SSLCertVerificationError: [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: self-signed certificate in certificate chain
यो macOS मा पाइथनसँग सम्बन्धित ज्ञात समस्या हो जहाँ प्रणालीको SSL प्रमाणपत्रहरू स्वतः विश्वासयोग्य हुँदैनन्। तलका समाधानहरू क्रमशः प्रयास गर्नुहोस्:
विकल्प १: पाइथनको Install Certificates स्क्रिप्ट चलाउनुहोस् (सिफारिस गरिन्छ)
# 3.XX लाई तपाईंले स्थापना गरेको Python संस्करण (जस्तै, 3.12 वा 3.13) सँग बदल्नुहोस्:
/Applications/Python\ 3.XX/Install\ Certificates.command
विकल्प २: तपाईंको नोटबुकमा connection_verify=False प्रयोग गर्नुहोस् (मात्र GitHub Models नोटबुकहरूमा)
पाठ ६ को नोटबुक (06-building-trustworthy-agents/code_samples/06-system-message-framework.ipynb) मा, एक कमेन्ट गरिएको समाधानले पहिले नै यो समावेश गरेको छ। क्लाइन्ट बनाउँदा connection_verify=False अनकमेन्ट गर्नुहोस्:
client = ChatCompletionsClient(
endpoint=endpoint,
credential=AzureKeyCredential(token),
connection_verify=False, # प्रमाणपत्र त्रुटिहरू आएमा एसएसएल प्रमाणीकरण अक्षम गर्नुहोस्
)
⚠️ चेतावनी: SSL प्रमाणीकरण अक्षम गर्दा (
connection_verify=False) प्रमाणपत्र जाँच नगरेर सुरक्षा कम हुन्छ। विकास वातावरणमा अस्थायी समाधानको रूपमा मात्र प्रयोग गर्नुहोस्, उत्पादनमा कहिल्यै होइन।
विकल्प ३: truststore इन्स्टल गरी प्रयोग गर्नुहोस्
pip install truststore
त्यसपछि तपाईंको नोटबुक वा स्क्रिप्टको सुरुमा कुनै पनि नेटवर्क कल गर्नु अघि यो थप्नुहोस्:
import truststore
truststore.inject_into_ssl()
यदि तपाईंलाई यो सेटअप चलाउन कुनै समस्या छ भने, हाम्रो Azure AI Community Discord मा सहभागी हुनुहोस् वा issue सिर्जना गर्नुहोस्।
अब तपाईं यो कोर्सको कोड चलाउन तयार हुनुहुन्छ। एआई एजेन्टहरूको संसारबारे थप जान्न सफल हुनुहोस्!
एआई एजेन्टहरूको परिचय र एजेन्ट प्रयोग केसहरू
अस्वीकरण: यो दस्तावेज़ AI अनुवाद सेवा Co-op Translator प्रयोग गरेर अनुवाद गरिएको हो। हामी सही हुन प्रयास गर्छौं, तर कृपया जानकार हुनुस् कि स्वचालित अनुवादमा त्रुटिहरू वा अशुद्धताहरू हुन सक्छन्। मूल दस्तावेज़ यसको मूल भाषामा आधिकारिक स्रोत मानिनुपर्छ। महत्वपूर्ण जानकारीका लागि व्यावसायिक मानव अनुवाद सिफारिस गरिन्छ। यस अनुवादको प्रयोगबाट उत्पन्न कुनै पनि गलत बुझाइ वा त्रुटिको लागि हामी जिम्मेवार छैनौं।