# Babak 2: Kumpulkan Pasukan Penghasilan Podcast Anda 🎬

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

## Plot Semakin Hangat

Alex (penolong AI anda dari Babak 1) memang hebat, tetapi seorang ejen tidak dapat mengendalikan seluruh studio podcast. Anda memerlukan *pasukan*:
- 🔍 **Ejen Penyelidikan**: Mencari maklumat segar di internet
- ✍️ **Ejen Skrip**: Mengubah penyelidikan menjadi dialog yang menarik
- 👤 **Anda (Penyunting)**: Meluluskan skrip atau menghantarnya semula untuk penulisan semula

Selamat datang ke **Pengaturan Ejen AI** — di mana anda menjadi pengarah kumpulan AI anda sendiri. Fikirkan seperti Avengers, tapi untuk penghasilan podcast.

## Apa Itu Pengaturan Ejen? (Versi Mudah)

Bayangkan anda mengendalikan sebuah restoran. Anda tidak melakukan semua sendiri, kan? Anda mempunyai:
- 🍳 Seorang cef yang memasak
- 👨‍🍳 Seorang sous cef yang menyediakan bahan
- 👩‍🍳 Seorang pelayan yang menghantar

Pengaturan ejen adalah idea yang sama, tetapi dengan AI. Setiap ejen mempunyai kepakaran, dan anda menyelaraskan mereka untuk mencapai matlamat yang lebih besar. Tiada seorang ejen pun terbeban, dan kerja diselesaikan dengan lebih pantas.

### Analogi Kumpulan Muzik 🎸

Ejen AI anda seperti sebuah kumpulan muzik:
- **Penyanyi utama**: Ejen utama yang mengendalikan tugas berhadapan pelanggan
- **Pemain dram**: Menjaga rentak, mengendalikan pemprosesan latar belakang  
- **Pemain bass**: Menyokong semua orang, mengambil data
- **Anda (Pengurus Kumpulan)**: Menyelaraskan semuanya!

Tanpa penyelarasan? Hanya bunyi bising. Dengan pengaturan? Muzik yang indah.

### Kenapa Ini Penting

Satu ejen AI cuba buat semua perkara = keletihan. Ejen khusus bekerja bersama = kecekapan terbuka! 🚀

**Cerita Sebenar**: Ingat cuba menyelidik, menulis, DAN menyunting podcast anda seorang diri? Ya, itu melelahkan. Dengan pengaturan, setiap ejen mengendalikan apa yang dia terbaik. Anda cuma buat keputusan akhir.

**Contoh Dunia Sebenar**: Bot sokongan pelanggan yang tahu bila nak uruskan bil, isu teknikal, dan bila perlu panggil manusia. Itu pengaturan!

## Ejen vs. Aliran Kerja: Apa Bezanya?

Fikirkan begini:

### 🤖 Ejen AI = Pemuzik Jazz
- **Membuat keputusan secara spontan** berdasarkan apa yang didengarnya
- **Mengimprovisasi** penyelesaian menggunakan alatan yang ada
- **Berfikir** dengan otak LLM
- **Menyesuaikan diri** dengan apa sahaja yang diberi

### 🎵 Aliran Kerja = Orkestra Main Muzik Klasik  
- **Mengikuti partitur** (langkah-langkah yang telah ditetapkan)
- **Jalan pelaksanaan yang boleh diramal**
- **Menyelaras** beberapa ejen, manusia, sistem
- **Bersifat terstruktur** seperti resipi

**Keajaiban**: Aliran kerja *mengatur* ejen! Anda bina aliran kerja yang memberitahu ejen bila nak buat bahagian mereka. Gabungan terbaik dua dunia. 🎭

## Tiga Cara Menyelaras Pasukan AI Anda

### 1. 🎯 Berpusat (Anda Ketua)

Satu ejen utama membuat semua keputusan. Fikirkan anda mengurus sebuah pasukan — anda tentukan siapa buat apa dan bila.

**Kelebihan**:
- ✅ Kepimpinan jelas (tiada kekeliruan)
- ✅ Keputusan konsisten
- ✅ Mudah untuk nyahpepijat

**Gunakan untuk**:
- Penghalaan perkhidmatan pelanggan ("Ini bil atau sokongan teknikal?")
- Aliran kelulusan kandungan ("Skrip ini lulus ke?")
- Penghasilan podcast (betul-betul apa yang kita bina!)

### 2. 🤝 Terdesentralisasi (Ejen Atur Sendiri)

Ejen berbincang terus antara satu sama lain dan membuat keputusan secara kumpulan. Seperti chat kumpulan di mana semua menyelaraskan tindakan.

**Kelebihan**:
- ✅ Mudah diskalakan (tambah ejen bila-bila masa)
- ✅ Tiada titik kegagalan tunggal
- ✅ Ejen bekerjasama secara semula jadi

**Gunakan untuk**:
- Pasukan penyelidikan (setiap ejen siasat sumber berbeza)
- Sesi idea bersama
- Penyelesaian masalah teragih

### 3. 🔀 Hibrid (Gabungan Terbaik)

Anda tetapkan hala tuju keseluruhan, tetapi ejen bebas atur diri untuk tugasan. Seperti CEO yang mempercayai pasukannya.

**Sesuai untuk**: Projek kompleks yang perlukan kawalan dan fleksibiliti.

## Rangka Kerja Ejen Microsoft: Alat Pengaturan Anda 🧰

Masa untuk bina! Ini yang anda akan guna:

### Komponen Asas

#### 1. 🧱 Eksekutor (Pekerja Anda)
- **Apa itu**: Unit pemprosesan individu — boleh jadi ejen atau logik khusus
- **Apa fungsinya**: Terima input, buat kerja, hasilkan output
- **Fikirkan seperti**: Stesen dalam garisan pemasangan

#### 2. ➡️ Tepi (Sambungan)
- **Apa itu**: Laluan antara eksekutor
- **Apa fungsinya**: Kawal aliran mesej ("Selepas A, pergi ke B")
- **Fikirkan seperti**: Anak panah pada carta alir

#### 3. 🗺️ Aliran Kerja (Rancangan Utama)
- **Apa itu**: Graf lengkap eksekutor + tepi
- **Apa fungsinya**: Tentukan keseluruhan proses dari mula hingga selesai
- **Fikirkan seperti**: Rangkabentuk saluran pengeluaran anda

### Ciri Hebat yang Anda Suka

**🛡️ Keselamatan Jenis**: Mesej antara ejen diperiksa jenisnya. Tiada kejutan "Ups, jenis data salah".

**🔀 Laluan Fleksibel**: 
- Keadaan jika-maka ("Jika diluluskan, terbit; jika tidak, tulis semula")
- Pemprosesan selari (berbilang ejen kerja serentak)
- Laluan dinamik (aliran kerja menyesuaikan ikut keputusan)

**🔌 Integrasi Luaran**:
- Sambung ke API
- Tambah titik semak manusia-dalam-silangan (anda luluskan sebelum terbit)
- Bina aliran permintaan/respons

**💾 Penanda Pos**: Simpan kemajuan! Jika ada masalah, sambung semula dari titik terakhir.

**🤝 Penyelarasan Multi-Ejen**:
- Jalankan ejen berperingkat (A → B → C)
- Jalankan ejen serentak (A + B + C sekali gus)
- Serah tugas antara ejen
- Pemprosesan kolaboratif

## Amalan Terbaik (Tip Pro) 🎯

### 1. Kekalkan Modular
Setiap ejen perlu melakukan SATU perkara dengan sangat baik. Jangan buat "super ejen" yang lakukan semua — anda akan menyesal masa nyahpepijat.

### 2. Rancang Untuk Kegagalan
Ejen boleh buat silap. Rangkaian boleh gagal. Bina kawalan ralat dan pelan sandaran. Diri anda di masa depan akan berterima kasih.

### 3. Pantau Segala-galanya
Jejak apa yang ejen anda buat. Gunakan DevUI (kita akan terangkan!) untuk lihat aliran kerja berfungsi.

### 4. Optimumkan Saiz Mesej
Jangan hantar fail besar antara ejen. Pastikan mesej kecil dan kemas untuk kelajuan.

### 5. Pilih Corak Betul
Perlukan kawalan? Gunakan berpusat. Perlukan skala? Gunakan terdesentralisasi. Tak pasti? Pilih hibrid!

## DevUI: Penyahpepijat Aliran Kerja Anda 🔍

### Apa Itu DevUI?

DevUI adalah seperti taman permainan untuk menguji ejen dan aliran kerja. Ia adalah antara muka web dimana anda boleh:
- 👀 Melihat aliran kerja berjalan
- 💬 Bersembang terus dengan ejen
- 🔍 Nyahpepijat bila ada masalah
- 📊 Lihat jejak dan metrik prestasi

> **Penting**: DevUI untuk pembangunan sahaja! Jangan guna dalam produksi. Fikirkan ia sebagai persekitaran ujian tempatan anda.

### Apa Yang Menjadikan Ia Hebat

- **🖥️ UI Web Interaktif**: Klik, taip, uji — tak perlu baris arahan
- **📁 Seret & Lepas Sedia**: Muat naik fail, uji dengan input berbeza
- **📂 Auto-Pengesanan**: Tunjuk ke folder, ia cari semua ejen automatik
- **📋 Mod Tanpa Penyetelan**: Daftar ejen dalam kod, tak perlu struktur folder
- **🔌 Kompatibel OpenAI**: Berfungsi dengan SDK OpenAI (keserasian tiada tandingan!)
- **👁️ Jejak Terbina Dalam**: Lihat apa yang ejen buat dengan tepat

### Cara Input Berfungsi

DevUI pintar tentang input:

- **Uji Ejen?** Anda dapat kotak teks dan butang muat naik fail
- **Uji Aliran Kerja?** UI hasilkan medan input berdasarkan apa aliran kerja perlukan

Macam sihir, tapi sebenarnya cuma kod yang baik. ✨

## Misi Anda: Bina Studio Podcast 🎬

### Misi 1: Cipta Satu Ejen Dengan DevUI

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

**Cabaran**: Sebelum bina pasukan penuh, mari uji DevUI dengan satu ejen: pakar carian web.

**Apa Yang Anda Bina**:
Ejen penyelidikan yang boleh cari topik podcast di internet. Anda akan uji menggunakan antara muka web DevUI di `http://localhost:8090`.

**Kemahiran Yang Anda Pelajari**:
- 🚀 Melancarkan ejen dalam DevUI
- 🔍 Uji respons ejen masa nyata
- 🛠️ Bina alatan khusus (carian web)
- 📊 Hidupkan jejak untuk nyahpepijat isu
- 🖥️ Guna UI web interaktif

**Kod**:
- `agent.py`: SearchAgent anda dengan kuasa carian web
- Guna OllamaChatClient sambung ke Qwen
- Laksanakan fungsi alatan `web_search()`
- Lancarkan dengan `serve()` — buka DevUI secara automatik

**Syarat Kemenangan**: Tanyakan pada ejen anda "Apa yang trending dalam AI?" dan lihat ia cari web! 🎉

### Misi 2: Bina Aliran Kerja Multi-Ejen

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

**Cabaran**: Kini keseronokan sebenar bermula! Bina aliran kerja lengkap produksi podcast dengan:
1. 🔍 **Ejen Carian** → Menyelidik topik anda
2. ✍️ **Ejen Skrip** → Tulis dialog antara dua hos (dalam bahasa Cina!)
3. 👤 **Eksekutor Semak** → Minta ANDA luluskan atau tolak
4. 🔄 **Ulang Kembali** → Jika ditolak, tulis semula ikut maklum balas anda

**Kemahiran Yang Anda Pelajari**:
- 🧱 Cipta ejen khusus untuk tugasan berlainan
- 🔗 Sambung ejen dengan WorkflowBuilder
- 🔀 Laksanakan gelung kelulusan (manusia dalam kitaran!)
- 🚦 Laluan bersyarat (jika lulus vs. tolak)
- 🔧 Bina eksekutor khusus untuk logik perniagaan

**Aliran Kerja**:
```
SearchAgent → ScriptAgent → ReviewExecutor
                             ↑          ↓ (if rejected)
                             ←─────────
```

**Kod**:
- `search_agent/agent.py`: Pakar penyelidikan anda
- `generate_script_agent/agent.py`: Penulis skrip anda (tulis dalam Cina!)
- `workflow/workflow.py`: Magik pengaturan berlaku di sini
- `main.py`: Lancarkan semuanya di DevUI

**Syarat Kemenangan**: Berikan topik, semak skrip, tolak sekali untuk uji gelung, kemudian luluskan! 🎉

### Misi 3: Bina Aplikasi Konsol

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

**Cabaran**: Ambil aliran kerja anda dari DevUI dan jadikan aplikasi terminal bergaya dengan output berwarna, pemutar beban, dan simpan fail. Ini sedia untuk produksi!

**Kemahiran Yang Anda Pelajari**:
- ⚡ Jalankan aliran kerja secara programatik (tanpa DevUI)
- 📡 Reka bentuk berasaskan acara dengan penstriman
- 🎨 Cipta UI terminal cantik (warna, pemutar, bar kemajuan)
- 💾 Simpan skrip akhir ke dalam fail
- 🔄 Urus aliran kerja asinkron dengan asyncio Python

**Apa Yang Dilakukan**:
1. Tanya topik podcast
2. Tunjuk kemajuan masa nyata ("Ejen Carian sedang bekerja...")
3. Papar skrip yang dijana dengan warna
4. Tanya kelulusan anda
5. Simpan skrip diluluskan ke `podcast.txt`

**Kod**:
- `podcast_app.py`: Aplikasi utama dengan pengendalian acara
- `workflow.py`: Guna semula aliran kerja dari Misi 2
- Urus acara: `AgentRunUpdateEvent`, `RequestInfoEvent`, `WorkflowOutputEvent`
- Guna warna ANSI untuk gaya terminal

**Syarat Kemenangan**: Jalankan aplikasi, cipta skrip podcast, dan lihat ia disimpan! Anda telah bina alat sebenar. 🚀

## Apa Yang Anda Kuasai 🏆

Selepas Babak 2, anda boleh:

- ✅ Menyelaras beberapa ejen AI seperti seorang ketua
- ✅ Bina aliran kerja dengan logik bersiri DAN bersyarat
- ✅ Tambah titik semak kelulusan manusia
- ✅ Guna DevUI untuk uji dan nyahpepijat aliran kerja
- ✅ Cipta aplikasi konsol sedia produksi
- ✅ Urus ralat dengan baik dalam sistem kompleks
- ✅ Pilih corak pengaturan tepat untuk sebarang projek

## Bila Ada Masalah 🔧

### "Aliran kerja saya terlalu rumit!"
**Penyelesaiannya**: Pecahkan kepada sub-aliran yang lebih kecil. Setiap aliran kerja perlu buat SATU perkara dengan baik. Sambungkan mereka jika perlu.

### "Saya tak boleh pantau apa yang terjadi!"
**Penyelesaiannya**: Gunakan penandaan pos aliran kerja untuk simpan keadaan. Hidupkan jejak dalam DevUI untuk lihat setiap langkah.

### "Ralat satu ejen rosakkan semuanya!"
**Penyelesaiannya**: Tambah sempadan ralat. Setiap ejen perlu urus kegagalannya sendiri dan ada tingkah laku sandaran.

### "Ini sangat perlahan"
**Penyelesaiannya**: Ada ejen boleh jalankan serentak? Aliran kerja bersiri mudah tapi perlahan. Cari peluang jalankan selari!

## Sumber Berguna 🔗

- [Dokumen Aliran Kerja](https://learn.microsoft.com/en-us/agent-framework/user-guide/workflows/overview) — Panduan rasmi Microsoft
- [Corak Pengaturan](https://www.ibm.com/think/topics/ai-agent-orchestration) — Pendapat IBM
- [Repositori Agent Framework GitHub](https://github.com/microsoft/agent-framework) — Semak kod sumber
- [Contoh Kod](https://github.com/microsoft/agent-framework/tree/main/python/samples) — Curi corak dari sini

---

**Bersedia untuk penutup?** Anda telah ada skrip anda. Sekarang mari kita jadikan ia menjadi audio sebenar! → [Babak 3: Hidupkan Podcast Anda](03.Multi-SpeakerPodcastGenerationWithVibeVoice.md) 🎤

---

**Terlalu susah? Keliru? Teruja?** Kongsi dalam sembang bengkel! Kita semua belajar bersama. 🚀

---

<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Penafian**:
Dokumen ini telah diterjemahkan menggunakan perkhidmatan terjemahan AI [Co-op Translator](https://github.com/Azure/co-op-translator). Walaupun kami berusaha untuk ketepatan, sila ambil perhatian bahawa terjemahan automatik mungkin mengandungi kesilapan atau ketidaktepatan. Dokumen asal dalam bahasa asalnya harus dianggap sebagai sumber yang sahih. Untuk maklumat penting, terjemahan profesional oleh manusia adalah disyorkan. Kami tidak bertanggungjawab atas sebarang salah faham atau salah tafsir yang timbul daripada penggunaan terjemahan ini.
<!-- CO-OP TRANSLATOR DISCLAIMER END -->