{/* Trang này được tạo tự động từ SKILL.md của kỹ năng bởi website/scripts/generate-skill-docs.py. Chỉnh sửa nguồn SKILL.md, không phải trang này. */}

Quy trình họp nhóm

Vận hành quy trình tóm tắt cuộc họp Teams thông qua Hermes CLI — tóm tắt các cuộc họp, kiểm tra trạng thái quy trình, phát lại công việc, quản lý đăng ký Microsoft Graph.

Siêu dữ liệu kỹ năng

Nguồn	Đi kèm (được cài đặt theo mặc định)
Đường dẫn

skills/productivity/teams-meeting-pipeline ` | | Phiên bản |

1.1.0 ` | | Tác giả | Đại lý Hermes + Teknium | | Giấy phép | MIT | | Thẻ |

Teams

, `Microsoft Graph

, `Meetings

, `Productivity

, Operations |

Tham khảo: đầy đủ SKILL.md

thông tin

Sau đây là định nghĩa kỹ năng đầy đủ mà Hermes tải khi kỹ năng này được kích hoạt. Đây là những gì tác nhân coi là hướng dẫn khi kỹ năng được kích hoạt.

Quy trình họp nhóm

Sử dụng kỹ năng này bất cứ khi nào người dùng hỏi về tóm tắt cuộc họp, bản ghi, bản ghi, mục hành động, đăng ký Graph hoặc bất kỳ câu hỏi vận hành nào về quy trình cuộc họp của Teams. Hoạt động ở mọi ngôn ngữ — trình kích hoạt bên dưới là ví dụ, không phải danh sách đầy đủ.

Mọi thứ mà người vận hành phải đối mặt là lệnh phụ Hermes teams-pipeline chạy thông qua công cụ đầu cuối. Không có công cụ mô hình mới nào cho quy trình này - CLI là bề mặt.

Khi nào nên sử dụng kỹ năng này

Người dùng đang yêu cầu:

• tóm tắt cuộc họp Nhóm / trích xuất các mục hành động / lấy ghi chú cuộc họp
• kiểm tra trạng thái quy trình, kiểm tra công việc cuộc họp được lưu trữ hoặc xem các cuộc họp gần đây
• phát lại / chạy lại công việc đã lưu bị lỗi hoặc cần một bản tóm tắt mới
• xác thực thiết lập Microsoft Graph sau khi thay đổi env hoặc config
• khắc phục sự cố "không bao giờ đến bản tóm tắt cuộc họp" hoặc "không có cuộc họp mới nào được nhập"
• quản lý đăng ký webhook Graph (tạo, gia hạn, xóa, kiểm tra)
• thiết lập gia hạn đăng ký tự động (xem cạm bẫy bên dưới)

Ví dụ về trình kích hoạt đa ngôn ngữ (không đầy đủ):

• Tiếng Anh: “tóm tắt cuộc họp Team”, “trạng thái đường ống”, “phát lại công việc X”
• Tiếng Thổ Nhĩ Kỳ: "Cuộc họp nhóm özetle", "mục hành động çıkar", "toplantı notu", "pipeline durumu", "công việc phát lại"

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

Trước khi sử dụng đường dẫn, hãy xác minh những điều này được đặt trong

~/.Hermes/.env

:

MSGRAPH_TENANT_ID=...
MSGRAPH_CLIENT_ID=...
MSGRAPH_CLIENT_SECRET=...

`
``Nếu thiếu bất kỳ điều gì, hãy hướng người dùng đến hướng dẫn đăng ký ứng dụng Azure tại 

/docs/guides/Microsoft-graph-app-registration
` — họ cần đăng ký ứng dụng Azure AD với các quyền ứng dụng Graph được quản trị viên đồng ý trước khi quy trình hoạt động.

## Tham chiếu lệnh

### Tình trạng và kiểm tra (bắt đầu tại đây)

`bash
Hermes teams-pipeline validate              # config snapshot — run first after any change
Hermes teams-pipeline token-health          # Graph token status
Hermes teams-pipeline token-health --force-refresh   # force a fresh token acquisition
Hermes teams-pipeline list                  # recent meeting jobs
Hermes teams-pipeline list --status failed  # only failed jobs
Hermes teams-pipeline show <job-id         # full detail of one job
Hermes teams-pipeline subscriptions         # current Graph webhook subscriptions

`

### Chạy lại/gỡ lỗi

`bash
Hermes teams-pipeline run <job-id          # replay a stored job (re-summarize, re-deliver)
Hermes teams-pipeline fetch --meeting-id <id   # dry-run: resolve meeting + transcript without persisting
Hermes teams-pipeline fetch --join-web-url "<url"   # dry-run by join URL

`

### Quản lý đăng ký

`bash
Hermes teams-pipeline subscribe \

  --resource communications/onlineMeetings/getAllTranscripts \
  --notification-url https://<your-public-host/msgraph/webhook \
  --CLIent-state "$MSGRAPH_WEBHOOK_CLIENT_STATE"

Hermes teams-pipeline renew-subscription <sub-id --expiration <iso-8601
Hermes teams-pipeline delete-subscription <sub-id
Hermes teams-pipeline maintain-subscriptions            # renew near-expiry ones
Hermes teams-pipeline maintain-subscriptions --dry-run  # show what would be renewed

`

## Cây quyết định cho các câu hỏi thông thường
- Người dùng hỏi "tại sao tôi không nhận được bản tóm tắt cho cuộc họp hôm nay?" → bắt đầu bằng 
`list --status failed

, sau đó là 
`show <job-id>
` trên hàng liên quan. Nếu công việc hoàn toàn không tồn tại, hãy kiểm tra 
`subscriptions
` — webhook có thể đã hết hạn (xem cạm bẫy bên dưới).
- Người dùng hỏi "thiết lập có hoạt động không?" → 
`validate

, rồi 
`token-health

, rồi 
`subscriptions

. Nếu cả ba đều đạt, hãy yêu cầu một cuộc họp kiểm tra và kiểm tra 
`list
` để có hàng mới.
- User yêu cầu “chạy lại tóm tắt cuộc họp X” → 
`list
` tìm ID công việc, 
`run <job-id
` để phát lại. Nếu thất bại lần nữa, 
`show <job-id
` sẽ kiểm tra lỗi và 
`fetch --meeting-id
` để chạy thử độ phân giải giả.
- Người dùng yêu cầu "thêm cuộc họp X vào quy trình" → thường thì bạn không hỏi — quy trình được điều khiển theo đăng ký chứ không phải mỗi cuộc họp. Nếu họ muốn tóm tắt một cuộc họp cụ thể trước đây, hãy sử dụng 
`fetch
` để lấy bản ghi + 
`run
` sau khi công việc được tạo.

## Cạm bẫy nghiêm trọng: Đă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**. Nếu 
`maintain-subscriptions
` không được lên lịch, thông báo cuộc họp sẽ âm thầm ngừng đến sau 3 ngày kể từ khi tạo bất kỳ đăng ký thủ công nào.

Khi người dùng báo cáo "đường ống đã hoạt động ngày hôm qua nhưng hôm nay không có gì đến":
1. Chạy 
`Hermes teams-pipeline subscriptions

 - nếu nó trống hoặc tất cả các mục hiển thị 
`expirationDateTime
` trong quá khứ thì đó là nguyên nhân.
2. Tạo lại bằng 
`subscribe
` như hình trên.
3. **Thiết lập gia hạn tự động ngay lập tức** thông qua 
`Hermes cron add

, bộ hẹn giờ systemd hoặc crontab đơn giản. Sổ tay vận hành tại 

/docs/guides/operate-teams-meeting-pipeline#automating-subscription-renewal-required-for-production
` có tất cả ba tùy chọn. Khoảng thời gian 12 giờ là an toàn (khoảng không gấp 6 lần so với giới hạn 72 giờ).

## Những cạm bẫy khác- **Chưa có bản ghi.** Các nhóm sẽ mất một khoảng thời gian sau khi cuộc họp kết thúc để tạo thành phần bản ghi. 
`fetch --meeting-id
` trong cuộc họp vừa kết thúc có thể trả về kết quả trống. Đợi 2-5 phút rồi thử lại hoặc để webhook Graph điều khiển quá trình nhập một cách tự nhiên.
- **Chế độ phân phối không khớp.** Nếu các bản tóm tắt được tạo ra (
`list
` hiển thị thành công) nhưng không có nội dung nào lọt vào Nhóm, hãy kiểm tra 
`platforms.teams.extra.delivery_mode
` và cấu hình mục tiêu phù hợp (
`incoming_webhook_url
` HOẶC 
`chat_id
` HOẶC 
`team_id

+
`channel_id

). Người viết đọc chúng từ config.yaml hoặc 
`TEAMS_*
` env vars.
- **Quyền ứng dụng đồ thị.** Mã thông báo nhận được một cách rõ ràng (
`token-health
` vượt qua) nhưng lệnh gọi API đồ thị trả về 401/403 khi quyền được thêm nhưng sự đồng ý của quản trị viên không được cấp lại. Yêu cầu người dùng xem lại đăng ký ứng dụng trong cổng Azure và nhấp lại vào "Cấp sự đồng ý của quản trị viên".

## Tài liệu liên quan

Hướng người dùng đến những điều này khi họ cần sâu hơn kỹ năng này:
- Hướng dẫn đăng ký ứng dụng Azure: 

/docs/guides/Microsoft-graph-app-registration

- Thiết lập đường ống đầy đủ: 

/docs/user-guide/messaging/teams-meetings

- Sổ tay vận hành (tự động gia hạn, khắc phục sự cố, danh sách kiểm tra đi vào hoạt động): 

/docs/guides/operate-teams-meeting-pipeline

- Thiết lập trình nghe Webhook: 

/docs/user-guide/messaging/msgraph-webhook
`