ဒီသင်ခန်းစာမှာ ဒီသင်တန်းရဲ့ ကုဒ်နမူနာတွေကို ဘယ်လိုအသုံးပြုရမလဲဆိုတာကို ဖော်ပြပေးမှာဖြစ်ပါတယ်။
သင့်ရဲ့ repo ကို clone လုပ်ဖို့မစတင်ခင် AI Agents For Beginners Discord channel ကို join လုပ်ပြီး setup အတွက် အကူအညီရယူပါ၊ သင်တန်းနဲ့ပတ်သက်တဲ့မေးခွန်းတွေမေးပါ၊ ဒါမှမဟုတ် အခြားလေ့လာသူတွေနဲ့ ဆက်သွယ်ပါ။
စတင်ရန်အတွက် GitHub Repository ကို clone လုပ်ပါ ဒါမှမဟုတ် fork လုပ်ပါ။ ဒါက သင့်ကိုယ်ပိုင် သင်တန်းစာအုပ်ကို ရရှိစေပြီး ကုဒ်တွေကို run, test, ပြင်ဆင်နိုင်ပါမယ်။
ဒီအရာကို repo ကို fork လုပ်ရန် လင့်ခ်ကို နှိပ်ခြင်းဖြင့် ပြုလုပ်နိုင်ပါတယ်။
အခု သင့်မှာ ဒီသင်တန်းရဲ့ fork လုပ်ထားတဲ့ ကိုယ်ပိုင် version ကို အောက်ပါလင့်ခ်မှာ ရရှိထားပါပြီ။

အပြည့်အစုံ repository ကို download လုပ်တဲ့အခါမှာ အလွန်ကြီးမားတဲ့ (~3 GB) file တွေကို download လုပ်ရနိုင်ပါတယ်။ Workshop တက်ရောက်ဖို့ ဒါမှမဟုတ် သင်ခန်းစာ folder အနည်းငယ်သာလိုအပ်တဲ့အခါမှာ shallow clone (ဒါမှမဟုတ် sparse clone) က history အများစုကို truncate လုပ်ပြီး blob တွေကို skip လုပ်ခြင်းဖြင့် download အများဆုံးကို ရှောင်ရှားနိုင်ပါတယ်။
အောက်ပါ command တွေမှာ <your-username> ကို သင့် fork URL (ဒါမှမဟုတ် သင့်အကြိုက်အတိုင်း upstream URL) နဲ့ အစားထိုးပါ။
နောက်ဆုံး commit history ကိုသာ clone လုပ်ရန် (download အနည်းဆုံး):
git clone --depth 1 https://github.com/<your-username>/ai-agents-for-beginners.git
တစ်ခုချင်း branch ကို clone လုပ်ရန်:
git clone --depth 1 --branch <branch-name> https://github.com/<your-username>/ai-agents-for-beginners.git
ဒီအရာက partial clone နဲ့ sparse-checkout ကို အသုံးပြုပါတယ် (Git 2.25+ လိုအပ်ပြီး partial clone ကို ပံ့ပိုးတဲ့ Git version အသစ်ကို အကြံပြုပါတယ်):
git clone --depth 1 --filter=blob:none --sparse https://github.com/<your-username>/ai-agents-for-beginners.git
repo folder ထဲကို ဝင်ပါ:
bash အတွက်:
cd ai-agents-for-beginners
Powershell အတွက်:
Set-Location ai-agents-for-beginners
ထို့နောက် သင်လိုအပ်တဲ့ folder တွေကို သတ်မှတ်ပါ (အောက်မှာ ဥပမာအနေနဲ့ folder နှစ်ခုကို ပြထားပါတယ်):
git sparse-checkout set 00-course-setup 01-intro-to-ai-agents
clone လုပ်ပြီး file တွေကို အတည်ပြုပြီးနောက်မှာ၊ file တွေကိုသာလိုအပ်ပြီး နေရာလွတ်ချင်ရင် (git history မပါ) repository metadata ကို delete လုပ်ပါ (💀မပြန်လည်ပြင်နိုင် — Git functionality အားလုံးကို ဆုံးရှုံးပါမည်: commit, pull, push, ဒါမှမဟုတ် history access မရှိပါ):
Linux/macOS အတွက်:
rm -rf .git
Windows အတွက်:
Remove-Item -Recurse -Force .git
GitHub UI မှတဆင့် ဒီ repo အတွက် Codespace အသစ်တစ်ခုကို ဖန်တီးပါ။
ဒီသင်တန်းက AI Agents တည်ဆောက်ခြင်းကို လက်တွေ့လုပ်ဆောင်နိုင်ဖို့ Jupyter Notebooks တွေကို ပေးထားပါတယ်။
ကုဒ်နမူနာတွေမှာ အောက်ပါအတိုင်း အသုံးပြုထားပါတယ် -
GitHub Account လိုအပ်သည် - အခမဲ့:
1) Semantic Kernel Agent Framework + GitHub Models Marketplace. (semantic-kernel.ipynb) အဖြစ် label လုပ်ထားသည်။ 2) AutoGen Framework + GitHub Models Marketplace. (autogen.ipynb) အဖြစ် label လုပ်ထားသည်။
Azure Subscription လိုအပ်သည်: 3) Azure AI Foundry + Azure AI Agent Service. (azureaiagent.ipynb) အဖြစ် label လုပ်ထားသည်။
ဒီနမူနာ ၃ ခုလုံးကို စမ်းသုံးဖို့ အကြံပြုပါတယ်၊ ဘယ်ဟာက သင့်အတွက် အကောင်းဆုံးဖြစ်မလဲဆိုတာကို သိနိုင်ဖို့။
သင်ရွေးချယ်တဲ့ option တစ်ခုတည်းက အောက်မှာဖော်ပြထားတဲ့ setup အဆင့်တွေကို သင်လိုက်နာဖို့လိုအပ်မှုကို သတ်မှတ်ပေးပါမယ်။
NOTE: Python3.12 မရှိရင် install လုပ်ပါ။ ထို့နောက် requirements.txt file မှာပါဝင်တဲ့ version တွေကို install လုပ်ဖို့ python3.12 ကို အသုံးပြုပြီး venv ကို ဖန်တီးပါ။
ဥပမာ
Python venv directory ကို ဖန်တီးပါ:
python3 -m venv venv
ထို့နောက် venv environment ကို activate လုပ်ပါ:
macOS နှင့် Linux အတွက်
source venv/bin/activate
Windows အတွက်
venv\Scripts\activate
ဒီ repository ရဲ့ root မှာ requirements.txt file ကို ထည့်သွင်းထားပြီး ကုဒ်နမူနာတွေကို run လုပ်ဖို့လိုအပ်တဲ့ Python packages တွေပါဝင်ပါတယ်။
အောက်ပါ command ကို terminal မှာ run လုပ်ခြင်းဖြင့် install လုပ်နိုင်ပါတယ်:
pip install -r requirements.txt
Python virtual environment ကို ဖန်တီးပြီး conflicts နဲ့ ပြဿနာတွေကို ရှောင်ရှားဖို့ အကြံပြုပါတယ်။
VSCode မှာ Python version မှန်ကန်တဲ့အရာကို အသုံးပြုနေကြောင်း သေချာပါစေ။
ဒီသင်တန်းက GitHub Models Marketplace ကို အသုံးပြုပြီး သင် AI Agents တည်ဆောက်ဖို့ အသုံးပြုမယ့် Large Language Models (LLMs) ကို အခမဲ့ access ရရှိစေပါတယ်။
GitHub Models ကို အသုံးပြုဖို့ GitHub Personal Access Token ကို ဖန်တီးဖို့လိုအပ်ပါတယ်။
ဒီအရာကို သင့် GitHub Account ရဲ့ Personal Access Tokens settings ကိုသွားပြီး ပြုလုပ်နိုင်ပါတယ်။
Token ကို ဖန်တီးတဲ့အခါ Principle of Least Privilege ကို လိုက်နာပါ။ ဒါက သင့် token ကို ဒီသင်တန်းရဲ့ ကုဒ်နမူနာတွေကို run လုပ်ဖို့လိုအပ်တဲ့ permission တွေကိုသာပေးဖို့ အဓိကပါ။
Developer settings ကိုသွားပြီး ဘယ်ဘက်ဘက်မှာရှိတဲ့ Fine-grained tokens option ကို ရွေးပါ။

ထို့နောက် Generate new token ကို ရွေးပါ။

Token ရဲ့ ရည်ရွယ်ချက်ကို ဖော်ပြတဲ့ အမည်တစ်ခုကို ထည့်သွင်းပြီး နောက်ပိုင်းမှာ အလွယ်တကူသိနိုင်အောင် ပြုလုပ်ပါ။
🔐 Token Duration အကြံပြုချက်
အကြံပြုထားသော သက်တမ်း: ၃၀ ရက် ပိုမိုလုံခြုံမှုရှိစေရန် အတိုချုပ်တဲ့ကာလကို ရွေးချယ်နိုင်ပါတယ်—ဥပမာ ၇ ရက် 🛡️ သင့်ရဲ့ သင်ယူမှုအလှုပ်လှုပ်ရှိနေစဉ်အတွင်း သင်တန်းကို ပြီးမြောက်စေရန် ကိုယ်ပိုင်ပန်းတိုင်တစ်ခုကို သတ်မှတ်နိုင်ပါတယ် 🚀။

Token ရဲ့ scope ကို ဒီ repository ရဲ့ fork အတွက်သာ ကန့်သတ်ပါ။

Token ရဲ့ permissions ကို ကန့်သတ်ပါ: Permissions အောက်မှာ Account tab ကို click လုပ်ပြီး “+ Add permissions” button ကို click လုပ်ပါ။ Dropdown တစ်ခု ပေါ်လာပါမယ်။ Models ကို ရှာပြီး box ကို check လုပ်ပါ။

Token ကို generate လုပ်မည့်အခါမှာ လိုအပ်တဲ့ permissions တွေကို အတည်ပြုပါ။ 
Token ကို generate လုပ်မည့်အခါမှာ password manager vault ကဲ့သို့သော လုံခြုံတဲ့နေရာမှာ token ကို သိမ်းဆည်းဖို့ ပြင်ဆင်ထားပါ။ Token ကို ဖန်တီးပြီးနောက်မှာ ပြန်လည်ကြည့်နိုင်မှာမဟုတ်ပါဘူး။ 
သင် vừa ဖန်တီးထားတဲ့ token ကို copy လုပ်ပါ။ အခု သင့်ရဲ့ .env file ထဲကို ဒီ token ကို ထည့်သွင်းပါ။
.env File ကို ဖန်တီးပါသင့် terminal မှာ အောက်ပါ command ကို run လုပ်ပြီး .env file ကို ဖန်တီးပါ။
cp .env.example .env
ဒီအရာက example file ကို copy လုပ်ပြီး .env file ကို directory ထဲမှာ ဖန်တီးပါမယ်။ ထို့နောက် environment variables အတွက် value တွေကို ဖြည့်ပါ။
သင့် token ကို copy လုပ်ပြီး .env file ကို သင့်အကြိုက်ဆုံး text editor မှာ ဖွင့်ပြီး GITHUB_TOKEN field ထဲကို paste လုပ်ပါ။

အခု သင် ဒီသင်တန်းရဲ့ ကုဒ်နမူနာတွေကို run လုပ်နိုင်ပါပြီ။
Azure AI Foundry မှာ hub နဲ့ project တစ်ခုကို ဖန်တီးခြင်းအဆင့်တွေကို ဒီမှာ လိုက်နာပါ: Hub resources overview
Project ကို ဖန်တီးပြီးနောက်မှာ project ရဲ့ connection string ကို ရယူဖို့လိုအပ်ပါမယ်။
ဒီအရာကို Azure AI Foundry portal ရဲ့ Overview စာမျက်နှာကိုသွားပြီး ပြုလုပ်နိုင်ပါတယ်။

.env File ကို ဖန်တီးပါသင့် terminal မှာ အောက်ပါ command ကို run လုပ်ပြီး .env file ကို ဖန်တီးပါ။
cp .env.example .env
ဒီအရာက example file ကို copy လုပ်ပြီး .env file ကို directory ထဲမှာ ဖန်တီးပါမယ်။ ထို့နောက် environment variables အတွက် value တွေကို ဖြည့်ပါ။
သင့် token ကို copy လုပ်ပြီး .env file ကို သင့်အကြိုက်ဆုံး text editor မှာ ဖွင့်ပြီး PROJECT_ENDPOINT field ထဲကို paste လုပ်ပါ။
လုံခြုံရေးအကောင်းဆုံးအနေအထားအတွက် Microsoft Entra ID နဲ့ keyless authentication ကို အသုံးပြုပြီး Azure OpenAI ကို authenticate လုပ်ပါ။
နောက်ဆုံးမှာ terminal ကိုဖွင့်ပြီး az login --use-device-code ကို run လုပ်ပြီး သင့် Azure account ကို sign in လုပ်ပါ။
Sign in လုပ်ပြီးနောက်မှာ terminal မှာ သင့် subscription ကို ရွေးချယ်ပါ။
Agentic RAG Lesson - Lesson 5 - မှာ Azure Search နှင့် Azure OpenAI ကို အသုံးပြုတဲ့ နမူနာတွေပါဝင်ပါတယ်။
ဒီနမူနာတွေကို run လုပ်ချင်တယ်ဆိုရင် .env file ထဲမှာ အောက်ပါ environment variables တွေကို ထည့်သွင်းဖို့လိုအပ်ပါတယ်:
AZURE_SUBSCRIPTION_ID - Overview စာမျက်နှာရဲ့ Project details မှာ ကြည့်ပါ။
AZURE_AI_PROJECT_NAME - သင့် project ရဲ့ Overview စာမျက်နှာရဲ့ အပေါ်မှာ ကြည့်ပါ။
AZURE_OPENAI_SERVICE - Overview စာမျက်နှာရဲ့ Included capabilities tab မှာ Azure OpenAI Service ကို ရှာပါ။
AZURE_OPENAI_RESOURCE_GROUP - Management Center ရဲ့ Overview စာမျက်နှာမှာ Project properties ကို သွားပါ။
GLOBAL_LLM_SERVICE - Connected resources အောက်မှာ Azure AI Services connection name ကို ရှာပါ။ မရှိရင် Azure portal မှာ သင့် resource group အောက်မှာ AI Services resource name ကို ကြည့်ပါ။
AZURE_OPENAI_EMBEDDING_DEPLOYMENT_NAME - သင့် embedding model (ဥပမာ text-embedding-ada-002) ကို ရွေးချယ်ပြီး model details မှာ Deployment name ကို မှတ်သားပါ။
AZURE_OPENAI_CHAT_DEPLOYMENT_NAME - သင့် chat model (ဥပမာ gpt-4o-mini) ကို ရွေးချယ်ပြီး model details မှာ Deployment name ကို မှတ်သားပါ။
AZURE_OPENAI_ENDPOINT - Azure AI services ကို ရှာပြီး click လုပ်ပါ၊ ထို့နောက် Resource Management, Keys and Endpoint ကို သွားပြီး “Azure OpenAI endpoints” မှာ “Language APIs” ဆိုတဲ့ endpoint ကို copy လုပ်ပါ။
AZURE_OPENAI_API_KEY - အဲဒီအတူတူ screen မှာ KEY 1 ဒါမှမဟုတ် KEY 2 ကို copy လုပ်ပါ။
AZURE_SEARCH_SERVICE_ENDPOINT - သင့် Azure AI Search resource ကို ရှာပြီး click လုပ်ပါ၊ ထို့နောက် Overview ကို ကြည့်ပါ။
AZURE_SEARCH_API_KEY - Settings ကို သွားပြီး Keys ကို click လုပ်ပြီး primary ဒါမှမဟုတ် secondary admin key ကို copy လုပ်ပါ။
### အကယ်၍ ဒီ setup ကို run လုပ်ရာတွင် ပြဿနာများရှိပါက၊ ကျွန်ုပ်တို့၏ Azure AI Community Discord သို့ ဝင်ရောက်ပါ၊ သို့မဟုတ် issue တစ်ခု ဖန်တီးပါ။
ဒီ course အတွက် code ကို run လုပ်ရန် သင့်အနေဖြင့် အဆင်သင့်ဖြစ်ပါပြီ။ AI Agents အကြောင်းကို ပိုမိုလေ့လာရင်း ပျော်ရွှင်ပါစေ!
AI Agents နှင့် Agent အသုံးပြုမှု အကြောင်းအရာများကို မိတ်ဆက်ခြင်း
အကြောင်းကြားချက်:
ဤစာရွက်စာတမ်းကို AI ဘာသာပြန်ဝန်ဆောင်မှု Co-op Translator ကို အသုံးပြု၍ ဘာသာပြန်ထားပါသည်။ ကျွန်ုပ်တို့သည် တိကျမှုအတွက် ကြိုးစားနေသော်လည်း အလိုအလျောက် ဘာသာပြန်မှုများတွင် အမှားများ သို့မဟုတ် မမှန်ကန်မှုများ ပါဝင်နိုင်သည်ကို သတိပြုပါ။ မူရင်းဘာသာစကားဖြင့် ရေးသားထားသော စာရွက်စာတမ်းကို အာဏာတရ အရင်းအမြစ်အဖြစ် သတ်မှတ်သင့်ပါသည်။ အရေးကြီးသော အချက်အလက်များအတွက် လူ့ဘာသာပြန်ပညာရှင်များကို အသုံးပြုရန် အကြံပြုပါသည်။ ဤဘာသာပြန်မှုကို အသုံးပြုခြင်းမှ ဖြစ်ပေါ်လာသော အလွဲအလွတ်များ သို့မဟုတ် အနားလွဲမှုများအတွက် ကျွန်ုပ်တို့သည် တာဝန်မယူပါ။