赫耳墨斯代理（GitHub 164k star）非仅终端编码之助。通其消息之门，代理可接二十四平台——Telegram、Discord、Slack、微信、飞书、钉钉、Microsoft Teams 等。于一平台所设代理之能（Skills、工具调用、审批之序），诸平台皆通。

此篇专论Microsoft Teams之接入法：六步使AI代理机器人现于Teams群聊。

此文涵何

• 赫耳墨斯代理+Teams之架构
• 六步接入之序
• 交互式审批之卡
• 会议纪要自动推送
• 生产环境部署
• 安全配置

架构

Teams 群聊 ←── HTTPS Webhook ──→ Hermes Gateway (端口 3978) ←──→ Agent + LLM

与 Slack 之 Socket Mode 异，Teams 乃以公共 HTTPS Webhook 推送讯息。汝之 Hermes 实例，需一可由公网达之端点——本地开发则用隧道工具，生产环境则用真实名域。

消息触发规则

隊伍以 @提及為 <at>BotName</at> 标記傳遞，Hermes 自動剝離後處理。

6 步接入

第 1 步：安裝隊伍 CLI

微軟的 @microsoft/teams.cli 自動化 Bot 註冊，無需 Azure Portal：

npm install -g @microsoft/teams.cli@preview
teams login

驗證登錄並獲取你的 AAD Object ID（後續配置白名單要用）：

teams status --verbose

第 2 步：暴露 Webhook 端口

隊伍不能向 localhost 推送消息。本地開發需要隧道工具：

# Microsoft devtunnel（推荐，URL 持久）
devtunnel create hermes-bot --allow-anonymous
devtunnel port create hermes-bot -p 3978 --protocol https
devtunnel host hermes-bot

# 或 ngrok
ngrok http 3978

# 或 cloudflared
cloudflared tunnel --url http://localhost:3978

記下輸出https://之URL，次当用之。开发生计时，恒使隧道行。

第三步：造Bot

teams app create \
  --name "Hermes" \
  --endpoint "https://<your-tunnel-url>/api/messages"

CLI出CLIENT_ID、CLIENT_SECRET及TENANT_ID。亟存Client Secret——不复再显。

第四步：设环境变量

加于~/.hermes/.env：

# 必填
TEAMS_CLIENT_ID=<your-client-id>
TEAMS_CLIENT_SECRET=<your-client-secret>
TEAMS_TENANT_ID=<your-tenant-id>

# 限制访问用户（强烈建议）
# 用 teams status --verbose 获取 AAD Object ID
TEAMS_ALLOWED_USERS=<your-aad-object-id>

亦可用config.yaml设之：

platforms:
  teams:
    enabled: true
    extra:
      client_id: "your-client-id"
      client_secret: "your-secret"
      tenant_id: "your-tenant-id"
      port: 3978

第五步：启网关

HERMES_UID=$(id -u) HERMES_GID=$(id -g) docker compose up -d gateway

验其行否：

curl http://localhost:3978/health
# 应返回: ok

docker logs -f hermes
# 看到: [teams] Webhook server listening on 0.0.0.0:3978/api/messages

第六步：于Teams中植应用

teams app get <teamsAppId> --install-link

启输出之链，于Teams客户端中植之。植毕，致机器人一讯——彼已备矣。

交互式审批卡

此乃Teams集成至要之能。当Agent欲行危令（删文件、施shell命等），彼不令汝手输/approve，乃发一张Adaptive Card，具四钮：

按此钮，卡即新为决，Agent 继行或止

会纪自推

赫尔墨斯 Agent 之 Teams 集非惟聊，亦自推会纪。启 Teams Meeting Pipeline 插件，会终自生纪并推至指 Teams 频或聊

二推模

graph式之设：

platforms:
  teams:
    enabled: true
    extra:
      client_id: "..."
      client_secret: "..."
      tenant_id: "..."
      delivery_mode: "graph"
      chat_id: "19:meeting_..."    # 推送到聊天
      # 或
      # team_id: "..."
      # channel_id: "..."          # 推送到频道

产境布署

本境开用隧道，产境用真域：

# 创建 Bot 时直接用生产域名
teams app create \
  --name "Hermes" \
  --endpoint "https://your-domain.com/api/messages"

# 已有 Bot 更新端点
teams app update --id <teamsAppId> --endpoint "https://your-domain.com/api/messages"

求：
- 端口 3978（或 TEAMS_PORT 所定之口）可自外得之
- TLS 之证有效（Teams 拒自签之证）

安之设

⚠️ 必须设置TEAMS_ALLOWED_USERS不然，凡能得汝 Bot 者皆可与之交。

安危之至要也：

• TEAMS_ALLOWED_USERS填入授权者之AAD Object ID，未授权之讯，默然弃之。
• TEAMS_CLIENT_SECRET视若密钥，时更其用
• ~/.hermes/.env文件權限設為600：chmod 600 ~/.hermes/.env
• 公开展示之端点/api/messages由 Teams Bot Framework 认可——无有效 JWT 之请，必拒之

配置之参考也

常遇之问

赫尔墨斯代理所载之二十四讯息平台

Teams亦其一耳。Hermes Agent复支持：

Telegram、Discord、Slack、WhatsApp、Signal、Email、SMS（Twilio）、Home Assistant、Mattermost、Matrix、钉钉、飞书/Lark、企业微信、企业微信回调、微信、iMessage（BlueBubbles）、QQ Bot、元宝、Microsoft Teams、Teams Meetings、LINE、SimpleX Chat、ntfy、Open WebUI、Webhooks。

同一 Agent，一套 Skills 与工具配置，悉平台通用。

作者ITech001
来处公众号：AI人工智能时代
之网：https://www.theaiera.cn/
日日分亨最前沿之AI新闻资讯与技术研究所。

本文首发于AI人工智能时代，转载须注明出处。