Điều kiện tiên quyết
Quyền Azure AD cần thiết
Trong luồng OAuth, CloudThinker yêu cầu các quyền Microsoft Graph API sau:| Quyền | Loại | Mục đích |
|---|---|---|
User.Read | Đồng ý người dùng | Đọc hồ sơ của người dùng đã đăng nhập |
Channel.ReadBasic.All | Đồng ý người dùng | Liệt kê các kênh trong nhóm |
Team.ReadBasic.All | Đồng ý người dùng | Liệt kê các nhóm mà người dùng thuộc về |
TeamsAppInstallation.ReadWriteForTeam | Đồng ý quản trị | Cài đặt bot vào nhóm |
TeamsAppInstallation.ReadWriteAndConsentForTeam | Đồng ý quản trị | Cài đặt bot và cấp đồng ý tài nguyên cụ thể |
TeamsAppInstallation.ReadWriteSelfForTeam | Đồng ý quản trị | Quản lý cài đặt của chính bot |
AppCatalog.ReadWrite.All | Đồng ý quản trị | Xuất bản bot lên danh mục ứng dụng của tổ chức |
Organization.Read.All | Đồng ý quản trị | Đọc thông tin tổ chức |
- Đã chọn — quyền được cấp trên toàn tenant cho tất cả người dùng trong Azure AD tenant. Các quản trị viên khác kết nối sau này sẽ không cần cấp lại đồng ý.
- Không chọn — quyền chỉ được cấp cho tài khoản của quản trị viên. Điều này đủ để hoàn tất thiết lập vì quản trị viên có vai trò cần thiết để xuất bản bot.
Ai nên thực hiện thiết lập?
| Vai trò của bạn | Phải làm gì |
|---|---|
| Global Admin hoặc Teams Admin | Bạn có thể tự hoàn tất thiết lập đầy đủ — tiến hành đến Bước 1 bên dưới |
| Người dùng thông thường | Yêu cầu Global Admin hoặc Teams Admin của bạn hoàn tất Bước 1–3. Sau khi bot được xuất bản, bạn có thể sử dụng nó trong bất kỳ kênh nào mà nó được cài đặt |
Thiết lập
Điều hướng đến Integrations
Đi đến Admin Settings → Integrations và tìm Microsoft Teams
Cài đặt bot
Chọn Teams nào để thêm bot CloudThinker vào và xác nhận cài đặt. Bot được xuất bản lên danh mục ứng dụng Teams của tổ chức — đây là thao tác một lần.
Ánh xạ Teams với workspace
Ánh xạ Microsoft Teams của bạn với các workspace CloudThinker để agent biết tài khoản cloud nào cần vận hành
Cấu hình thông báo
Tùy chọn chọn kênh cho từng loại thông báo (cảnh báo chi phí, phát hiện bảo mật, cập nhật incident)
Cú pháp
Trong Teams, thêm tiền tố@CloudThinker vào tất cả lệnh:
@CloudThinker.
Ví dụ
Truy vấn nhanh
Với công cụ
Đa agent
Cảnh báo
Cấu hình agent để gửi cảnh báo đến các kênh Teams:Thông báo Code Review
Khi AI Code Review hoàn thành, CloudThinker gửi thông báo Adaptive Card đến kênh Teams đã cấu hình của bạn. Thẻ bao gồm:- Bảng mức độ nghiêm trọng — bảng có cấu trúc hiển thị số lượng theo cấp độ nghiêm trọng (🔴 Critical, 🟠 High, 🟡 Medium, 🟢 Low)
- Chi tiết phát hiện — tối đa 5 phát hiện chưa giải quyết với tiêu đề, nhãn mức độ nghiêm trọng, đường dẫn file và số dòng
- Số lượng đã giải quyết — số phát hiện đã được xác định trước đó đã được giải quyết
- Nút View Code Review — liên kết trực tiếp đến dashboard review
- Thông qua sạch — khi không tìm thấy vấn đề, một tin nhắn đơn giản “No issues found”
Cấu hình kênh Teams nào nhận thông báo Code Review và đặt ngưỡng mức độ nghiêm trọng trong Settings > Notifications > Code Review / Pipeline Monitoring. Xem Notifications Center để biết chi tiết.
Mẫu kênh
| Kênh | Trường hợp sử dụng |
|---|---|
#cloud-ops | Vận hành hạ tầng chung và cảnh báo chi phí |
#security | Phát hiện bảo mật và cập nhật tuân thủ |
#incidents | Điều tra và phối hợp incident đang diễn ra |
#code-reviews | Phát hiện Code Review và giám sát pipeline |
#reports | Báo cáo định kỳ và tóm tắt |
Xử lý sự cố
Agent không phản hồi
Agent không phản hồi
- Kiểm tra xem bot CloudThinker có được cài đặt trong nhóm không
- Xác minh bạn đang sử dụng cú pháp
@CloudThinker agent(không chỉagent) - Xác nhận các agent được cấu hình trong console CloudThinker
- Kiểm tra trạng thái đồng ý quản trị Azure AD
Thiếu cảnh báo
Thiếu cảnh báo
- Kiểm tra cấu hình cảnh báo trong CloudThinker Settings
- Xác minh cài đặt thông báo kênh Teams
- Đảm bảo bot có quyền đăng trong kênh đích
Lỗi quyền
Lỗi quyền
- “Missing required permissions” — Người dùng đã kết nối không có vai trò Global Administrator hoặc Teams Administrator. Yêu cầu nhóm IT của bạn thực hiện kết nối ban đầu thay thế.
- “Consent on behalf of your organization” — Trong OAuth, quản trị viên có thể chọn hộp kiểm này để cấp quyền trên toàn tenant. Điều này là tùy chọn — nếu người dùng kết nối đã là quản trị viên, đồng ý cá nhân của họ là đủ.
- Kết nối có vẻ thành công nhưng bot không hoạt động — Điều này có thể xảy ra nếu người dùng không phải quản trị viên hoàn tất luồng OAuth. Xác thực cá nhân của người dùng thành công, nhưng việc xuất bản bot lên danh mục ứng dụng thất bại âm thầm. Yêu cầu Global Administrator hoặc Teams Administrator kết nối lại.
- Đối với bất kỳ lỗi quyền nào khác, kiểm tra quyền quản trị workspace trong CloudThinker, hoặc thử xóa và thêm lại bot vào nhóm.
Tôi không phải quản trị viên — làm thế nào để thiết lập?
Tôi không phải quản trị viên — làm thế nào để thiết lập?
Bạn cần Global Administrator hoặc Teams Administrator từ tổ chức của bạn để hoàn tất kết nối ban đầu. Đây là những gì cần chia sẻ với họ:
- Đăng nhập vào CloudThinker (họ cần tài khoản CloudThinker với quyền quản trị tổ chức)
- Đi đến Admin Settings → Integrations → Microsoft Teams
- Nhấp Connect with Teams và hoàn tất luồng Microsoft OAuth
- Bot sẽ được xuất bản lên danh mục ứng dụng Teams của tổ chức
@CloudThinker trong các kênh mà bot được cài đặt.Quyền
Quyền Azure AD
Kết nối ban đầu yêu cầu Global Administrator hoặc Teams Administrator trong Azure AD. Điều này là vì CloudThinker cần xuất bản một bot lên danh mục ứng dụng Teams của tổ chức, đây là hành động cấp quản trị. Thiết lập này là thao tác một lần — sau khi bot được xuất bản, không cần thêm hành động quản trị nào. Trong OAuth, quản trị viên có thể tùy chọn chọn “Consent on behalf of your organization” để cấp quyền trên toàn tenant. Nếu không chọn, quyền chỉ được cấp cho tài khoản của quản trị viên, điều này vẫn đủ để hoàn tất thiết lập. Xem bảng Quyền Azure AD cần thiết ở trên để có danh sách đầy đủ các phạm vi được yêu cầu.Quyền CloudThinker
Trong Teams, người dùng chỉ có thể truy cập các agent và kết nối cloud mà tài khoản CloudThinker của họ cho phép. Các vai trò workspace CloudThinker áp dụng theo cùng cách như trong console web.Liên quan
CloudThinker Language
Tài liệu tham khảo cú pháp đầy đủ cho tất cả lệnh
Tích hợp Slack
Thiết lập CloudThinker trong Slack