Malas Baca Laporan Panjang? Biar Python & Gemini Ringkaskan Terus Dari Fail PDF!

Bayangkan senario ini: Hari Jumaat, jam 4:45 petang. Anda sedang gembira mengemas meja dan memasukkan barang ke dalam beg untuk pulang tepat pada waktunya. Tiba-tiba, telefon anda berbunyi. Bos anda menghantar satu fail PDF laporan perniagaan setebal 20 muka surat di WhatsApp, berserta mesej ringkas: “Ah Chong, jam 5:30 petang kita ada mesyuarat tergempar. Tolong baca laporan ini dan bentangkan poin-poin penting nanti.”

Melihat fail PDF yang penuh dengan ribuan abjad Inggeris yang padat itu, bukankah tekanan darah anda mendadak naik? Silap-silap, penyakit rabun dan pening kepala pun boleh datang serentak! Untuk menghabiskan bacaan, memahami isi kandungan, dan merumuskannya dalam masa kurang satu jam adalah satu misi yang hampir mustahil.

Bukan sahaja di tempat kerja, malah dalam kehidupan seharian pun sama. Apabila kawan-kawan atau saudara-mara menghantar fail dokumen ‘panjang berjela’, berapa kerap anda sebenarnya membacanya sampai habis? Mesti anda selalu ‘scroll‘ laju-laju ke bawah sebab malas nak baca (TL;DR – Too Long; Didn’t Read), bukan?

Tetapi, bagaimana jika Ah Pek beritahu anda satu rahsia besar? Anda sebenarnya tidak perlu buka pun fail PDF itu! Anda hanya perlu ambil fail tersebut, campakkan ke dalam ‘dapur magik’ Google Colab anda, dan beritahu otak Google Gemini: “Tolong baca PDF ni, buang semua ayat berbunga-bunga, dan berikan saya 3 isi paling penting sahaja dalam Bahasa Melayu yang mudah.”

Hanya dalam masa 5 saat, laporan 20 muka surat yang asalnya memerlukan 40 minit untuk dibaca, kini bertukar menjadi rumusan padat yang boleh anda fahami dalam masa 1 minit sahaja!

Hari ini, Ah Pek akan mengajar anda bagaimana menggunakan Python untuk membina ‘Mesin Pembaca Super’ peribadi anda. Mari kita ucapkan selamat tinggal kepada sakit mata membaca teks panjang, dan gunakan masa yang berbaki itu untuk menikmati secawan Kopi O dengan tenang!

[Nota Ah Pek untuk yang tak sabar]

Kepada anda yang nak cepat siapkan kerja dan terus nak Copy-Paste kod penuh tanpa baca panjang-panjang, anda boleh terus scroll laju-laju ke bahagian paling bawah (Nombor 9). Tapi kalau anda nak faham ilmu magik ni step-by-step, jom baca perlahan-lahan dari mula!

1. Penyelamat ‘Mata Rabun’ di Era Lambakan Maklumat

Kenapa kita cepat rasa penat bila nampak dokumen yang panjang? Secara psikologinya, otak manusia moden sudah terbiasa dengan maklumat yang pantas. Apabila kita dipaksa membaca PDF yang meleret, otak kita menggunakan banyak tenaga (glukosa) untuk memproses perkataan demi perkataan, dan cuba menapis mana satu fakta penting.

Di sinilah teknologi Kepintaran Buatan (AI) masuk sebagai wira penyelamat. AI seperti Google Gemini dicipta untuk membaca dokumen setebal mana pun dalam sekelip mata tanpa rasa penat.

Mari kita lihat jadual perbandingan di bawah untuk membuktikan betapa besarnya kerugian anda jika tidak menggunakan skil Python ini:

Situasi & Cabaran	Baca Sendiri (Cara Manual)	Guna Python + Google Gemini
Masa Menyiapkan Tugasan	30 minit hingga 1 jam penuh.	Bawah 5 saat!
Tahap Tekanan (Kepenatan)	Mata pedih, otak tepu, cepat mengantuk.	Sangat relaks. Sambil minum air pun siap.
Halangan Bahasa	Perlu buka Google Translate ayat demi ayat.	Automatik. AI baca PDF Inggeris, dan ringkaskan terus dalam Bahasa Melayu.
Fokus & Kejelasan	Mudah terlepas pandang fakta penting.	Fokus tajam. AI terus ‘tembak’ 3 isi utama.

Apabila anda menguasai teknik ini, anda bukan menjadi malas, tetapi anda menjadi seorang profesional yang cekap dan bijak menguruskan masa!

2. Ulang Kaji Ringkas: Sediakan ‘Dapur’ dan ‘Kunci’ Anda

Sebelum kita mula menulis kod, mari kita buat persiapan dapur (bagi yang dah baca artikel pertama Ah Pek, pasti anda dah terer bab ni!).

• Dapatkan Kunci API: Pergi ke aistudio.google.com, log masuk akaun Google, dan tekan butang “Create API key” untuk mendapatkan kunci rahsia anda. Kunci ini ibarat pasport untuk anda mengarahkan Gemini.
• Buka Meja Kerja Anda: Pergi ke colab.research.google.com dan buka Notebook baharu.
• Pasang Alat Bantuan: Di dalam kotak kod pertama Google Colab, taip arahan ini: !pip install google-genai dan tekan butang Play. Tunggu sebentar biarkan ia siap dimuat turun.

Dapur dah siap, kuali dah panas. Jom kita mula mengekod!

3. [Langkah 1] Campakkan Dokumen PDF Anda ke Awan!

Oleh kerana kita menggunakan Google Colab (komputer di awan), kita kena hantar fail PDF bos tadi naik ke atas awan dulu. Caranya sangat mudah, tak payah tulis kod pun:

1. Tengok menu di sebelah KIRI skrin Google Colab anda. Klik ikon yang rupa macam Folder (Files).
2. Tarik dan lepas (drag and drop) fail PDF anda (contohnya laporan.pdf) dari komputer anda masuk ke dalam ruangan kosong itu.
3. Tunggu beberapa saat sampai nama fail tu muncul. Siap!

Sekarang, buka kotak kod baharu, dan tulis kod ini untuk melantik Runner kita dan suruh dia hantar dokumen tu masuk ke “dapur” Google:

# Bawa masuk "kotak alatan" (library) Google Gemini versi terkini ke dalam sistem
from google import genai

# ==============================================================
# BAHAGIAN 1: MASUKKAN KUNCI RAHSIA (API KEY) ANDA
# ==============================================================
client = genai.Client(api_key="Letak_API_KEY_Sebenar_Anda_Di_Sini")

# ==============================================================
# BAHAGIAN 2: UPLOAD FAIL PDF KE DALAM OTAK GEMINI
# ==============================================================
print("Sedang memuat naik dokumen PDF ke dapur... sabar ya!")
# Pastikan nama fail di bawah sama dengan nama PDF di komputer anda
dokumen_pdf = client.files.upload(file="laporan.pdf")
print("✅ Dokumen berjaya dihidangkan!\n")

4. [Langkah 2] Cari Chef Bertugas & Tulis Kertas Pesanan

Google selalu tukar-tukar nama AI di pelayan mereka. Kadang-kadang nama dia ‘Pro’, esok lusa jadi ‘Flash’. Daripada kita pening teka dan asyik kena ralat, kita suruh Python cari sendiri Ketua Chef mana yang tengah kerja hari ni.

Selepas tu, kita tulis arahan (Prompt) yang jelas. Masukkan kod ini di bawah kod tadi:

# ==============================================================
# BAHAGIAN 3: AUTO-DETECT MODEL AI (Cari "Ketua Chef" secara automatik)
# ==============================================================
print("Sedang menyemak senarai model AI yang aktif pada akaun anda...")
best_model = None

for m in client.models.list():
    if "gemini" in m.name and "embedding" not in m.name and "aqa" not in m.name:
        best_model = m.name
        break

if not best_model:
    print("❌ Ralat: Tiada model Gemini yang aktif ditemui untuk API Key ini.")
    exit()

print(f"✅ Berjaya! Model yang akan digunakan: {best_model}\n")

# ==============================================================
# BAHAGIAN 4: TULIS ARAHAN KEPADA AI (PROMPT ENGINEERING)
# ==============================================================
# Nampak? Sekarang arahan jadi sangat pendek dan kemas!
arahan_anda = """
Sila baca dokumen PDF yang dilampirkan bersama ini.
Tugas anda:
1. Ekstrak 3 isi paling penting sahaja daripada dokumen tersebut.
2. Tuliskan rumusan dalam bentuk 'bullet points' bernombor.
3. Terjemahkan rumusan tersebut ke dalam Bahasa Melayu yang santai dan mudah difahami.
4. Jangan gunakan ayat berbunga-bunga, terus *straight to the point*.
"""

5. [Langkah 3] Laksanakan Magik: Ekstrak Pati Dalam 5 Saat

Sekarang, fail PDF dah ada, kertas order arahan pun dah siap. Tiba masanya kita suruh runner letak dua-dua benda ni atas satu dulang dan hantar ke Chef!

Masukkan baris kod terakhir ini, dan tekan butang Play:

# ==============================================================
# BAHAGIAN 5: HANTAR ARAHAN + PDF DAN TERIMA HASILNYA
# ==============================================================
print("Mesin Pembaca Super sedang memproses dokumen... Sila tunggu!\n")

# Perhatikan di sini: Kita hantar DUA benda di dalam kurungan [ ]
# Iaitu fail PDF tadi, dan juga arahan kita.
response = client.models.generate_content(
    model=best_model,
    contents=[dokumen_pdf, arahan_anda]
)

print("===== INI DIA 3 ISI PENTING UNTUK ANDA! =====")
print(response.text)

Kira di dalam hati… satu, dua, tiga, empat, lima!

Saksikan keajaiban yang keluar di skrin bawah anda. Walaupun laporan PDF bos anda mengandungi 20 muka surat berlaras bahasa korporat Inggeris yang sangat kompleks, Gemini dengan tenang akan mengeluarkan jawapan seperti ini:

===== INI DIA 3 ISI PENTING UNTUK ANDA! (CONTOH SAHAJA)=====

1. Keuntungan Syarikat Menurun: Suku tahun ini, syarikat kita mengalami kerugian sebanyak 15% berbanding tahun lepas disebabkan kos bahan mentah yang melambung tinggi.
2. Projek C Ditangguhkan: Projek pembinaan gudang baharu terpaksa ditangguhkan ke tahun hadapan untuk menyelamatkan bajet aliran tunai (cash flow) syarikat.
3. Tiada Pembuangan Pekerja (Bertenang!): Walaupun rugi, pihak pengurusan berjanji tiada pekerja yang akan dibuang kerja, tetapi tiada bonus akan diberikan pada tahun ini.

Siap! Anda kini dah tahu 100% inti pati keseluruhan dokumen PDF tebal tersebut. Anda dah bersedia untuk masuk ke bilik mesyuarat dengan dada yang lapang dan idea yang jelas. Kawan-kawan anda yang lain mungkin masih lagi menggaru kepala menatap helaian PDF muka surat pertama!

6. [Bonus Ah Pek] Bukan Sekadar Ringkas, Boleh Analisis Emosi & Pelbagai Dokumen!

Kuasa membaca fail AI ini bukan hanya terhad untuk meringkaskan laporan bos. Katakanlah anda seorang peniaga yang mendapat satu fail maklum balas (feedback form) daripada pelanggan yang mengandungi berpuluh-puluh komen.

Anda hanya perlu tukar PDF tersebut, dan ubah sedikit arahan (arahan_anda) kepada ini:

“Tolong baca fail dokumen aduan pelanggan ini. Beritahu saya: Secara majoritinya, adakah pelanggan marah, sedih, atau gembira? Senaraikan 2 rungutan paling utama mereka, dan cadangkan satu cara untuk saya selesaikan masalah mereka dengan bajet paling murah.”

Tengok betapa ajaibnya gabungan Python dan AI ini! Anda baru sahaja membina sistem analisis perniagaan peribadi anda sendiri. Inilah sebabnya kita menggunakan fail terus kepada AI, kerana fleksibiliti dan kelajuannya tiada tandingan!

7. Nasihat Otai Ah Pek & Minda Positif (Mindset)

Ah Pek tahu, bila anda dah pandai guna alat ni, anda rasa nak sumbat semua dokumen suruh AI baca. Tetapi, sebagai orang yang pakar, Ah Pek kena bagi satu peringatan keras:

AI adalah penapis (filter) maklumat, bukan penasihat undang-undang!

Jika dokumen PDF yang anda upload itu adalah Dokumen Perjanjian Jual Beli Rumah, Kontrak Pekerjaan Baru, atau Surat Peguam, tolong… tolong jangan hanya baca rumusan AI dan terus turunkan tandatangan!

AI direka bentuk untuk meringkaskan. Dalam proses itu, mungkin terdapat klausa-klausa halus yang disembunyikan oleh pihak peguam yang tidak dimasukkan oleh AI ke dalam rumusannya. Untuk dokumen kritikal yang melibatkan wang dan undang-undang, rumusan AI hanya boleh digunakan sebagai kefahaman asas. Anda tetap wajib membaca kontrak itu dengan mata anda sendiri.

Dari sudut minda (mindset) pula, jangan rasa bersalah kerana menggunakan AI untuk ‘memendekkan’ jalan. Otak manusia tidak direka untuk membaca lambakan data seperti robot. Dengan menyerahkan tugas membaca fail mentah kepada AI, anda telah membebaskan ruang mental anda untuk kerja-kerja yang lebih penting: membuat keputusan strategik dan mencipta inovasi.

8. Kesimpulan: Anda Berjaya Menjimatkan Masa Hayat Anda!

Tepuk bahu anda sendiri, tarik nafas panjang, dan senyum! Hari ini anda telah dinaik taraf menjadi pengguna teknologi tahap Pro.

Mari kita semak semula apa yang anda telah capai hari ini:

• Anda tahu cara untuk berkomunikasi dengan API baharu Gemini dan memuat naik (upload) fail PDF terus ke ruang awan Google.
• Anda pandai membina sistem Auto-Detect supaya kod anda tidak pernah rosak walaupun Google menukar nama model AI mereka.
• Anda menguasai Prompt Engineering, memaksa AI mematuhi arahan format dan menterjemah dokumen kompleks kepada bahasa santai.

Mulai hari ini, tiada apa lagi dokumen tebal yang boleh menakutkan anda. Masa anda sangat mahal. Habiskan masa tersebut untuk duduk merancang masa depan atau berborak mesra dengan keluarga, bukannya merenung skrin komputer membaca teks yang membosankan!

Jika tutorial Ah Pek IT pada hari ini berjaya menyelamatkan anda daripada terpaksa menelan Panadol kerana pening kepala membaca laporan, tolong jangan kedekut ilmu. Klik butang kongsi (Share) dan hantarkan artikel ini kepada rakan-rakan sekerja anda di pejabat. Biar mereka tahu rahsia macam mana anda siapkan kerja 1 jam dalam masa 5 saat.

9. [Hadiah Ah Pek] Kod Penuh ‘Mesin Pembaca Super’ Anda!

Tahniah sebab anda sudi baca dan fahamkan langkah demi langkah di atas! Seperti yang Ah Pek janji, ini adalah kod penuh yang telah disatukan.

Anda hanya perlu Copy semua kod di bawah, Paste ke dalam Google Colab anda, tukar API Key dan nama fail PDF anda, dan terus tekan Play!

# Bawa masuk "kotak alatan" (library) Google Gemini versi terkini ke dalam sistem
from google import genai

# ==============================================================
# BAHAGIAN 1: MASUKKAN KUNCI RAHSIA (API KEY) ANDA
# ==============================================================
client = genai.Client(api_key="Letak_API_KEY_Sebenar_Anda_Di_Sini")

# ==============================================================
# BAHAGIAN 2: UPLOAD FAIL PDF KE DALAM OTAK GEMINI
# ==============================================================
print("Sedang memuat naik dokumen PDF ke dapur... sabar ya!")
# Pastikan nama fail di bawah sama dengan nama PDF di komputer anda
dokumen_pdf = client.files.upload(file="laporan.pdf")
print("✅ Dokumen berjaya dihidangkan!\n")

# ==============================================================
# BAHAGIAN 3: AUTO-DETECT MODEL AI (Cari "Ketua Chef" secara automatik)
# ==============================================================
print("Sedang menyemak senarai model AI yang aktif pada akaun anda...")
best_model = None

for m in client.models.list():
    if "gemini" in m.name and "embedding" not in m.name and "aqa" not in m.name:
        best_model = m.name
        break

if not best_model:
    print("❌ Ralat: Tiada model Gemini yang aktif ditemui untuk API Key ini.")
    exit()

print(f"✅ Berjaya! Model yang akan digunakan: {best_model}\n")

# ==============================================================
# BAHAGIAN 4: TULIS ARAHAN KEPADA AI (PROMPT ENGINEERING)
# ==============================================================
# Nampak? Sekarang arahan jadi sangat pendek dan kemas!
arahan_anda = """
Sila baca dokumen PDF yang dilampirkan bersama ini.
Tugas anda:
1. Ekstrak 3 isi paling penting sahaja daripada dokumen tersebut.
2. Tuliskan rumusan dalam bentuk 'bullet points' bernombor.
3. Terjemahkan rumusan tersebut ke dalam Bahasa Melayu yang santai dan mudah difahami.
4. Jangan gunakan ayat berbunga-bunga, terus *straight to the point*.
"""

# ==============================================================
# BAHAGIAN 5: HANTAR ARAHAN + PDF DAN TERIMA HASILNYA
# ==============================================================
print("Mesin Pembaca Super sedang memproses dokumen... Sila tunggu!\n")

# Perhatikan di sini: Kita hantar DUA benda di dalam kurungan [ ]
# Iaitu fail PDF tadi, dan juga arahan kita.
response = client.models.generate_content(
    model=best_model,
    contents=[dokumen_pdf, arahan_anda]
)

print("===== INI DIA 3 ISI PENTING UNTUK ANDA! =====")
print(response.text)