# 🚀 মডিউল ১: মাইক্রোসফ্ট ফাউন্ড্রি টুলকিট ফান্ডামেন্টালস

[![Duration](https://img.shields.io/badge/Duration-15%20minutes-blue.svg)]()
[![Difficulty](https://img.shields.io/badge/Difficulty-Beginner-green.svg)]()
[![Prerequisites](https://img.shields.io/badge/Prerequisites-VS%20Code-orange.svg)]()

## 📋 শেখার উদ্দেশ্যসমূহ

এই মডিউলের শেষে, আপনি সক্ষম হবেন:
- ✅ VS Code এর জন্য মাইক্রোসফ্ট ফাউন্ড্রি টুলকিট এক্সটেনশন ইনস্টল এবং কনফিগার করতে
- ✅ মডেল ক্যাটালগ নেভিগেট করতে এবং বিভিন্ন মডেল সোর্স বুঝতে
- ✅ প্লেগ্রাউন্ড ব্যবহার করে মডেল টেস্টিং এবং পরীক্ষণ করতে
- ✅ এজেন্ট বিল্ডার ব্যবহার করে কাস্টম AI এজেন্ট তৈরি করতে
- ✅ বিভিন্ন প্রোভাইদারের মধ্যে মডেলের পারফরম্যান্স তুলনা করতে
- ✅ প্রম্পট ইঞ্জিনিয়ারিং এর জন্য সেরা অনুশীলন প্রয়োগ করতে

## 🧠 মাইক্রোসফ্ট ফাউন্ড্রি টুলকিট পরিচিতি

**মাইক্রোসফ্ট ফাউন্ড্রি টুলকিট এক্সটেনশন ফর VS কোড** হলো মাইক্রোসফ্টের প্রধানতম এক্সটেনশন যা VS কোডকে একটি পূর্ণাঙ্গ AI ডেভেলপমেন্ট পরিবেশে রূপান্তরিত করে। এটি AI গবেষণা ও ব্যবহারিক অ্যাপ্লিকেশন ডেভেলপমেন্টের মধ্যে সেতুবন্ধন করে, যা সকল দক্ষতার ডেভেলপারদের জন্য জেনেরেটিভ AI অ্যাক্সেসযোগ্য করে তোলে।

### 🌟 মূল সক্ষমতাসমূহ

| বৈশিষ্ট্য | বিবরণ | ব্যবহারের ক্ষেত্র |
|---------|-------------|----------|
| **🗂️ মডেল ক্যাটালগ** | GitHub, ONNX, OpenAI, Anthropic, Google থেকে ১০০+ মডেলে অ্যাক্সেস | মডেল আবিষ্কার ও নির্বাচন |
| **🔌 BYOM সাপোর্ট** | আপনার স্ব-স্ব মডেল (লোকাল/রিমোট) ইন্টিগ্রেট করুন | কাস্টম মডেল ডিপ্লয়মেন্ট |
| **🎮 ইন্টারেক্টিভ প্লেগ্রাউন্ড** | চ্যাট ইন্টারফেস সহ রিয়েল-টাইম মডেল টেস্টিং | দ্রুত প্রোটোটাইপ এবং পরীক্ষণ |
| **📎 মাল্টি-মোডাল সাপোর্ট** | টেক্সট, ইমেজ, ও এটাচমেন্ট হ্যান্ডেল করুন | জটিল AI অ্যাপ্লিকেশন |
| **⚡ ব্যাচ প্রসেসিং** | এক সাথে একাধিক প্রম্পট রান করুন | কার্যকরী টেস্টিং ওয়ার্কফ্লো |
| **📊 মডেল ইভ্যালুয়েশন** | বিল্ট-ইন মেট্রিকস (F1, প্রাসঙ্গিকতা, সাদৃশ্য, সম্প্রীতি) | কর্মক্ষমতা মূল্যায়ন |

### 🎯 মাইক্রোসফ্ট ফাউন্ড্রি টুলকিট কেন গুরুত্বপূর্ণ

- **🚀 দ্রুত ডেভেলপমেন্ট**: আইডিয়া থেকে প্রোটোটাইপ কয়েক মিনিটে
- **🔄 একীভূত ওয়ার্কফ্লো**: এক ইন্টারফেসে একাধিক AI প্রোভাইদার
- **🧪 সহজ পরীক্ষণ**: জটিল সেটআপ ছাড়াই মডেল তুলনা
- **📈 প্রোডাকশন রেডি**: প্রোটোটাইপ থেকে ডিপ্লয়মেন্টে সহজ রূপান্তর

## 🛠️ পূর্বপ্রয়োজনীয়তা ও সেটআপ

### 📦 মাইক্রোসফ্ট ফাউন্ড্রি টুলকিট এক্সটেনশন ইনস্টল

**ধাপ ১: এক্সটেনশন মার্কেটপ্লেসে প্রবেশ**
1. ভিজ্যুয়াল স্টুডিও কোড ওপেন করুন
2. এক্সটেনশন ভিউতে যান (`Ctrl+Shift+X` অথবা `Cmd+Shift+X`)
3. "Microsoft Foundry Toolkit" সার্চ করুন

**ধাপ ২: আপনার ভার্সন নির্বাচন করুন**
- **🟢 রিলিজ**: প্রোডাকশন ব্যবহার জন্য সুপারিশকৃত
- **🔶 প্রি-রিলিজ**: আধুনিক ফিচারগুলোর প্রাথমিক প্রবেশাধিকার

**ধাপ ৩: ইনস্টল ও সক্রিয় করুন**

![Microsoft Foundry Toolkit Extension](../../../../translated_images/bn/aitkext.d28945a03eed003c.webp)

### ✅ যাচাই চেকলিস্ট
- [ ] Microsoft Foundry Toolkit আইকন VS কোড সাইডবারে উপস্থিত
- [ ] এক্সটেনশন সক্রিয় ও চালু আছে
- [ ] আউটপুট প্যানেলে কোনো ইনস্টলেশন এরর নেই

## 🧪 হাতেকলমে অনুশীলন ১: GitHub মডেল এক্সপ্লোর করা

**🎯 উদ্দেশ্য**: মডেল ক্যাটালগ মাস্টার করুন এবং আপনার প্রথম AI মডেল পরীক্ষা করুন

### 📊 ধাপ ১: মডেল ক্যাটালগ নেভিগেট করা

মডেল ক্যাটালগ AI ইকোসিস্টেমের আপনার গেটওয়ে। এটি একাধিক প্রোভাইডারের মডেল একত্রিত করে, যা বিকল্প আবিষ্কার ও তুলনা সহজ করে তোলে।

**🔍 নেভিগেশন গাইড:**

Microsoft Foundry Toolkit সাইডবারে **MODELS - Catalog** এ ক্লিক করুন

![Model Catalog](../../../../translated_images/bn/aimodel.263ed2be013d8fb0.webp)

**💡 পরামর্শ**: আপনার ব্যবহারের ক্ষেত্রে উপযোগী বিশেষ সক্ষমতাসম্পন্ন মডেল দেখুন (যেমন, কোড জেনারেশন, সৃজনশীল লেখা, বিশ্লেষণ)।

**⚠️ নোট**: GitHub-হোস্ট করা মডেলগুলি (অর্থাৎ GitHub মডেল) বিনামূল্যে ব্যবহারের জন্য, তবে রিকোয়েস্ট ও টোকেনের ওপর রেট লিমিট প্রযোজ্য। যদি আপনি না-GitHub মডেল অ্যাক্সেস করতে চান (যা হলো Azure AI বা অন্যান্য এন্ডপয়েন্ট থেকে হোস্টকৃত বাইরের মডেল), তাহলে প্রযোজ্য API কী বা প্রমাণীকরণ দিতে হবে।

### 🚀 ধাপ ২: প্রথম মডেল যোগ ও কনফিগার করুন

**মডেল নির্বাচন কৌশল:**
- **GPT-4.1**: জটিল যুক্তি ও বিশ্লেষণের জন্য সেরা
- **Phi-4-mini**: হালকা, দ্রুত প্রতিক্রিয়া সরল কাজের জন্য

**🔧 কনফিগারেশন প্রক্রিয়া:**
1. ক্যাটালগ থেকে **OpenAI GPT-4.1** নির্বাচন করুন
2. **Add to My Models** ক্লিক করুন - এটি মডেল ব্যবহারের জন্য নিবন্ধন করবে
3. **Try in Playground** নির্বাচন করে পরীক্ষার পরিবেশ চালু করুন
4. মডেল ইনিশিয়ালাইজেশনের জন্য অপেক্ষা করুন (প্রথম বারের সেটআপ সময় নিতে পারে)

![Playground Setup](../../../../translated_images/bn/playground.dd6f5141344878ca.webp)

**⚙️ মডেল প্যারামিটার বোঝা:**
- **Temperature**: সৃজনশীলতা নিয়ন্ত্রণ করে (০ = নিশ্চিত, ১ = সৃজনশীল)
- **Max Tokens**: সর্বোচ্চ প্রতিক্রিয়া দৈর্ঘ্য
- **Top-p**: প্রতিক্রিয়ার বৈচিত্র্যের জন্য নিউক্লিয়াস স্যাম্পলিং

### 🎯 ধাপ ৩: প্লেগ্রাউন্ড ইন্টারফেস মাস্টার করা

প্লেগ্রাউন্ড হলো আপনার AI পরীক্ষণ ল্যাব। এর সক্ষমতা সর্বাধিক করার উপায়:

**🎨 প্রম্পট ইঞ্জিনিয়ারিং সেরা অনুশীলন:**
1. **নির্দিষ্ট হন**: স্পষ্ট, বিস্তারিত নির্দেশ ফলপ্রসূতা বাড়ায়
2. **প্রসঙ্গ প্রদান করুন**: প্রাসঙ্গিক পটভূমি অন্তর্ভুক্ত করুন
3. **উদাহরণ ব্যবহার করুন**: মডেলকে আপনি যা চান তা দেখাতে উদাহরণ দিন
4. **অপডেট করুন**: প্রাথমিক ফলাফলের ভিত্তিতে প্রম্পট পরিমার্জন করুন

**🧪 পরীক্ষণ দৃশ্য**:
```markdown
# Example 1: Code Generation
"Write a Python function that calculates the factorial of a number using recursion. Include error handling and docstrings."

# Example 2: Creative Writing
"Write a professional email to a client explaining a project delay, maintaining a positive tone while being transparent about challenges."

# Example 3: Data Analysis
"Analyze this sales data and provide insights: [paste your data]. Focus on trends, anomalies, and actionable recommendations."
```

![Testing Results](../../../../translated_images/bn/result.1dfcf211fb359cf6.webp)

### 🏆 চ্যালেঞ্জ অনুশীলন: মডেল পারফরম্যান্স তুলনা

**🎯 লক্ষ্য**: একই প্রম্পট ব্যবহার করে বিভিন্ন মডেল তুলনা করে তাদের শক্তি বুঝুন

**📋 নির্দেশনা:**
1. আপনার ওয়ার্কস্পেসে **Phi-4-mini** যোগ করুন
2. GPT-4.1 এবং Phi-4-mini উভয়ের জন্য একই প্রম্পট ব্যবহার করুন

![set](../../../../translated_images/bn/set.88132df189ecde2c.webp)

3. প্রতিক্রিয়া গুণমান, গতি, এবং নির্ভুলতা তুলনা করুন
4. আপনার পর্যবেক্ষণ ফলাফল অংশে নথিভুক্ত করুন

![Model Comparison](../../../../translated_images/bn/compare.97746cd0f9074955.webp)

**💡 আবিষ্কারের জন্য মূল অন্তর্দৃষ্টি:**
- কখন LLM বনাম SLM ব্যবহার করবেন
- খরচ বনাম পারফরম্যান্সের ট্রেড-অফ
- বিভিন্ন মডেলের বিশেষায়িত ক্ষমতা

## 🤖 হাতেকলমে অনুশীলন ২: এজেন্ট বিল্ডারের মাধ্যমে কাস্টম এজেন্ট তৈরি

**🎯 উদ্দেশ্য**: নির্দিষ্ট কাজ ও ওয়ার্কফ্লো জন্য স্পেশালাইজড AI এজেন্ট তৈরি করুন

### 🏗️ ধাপ ১: এজেন্ট বিল্ডার বুঝা

এজেন্ট বিল্ডার হলো মাইক্রোসফ্ট ফাউন্ড্রি টুলকিটের পরম শক্তি। এটি আপনাকে বৃহৎ ভাষার মডেলের ক্ষমতা, কাস্টম নির্দেশনা, নির্দিষ্ট প্যারামিটার, ও বিশেষায়িত জ্ঞানের সংমিশ্রণে উদ্দেশ্যনির্দিষ্ট AI সহকারী তৈরি করতে দেয়।

**🧠 এজেন্ট আর্কিটেকচার উপাদানসমূহ:**
- **কোর মডেল**: ভিত্তি LLM (GPT-4, Groks, Phi, ইত্যাদি)
- **সিস্টেম প্রম্পট**: এজেন্টের ব্যক্তিত্ব ও আচরণ নির্ধারণ করে
- **প্যারামিটারসমূহ**: সর্বোত্তম কর্মক্ষমতার জন্য ফাইন-টিউনড সেটিংস
- **টুলস ইন্টিগ্রেশন**: বাহ্যিক API ও MCP সার্ভিসের সাথে সংযোগ
- **মেমরি**: কথোপকথন প্রসঙ্গ এবং সেশন স্থায়িত্ব

![Agent Builder Interface](../../../../translated_images/bn/agentbuilder.25895b2d2f8c02e7.webp)

### ⚙️ ধাপ ২: এজেন্ট কনফিগারেশন বিস্তারিত

**🎨 কার্যকর সিস্টেম প্রম্পট তৈরি:**
```markdown
# Template Structure:
## Role Definition
You are a [specific role] with expertise in [domain].

## Capabilities
- List specific abilities
- Define scope of knowledge
- Clarify limitations

## Behavior Guidelines
- Response style (formal, casual, technical)
- Output format preferences
- Error handling approach

## Examples
Provide 2-3 examples of ideal interactions
```

*অবশ্যই, আপনি Generate System Prompt ব্যবহার করে AIর সাহায্যে প্রম্পট তৈরি ও অপ্টিমাইজ করতে পারেন*

**🔧 প্যারামিটার অপ্টিমাইজেশন:**
| প্যারামিটার | সুপারিশকৃত সীমা | ব্যবহারের ক্ষেত্র |
|-----------|------------------|----------|
| **Temperature** | 0.1-0.3 | প্রযুক্তিগত/বাস্তবিক উত্তরসমূহ |
| **Temperature** | 0.7-0.9 | সৃজনশীল/ব্রেনস্টর্মিং কাজ |
| **Max Tokens** | 500-1000 | সংক্ষিপ্ত উত্তর |
| **Max Tokens** | 2000-4000 | বিস্তারিত ব্যাখ্যা |

### 🐍 ধাপ ৩: ব্যবহারিক অনুশীলন - পাইথন প্রোগ্রামিং এজেন্ট

**🎯 মিশন**: একটি স্পেশালাইজড পাইথন কোডিং সহকারী তৈরি করুন

**📋 কনফিগারেশন ধাপসমূহ:**

1. **মডেল নির্বাচন**: নির্বাচন করুন **Claude 3.5 Sonnet** (কোডের জন্য চমৎকার)

2. **সিস্টেম প্রম্পট ডিজাইন**:
```markdown
# Python Programming Expert Agent

## Role
You are a senior Python developer with 10+ years of experience. You excel at writing clean, efficient, and well-documented Python code.

## Capabilities
- Write production-ready Python code
- Debug complex issues
- Explain code concepts clearly
- Suggest best practices and optimizations
- Provide complete working examples

## Response Format
- Always include docstrings
- Add inline comments for complex logic
- Suggest testing approaches
- Mention relevant libraries when applicable

## Code Quality Standards
- Follow PEP 8 style guidelines
- Use type hints where appropriate
- Handle exceptions gracefully
- Write readable, maintainable code
```

3. **প্যারামিটার কনফিগারেশন**:
   - Temperature: 0.2 (সঙ্গতিশীল, নির্ভরযোগ্য কোডের জন্য)
   - Max Tokens: 2000 (বিশদ ব্যাখ্যার জন্য)
   - Top-p: 0.9 (সন্তুলিত সৃজনশীলতা)

![Python Agent Configuration](../../../../translated_images/bn/pythonagent.5e51b406401c165f.webp)

### 🧪 ধাপ ৪: আপনার পাইথন এজেন্ট পরীক্ষা

**পরীক্ষণ দৃশ্য:**
1. **মৌলিক ফাংশন**: "প্রাইম নম্বর খুঁজে বের করার একটি ফাংশন তৈরি করুন"
2. **জটিল অ্যালগরিদম**: "ইনসার্ট, ডিলিট, এবং সার্চ মেথডসহ বাইনারি সার্চ ট্রি ইমপ্লিমেন্ট করুন"
3. **বাস্তবজীবন সমস্যা**: "রেট লিমিটিং এবং রিট্রাই সহ একটি ওয়েব স্ক্র্যাপার তৈরি করুন"
4. **ডিবাগিং**: "এই কোড [ত্রুটিপূর্ণ কোড পেস্ট করুন] ঠিক করুন"

**🏆 সফলতার মানদণ্ড:**
- ✅ কোড ত্রুটিমুক্ত চলে
- ✅ যথাযথ ডকুমেন্টেশন রয়েছে
- ✅ পাইথনের সেরা অনুশীলন মানে চলে
- ✅ পরিষ্কার ব্যাখ্যা প্রদান করে
- ✅ উন্নতির পরামর্শ দেয়

## 🎓 মডিউল ১ সারাংশ ও পরবর্তী ধাপসমূহ

### 📊 জ্ঞান পরিক্ষা

আপনার বোঝাপড়া পরীক্ষা করুন:
- [ ] ক্যাটালগে মডেলসমূহের মধ্যে পার্থক্য ব্যাখ্যা করতে পারেন?
- [ ] সফলভাবে একটি কাস্টম এজেন্ট তৈরি ও পরীক্ষা করেছেন?
- [ ] বিভিন্ন ব্যবহারের জন্য প্যারামিটার কিভাবে অপ্টিমাইজ করবেন তা বুঝেন?
- [ ] কার্যকর সিস্টেম প্রম্পট ডিজাইন করতে পারেন?

### 📚 অতিরিক্ত সম্পদসমূহ

- **Microsoft Foundry Toolkit ডকুমেন্টেশন**: [Official Microsoft Docs](https://github.com/microsoft/vscode-ai-toolkit)
- **Prompt Engineering Guide**: [Best Practices](https://platform.openai.com/docs/guides/prompt-engineering)
- **Microsoft Foundry Toolkit এর মডেলসমূহ**: [Models in Development](https://github.com/microsoft/vscode-ai-toolkit/blob/main/doc/models.md)

**🎉 অভিনন্দন!** আপনি মাইক্রোসফ্ট ফাউন্ড্রি টুলকিটের ভিত্তি বিষয়সমূহে দক্ষ হয়েছেন এবং আরও উন্নত AI অ্যাপ্লিকেশন নির্মাণের জন্য প্রস্তুত!

### 🔜 পরবর্তী মডিউলে যান

আরও উন্নত সক্ষমতার জন্য প্রস্তুত? যান **[মডিউল ২: MCP উইথ মাইক্রোসফ্ট ফাউন্ড্রি টুলকিট ফান্ডামেন্টালস](../lab2/README.md)** যেখানে আপনি শিখবেন:
- Model Context Protocol (MCP) ব্যবহার করে আপনার এজেন্টগুলোকে বাইরের টুলের সাথে সংযুক্ত করা
- Playwright দিয়ে ব্রাউজার অটোমেশন এজেন্ট তৈরি করা
- Microsoft Foundry Toolkit এজেন্টের সাথে MCP সার্ভার ইন্টিগ্রেট করা
- বাহ্যিক ডেটা ও সক্ষমতা ব্যবহার করে আপনার এজেন্টগুলোকে সুপারচার্জ করা

---

<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**অস্বীকৃতি**:
এই নথিটি AI অনুবাদ পরিষেবা [Co-op Translator](https://github.com/Azure/co-op-translator) ব্যবহার করে অনূদিত হয়েছে। যদিও আমরা শুদ্ধতার জন্য চেষ্টা করি, অনুগ্রহ করে মনে রাখবেন যে স্বয়ংক্রিয় অনুবাদে ত্রুটি বা অসঙ্গতি থাকতে পারে। মূল নথিটি তার স্বভাষায় কর্তৃত্বপূর্ণ উৎস হিসেবে বিবেচিত হওয়া উচিত। গুরুত্বপূর্ণ তথ্যের জন্য পেশাদার মানব অনুবাদ সুপারিশ করা হয়। এই অনুবাদের ব্যবহারে প্রয়োজনীয় ভুল বোঝাবুঝি বা ভুল ব্যাখ্যার জন্য আমরা দায়বদ্ধ নই।
<!-- CO-OP TRANSLATOR DISCLAIMER END -->