DingTalk — AI untuk Tempat Kerja Tiongkok

Bayangkan berjalan ke sebuah kantor di Shanghai di mana obrolan ringan di sekitar pendingin air terjadi di dalam ikon aplikasi biru cerah—DingTalk. Ini sebagian Slack, sebagian Trello, sebagian portal HR, dan bagi ratusan juta pengguna, aplikasi ini adalah tempat kerja. Sekarang bayangkan agen AI Anda, Hermes, hidup dengan tenang di dalam aplikasi itu—menjawab pertanyaan, memilah tugas, dan mengirimkan tindak lanjut tanpa harus meninggalkan utas obrolan. Itulah janji integrasi DingTalk di Hermes Agent.

Mengapa DingTalk Penting untuk Agen AI

Kebanyakan tutorial agen AI mengasumsikan perangkat dan budaya kerja berbahasa Inggris ala Barat. Namun di China, DingTalk adalah sistem operasi default untuk komunikasi bisnis. Jika Anda membangun agen sumber terbuka untuk tim di Shenzhen atau pabrik di Chengdu, Anda memerlukan jembatan yang alami. Hermes Agent kini menyediakan hal itu—integrasi berbasis konfigurasi yang bersih dan rapi yang mengubah grup DingTalk mana pun menjadi pusat komando untuk agen Anda.

Menyiapkan Bot DingTalk

Anda punya dua pilihan: webhook (paling sederhana, satu arah) atau callback (dua arah penuh, menerima pesan). Untuk asisten yang sesungguhnya, Anda pasti ingin menggunakan callback. Berikut alurnya:

1. Buat bot di Konsol Pengembang DingTalk.
2. Dapatkan AppKey dan AppSecret Anda.
3. Siapkan URL callback publik (wajib HTTPS) untuk menerima pesan masuk.
4. Konfigurasikan webhook keluar bot untuk membalas pesan.

Di Hermes, Anda mendefinisikan ini di config.yaml:

channels:
  dingtalk:
    enabled: true
    mode: callback          # atau "webhook" untuk notifikasi satu arah
    app_key: "your_app_key"
    app_secret: "your_app_secret"
    callback_url: "https://your-server.com/dingtalk/callback"
    webhook_url: "https://oapi.dingtalk.com/robot/send?access_token=xxx"  # untuk balasan
    agent_id: "your_agent_id"
    verify_token: "random_string_for_signature"

Menerima Pesan

Setelah URL callback aktif, DingTalk akan mengirimkan setiap pesan grup ke Hermes. Agen akan mengurai payload JSON, mengekstrak pengirim, ID obrolan, dan teks, lalu meneruskannya ke alur skill Anda. Anda bisa menyaring berdasarkan kata kunci, mention, atau bahkan grup tertentu. Misalnya, hanya merespons saat bot di-@mention:

channels:
  dingtalk:
    filters:
      require_mention: true
      allow_groups:
        - "ops-alerts"
        - "ai-assistant"

Mengirim Balasan

Balasan dikirim kembali melalui URL webhook. Hermes secara otomatis membungkus respons dalam format pesan DingTalk yang benar—teks biasa, markdown, atau kartu interaktif. Berikut contoh skill sederhana yang membalas sapaan:

@agent.skill
async def greet(ctx, text):
    return f"Hello from Hermes! You said: {text}"

Tanpa panggilan HTTP manual. Hermes menangani tanda tangan, stempel waktu, dan amplop JSON untuk Anda.

Ringkasan

Integrasi DingTalk mengubah Hermes dari sekadar mainan berbasis terminal menjadi warga kantor digital bagi tim-tim di China. Hanya dengan beberapa baris di config.yaml, Anda mendapatkan pesan dua arah, penyaringan mention, dan format balasan otomatis. Baik Anda membangun bot QA untuk lantai pabrik atau asisten pribadi untuk manajer yang sibuk, Hermes + DingTalk berarti AI Anda berbicara dalam bahasa kantor modern China—lancar, andal, dan tanpa satu pun karakter China di basis kode Anda.

---