Pipeline Rapat Teams

Menjaga agen AI Anda tetap terhubung dengan rapat Microsoft Teams itu seperti menyiram tanaman—jika Anda lupa beberapa hari saja, semuanya layu. Kabar baiknya? Hermes Agent memberi Anda seperangkat alat sederhana untuk menjaga pipeline itu tetap hidup dan sehat.

Apa Itu Pipeline Rapat Teams?

Saat Anda menghubungkan Hermes Agent ke Microsoft Teams, ia menggunakan sesuatu yang disebut subscriptions (langganan) untuk mendengarkan event rapat (seperti saat rapat dimulai atau berakhir). Anggap saja subscriptions ini seperti antena radio kecil. Mereka tidak bertahan selamanya—Microsoft memaksa mereka kedaluwarsa setiap 72 jam. Jika tidak ada yang memperbaruinya, agen Anda menjadi tuli terhadap rapat, dan Anda tidak akan tahu penyebabnya.

Itulah alasan #1 mengapa integrasi Teams gagal. Bukan karena bug kode, tapi karena tidak ada yang memperbarui subscriptions tepat waktu.

Langkah 1: Validasi Setup Anda (Selalu Lakukan Ini Pertama)

Setelah perubahan konfigurasi apa pun, jalankan perintah ini untuk memastikan semuanya terhubung dengan benar:

hermes teams-pipeline validate

Perintah ini memeriksa snapshot konfigurasi Anda dan memberi tahu jika ada yang rusak. Anggap saja ini sebagai pemeriksaan kesehatan cepat sebelum Anda mempercayai sistem.

Langkah 2: Periksa Kesehatan Token

Agen Anda menggunakan token autentikasi untuk berbicara dengan Microsoft. Token ini bisa basi. Untuk memeriksanya:

hermes teams-pipeline token-health

Jika Anda curiga status autentikasi lama menyebabkan masalah, paksa penyegaran:

hermes teams-pipeline token-health --force-refresh

Langkah 3: Lihat Subscriptions Anda

Untuk melihat apa yang sedang aktif saat ini:

hermes teams-pipeline subscriptions

Ini menunjukkan subscription rapat apa saja yang ada dan kapan kedaluwarsanya. Ini seperti memeriksa kalender Anda—Anda ingin tahu apa yang akan datang sebelum terlambat.

Langkah 4: Perbarui Subscriptions (Bagian Kritis)

Anda bisa memperbaruinya secara manual:

hermes teams-pipeline maintain-subscriptions

Atau lakukan dry run terlebih dahulu untuk melihat apa yang akan terjadi tanpa benar-benar mengubah apa pun:

hermes teams-pipeline maintain-subscriptions --dry-run

Tapi ini rahasianya: Anda harus mengotomatiskan ini. Jika tidak, Anda akan lupa, dan setelah 3 hari, semuanya berhenti.

Mengotomatiskan Perpanjangan Subscription (Tidak Bisa Ditawar)

Anda punya dua opsi yang solid. Pilih salah satu.

Opsi A: Hermes Cron (Paling Mudah Jika Anda Sudah Menggunakan Hermes)

Buat file skrip:

mkdir -p ~/.hermes/scripts
cat > ~/.hermes/scripts/maintain-teams-subscriptions.sh << 'EOF'
#!/usr/bin/env bash
exec hermes teams-pipeline maintain-subscriptions
EOF
chmod +x ~/.hermes/scripts/maintain-teams-subscriptions.sh

Lalu daftarkan cron job yang berjalan setiap 12 jam (6x ruang aman terhadap kedaluwarsa 72 jam):

hermes cron create "0 */12 * * *" \
  --name "teams-pipeline-maintain-subscriptions" \
  --no-agent \
  --script maintain-teams-subscriptions.sh \
  --deliver local

Verifikasi bahwa itu sudah terdaftar:

hermes cron list
hermes cron status

Opsi B: Systemd Timer (Untuk Produksi Linux)

Buat file service di /etc/systemd/system/hermes-teams-pipeline-maintain.service:

[Unit]
Description=Hermes Teams pipeline subscription maintenance
After=network-online.target

[Service]
Type=oneshot
User=hermes
EnvironmentFile=/etc/hermes/env
ExecStart=/usr/local/bin/hermes teams-pipeline maintain-subscriptions

Lalu aktifkan timer untuk menjalankannya setiap 12 jam. Ini sangat kokoh untuk server produksi.

Ringkasan & Tips Praktis

Pipeline Rapat Teams itu sederhana: validasi → periksa token → tinjau subscriptions → perbarui secara otomatis. Satu-satunya hal yang membunuhnya adalah lupa memperbarui.

Tips praktis: Siapkan otomatisasi sebelum Anda membutuhkannya. Jangan tunggu sampai hari ketiga. Gunakan pendekatan cron jika Anda di mesin apa pun, atau systemd jika Anda di Linux. Lalu atur pengingat kalender satu bulan dari sekarang untuk memverifikasi otomatisasi masih berjalan. Itu saja—Anda selesai.

Agen Anda akan terus mendengarkan rapat, dan Anda tidak akan pernah bertanya-tanya mengapa ia tiba-tiba diam.