實戰：Teams 會議流水線 | Easy Understand Hermes Agent

這篇教學講的是：當你已經依照官方文件開啟 Teams 會議功能後，如何日常「維運」這條管線——就像你買回一台洗衣機，現在要學的是怎麼保養它、排除故障，以及確保它不會在半夜悄悄罷工。

第 1 步：先學會三個「體檢」指令

任何時候改過設定，先跑一遍體檢：

hermes teams-pipeline validate          # 檢查設定快照是否正常
hermes teams-pipeline token-health      # 檢查微軟登入權杖是否過期
hermes teams-pipeline subscriptions     # 查看目前訂閱了哪些會議通知

如果懷疑權杖狀態異常，加個 --force-refresh 強制重新整理。

第 2 步：解決最大的坑——訂閱 72 小時自動過期

這是整條管線最容易翻車的地方。 微軟的 Graph 訂閱最長只能活 72 小時，如果沒人續命，會議通知就會悄悄停止，表面上看一切正常，實際已經「腦死」。

解決辦法：必須定時執行 maintain-subscriptions 指令。官方提供了三種定時方案，推薦前兩種：

方案 A：用 Hermes 自帶的定時器（適合已經在跑 Hermes 閘道的使用者）

先建立一個指令稿檔案：

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

再註冊一個每 12 小時跑一次的定時任務（留足 6 倍餘量）：

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

方案 B：用 systemd 定時器（適合 Linux 正式環境）

建立 service 和 timer 兩個檔案（見官方文件），然後執行：

sudo systemctl daemon-reload
sudo systemctl enable --now hermes-teams-pipeline-maintain.timer

驗證續命是否生效：等第一次定時跑完後，執行 hermes teams-pipeline subscriptions，看 expirationDateTime 是不是往後推了。如果某個功能在「恰好 72 小時」後失靈，第一個要查的就是這個定時任務有沒有跑。

第 3 步：日常巡檢清單

每天或定期做三件事：

hermes teams-pipeline maintain-subscriptions --dry-run   # 應該顯示「0 expiring soon」
hermes teams-pipeline list --status failed                # 看有沒有失敗任務
hermes teams-pipeline list                                # 看最近處理了哪些會議

第 4 步：出故障了怎麼排除

沒有新任務產生 → 檢查 webhook 是否啟用、公網位址是否正確、訂閱是否已過期
任務卡在重試 → 檢查會議轉錄/錄製權限、ffmpeg 是否安裝、權杖是否健康
摘要產生了但沒發到 Teams → 檢查 platforms.teams.enabled、delivery_mode、incoming_webhook_url 或 chat_id 設定

第 5 步：上線前對照清單

最重要的一條：maintain-subscriptions 必須已定時執行。 沒有它，72 小時後一切靜默失效。其餘檢查項目包括：Graph 憑證正確、webhook 公網可達、轉錄訂閱已建立、Teams 投遞目標已驗證、真實會議事件已跑通全流程。

總結：這條管線本身不難，難在「別讓它悄悄死掉」。記住三件事：定時續訂閱、定期看失敗任務、改動後先 validate。

下篇預告：當會議管線跑通後，如何讓 Hermes 自動把會議紀錄整理成 Notion 頁面或 Linear 任務？我們下篇聊「會議產物的自動分發」。