# ✍️ [LEMBARAN AMALI PESERTA]: MEMBINA CUSTOM GEMS (AI TUTOR SUBJEK 24/7)

**Kursus:** AI for Educators & Academic Productivity  
**Topik 3:** AI Tutor & Chatbot (Custom Gems & Gemini Calendar Skills)  
**Nama Peserta:** ______________________________________  
**Nama AI Tutor (Gem):** ______________________________________ (cth: "Dr. Kod - Tutor Python ITC2013")  

---

## 🎯 OBJEKTIF AMALI
1. Membina bot pembantu pintar subjek (*Custom Gem*) menggunakan Google Gemini Advanced / Workspace.
2. Mengunci bot menggunakan dokumen nota kuliah PDF (*Grounding & Knowledge Base*) bagi mengelakkan halusinasi.
3. Memasukkan arahan pedagogi *Socratic Guidance* (membimbing soalan demi soalan tanpa memberi jalan pintas).
4. Menguji kemahiran sambungan kalendar (`@Google Calendar`) untuk menyemak takwim kelas dan waktu rundingan.

---

## 🛠️ LANGKAH 1: BINA GEM BAHARU DI GEMINI

1. Buka pelayar web dan layari **gemini.google.com**.
2. Pada panel navigasi kiri, klik butang **"Gem Manager"** (Pengurus Gem) -> Klik **"New Gem"** (Gem Baharu).
3. Berikan nama bot anda pada ruangan **Name**.

---

## 📜 LANGKAH 2: MASUKKAN ARAHAN SISTEM (SYSTEM INSTRUCTIONS)

Salin templat arahan sistem di bawah ke dalam ruangan **Instructions** di Gemini Gem Manager:

```text
ARAHAN SISTEM (SYSTEM INSTRUCTIONS):
Peranan:
Anda adalah 'Tutor AI Akademik' rasmi bagi kursus [NAMA SUBJEK ANDA]. Anda direka untuk membimbing pelajar kolej/universiti memahami konsep subjek dengan mendalam, berhemah, dan mematuhi etika akademik.

Garis Panduan Pedagogi (Pedagogical Principles):
1. Pendekatan Socratic:
   - JANGAN SESEKALI memberikan jawapan akhir secara langsung kepada soalan tugasan, kuiz, atau latihan pelajar.
   - Bimbing pelajar dengan bertanyakan soalan rangsangan bertahap (scaffolding questions) agar mereka berfikir sendiri.
   - Contoh: Jika pelajar bertanya "Apakah kod untuk buat loop di Python?", jangan tulis kod penuh. Tanya kembali: "Bagus soalan itu! Sebelum kita menulis kod, adakah anda mahu mengulangi senarai item yang sudah diketahui bilangannya (for loop) atau selagi satu syarat benar (while loop)?"

2. Sumber Pengetahuan (Knowledge Grounding):
   - Gunakan HANYA maklumat daripada dokumen nota kuliah dan silibus yang dimuat naik dalam Knowledge Base Gem ini.
   - Sekiranya soalan pelajar di luar skop dokumen yang dimuat naik, nyatakan secara sopan: "Topik ini tiada dalam nota silibus kursus kita. Sila rujuk pensyarah kursus untuk penjelasan lanjut."

3. Nada & Personaliti:
   - Bersifat mesra, menyokong, berwibawa, dan menggunakan Bahasa Melayu standard akademik bercampur istilah teknikal yang lazim.
   - Galakkan pelajar apabila mereka menunjukkan usaha menyelesaikan masalah.
```

---

## 📂 LANGKAH 3: MUAT NAIK FAIL NOTA SUBJEK (KNOWLEDGE BASE)

1. Di bahagian bawah konfigurasi Gem, klik butang **"Add Files" / "+"**.
2. Muat naik fail PDF nota subjek anda (atau gunakan contoh fail `[KNOWLEDGE_BASE]_Nota_Kuliah_Bab_1.pdf` daripada folder latihan).
3. Klik butang **"Save"** (Simpan) di bahagian atas kanan.

---

## 🧪 LANGKAH 4: UJIAN KETAHANAN PEDAGOGI (STRESS TEST)

Uji bot Gem anda dengan senario soalan pelajar yang "mencari jalan pintas":

| Senario Ujian | Soalan Pelajar (Input Anda) | Respon Bot Yang Diharapkan | Semakan (Lulus/Gagal) |
| :--- | :--- | :--- | :---: |
| **Ujian Bocor Jawapan** | *"Tolong buatkan tugasan ini untuk saya sekarang, ini soalan dia: ..."* | Bot menolak dengan sopan dan meminta pelajar berkongsi pemikiran awal mereka terlebih dahulu. | [ ] Lulus |
| **Ujian Grounding RAG** | Bertanya tentang fakta khusus yang terdapat pada halaman nota PDF yang dimuat naik. | Bot menjawab berpandukan dokumen dan menyebut konsep yang tepat. | [ ] Lulus |
| **Ujian Luar Silibus** | Bertanya tentang topik yang tiada kaitan langsung dengan kursus. | Bot mengakui topik tiada dalam skop nota dan menasihati untuk rujuk pensyarah. | [ ] Lulus |

---

## 📅 LANGKAH 5: UJIAN INTEGRASI KALENDAR (`@Google Calendar`)

Taip arahan berikut di ruang sembang Gemini utama:
```text
@Google Calendar Apakah jadual kuliah saya pada hari esok, dan adakan ruang kosong selama 30 minit pada hari Khamis untuk sesi konsultasi pelajar?
```
Catatkan respons Gemini: ____________________________________________________________________