Email — AI Mengirim dan Menerima Surat

Email — AI Mengirim dan Menerima Surat

Bayangkan ini: kamu mengirim email ke agen AI-mu, dan dia membalasnya — langsung di thread yang sama. Tanpa aplikasi chat canggih, tanpa bot API, tanpa software tambahan. Hanya email biasa. Itulah yang dilakukan oleh adaptor gateway Email untuk Hermes.

Di postingan ini, kita akan membahas cara mengaturnya, cara kerjanya di balik layar, dan cara menjaga keamanan kotak masukmu.

Kenapa Email?

Email itu universal. Semua orang punya alamat. Dengan menyambungkan Hermes ke kotak suratmu melalui IMAP standar (untuk menerima) dan SMTP (untuk mengirim), kamu mendapatkan AI percakapan yang berfungsi dengan Gmail, Outlook, Yahoo, Fastmail, atau penyedia mana pun yang mendukung protokol ini.

Dan ini bagian terbaiknya: nol dependensi eksternal. Adaptor ini menggunakan modul bawaan Python imaplib, smtplib, dan email. Tanpa paket tambahan, tanpa layanan pihak ketiga.

Catatan: Ini berbeda dari skill email Himalaya yang sudah dibundel, yang memungkinkan agen mengelola kotak suratmu melalui perintah terminal. Skill tersebut memerlukan CLI himalaya eksternal. Adaptor gateway ini adalah jalur yang lebih sederhana dan mandiri.

Sebelum Kamu Mulai

Kamu perlu tiga hal:

1. Akun email khusus untuk agenmu (tolong jangan gunakan kotak masuk pribadimu)
2. IMAP diaktifkan di akun tersebut
3. Kata sandi aplikasi jika kamu menggunakan Gmail atau penyedia mana pun dengan autentikasi dua faktor

Untuk Gmail: aktifkan 2FA, lalu buat App Password di myaccount.google.com/apppasswords. Kamu akan mendapatkan kata sandi 16 karakter — gunakan itu, bukan kata sandi biasa.

Untuk Outlook/Microsoft 365: aktifkan 2FA, buat kata sandi aplikasi di bawah “Additional security options,” dan gunakan outlook.office365.com untuk IMAP dan smtp.office365.com untuk SMTP.

Untuk penyedia lain, periksa dokumentasi mereka untuk host dan port IMAP/SMTP (biasanya 993 untuk IMAP SSL, 587 untuk SMTP STARTTLS).

Langkah 1: Konfigurasi Hermes

Cara termudah adalah dengan wizard pengaturan:

hermes gateway setup

Pilih Email dari menu dan ikuti petunjuknya. Wizard akan meminta alamatmu, kata sandi aplikasi, host IMAP/SMTP, dan pengirim yang diizinkan.

Lebih suka konfigurasi manual? Tambahkan ini ke ~/.hermes/.env:

# Wajib
EMAIL_ADDRESS=hermes@gmail.com
EMAIL_PASSWORD=abcd efgh ijkl mnop    # Kata sandi aplikasi, bukan kata sandi biasa
EMAIL_IMAP_HOST=imap.gmail.com
EMAIL_SMTP_HOST=smtp.gmail.com

# Keamanan (disarankan)
EMAIL_ALLOWED_USERS=your@email.com,colleague@work.com

# Opsional
EMAIL_IMAP_PORT=993                    # Default: 993
EMAIL_SMTP_PORT=587                    # Default: 587
EMAIL_POLL_INTERVAL=15                 # Detik antara pengecekan kotak masuk
EMAIL_HOME_ADDRESS=your@email.com      # Target pengiriman default untuk cron jobs

Langkah 2: Mulai Gateway

hermes gateway              # Jalankan di latar depan
hermes gateway install      # Pasang sebagai layanan pengguna
sudo hermes gateway install --system   # Linux: layanan sistem saat boot

Saat startup, adaptor menguji koneksi IMAP dan SMTP, menandai semua pesan kotak masuk yang ada sebagai “sudah dibaca” (sehingga hanya memproses email baru), dan mulai melakukan polling.

Cara Kerjanya

Menerima pesan. Adaptor memeriksa email BELUM DIBACA setiap 15 detik secara default. Untuk setiap pesan baru:

• Baris subjek disertakan sebagai konteks (misalnya, [Subjek: Deploy ke produksi])
• Balasan (subjek yang dimulai dengan Re:) melewati prefiks subjek — konteks thread sudah ada di sana
• Lampiran di-cache secara lokal: gambar tersedia untuk alat visi, dokumen seperti PDF dan ZIP untuk akses file
• Email HTML-only tag-nya dihapus untuk ekstraksi teks biasa
• Pesan ke diri sendiri disaring untuk mencegah perulangan balasan
• Pengirim otomatis diabaikan secara diam-diam — noreply@, mailer-daemon@, bounce@, dan email dengan header Auto-Submitted, Precedence: bulk, atau List-Unsubscribe

Mengirim balasan. Balasan dikirim melalui SMTP dengan threading yang tepat: header In-Reply-To dan References menjaga percakapan tetap terhubung, subjek mempertahankan prefiks Re: (tanpa Re: Re: ganda), dan respons dikirim sebagai teks UTF-8 biasa.

Lampiran file. Ingin agen mengirim file kembali? Cukup sertakan MEDIA:/path/to/file dalam responsnya dan file itu akan dilampirkan secara otomatis.

Melewati lampiran. Khawatir tentang malware atau bandwidth? Tambahkan ini ke config.yaml:

platforms:
  email:
    skip_attachments: true

Teks badan email tetap diproses secara normal — hanya lampiran yang diabaikan.

Kontrol Akses: Bersikap Ketat Secara Default

Email lebih terkunci dibandingkan platform chat secara desain:

1. EMAIL_ALLOWED_USERS diatur → hanya email dari alamat tersebut yang diproses
2. Tidak ada daftar izin → pengirim tidak dikenal diabaikan secara diam-diam
3. EMAIL_ALLOW_ALL_USERS=true → pengirim mana pun diterima (gunakan dengan hati-hati!)
4. platforms.email.unauthorized_dm_behavior: pair → pengirim tidak dikenal menerima kode pemasangan

Aturan emas: gunakan kotak masuk khusus dan selalu konfigurasikan EMAIL_ALLOWED_USERS. Pemasangan email bersifat opt-in karena kotak masuk bersama sering kali berisi pesan belum dibaca yang tidak terkait — Hermes seharusnya tidak membalas kontak tersebut secara default.

Pemecahan Masalah

Masalah	Solusi
“Koneksi IMAP gagal” saat startup	Periksa EMAIL_IMAP_HOST dan EMAIL_IMAP_PORT. Pastikan IMAP diaktifkan di akun (Gmail: Setelan → Penerusan dan POP/IMAP)

Penutup

Adaptor gateway Email mengubah kotak surat standar mana pun menjadi saluran komunikasi untuk agen AI-mu. Tanpa dependensi eksternal, tanpa klien khusus — hanya IMAP, SMTP, dan sedikit konfigurasi. Siapkan akun khusus, kunci pengirim yang diizinkan, dan biarkan email mengalir.

Selamat berkirim email! 📧