Tutorial 22: Delegasi Subagen | Easy Understand Hermes Agent

Ini adalah bagian dari seri tutorial resmi Hermes Agent. Lihat semua tutorial

Bayangkan kamu adalah pimpinan tim dalam sebuah proyek. Kamu bisa mengerjakan semuanya sendiri, tapi itu lambat. Sebaliknya, kamu membagikan tugas-tugas spesifik kepada rekan timmu, memberi mereka detail yang mereka butuhkan, dan menunggu laporan mereka kembali. Itulah persisnya yang dilakukan Delegasi Subagen untuk Hermes Agent — ini memungkinkan agen utamamu untuk mempekerjakan “pekerja” sementara untuk menangani tugas-tugas di latar belakang.

Langkah 1: Pahami Konsep Dasarnya

Ketika kamu memanggil delegate_task, Hermes membuat satu atau lebih agen anak (subagen). Setiap agen anak:

Mendapatkan percakapan yang benar-benar baru — mereka tidak tahu apa-apa tentang riwayat obrolanmu.
Memiliki akses ke alat yang sama dengan agen induk.
Berjalan di sesi terminal terisolasi miliknya sendiri.
Hanya mengembalikan ringkasan akhir kepada agen induk.

Anggap saja seperti mengirim rekan kerja untuk meneliti suatu topik. Mereka tidak perlu duduk mengikuti seluruh rapatmu — kamu cukup memberikan catatan berisi tugas dan konteks, dan mereka kembali dengan laporan.

Langkah 2: Delegasikan Satu Tugas

Kasus penggunaan paling sederhana: satu tugas, satu subagen.

delegate_task(
    goal="Debug mengapa tes gagal",
    context="Error: assertion di test_foo.py baris 42"
)

goal memberi tahu subagen apa yang harus dilakukan. context memberikan semua yang dibutuhkan untuk melakukannya.

Langkah 3: Delegasikan Banyak Tugas Secara Paralel

Perlu menyelesaikan beberapa hal sekaligus? Berikan daftar tugas. Secara default, Hermes menjalankan hingga 3 subagen secara bersamaan (kamu bisa mengubahnya — tidak ada batasan keras).

delegate_task(tasks=[
    {"goal": "Riset topik A", "context": "Fokus pada sumber-sumber primer terbaru"},
    {"goal": "Riset topik B", "context": "Bandingkan penjelasan-penjelasan utama"},
    {"goal": "Perbaiki build", "context": "Root proyek: /home/user/project"}
])

Setiap subagen bekerja secara independen. Agen induk menunggu semuanya selesai, lalu menggabungkan hasilnya.

Langkah 4: Aturan Emas — Subagen Tidak Tahu Apa-Apa

Ini poin terpenting, jadi dengarkan baik-baik:

Subagen mulai dengan pengetahuan nol tentang percakapanmu.

Jika kamu berkata “Perbaiki errornya” tanpa menjelaskan apa itu “error”, subagen akan kebingungan. Kamu harus memberikan semua konteks yang diperlukan di kolom goal dan context.

Ini contoh yang buruk:

# BURUK - subagen tidak tahu apa itu "error"
delegate_task(goal="Perbaiki error")

Dan versi yang baik:

# BAIK - subagen memiliki semua konteks yang dibutuhkan
delegate_task(
    goal="Perbaiki TypeError di api/handlers.py",
    context="""File api/handlers.py memiliki TypeError di baris 47:
    'NoneType' object has no attribute 'get'.
    Fungsi process_request() menerima dict dari parse_body(),
    tetapi parse_body() mengembalikan None ketika Content-Type tidak ada.
    Proyek berada di /home/user/myproject dan menggunakan Python 3.11."""
)

Anggap context sebagai dokumen briefing. Semakin spesifik kamu, semakin baik hasil kerja subagen.

Langkah 5: Gunakan untuk Alur Kerja Dunia Nyata

Riset Paralel

Kumpulkan informasi tentang beberapa topik sekaligus:

delegate_task(tasks=[
    {
        "goal": "Riset status WebAssembly saat ini di 2025",
        "context": "Fokus pada: dukungan browser, runtime non-browser, dukungan bahasa"
    },
    {
        "goal": "Riset status adopsi RISC-V di 2025",
        "context": "Fokus pada: chip server, sistem tertanam, ekosistem perangkat lunak"
    },
    {
        "goal": "Riset perkembangan komputasi kuantum di 2025",
        "context": "Fokus pada: terobosan koreksi error, aplikasi praktis, pemain kunci"
    }
])

Review Kode + Perbaikan

Serahkan pekerjaan review-dan-perbaikan menyeluruh ke konteks baru:

delegate_task(
    goal="Review modul autentikasi untuk masalah keamanan dan perbaiki semua yang ditemukan",
    context="""Proyek di /home/user/webapp.
    File modul auth: src/auth/login.py, src/auth/jwt.py, src/auth/middleware.py.
    Proyek menggunakan Flask, PyJWT, dan bcrypt.
    Fokus pada: SQL injection, validasi JWT, penanganan password, manajemen sesi.
    Perbaiki semua masalah yang ditemukan dan jalankan test suite (pytest tests/auth/)."""
)

Ringkasan

Delegasi subagen adalah caramu untuk memparalelkan pekerjaan di Hermes Agent. Ingat poin-poin penting ini:

Gunakan delegate_task untuk satu tugas atau sekumpulan tugas.
Selalu berikan konteks lengkap — subagen mulai dari nol.
Hingga 3 subagen bersamaan secara default, bisa dikonfigurasi jika butuh lebih.
Setiap subagen mengembalikan ringkasan terstruktur — apa yang dilakukan, apa yang ditemukan, file yang diubah, masalah yang dihadapi.

Ini seperti memiliki tim asisten yang hanya tahu apa yang kamu beri tahu — jadi beri tahu mereka semua yang mereka butuhkan.

Selanjutnya: Tutorial 23 — Kanban: papan bersama yang persisten untuk kolaborasi multi-agen.