# ایکٹ 2: اپنی پوڈکاسٹ پروڈکشن ٹیم تیار کریں 🎬

![lab2](../../../../translated_images/ur/lab2.48444b9d549e7863.webp)

## کہانی مزید گہری ہوتی ہے

ایلکس (آپ کا AI اسسٹنٹ ایکٹ 1 سے) زبردست ہے، لیکن ایک ایجنٹ پورے پوڈکاسٹ اسٹوڈیو کو نہیں چلا سکتا۔ آپ کو ایک *ٹیم* چاہیے:
- 🔍 **ریسرچ ایجنٹ**: تازہ معلومات کے لیے انٹرنیٹ پر تحقیق کرتا ہے
- ✍️ **اسکرپٹ ایجنٹ**: تحقیق کو دلچسپ مکالمے میں بدلتا ہے
- 👤 **آپ (ایڈیٹر)**: اسکرپٹس کی منظوری دیتے ہیں یا دوبارہ لکھنے کے لیے بھیجتے ہیں

خوش آمدید **AI ایجنٹ آرکسٹریشن** میں — جہاں آپ اپنی AI ٹیم کے ڈائریکٹر بنتے ہیں۔ سوچیں ایونجرز کی طرح، مگر پوڈکاسٹ پروڈکشن کے لیے۔

## ایجنٹ آرکسٹریشن کیا ہے؟ (سادہ ورژن)

تصور کریں آپ ایک ریستوران چلا رہے ہیں۔ آپ سب کچھ خود نہیں کرتے، ہے نا؟ آپ کے پاس ہیں:
- 🍳 ایک شیف جو پکاتا ہے
- 👨‍🍳 ایک سوس شیف جو تیار کرتا ہے
- 👩‍🍳 ایک سرور جو کھانا پہنچاتا ہے

ایجنٹ آرکسٹریشن بھی اسی طرح ہے، مگر AI کے ساتھ۔ ہر ایجنٹ کی مہارت ہوتی ہے، اور آپ انہیں بڑے ہدف حاصل کرنے کے لیے ہم آہنگ کرتے ہیں۔ کوئی واحد ایجنٹ اوورلوڈ نہیں ہوتا، کام تیزی سے ہوتا ہے۔

### بینڈ کی تشبیہ 🎸

آپ کے AI ایجنٹ ایک بینڈ کی مانند ہیں:
- **لیڈ سنگر**: مرکزی ایجنٹ جو صارفین سے رابطے کے کام سنبھالتا ہے
- **ڈرم مر**: تال برقرار رکھتا ہے، پس منظر پراسیسنگ کرتا ہے  
- **بیس پلیئر**: سب کی مدد کرتا ہے، ڈیٹا لاتا ہے
- **آپ (بینڈ مینیجر)**: سب کو ہم آہنگ کرتے ہیں!

بغیر ہم آہنگی؟ صرف شور۔ آرکسٹریشن کے ساتھ؟ خوبصورت موسیقی۔

### کیوں یہ اہم ہے

ایک AI ایجنٹ ہر کام کرنے کی کوشش = تھکن۔ ماہر ایجنٹ مل کر کام کرتے ہیں = کارکردگی میں اضافہ! 🚀

**اصل بات**: یاد ہے جب آپ اکیلے تحقیق، تحریر، اور ایڈٹ کرنے کی کوشش کرتے تھے؟ ہاں، یہ مشکل ہوتا ہے۔ آرکسٹریشن میں، ہر ایجنٹ اپنے بہترین کام سنبھالتا ہے۔ آپ صرف حتمی فیصلے کرتے ہیں۔

**حقیقی مثال**: کسٹمر سپورٹ بوٹس جو جانتے ہیں کب بلنگ، ٹیکنیکل مسائل، یا انسانی مدد کی ضرورت ہے۔ یہی آرکسٹریشن ہے!

## ایجنٹ بمقابلہ ورک فلو: فرق کیا ہے؟

ایسے سمجھیں:

### 🤖 AI ایجنٹ = جاز موسیقار
- **فی الفور فیصلے کرتا ہے** جو وہ سنتا ہے اس کی بنیاد پر
- **اپنی فطری صلاحیتوں سے مسئلے حل کرتا ہے**
- **LLM دماغ سے سوچتا ہے**
- **آپ جو بھی دے، اس کے مطابق ڈھل جاتا ہے**

### 🎵 ورک فلو = کلاسیکل موسیقی کی آرکسٹرا  
- **سکور یعنی طے شدہ مراحل پر عمل کرتا ہے**
- **متوقع طریقہ کار**
- **متعدد ایجنٹس، انسان، سسٹمز کو ہم آہنگ کرتا ہے**
- **نسخے کی طرح منظم**

**جادو**: ورک فلو ایجنٹس کو *آرکسٹریٹ* کرتے ہیں! آپ ایسا ورک فلو بناتے ہیں جو ایجنٹس کو وقت بتاتا ہے جب وہ اپنا حصہ ادا کریں۔ دونوں کا بہترین امتزاج۔ 🎭

## اپنی AI ٹیم کو ہم آہنگ کرنے کے تین طریقے

### 1. 🎯 مرکزی (آپ باس ہیں)

ایک مرکزی ایجنٹ تمام فیصلے کرتا ہے۔ جیسے آپ ٹیم مینیج کرتے ہیں — آپ طے کرتے ہیں کون کیا کب کرے گا۔

**فائدے**:
- ✅ واضح قیادت (کوئی الجھن نہیں)
- ✅ یکساں فیصلے
- ✅ آسان ڈی بگنگ

**استعمال کریں**:
- کسٹمر سروس راؤٹنگ ("یہ بلنگ ہے یا ٹیک سپورٹ؟")
- مواد کی منظوری کے ورک فلو ("کیا یہ اسکرپٹ منظور ہے؟")
- پوڈکاسٹ پروڈکشن (جو ہم بنا رہے ہیں!)

### 2. 🤝 غیر مرکزی (ایجنٹس خود سے منظم ہوتے ہیں)

ایجنٹس آپس میں براہ راست بات کرتے ہیں اور گروپ کے طور پر مسائل حل کرتے ہیں۔ جیسے گروپ چیٹ جہاں سب ہم آہنگ ہوتے ہیں۔

**فائدے**:
- ✅ آسانی سے بڑھتا ہے (کبھی بھی مزید ایجنٹس شامل کریں)
- ✅ کوئی واحد ناکامی کا نقطہ نہیں
- ✅ ایجنٹس قدرتی طور پر تعاون کرتے ہیں

**استعمال کریں**:
- ریسرچ ٹیمز (ہر ایجنٹ مختلف ذرائع کو تلاش کرتا ہے)
- آئیڈیاز کا جلسہ
- تقسیم شدہ مسئلہ حل کرنا

### 3. 🔀 ہائبرڈ (دونوں کا بہترین)

آپ عمومی سمت دیتے ہیں، مگر ایجنٹس کو کاموں پر خود نظم و نسق کی آزادی ہے۔ جیسے CEO جو اپنی ٹیم پر اعتماد کرتا ہے۔

**مناسب**: پیچیدہ منصوبے جنہیں کنٹرول اور لچک دونوں کی ضرورت ہو۔

## مائیکروسافٹ ایجنٹ فریم ورک: آپ کا آرکسٹریشن ٹول کٹ 🧰

بنانے کا وقت! یہ ہے جو آپ استعمال کریں گے:

### بنیادی اجزاء

#### 1. 🧱 ایگزیکیوٹرز (آپ کے کارکن)
- **کیا ہیں؟** انفرادی پراسیسنگ یونٹس — ایجنٹس یا کسٹم لاجک ہو سکتے ہیں
- **کیا کرتے ہیں؟** ان پٹ لیتے ہیں، کام کرتے ہیں، آؤٹ پٹ بناتے ہیں
- **سوچیں انہیں**: اسمبلی لائن کے اسٹیشن کی طرح

#### 2. ➡️ ایجز (کنکشنز)
- **کیا ہیں؟** ایگزیکیوٹرز کے درمیان راستے
- **کیا کرتے ہیں؟** پیغام کے بہاؤ کو کنٹرول کرتے ہیں ("A کے بعد B جائے")
- **سوچیں انہیں**: فلوچارٹ کے تیر کی طرح

#### 3. 🗺️ ورک فلو (ماسٹر پلان)
- **کیا ہیں؟** ایگزیکیوٹرز + ایجز کا مکمل گراف
- **کیا کرتے ہیں؟** شروع سے آخر تک پورا عمل متعین کرتے ہیں
- **سوچیں انہیں**: آپ کی پروڈکشن پائپ لائن کی خاکہ

### زبردست خصوصیات جو آپ کو پسند آئیں گی

**🛡️ قسم کی حفاظت**: ایجنٹس کے مابین پیغامات ٹائپ چیک ہوتے ہیں۔ کوئی "اوپس، غلط ڈیٹا ٹائپ" کی غلطی نہیں۔

**🔀 لچکدار راؤٹنگ**: 
- اگر-تو حالتیں ("اگر منظور، شائع کریں؛ ورنہ دوبارہ لکھیں")
- متوازی پراسیسنگ (متعدد ایجنٹس بیک وقت کام کرتے ہیں)
- متحرک راستے (نتائج کی بنیاد پر ورک فلو ڈھلتا ہے)

**🔌 بیرونی انضمام**:
- APIs سے کنیکٹ کریں
- انسانی ان پٹ پوائنٹس شامل کریں (آپ شائع کرنے سے پہلے منظوری دیں)
- درخواست/جواب کے فلو بنائیں

**💾 چیک پوائنٹنگ**: پیش رفت محفوظ کریں! اگر کچھ کریش ہو جائے تو جہاں چھوڑا تھا وہاں سے شروع کریں۔

**🤝 ملٹی ایجنٹ کوآرڈینیشن**:
- ایجنٹس کو ترتیب سے چلائیں (A → B → C)
- بیک وقت چلائیں (A + B + C ساتھ ساتھ)
- ایجنٹس کے مابین ہینڈ آف کریں
- تعاون کے ساتھ عمل

## بہترین عملی طریقے (پرو ٹپس) 🎯

### 1. اسے ماڈیولر رکھیں
ہر ایجنٹ کو ایک کام بہت اچھے طریقے سے کرنا چاہیے۔ "سپراس ایجنٹ" نہ بنائیں جو سب کچھ کرے — ڈی بگنگ میں مشکل ہوگی۔

### 2. ناکامیوں کا منصوبہ بنائیں
ایجنٹس غلطیاں کرتے ہیں۔ نیٹ ورکس فیل ہوتے ہیں۔ ایرر ہینڈلنگ اور بیک اپ پلانز بنائیں۔ آپ کا مستقبل آپ کا شکریہ ادا کرے گا۔

### 3. ہر چیز کی نگرانی کریں
دیکھتے رہیں کہ آپ کے ایجنٹس کیا کر رہے ہیں۔ DevUI استعمال کریں (ہم اس پر بات کریں گے!) ورک فلو کو عملی حالت میں دیکھنے کے لیے۔

### 4. پیغام کا سائز بہتر کریں
ایجنٹس کے درمیان بڑے فائلز نہ بھیجیں۔ پیغامات کو ہلکا اور مؤثر رکھیں تاکہ رفتار تیز ہو۔

### 5. صحیح پیٹرن کا انتخاب کریں
کنٹرول چاہیے؟ مرکزی پیٹرن اپنائیں۔ پیمانے کی ضرورت ہے؟ غیر مرکزی اپنائیں۔ فیصلہ نہیں کر پارہے؟ ہائبرڈ اپنائیں!

## DevUI: آپ کا ورک فلو ڈی باگر 🔍

### DevUI کیا ہے؟

DevUI آپ کے ایجنٹس اور ورک فلو کو ٹیسٹ کرنے کے لیے ایک کھیل کا میدان ہے۔ یہ ایک ویب انٹرفیس ہے جہاں آپ:
- 👀 اپنے ورک فلو کو عملی طور پر دیکھ سکتے ہیں
- 💬 ایجنٹس سے براہ راست بات کر سکتے ہیں
- 🔍 جب کچھ غلط ہو تو ڈی بگ کر سکتے ہیں
- 📊 ٹریسز اور کارکردگی کے میٹرکس دیکھ سکتے ہیں

> **اہم**: DevUI صرف ترقی کے لیے ہے! اسے پروڈکشن میں استعمال نہ کریں۔ یہ آپ کا لوکل ٹیسٹنگ ماحول ہے۔

### کیا چیز اسے زبردست بناتی ہے

- **🖥️ انٹرایکٹو ویب UI**: کلک کریں، لکھیں، ٹیسٹ کریں — کمانڈ لائن کی ضرورت نہیں
- **📁 ڈریگ اینڈ ڈراپ ہوگا**: فائلیں اپلوڈ کریں، مختلف ان پٹس سے ٹیسٹ کریں
- **📂 آٹو ڈسکوری**: کسی فولڈر کی طرف اشارہ کریں، یہ خودکار سب ایجنٹس تلاش کرتا ہے
- **📋 بغیر سیٹ اپ کا موڈ**: ایجنٹس کو کوڈ میں رجسٹر کریں، فولڈر اسٹرکچر کی ضرورت نہیں
- **🔌 اوپن AI کے ساتھ مطابقت**: OpenAI SDK کے ساتھ کام کرتا ہے (مطابقت بہترین!)
- **👁️ بلٹ ان ٹریسنگ**: دیکھیں کہ ایجنٹس کیا کر رہے ہیں

### ان پٹ کیسے کام کرتا ہے

DevUI ان پٹس کو سمجھدار طریقے سے ہینڈل کرتا ہے:

- **ایجنٹس کو ٹیسٹ کر رہے ہیں؟** آپ کو ٹیکسٹ باکسز اور فائل اپلوڈ بٹن ملتے ہیں
- **ورک فلوز کو ٹیسٹ کر رہے ہیں؟** UI خود بخود ان پٹ فیلڈز بناتا ہے، جو ورک فلو کی ضرورت کے مطابق ہوتے ہیں

یہ جادو کی طرح ہے، مگر درحقیقت یہ بہترین کوڈ ہے۔ ✨

## آپ کے مشن: پوڈکاسٹ اسٹوڈیو بنائیں 🎬

### مشن 1: DevUI کے ساتھ ایک ایجنٹ بنائیں

📂 [01.AgentDevUI](../../../../WorkshopForAgentic/code/02.Workflow/01.AgentDevUI)

**چیلنج**: پوری ٹیم بنانے سے پہلے، DevUI کو ایک ایجنٹ کے ساتھ آزمائیں: ایک ویب سرچ اسپیشلسٹ۔

**جو آپ بنا رہے ہیں**:
ایک ریسرچ ایجنٹ جو پوڈکاسٹ موضوعات کے لیے انٹرنیٹ پر تلاش کر سکے۔ آپ اسے DevUI کے ویب انٹرفیس پر `http://localhost:8090` سے ٹیسٹ کریں گے۔

**سیکھیں گے**:
- 🚀 DevUI میں ایجنٹس لانچ کرنا
- 🔍 ایجنٹ کے جوابات کو حقیقی وقت میں ٹیسٹ کرنا
- 🛠️ کسٹم ٹولز بنانا (ویب سرچ)
- 📊 مسائل کی جانچ کے لیے ٹریسنگ فعال کرنا
- 🖥️ انٹرایکٹو ویب UI کا استعمال

**کوڈ**:
- `agent.py`: آپ کا SearchAgent ویب سرچ صلاحیتوں کے ساتھ
- OllamaChatClient کو Qwen سے کنیکٹ کرتا ہے
- `web_search()` ٹول فنکشن نافذ کرتا ہے
- `serve()` کے ساتھ لانچ ہوتا ہے — DevUI خودکار کھلتا ہے

**فتح کی شرط**: اپنے ایجنٹ سے پوچھیں "AI میں کیا رجحان ہے؟" اور دیکھیں کہ وہ ویب پر تلاش کرے! 🎉

### مشن 2: ایک ملٹی-ایجنٹ ورک فلو بنائیں

📂 [02.WorkflowDevUI](../../../../WorkshopForAgentic/code/02.Workflow/02.WorkflowDevUI)

**چیلنج**: اب اصل مزہ شروع ہوتا ہے! مکمل پوڈکاسٹ پروڈکشن ورک فلو بنائیں جس میں:
1. 🔍 **سرچ ایجنٹ** → آپ کے موضوع کی تحقیق کرتا ہے
2. ✍️ **اسکرپٹ ایجنٹ** → دو میزبانوں کے درمیان مکالمہ لکھتا ہے (چینی زبان میں!)
3. 👤 **ریویو ایگزیکیوٹر** → آپ سے منظوری یا رد کرنے کو کہتا ہے
4. 🔄 **لوپ بیک** → اگر رد کیا گیا تو آپ کی رائے کی بنیاد پر دوبارہ لکھتا ہے

**سیکھیں گے**:
- 🧱 مختلف کاموں کے لیے ماہر ایجنٹس بنانا
- 🔗 ایجنٹس کو WorkflowBuilder کے ساتھ منسلک کرنا
- 🔀 منظوری کے لوپس نافذ کرنا (human-in-the-loop!)
- 🚦 شرطی راؤٹنگ (منظور یا رد شدہ)
- 🔧 کاروباری منطق کے لیے کسٹم ایگزیکیوٹرز بنانا

**ورک فلو**:
```
SearchAgent → ScriptAgent → ReviewExecutor
                             ↑          ↓ (if rejected)
                             ←─────────
```
  
**کوڈ**:
- `search_agent/agent.py`: آپ کا ریسرچ اسپیشلسٹ
- `generate_script_agent/agent.py`: آپ کا اسکرپٹ رائٹر (چینی میں لکھتا ہے!)
- `workflow/workflow.py`: یہاں آرکسٹریشن کا جادو ہوتا ہے
- `main.py`: DevUI میں سب کچھ لانچ کرتا ہے

**فتح کی شرط**: کوئی موضوع دیں، اسکرپٹ کا جائزہ لیں، ایک بار رد کریں لوپ کی جانچ کے لیے، پھر منظوری دیں! 🎉

### مشن 3: ایک کنسول ایپ بنائیں

📂 [03.Application](../../../../WorkshopForAgentic/code/02.Workflow/03.Application)

**چیلنج**: اپنا ورک فلو DevUI سے لے کر ایک خوبصورت ٹرمینل ایپ میں تبدیل کریں جس میں رنگین آؤٹ پٹ، لوڈنگ اسپنرز، اور فائل سیونگ ہو۔ یہ پروڈکشن کے لیے تیار چیز ہے!

**سیکھیں گے**:
- ⚡ پروگرام کی سطح پر ورک فلو چلانا (DevUI کے بغیر)
- 📡 ایونٹ ڈریون آرکیٹیکچر کے ساتھ اسٹریمنگ
- 🎨 خوبصورت ٹرمینل UI بنانا (رنگ، اسپنرز، پیش رفت بارز)
- 💾 حتمی اسکرپٹس فائلوں میں محفوظ کرنا
- 🔄 Python کی asyncio کے ساتھ async ورک فلو ہینڈل کرنا

**یہ کیا کرتا ہے**:
1. آپ سے پوڈکاسٹ موضوع پوچھتا ہے
2. حقیقی وقت کی پیش رفت دکھاتا ہے ("سرچ ایجنٹ کام کر رہا ہے...")
3. رنگوں میں تیار اسکرپٹ دکھاتا ہے
4. آپ کی منظوری مانگتا ہے
5. منظور شدہ اسکرپٹ `podcast.txt` میں محفوظ کرتا ہے

**کوڈ**:
- `podcast_app.py`: آپ کی مرکزی ایپ ایونٹ ہینڈلنگ کے ساتھ
- `workflow.py`: مشن 2 کا ورک فلو دوبارہ استعمال کرتا ہے
- ایونٹس ہینڈل کرتا ہے: `AgentRunUpdateEvent`, `RequestInfoEvent`, `WorkflowOutputEvent`
- ٹرمینل اسٹائل کے لیے ANSI رنگ استعمال کرتا ہے

**فتح کی شرط**: ایپ چلائیں، پوڈکاسٹ اسکرپٹ بنائیں، اور اسے محفوظ ہوتے دیکھیں! آپ نے ایک اصلی آلہ بنایا ہے۔ 🚀

## آپ نے کیا سیکھا ہے 🏆

ایکٹ 2 کے بعد، آپ کر سکتے ہیں:

- ✅ متعدد AI ایجنٹس کو باس کی طرح آرکسٹریٹ کریں
- ✅ ترتیب وار اور شرطی منطق کے ساتھ ورک فلو بنائیں
- ✅ انسانی منظوری کے چیک پوائنٹس شامل کریں
- ✅ DevUI کا استعمال کر کے ورک فلو ٹیسٹ اور ڈی بگ کریں
- ✅ پروڈکشن کے قابل کنسول ایپلیکیشنز بنائیں
- ✅ پیچیدہ سسٹمز میں غلطیوں کو مؤثر طریقے سے ہینڈل کریں
- ✅ کسی بھی پروجیکٹ کے لیے صحیح آرکسٹریشن پیٹرن منتخب کریں

## جب چیزیں خراب ہوں 🔧

### "میرا ورک فلو بہت پیچیدہ ہے!"
**حل**: اسے چھوٹے سب ورک فلو میں تقسیم کریں۔ ہر ورک فلو کو ایک کام اچھی طرح کرنا چاہیے۔ اگر ضرورت ہو، انہیں چین کریں۔

### "میں نہیں دیکھ پا رہا کہ کیا ہو رہا ہے!"
**حل**: ورک فلو چیک پوائنٹنگ استعمال کریں تاکہ حالت محفوظ ہو جائے۔ DevUI میں ٹریسنگ فعال کریں تاکہ ہر قدم دیکھا جا سکے۔

### "ایک ایجنٹ کی غلطی سب کچھ کرپٹ کر دیتی ہے!"
**حل**: ایرر باؤنڈریز شامل کریں۔ ہر ایجنٹ کو اپنی غلطیوں کو سنبھالنا چاہیے اور متبادل رویہ رکھنا چاہیے۔

### "یہ بہت سست ہے"
**حل**: کیا کچھ ایجنٹس متوازی چل سکتے ہیں؟ ترتیب وار ورک فلو آسان ہے مگر سست۔ متوازی چلانے کے مواقع تلاش کریں!

## مددگار وسائل 🔗

- [Workflow Docs](https://learn.microsoft.com/en-us/agent-framework/user-guide/workflows/overview) — مائیکروسافٹ کے سرکاری گائیڈز
- [Orchestration Patterns](https://www.ibm.com/think/topics/ai-agent-orchestration) — آئی بی ایم کے نظریات
- [Agent Framework GitHub](https://github.com/microsoft/agent-framework) — سورس کوڈ براؤز کریں
- [کوڈ کی مثالیں](https://github.com/microsoft/agent-framework/tree/main/python/samples) — یہاں سے پیٹرنز چوری کریں

---

**فائنل کے لیے تیار؟** آپ کے پاس آپ کا اسکرپٹ ہے۔ اب اسے حقیقی آڈیو میں تبدیل کرتے ہیں! → [مرحلہ ۳: اپنے پوڈکاسٹ کو زندگی دیں](03.Multi-SpeakerPodcastGenerationWithVibeVoice.md) 🎤

---

**پھنسا ہوا؟ الجھن؟ پرجوش؟** ورکشاپ چیٹ میں شیئر کریں! ہم سب مل کر سیکھ رہے ہیں۔ 🚀

---

<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**دستخطی دستبرداری**:
یہ دستاویز AI ترجمہ سروس [Co-op Translator](https://github.com/Azure/co-op-translator) کے ذریعے ترجمہ کی گئی ہے۔ اگرچہ ہم درستگی کے لیے کوشاں ہیں، براہ کرم نوٹ کریں کہ خودکار تراجم میں غلطیاں یا بے ضابطگیاں ہو سکتی ہیں۔ اصل دستاویز اپنی مادری زبان میں ہی معتبر ذریعہ سمجھی جانی چاہیے۔ اہم معلومات کے لیے پیشہ ور انسانی ترجمہ تجویز کیا جاتا ہے۔ اس ترجمے کے استعمال سے پیدا ہونے والی کسی بھی غلط فہمی یا غلط تشریح کے لیے ہم ذمہ دار نہیں ہوں گے۔
<!-- CO-OP TRANSLATOR DISCLAIMER END -->