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 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 chuyên dụng: Operate the Teams Meeting pipeline.

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ó qua Hermes plugins enable 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

- [Microsoft Teams bot setup](/docs/user-guide/messaging/teams) hiện có nếu bạn muốn gửi đi Nhóm
- 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 Đồ thị vào 

~/.Hermes/.env

:

``` bash
MSGRAPH_TENANT_ID=&lt;tenant-id
MSGRAPH_CLIENT_ID=&lt;CLIent-id
MSGRAPH_CLIENT_SECRET=&lt;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:

``` bash
MSGRAPH_WEBHOOK_ENABLED=true
MSGRAPH_WEBHOOK_PORT=8646
MSGRAPH_WEBHOOK_CLIENT_STATE=&lt;random-shared-secret
MSGRAPH_WEBHOOK_ACCEPTED_RESOURCES=communications/onlineMeetings

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

- 

/msgraph/webhook
` 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à:

``` text
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 đường ống 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

:

`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://..."`meeting_pipeline:
        transcript_min_chars: 80
        transcript_required: false
        transcription_fallback: true
        ffmpeg_extract_audio: true
        notion:
          enabled: false
        linear:
          enabled: false

`

## 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:

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

`

###
`graph
``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 Team hiện có

Ví dụ:

``` yaml
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:

`bash
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:

`bash
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ụ:

`bash
Hermes teams-pipeline subscribe \

  --resource communications/onlineMeetings/getAllTranscripts \
  --notification-url https://ops.example.com/msgraph/webhook \
  --CLIent-state "$MSGRAPH_WEBHOOK_CLIENT_STATE"

Hermes teams-pipeline subscribe \
  --resource communications/onlineMeetings/getAllRecordings \
  --notification-url https://ops.example.com/msgraph/webhook \
  --CLIent-state "$MSGRAPH_WEBHOOK_CLIENT_STATE"

`

:::warning[Graph subscriptions expire in 72 hours]

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 
`Hermes teams-pipeline maintain-subscriptions
` trước khi phát hành trực tuyến, nếu không thông báo sẽ âm thầm dừng ba ngày sau khi tạo bất kỳ đăng ký thủ công nào. Xem [Automating subscription renewal](/docs/guides/operate-teams-meeting-pipeline#automating-subscription-renewal-required-for-production) trong sổ tay vận hành - ba tùy chọn (Hermes cron, bộ đếm thời gian systemd, crontab đơn giản).

:::

Để biết về bảo trì đăng ký và luồng nhà điều hành ngày thứ 2, hãy tiếp tục với hướng dẫn: [Operate the Teams Meeting pipeline](/docs/guides/operate-teams-meeting-pipeline).

## Xác thực

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

``` bash
Hermes teams-pipeline validate

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

`bash
Hermes teams-pipeline token-health
Hermes teams-pipeline subscriptions

`

## Khắc phục sự cố| Vấn đề | Kiểm tra những gì |
|----------|---------------|
| Xác thực webhook đồ thị không thành công | Xác nhận URL công khai là chính xác và có thể truy cập được, đồng thời Đồ thị đó đang gọi đường dẫn 

/msgraph/webhook
` chính xác |
| Việc làm không xuất hiện trong 
`Hermes teams-pipeline list
` | Xác nhận 
`msgraph_webhook
` đã được bật và đăng ký trỏ đến đúng URL thông báo |
| Bản ghi đầu tiên không bao giờ thành công | Kiểm tra các quyền của Biểu đồ đối với tài nguyên bản ghi và liệu cấu phần bản ghi có tồn tại cho cuộc họp đó hay không |
| Ghi dự phòng không thành công | Xác nhận 
`ffmpeg
` đã được cài đặt và ứng dụng Đồ thị có thể truy cập các tạo phẩm ghi âm |
| Việc gửi bản tóm tắt của nhóm không thành công | Kiểm tra lại 
`delivery_mode

, ID mục tiêu và cấu hình xác thực Nhóm |

## Tài liệu liên quan
- [Microsoft Teams bot setup](/docs/user-guide/messaging/teams)

- [Operate the Teams Meeting pipeline](/docs/guides/operate-teams-meeting-pipeline)

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

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