Cuộc họp nhóm Microsoft

Sử dụng quy trình cuộc họp Teams khi bạn muốn Hermes tiếp thu các sự kiện cuộc họp Microsoft Graph, tìm nạp bản ghi trước, quay lại bản ghi cộng với STT khi cần và cung cấp bản tóm tắt có cấu trúc cho các bộ phận tiếp theo.

Trang này tập trung vào thiết lập và kích hoạt:

Thông tin đồ thị
cấu hình trình nghe webhook
Chế độ giao hàng theo nhóm
hình dạng cấu hình đường ống

Đối với các hoạt động ngày thứ 2, kiểm tra đưa vào hoạt động và bảng tính dành cho người vận hành, hãy sử dụng hướng dẫn riêng: Vận hành quy trình họp nhóm.

Tính năng này làm gì

Đường ống:

nhận các sự kiện webhook của Microsoft Graph
giải quyết cuộc họp và ưu tiên các tạo phẩm trong bảng điểm trước
quay lại chế độ ghi tải xuống cộng với STT khi không có sẵn bản ghi có thể sử dụng được
lưu trữ trạng thái công việc lâu dài và bản ghi chìm cục bộ
có thể viết tóm tắt cho Notion, Linear và Microsoft Teams

Các hành động của người vận hành vẫn nằm trong CLI (lệnh phụ teams-pipeline được đăng ký bởi plugin teams_pipeline — kích hoạt nó thông qua hermes plugin kích hoạt Teams_pipeline hoặc đặt plugins.enabled: [teams_pipeline] trong config.yaml):

hermes teams-pipeline validate
hermes teams-pipeline list
hermes teams-pipeline maintain-subscriptions

Điều kiện tiên quyết

Trước khi kích hoạt quy trình cuộc họp, hãy đảm bảo bạn có:

bản cài đặt Hermes đang hoạt động
thiết lập bot Microsoft Teams hiện có nếu bạn muốn gửi đi Teams
Thông tin xác thực ứng dụng Microsoft Graph với các quyền cần thiết cho tài nguyên cuộc họp mà bạn định đăng ký
URL HTTPS công khai mà Microsoft Graph có thể gọi để phân phối webhook
Đã cài đặt ffmpeg nếu bạn muốn dự phòng ghi-plus-STT

Bước 1: Thêm thông tin xác thực Microsoft Graph

Thêm thông tin xác thực chỉ dành cho ứng dụng Graph vào ~/.hermes/.env:

MSGRAPH_TENANT_ID=<tenant-id>
MSGRAPH_CLIENT_ID=<client-id>
MSGRAPH_CLIENT_SECRET=<client-secret>

Những thông tin xác thực này được sử dụng bởi:

nền tảng máy khách Graph
lệnh bảo trì đăng ký
độ phân giải cuộc họp và tìm nạp hiện vật
Gửi đi Teams dựa trên biểu đồ khi bạn không cung cấp mã thông báo truy cập Teams chuyên dụng

Bước 2: Kích hoạt Trình nghe đồ thị Webhook

Trình nghe webhook là một nền tảng cổng có tên msgraph_webhook. Tối thiểu, hãy kích hoạt nó và đặt giá trị trạng thái máy khách:

MSGRAPH_WEBHOOK_ENABLED=true
MSGRAPH_WEBHOOK_PORT=8646
MSGRAPH_WEBHOOK_CLIENT_STATE=<random-shared-secret>
MSGRAPH_WEBHOOK_ACCEPTED_RESOURCES=communications/onlineMeetings

Người nghe bộc bạch:

/msgraph/webhook dành cho thông báo Đồ thị
/health để kiểm tra sức khỏe đơn giản

Bạn cần định tuyến điểm cuối HTTPS công khai của mình tới người nghe đó. Ví dụ: nếu miền công cộng của bạn là https://ops.example.com thì URL thông báo Biểu đồ của bạn thường sẽ là:

https://ops.example.com/msgraph/webhook

Bước 3: Định cấu hình hoạt động phân phối và quy trình của nhóm

Quy trình cuộc họp đọc cấu hình thời gian chạy của nó từ mục nhập nền tảng teams hiện có. Các nút bấm dành riêng cho quy trình nằm trong teams.extra.meeting_pipeline. Quá trình gửi đi của Nhóm vẫn nằm trên bề mặt cấu hình nền tảng Nhóm thông thường.

Ví dụ ~/.hermes/config.yaml:

platforms:
  msgraph_webhook:
    enabled: true
    extra:
      port: 8646
      client_state: "replace-me"
      accepted_resources:
        - "communications/onlineMeetings"

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

      # outbound summary delivery
      delivery_mode: "graph" # or incoming_webhook
      team_id: "team-id"
      channel_id: "channel-id"
      # incoming_webhook_url: "https://..."

cuộc họp_pipeline:
        bảng điểm_min_chars: 80
        bảng điểm_required: sai
        phiên âm_fallback: đúng
        ffmpeg_extract_audio: đúng
        khái niệm:
          đã bật: sai
        tuyến tính:
          đã bật: sai

Chế độ phân phối theo nhóm

Quy trình hỗ trợ hai chế độ phân phối tóm tắt của Teams bên trong plugin Teams hiện có.

`incoming_webhook`

Hãy sử dụng tính năng này khi bạn muốn đăng một webhook đơn giản vào Teams mà không cần tạo thông báo kênh thông qua Graph.

Cấu hình bắt buộc:

platforms:
  teams:
    enabled: true
    extra:
      delivery_mode: "incoming_webhook"
      incoming_webhook_url: "https://..."

`biểu đồ`

Sử dụng tùy chọn này khi bạn muốn Hermes đăng bản tóm tắt thông qua Microsoft Graph vào kênh hoặc cuộc trò chuyện trong Teams.

Các mục tiêu được hỗ trợ:

chat_id
team_id + channel_id
Dự phòng team_id + home_channel cho nền tảng Teams hiện có

Ví dụ:

platforms:
  teams:
    enabled: true
    extra:
      delivery_mode: "graph"
      team_id: "team-id"
      channel_id: "channel-id"

Bước 4: Khởi động Gateway

Khởi động Hermes bình thường sau khi cập nhật cấu hình:

hermes gateway run

Hoặc, nếu bạn chạy Hermes trong Docker, hãy khởi động cổng giống như cách bạn đã làm khi triển khai.

Kiểm tra người nghe:

curl http://localhost:8646/health

Bước 5: Tạo đăng ký Graph

Sử dụng plugin CLI để tạo và kiểm tra đăng ký.

Ví dụ:

hermes teams-pipeline subscribe \
  --resource communications/onlineMeetings/getAllTranscripts \
  --notification-url https://ops.example.com/msgraph/webhook \
  --client-state "$MSGRAPH_WEBHOOK_CLIENT_STATE"

đăng ký đội Hermes-pipeline \
  --resource Communications/onlineMeetings/getAllRecordings \
  --notification-url https://ops.example.com/msgraph/webhook \
  --trạng thái khách hàng "$MSGRAPH_WEBHOOK_CLIENT_STATE"

:::cảnh báo Đăng ký đồ thị sẽ hết hạn sau 72 giờ

Microsoft Graph giới hạn đăng ký webhook sau 72 giờ và sẽ không tự động gia hạn chúng. Bạn PHẢI lên lịch cho đăng ký duy trì đường dẫn của nhóm hermes trước khi đi vào hoạt động, nếu không thông báo sẽ âm thầm dừng ba ngày sau bất kỳ quá trình tạo đăng ký thủ công nào. Xem Tự động gia hạn đăng ký trong sổ tay vận hành — ba tùy chọn (Hermes cron, bộ đếm thời gian hệ thống, crontab đơn giản).

:::

Để bảo trì đăng ký và quy trình của nhà điều hành ngày thứ 2, hãy tiếp tục với hướng dẫn: Vận hành quy trình họp nhóm.

Xác thực

Chạy ảnh chụp nhanh xác thực tích hợp:

hermes teams-pipeline validate

Kiểm tra đồng hành hữu ích:

hermes teams-pipeline token-health
hermes teams-pipeline subscriptions

Khắc phục sự cố

Problem	What to check
Graph webhook validation fails	Confirm the public URL is correct and reachable, and that Graph is calling the exact `/msgraph/webhook` path
Jobs do not appear in `hermes teams-pipeline list`	Confirm `msgraph_webhook` is enabled and that subscriptions point at the right notification URL
Transcript-first never succeeds	Check Graph permissions for transcript resources and whether the transcript artifact exists for that meeting
Recording fallback fails	Confirm `ffmpeg` is installed and the Graph app can access recording artifacts
Teams summary delivery fails	Re-check `delivery_mode`, target IDs, and Teams auth config

Tính năng này làm gì​

Điều kiện tiên quyết​

Bước 1: Thêm thông tin xác thực Microsoft Graph​

Bước 2: Kích hoạt Trình nghe đồ thị Webhook​

Bước 3: Định cấu hình hoạt động phân phối và quy trình của nhóm​

Chế độ phân phối theo nhóm​

incoming_webhook​

biểu đồ​

Bước 4: Khởi động Gateway​

Bước 5: Tạo đăng ký Graph​

Xác thực​

Khắc phục sự cố​

Tài liệu liên quan​