Hermes Agent Documentation — Panduan Mudah

Bayangkan awak ada pembantu peribadi yang boleh ingat semua arahan awak, buat kerja automatik macam hantar emel berjadual, atau even bantu awak cari maklumat dalam dokumen panjang tanpa awak perlu baca satu persatu. Itu lah Hermes Agent — sebuah AI agent (pembantu pintar) yang boleh berfungsi macam pembantu setia awak dalam dunia digital. Tapi sebelum awak boleh guna sepenuhnya, awak perlu tahu cara baca dokumentasi rasminya.

Jangan risau, dokumentasi ni bukan macam buku teks sekolah yang penuh dengan istilah teknikal susah difahami. Ia lebih macam manual pengguna untuk kereta baru — ada bahagian yang terangkan apa fungsi setiap butang, dan ada bahagian yang ajar awak cara setkan supaya kereta tu jalan dengan lancar. Dalam artikel ini, kita akan belajar cara cari rujukan, fahami konfigurasi, dan guna alat bantuan dalam dokumentasi Hermes Agent dengan cara yang paling mudah. Siap dengan analogi kehidupan harian Malaysia supaya lebih senang difahami!

Apa Itu Dokumentasi Rasmi?

Dokumentasi rasmi ni macam buku panduan untuk sesuatu produk. Kalau awak beli mesin basuh baru, awak akan dapat buku panduan yang terangkan cara pasang, cara cuci, dan apa yang perlu buat kalau mesin tu rosak. Dokumentasi rasmi Hermes Agent pun sama — ia terangkan apa yang boleh Hermes buat, cara setkan, dan cara selesaikan masalah kalau ada.

Dalam dunia teknologi, dokumentasi biasanya ada dalam bentuk halaman web atau fail Markdown (macam nota ringkas dalam GitHub). Untuk Hermes Agent, awak boleh jumpa dokumentasi rasminya di dua tempat:

• Laman web rasmi Hermes Agent — lebih mesra pengguna, sesuai untuk pemula.
• GitHub Hermes Agent — lebih teknikal, sesuai untuk mereka yang nak ubah suai atau faham kod.

Untuk artikel ini, kita akan fokus pada laman web rasmi dulu, sebab ia lebih mudah difahami untuk pemula.

Kenapa Perlu Baca Dokumentasi?

Awak mungkin tertanya-tanya: “Kenapa tak boleh terus guna je?” Jawapannya: dokumentasi ni ibarat peta. Kalau awak nak pergi ke tempat baru, awak perlukan peta untuk tahu jalan mana yang perlu diambil. Tanpa peta, awak mungkin tersesat atau terlepas tempat menarik.

Contoh dalam kehidupan sebenar:

• Kalau awak nak setkan automasi berjadual (macam hantar emel setiap pagi), awak perlu tahu cara tulis arahan dalam Hermes. Dokumentasi akan terangkan macam mana nak tulis arahan tu.
• Kalau awak nak guna Hermes dalam Telegram atau WhatsApp, awak perlu tahu cara sambungkan Hermes dengan aplikasi tu. Dokumentasi akan terangkan langkah demi langkah.
• Kalau Hermes tak berfungsi macam yang awak harapkan, dokumentasi akan ada senarai masalah biasa dan cara selesaikannya.

Jadi, dokumentasi ni wajib kalau awak nak guna Hermes dengan berkesan. Tapi jangan risau — kita akan belajar cara baca dengan cara yang paling mudah!

Cara Cari Rujukan dalam Dokumentasi

Dokumentasi Hermes Agent ni panjang, tapi awak tak perlu baca semua sekali gus. Yang penting, awak tahu cara cari apa yang awak perlukan. Macam kalau awak cari resipi masakan dalam buku resipi — awak tak perlu baca semua, cuma cari bahagian yang awak nak.

Berikut adalah cara mudah untuk cari rujukan dalam dokumentasi:

1. Guna Kotak Carian (Search Box)

Kebanyakan dokumentasi, termasuk Hermes Agent, ada kotak carian di bahagian atas. Awak boleh taip apa yang awak cari, dan sistem akan tunjukkan hasil yang berkaitan.

Contoh:

• Awak taip “Telegram” — dokumentasi akan tunjukkan cara sambungkan Hermes dengan Telegram.
• Awak taip “jadual” — dokumentasi akan tunjukkan cara setkan automasi berjadual.

Ini macam awak taip “nasi lemak” dalam Google — awak akan dapat banyak resipi dan tempat jual nasi lemak.

2. Lihat Bahagian “Table of Contents” (Jadual Kandungan)

Dokumentasi biasanya ada jadual kandungan di sebelah kiri atau atas halaman. Ia macam senarai isi dalam buku. Awak boleh klik pada tajuk yang menarik minat awak untuk terus pergi ke bahagian tersebut.

Contoh bahagian yang mungkin ada dalam dokumentasi Hermes Agent:

• Getting Started — cara pasang dan mula guna Hermes.
• Configuration — cara setkan Hermes mengikut keperluan awak.
• Platforms — cara guna Hermes dalam Telegram, WhatsApp, Discord, dll.
• Automations — cara setkan tugas automatik.
• Troubleshooting — cara selesaikan masalah.

Ini macam awak buka buku resipi dan terus pergi ke bahagian “Makanan Sarapan” kalau awak nak masak nasi lemak.

3. Guna Ctrl+F (Cari dalam Halaman)

Kalau awak dah berada dalam halaman dokumentasi, awak boleh tekan Ctrl+F (untuk Windows) atau Cmd+F (untuk Mac) untuk cari perkataan tertentu dalam halaman tu. Ini sangat berguna kalau awak nak cari sesuatu yang spesifik.

Contoh:

• Awak taip “memory” untuk cari bahagian tentang Persistent Memory (keupayaan Hermes untuk ingat merentasi sesi).
• Awak taip “Docker” untuk cari cara guna Hermes dengan Docker.

Ini macam awak cari perkataan “gula” dalam resipi untuk tahu berapa banyak gula yang perlu dimasukkan.

Fahami Konfigurasi (Config) Hermes Agent

Salah satu bahagian paling penting dalam dokumentasi Hermes Agent ialah konfigurasi (atau config). Konfigurasi ni macam tetapan untuk Hermes — awak boleh ubah suai supaya Hermes berfungsi macam yang awak mahu.

Contoh dalam kehidupan sebenar:

• Awak boleh setkan jam penggera dalam telefon awak. Konfigurasi ni macam tetapan untuk jam penggera tu.
• Awak boleh ubah suhu peti sejuk supaya makanan lebih sejuk. Konfigurasi ni macam tetapan untuk peti sejuk tu.

Dalam Hermes Agent, konfigurasi biasanya ditulis dalam bentuk fail YAML atau fail JSON. Jangan risau kalau awak tak tahu apa itu YAML atau JSON — ia cuma cara untuk tulis tetapan dalam bentuk yang mudah dibaca oleh komputer.

Contoh Konfigurasi Sederhana

Berikut adalah contoh konfigurasi asas untuk Hermes Agent (jangan risau, dokumentasi akan terangkan setiap bahagian):

# Ini adalah contoh fail konfigurasi untuk Hermes Agent
name: "Pembantu Peribadi Saya"
platform: "telegram"  # Boleh tukar kepada "whatsapp", "discord", dll.
automations:
  - name: "Hantar emel pagi"
    schedule: "0 8 * * *"  # Setiap hari jam 8 pagi
    task: "Hantar emel kepada boss tentang laporan harian"
persistent_memory: true  # Hermes akan ingat perbualan lepas

Dalam dokumentasi, setiap bahagian konfigurasi akan diterangkan dengan jelas. Contoh:

• name — Nama untuk Hermes Agent awak. Contoh: “Pembantu Peribadi Saya”.
• platform — Platform yang awak nak guna (Telegram, WhatsApp, Discord, dll.).
• automations — Senarai tugas automatik yang awak nak Hermes jalankan.
• schedule — Bila tugas automatik tu perlu dijalankan (macam jam penggera).
• persistent_memory — Sama ada Hermes patut ingat perbualan lepas atau tidak.

Dokumentasi akan terangkan setiap pilihan ni dengan lebih terperinci, termasuk contoh-contoh lain yang awak boleh cuba.

Guna Alat Bantuan (Help Tools) dalam Dokumentasi

Dokumentasi Hermes Agent bukan sekadar teks — ia juga ada alat bantuan yang boleh memudahkan hidup awak. Berikut adalah beberapa alat bantuan yang mungkin awak jumpa:

1. Contoh Kod (Code Examples)

Dokumentasi biasanya akan ada contoh kod yang awak boleh salin dan tampal terus ke dalam konfigurasi awak. Ini macam awak dapat resipi siap masak — awak cuma perlu ikut langkah yang diberi.

Contoh:

# Contoh: Cara setkan automasi untuk hantar emel setiap hari
automations:
  - name: "Hantar emel laporan"
    schedule: "0 9 * * 1-5"  # Setiap hari Isnin hingga Jumaat, jam 9 pagi
    task: "Hantar emel laporan mingguan kepada pasukan"

Awak boleh salin kod ni dan ubah suai mengikut keperluan awak.

2. Soalan Lazim (FAQ)

Bahagian FAQ (Frequently Asked Questions) ni macam senarai soalan yang sering ditanya oleh pengguna lain. Ia sangat berguna kalau awak ada masalah yang sama.

Contoh soalan dalam FAQ:

• “Kenapa Hermes tak boleh sambung dengan Telegram?”
• “Macam mana nak setkan automasi berjadual?”
• “Kenapa Hermes lupa perbualan lepas?”

Dokumentasi akan berikan jawapan untuk setiap soalan tu.

3. Panduan Langkah Demi Langkah (Step-by-Step Guides)

Dokumentasi juga akan ada panduan langkah demi langkah untuk tugas-tugas tertentu. Ini macam arahan pasang perabot IKEA — setiap langkah dijelaskan dengan terperinci supaya awak tak tersilap.

Contoh:

1. Pasang Hermes Agent dalam komputer awak.
2. Sambungkan Hermes dengan Telegram.
3. Setkan automasi untuk hantar emel setiap pagi.
4. Uji automasi tu untuk pastikan ia berfungsi.

Setiap langkah akan ada penerangan dan mungkin gambar atau contoh kod.

4. Forum atau Komuniti

Walaupun dokumentasi rasmi ni lengkap, kadang-kadang awak mungkin ada soalan yang tak terjumpa jawapannya. Dalam kes ni, awak boleh tanya dalam forum komuniti atau Discord Hermes Agent. Dokumentasi biasanya akan ada pautan ke komuniti ni.

Ini macam awak tanya kawan yang dah pernah guna Hermes sebelum ni — mereka mungkin boleh bantu selesaikan masalah awak.

Tips untuk Baca Dokumentasi dengan Berkesan

Baca dokumentasi mungkin nampak menakutkan pada mulanya, tapi dengan tips berikut, awak boleh jadi lebih cekap:

1. Mulakan dengan Bahagian “Getting Started”

Bahagian ni biasanya terangkan apa itu Hermes Agent dan cara pasang untuk kali pertama. Ia macam bab pengenalan dalam buku — penting untuk faham konsep asas sebelum pergi lebih dalam.

2. Jangan Cuba Hafal Semua

Dokumentasi ni bukan untuk dihafal — ia untuk dirujuk bila awak perlukan. Fokus pada bahagian yang awak perlukan sahaja. Contoh: kalau awak nak guna Hermes dalam WhatsApp, fokus pada bahagian WhatsApp tu.

3. Cuba Langsung

Sebaik sahaja awak baca sesuatu bahagian, cuba praktikkan terus. Contoh: kalau awak baca cara setkan automasi, cuba setkan satu automasi mudah dan uji ia berfungsi.

Ini macam belajar memandu — awak tak boleh belajar dengan baca buku sahaja, awak perlu praktik di jalan raya.

4. Buat Nota Ringkas

Kalau awak jumpa sesuatu yang penting, buat nota ringkas dalam fail atau buku nota. Contoh:

# Nota: Cara setkan automasi berjadual
schedule: "0 8 * * *"  # Setiap hari jam 8 pagi

Ini akan memudahkan awak rujuk kemudian.

5. Jangan Malu Tanya

Kalau awak tak faham sesuatu, tanya dalam komuniti. Tiada soalan yang bodoh — semua orang bermula dari sifar!

Kesimpulan: Dokumentasi Adalah Kawan Awak

Dokumentasi rasmi Hermes Agent mungkin nampak panjang dan teknikal, tapi sebenarnya ia adalah kawan yang akan bantu awak guna Hermes dengan lebih berkesan. Dengan belajar cara cari rujukan, fahami konfigurasi, dan guna alat bantuan, awak akan boleh:

• Setkan Hermes untuk buat tugas automatik macam hantar emel atau mesej.
• Guna Hermes dalam platform kegemaran awak (Telegram, WhatsApp, Discord, dll.).
• Selesaikan masalah dengan cepat kalau Hermes tak berfungsi macam yang diharapkan.

Ingat, tiada siapa yang jadi pakar dalam sekelip mata. Ambil masa awak, cuba langkah demi langkah, dan jangan takut untuk bereksperimen. Hermes Agent ni dicipta untuk mudahkan hidup awak, dan dokumentasi ni adalah kunci untuk membuka potensi penuhnya.

Jadi, apa lagi yang awak tunggu? Mula baca dokumentasi Hermes Agent hari ini dan cuba sendiri! 🚀

Cuba Hermes Agent: https://hermes-agent.org

Hermes Agent — open-source, MIT license, percuma untuk kegunaan peribadi dan komersial.