Microsoft Foundry Agent Service-এ AI এজেন্ট তৈরি, পরীক্ষা এবং মোতায়েন করুন Hosted Agents হিসেবে — সম্পূর্ণরূপে VS Code ব্যবহার করে Microsoft Foundry এক্সটেনশন এবং Foundry Toolkit এর মাধ্যমে।
Hosted Agents বর্তমানে প্রিভিউ মোডে আছে। সমর্থিত অঞ্চলগুলি সীমিত - দেখুন অঞ্চল উপলব্ধতা।
প্রতিটি ল্যাবে
agent/ফোল্ডারটি Foundry এক্সটেনশন দ্বারা স্বয়ংক্রিয়ভাবে তৈরি হয় — তারপর আপনি কোড কাস্টমাইজ করেন, স্থানীয়ভাবে পরীক্ষা করেন, এবং মোতায়েন করেন।
Arabic | Bengali | Bulgarian | Burmese (Myanmar) | Chinese (Simplified) | Chinese (Traditional, Hong Kong) | Chinese (Traditional, Macau) | Chinese (Traditional, Taiwan) | Croatian | Czech | Danish | Dutch | Estonian | Finnish | French | German | Greek | Hebrew | Hindi | Hungarian | Indonesian | Italian | Japanese | Kannada | Khmer | Korean | Lithuanian | Malay | Malayalam | Marathi | Nepali | Nigerian Pidgin | Norwegian | Persian (Farsi) | Polish | Portuguese (Brazil) | Portuguese (Portugal) | Punjabi (Gurmukhi) | Romanian | Russian | Serbian (Cyrillic) | Slovak | Slovenian | Spanish | Swahili | Swedish | Tagalog (Filipino) | Tamil | Telugu | Thai | Turkish | Ukrainian | Urdu | Vietnamese
স্থানীয়ভাবে ক্লোন করতে চান?
এই রিপোজিটরিতে ৫০+ ভাষার অনুবাদ অন্তর্ভুক্ত, যা ডাউনলোড সাইজ অনেক বাড়িয়ে দেয়। অনুবাদ ছাড়া ক্লোন করতে স্পার্স চেকআউট ব্যবহার করুন:
Bash / macOS / Linux:
git clone --filter=blob:none --sparse https://github.com/microsoft-foundry/Foundry_Toolkit_for_VSCode_Lab.git cd Foundry_Toolkit_for_VSCode_Lab git sparse-checkout set --no-cone '/*' '!translations' '!translated_images'CMD (Windows):
git clone --filter=blob:none --sparse https://github.com/microsoft-foundry/Foundry_Toolkit_for_VSCode_Lab.git cd Foundry_Toolkit_for_VSCode_Lab git sparse-checkout set --no-cone "/*" "!translations" "!translated_images"এটি দ্রুত ডাউনলোডের মাধ্যমে কোর্স শেষ করার জন্য আপনার প্রয়োজনীয় সবকিছু দেয়।
flowchart TB
subgraph Local["স্থানীয় উন্নয়ন (VS কোড)"]
direction TB
FE["Microsoft Foundry
Extension"]
FoundryToolkit["Foundry Toolkit
Extension"]
Scaffold["Scaffolded Agent Code
(main.py · agent.yaml · Dockerfile)"]
Inspector["Agent Inspector
(Local Testing)"]
FE -- "Create New
Hosted Agent" --> Scaffold
Scaffold -- "F5 ডিবাগ" --> Inspector
FoundryToolkit -.- Inspector
end
subgraph Cloud["মাইক্রোসফট ফাউন্ডরি"]
direction TB
ACR["Azure Container
Registry"]
AgentService["Foundry Agent Service
(Hosted Agent Runtime)"]
Model["Azure OpenAI
(gpt-4.1 / gpt-4.1-mini)"]
Playground["Foundry Playground
& VS Code Playground"]
ACR --> AgentService
AgentService -- "/responses API" --> Model
AgentService --> Playground
end
Scaffold -- "Deploy
(Docker build + push)" --> ACR
Inspector -- "POST /responses
(localhost:8088)" --> স্ক্যাফোল্ড
Playground -- "টেস্ট প্রম্পটসমূহ" --> AgentService
style Local fill:#f0f4ff,stroke:#4a6cf7,stroke-width:2px
style Cloud fill:#fff4e6,stroke:#f59e0b,stroke-width:2px
প্রবাহ: Foundry এক্সটেনশন এজেন্ট তৈরি করে → আপনি কোড এবং নির্দেশাবলী কাস্টমাইজ করেন → Agent Inspector দিয়ে স্থানীয়ভাবে পরীক্ষা করেন → Foundry-তে মোতায়েন (Docker ইমেজ ACR তে পাঠানো) → Playground-এ যাচাই করেন।
| ল্যাব | বিবরণ | অবস্থা |
|---|---|---|
| ল্যাব ০১ - একক এজেন্ট | "Explain Like I'm an Executive" এজেন্টটি তৈরি করুন, স্থানীয়ভাবে পরীক্ষা করুন, এবং Foundry-তে মোতায়েন করুন | ✅ উপলব্ধ |
| ল্যাব ০২ - বহু-এজেন্ট ওয়ার্কফ্লো | "Resume → Job Fit Evaluator" - ৪টি এজেন্ট একসাথে কাজ করে রেজিউমের উপযোগিতা স্কোর করে এবং শেখার রোডম্যাপ তৈরি করে | ✅ উপলব্ধ |
এই কর্মশালায় আপনি "Explain Like I'm an Executive" এজেন্ট তৈরি করবেন - একটি AI এজেন্ট যা জটিল প্রযুক্তিগত ভাষা নিয়ে সেটিকে শান্ত ও বোর্ডরুম-উপযোগী সারাংশে অনুবাদ করে। কারণ সত্ত্বেও, সি-সুইটে কেউ "v3.2-এ সিঙ্ক্রোনাস কল দ্বারা তৈরি থ্রেড পুল ক্ষয়জনিত ডিলে" শুনতে চায় না।
আমি এই এজেন্টটি তৈরি করেছিলাম একাধিক ঘটনার পর যখন আমার নিখুঁত পোস্ট-মর্টেম পেয়ে উত্তর পাওয়া গেল: "তাহলে... ওয়েবসাইট ডাউন কি না?"
আপনি একটি প্রযুক্তিগত আপডেট দেবেন। এটি তিনটি পয়েন্টে একটি নির্বাহী সারাংশ ফিরিয়ে দেয় - কোন জটিল ভাষা নয়, না স্ট্যাক ট্রেস, না আতঙ্কজনক ব্যাখ্যা। শুধু কি ঘটেছে, ব্যবসায়িক প্রভাব, এবং পরবর্তী পদক্ষেপ।
আপনি বলুন:
"API বিলম্বতা বৃদ্ধি পেয়েছে v3.2 এ সিঙ্ক্রোনাস কল দ্বারা তৈরি থ্রেড পুল ক্ষয়ের কারণে।"
এজেন্ট উত্তর দেয়:
নির্বাহী সারাংশ:
- কি ঘটেছে: সর্বশেষ রিলিজের পর সিস্টেম ধীরে চলে।
- ব্যবসায়িক প্রভাব: কিছু ব্যবহারকারী সেবাটি ব্যবহার করতে দেরি অনুভব করেছে।
- পরবর্তী পদক্ষেপ: পরিবর্তনটি পূর্বাবস্থায় ফিরিয়ে আনা হয়েছে এবং পুনরায় মোতায়েনের আগে সমাধান প্রস্তুত করা হচ্ছে।
এটি খুব সহজ, একক উদ্দেশ্যের এজেন্ট - হোস্টেড এজেন্ট ওয়ার্কফ্লো শুরু থেকে শেষ পর্যন্ত শেখার জন্য পারফেক্ট, জটিল সরঞ্জাম চেইন ছাড়া। সত্যি বলতে? প্রতিটি ইঞ্জিনিয়ারিং দল এরকম একটি ব্যবহার করতে পারে।
📂 Foundry_Toolkit_for_VSCode_Lab/
├── 📄 README.md ← You are here
└── 📂 workshop/
├── 📂 lab01-single-agent/ ← Full lab: docs + agent code
│ ├── README.md ← Hands-on lab instructions
│ ├── 📂 docs/ ← Step-by-step tutorial modules
│ │ ├── 00-prerequisites.md
│ │ ├── 01-setup.md
│ │ ├── 02-create-hosted-agent.md
│ │ ├── 03-configure-and-code.md
│ │ ├── 04-test-locally.md
│ │ ├── 05-deploy-to-foundry.md
│ │ ├── 06-verify-in-playground.md
│ │ ├── 07-summary.md
│ │ └── 08-troubleshooting.md
│ └── 📂 agent/ ← Reference solution (auto-scaffolded by Foundry extension)
│ ├── agent.yaml
│ ├── Dockerfile
│ ├── main.py
│ └── requirements.txt
└── 📂 lab02-multi-agent/ ← Resume → Job Fit Evaluator
├── README.md ← Hands-on lab instructions (end-to-end)
├── 📂 docs/ ← Step-by-step tutorial modules
│ ├── 00-prerequisites.md
│ ├── 01-understand-multi-agent.md
│ ├── 02-scaffold-multi-agent.md
│ ├── 03-configure-agents.md
│ ├── 04-orchestration-patterns.md
│ ├── 05-test-locally.md
│ ├── 06-deploy-to-foundry.md
│ ├── 07-verify-in-playground.md
│ └── 08-troubleshooting.md
└── 📂 PersonalCareerCopilotCompleted/ ← Reference solution (multi-agent workflow)
├── agent.yaml
├── Dockerfile
├── main.py
└── requirements.txt
দ্রষ্টব্য: প্রতিটি ল্যাবের
agent/ফোল্ডারটি Microsoft Foundry এক্সটেনশন দ্বারা তৈরি হয় যখন আপনি কমান্ড প্যালেট থেকেMicrosoft Foundry: Create a New Hosted Agentরান করেন। এরপর ফাইলগুলো আপনার এজেন্টের নির্দেশাবলী, টুলস এবং কনফিগারেশন দিয়ে কাস্টমাইজ করা হয়। ল্যাব ০১ আপনাকে আবার থেকে তৈরি করার মাধ্যমে ধাপে ধাপে দেখায়।
git clone https://github.com/microsoft-foundry/Foundry_Toolkit_for_VSCode_Lab.git
cd Foundry_Toolkit_for_VSCode_Labpython -m venv venvএটি সক্রিয় করুন:
- Windows (PowerShell):
.\venv\Scripts\Activate.ps1
- macOS / Linux:
source venv/bin/activate
pip install -r workshop/lab01-single-agent/agent/requirements.txtএজেন্ট ফোল্ডারের ভিতরে উদাহরণ .env ফাইলটি কপি করুন এবং আপনার মানগুলি পূরণ করুন:
cp workshop/lab01-single-agent/agent/.env.example workshop/lab01-single-agent/agent/.envworkshop/lab01-single-agent/agent/.env সম্পাদনা করুন:
AZURE_AI_PROJECT_ENDPOINT=https://<your-account>.services.ai.azure.com/api/projects/<your-project>
AZURE_AI_MODEL_DEPLOYMENT_NAME=<your-model-deployment-name>প্রতিটি ল্যাব নিজস্ব মডিউল সহ স্বয়ংসম্পূর্ণ। মৌলিক বিষয়গুলি শেখার জন্য প্রথমে ল্যাব ০১ শুরু করুন, তারপর বহু-এজেন্ট ওয়ার্কফ্লোর জন্য ল্যাব ০২ এ যান।
ল্যাব ০১ - একক এজেন্ট (সম্পূর্ণ নির্দেশাবলী)
| # | মডিউল | লিঙ্ক |
|---|---|---|
| ১ | প্রাক-শর্ত পড়ুন | 00-prerequisites.md |
| ২ | Foundry Toolkit ও Foundry এক্সটেনশন ইনস্টল করুন | 01-setup.md |
| ৩ | একটি Foundry প্রকল্প তৈরি করুন | 01-setup.md |
| ৪ | একটি হোস্টেড এজেন্ট তৈরি করুন | 02-create-hosted-agent.md |
| ৫ | নির্দেশাবলী ও পরিবেশ কনফিগার করুন | 03-configure-and-code.md |
| ৬ | স্থানীয়ভাবে পরীক্ষা করুন | 04-test-locally.md |
| ৭ | Foundry-তে মোতায়েন করুন | 05-deploy-to-foundry.md |
| ৮ | প্লেগ্রাউন্ডে যাচাই করুন | 06-verify-in-playground.md |
| ৯ | সমস্যার সমাধান | 08-troubleshooting.md |
ল্যাব ০২ - বহু-এজেন্ট ওয়ার্কফ্লো (সম্পূর্ণ নির্দেশাবলী)
| # | মডিউল | লিঙ্ক |
|---|---|---|
| ১ | প্রাক-শর্ত (ল্যাব ০২) | 00-prerequisites.md |
| ২ | বহু-এজেন্ট স্থাপত্য বোঝা | 01-understand-multi-agent.md |
| ৩ | বহু-এজেন্ট প্রকল্প স্ক্যাফোল্ড করা | 02-scaffold-multi-agent.md |
| ৪ | এজেন্ট ও পরিবেশ কনফিগার করা | 03-configure-agents.md |
| ৫ | অর্কেস্ট্রেশন প্যাটার্ন | 04-orchestration-patterns.md |
| ৬ | স্থানীয়ভাবে পরীক্ষা করা (বহু-এজেন্ট) | 05-test-locally.md |
| 7 | Foundry তে স্থাপন করুন | 06-deploy-to-foundry.md | | 8 | প্লেগ্রাউন্ডে যাচাই করুন | 07-verify-in-playground.md | | 9 | সমস্যা সমাধান (মাল্টি-এজেন্ট) | 08-troubleshooting.md |
 শিবম গয়াল |
| পরিস্থিতি | প্রয়োজনীয় ভূমিকা |
|---|---|
| নতুন Foundry প্রকল্প তৈরি করুন | Foundry রিসোর্সে Azure AI Owner |
| বিদ্যমান প্রকল্পে স্থাপন করুন (নতুন রিসোর্স) | সাবস্ক্রিপশনে Azure AI Owner + Contributor |
| সম্পূর্ণ কনফিগার্ড প্রকল্পে স্থাপন করুন | অ্যাকাউন্টে Reader + প্রকল্পে Azure AI User |
গুরুত্বপূর্ণ: Azure
OwnerএবংContributorভূমিকা শুধুমাত্র ম্যানেজমেন্ট অনুমতি অন্তর্ভুক্ত করে, ডেভেলপমেন্ট (ডেটা অ্যাকশন) অনুমতি নয়। এজেন্ট তৈরি ও স্থাপনের জন্য আপনার Azure AI User বা Azure AI Owner প্রয়োজন।
- দ্রুত শুরু: আপনার প্রথম হোস্টেড এজেন্ট স্থাপন করুন (VS কোড)
- হোস্টেড এজেন্ট কী?
- VS কোডে হোস্টেড এজেন্ট ওয়ার্কফ্লো তৈরি করুন
- হোস্টেড এজেন্ট স্থাপন করুন
- Microsoft Foundry এর জন্য RBAC
- আর্কিটেকচার রিভিউ এজেন্ট নমুনা - MCP টুলস, Excalidraw ডায়াগ্রাম এবং ডুয়াল ডিপ্লয়মেন্ট সহ বাস্তব হোস্টেড এজেন্ট
অস্বীকৃতি: এই নথিটি AI অনুবাদ পরিষেবা Co-op Translator ব্যবহার করে অনূদিত হয়েছে। যদিও আমরা শুদ্ধতার জন্য চেষ্টা করি, অনুগ্রহ করে মনে রাখবেন যে স্বয়ংক্রিয় অনুবাদে ত্রুটি বা অসঙ্গতি থাকতে পারে। মূল নথিটি তার স্বভাষায় কর্তৃত্বপূর্ণ উৎস হিসেবে বিবেচিত হওয়া উচিত। গুরুত্বপূর্ণ তথ্যের জন্য পেশাদার মানব অনুবাদ সুপারিশ করা হয়। এই অনুবাদের ব্যবহারে প্রয়োজনীয় ভুল বোঝাবুঝি বা ভুল ব্যাখ্যার জন্য আমরা দায়বদ্ধ নই।