@CloudThinker trong một kênh để hỏi về cloud của bạn, rồi tiếp tục trao đổi trong thread. Cùng kết nối đó gửi thông báo, như cảnh báo và tóm tắt code review, dưới dạng Adaptive Card tới các kênh bạn chọn.
Điều kiện tiên quyết
- Owner hoặc Admin của tổ chức CloudThinker. Các vai trò khác xem được trang Teams nhưng không kết nối hay thay đổi được.
- Gói Team, Scale hoặc Enterprise. Ở gói Free, thẻ Microsoft Teams hiển thị Requires Team plan or above cùng nút Upgrade Plan. Xem bảng giá.
- Một quản trị viên Microsoft 365 có thể cấp admin consent trong Microsoft Entra ID. CloudThinker xuất bản bot vào Teams app catalog của tổ chức bạn, việc này cần admin consent. Một người có thể giữ cả hai vai trò. Nếu bạn không phải quản trị viên Microsoft 365, hãy mở trang Teams với vai trò Owner hoặc Admin của CloudThinker, nhấn Connect with Microsoft ở bước 2, và để quản trị viên Microsoft đăng nhập trên màn hình Microsoft đó trong lúc hai người cùng làm. Các quyền họ đồng ý cấp được liệt kê trong Bảo mật và quyền.
- CloudThinker được host tại app.cloudthinker.io. Bản cài đặt tự host hiển thị Not available on self-host trên thẻ.
Kết nối Microsoft Teams
1
Mở tích hợp Teams
Vào Admin Settings → Integrations, tìm thẻ Microsoft Teams, rồi nhấn Go to configure.
2
Nhấn Connect with Microsoft
Đăng nhập bằng tài khoản quản trị Microsoft. Trên màn hình quyền, tick Consent on behalf of your organization, rồi nhấn Accept.Trạng thái thành công: bạn quay lại trang Teams với thông báo Teams connected successfully, và Authenticate with Microsoft hiển thị tên và ID tenant của bạn.
3
Thêm một team
Trong Install bot and configure workspaces, nhấn Add team, tìm team và chọn. Kết quả tìm kiếm liệt kê mọi team trong tenant có tên bắt đầu bằng những gì bạn gõ, không chỉ các team bạn sở hữu, nên hãy trao đổi với chủ team trước: mọi thành viên của team đều thấy và mention được bot. CloudThinker cài bot vào team đó, nơi bot đọc được tin nhắn trong kênh (quyền
ChannelMessage.Read.Group) và đăng câu trả lời cùng thẻ.Trạng thái thành công: thông báo CloudThinker bot installed to team xuất hiện và team hiển thị thành một dòng. Nhấn Add another team để lặp lại cho các team khác.4
Chọn workspace cho từng team
Mở Select workspace trên dòng của team và chọn workspace CloudThinker có các kết nối mà team đó sẽ dùng. Mọi kênh trong team đều dùng workspace này.Trạng thái thành công: thông báo Workspace mapping updated xuất hiện.
5
Gửi tin nhắn thử
Trong bất kỳ kênh standard nào của team đó, mention bot:Trạng thái thành công: CloudThinker trả lời trong thread. Trả lời trong thread đó để hỏi tiếp. Bạn không cần mention bot lần nữa.
Liên kết tài khoản CloudThinker
Tài khoản đã liên kết giúp yêu cầu của bạn chạy dưới danh nghĩa chính bạn, với vai trò workspace của bạn, thay vì dưới tài khoản chung kia. Bạn không thể chủ động bắt đầu liên kết: CloudThinker chỉ đăng thẻ Link Your CloudThinker Account khi không tìm thấy tài khoản sở hữu workspace. Nhấn Link Account trên thẻ và đăng nhập. Trang hiển thị Account linked successfully! khi hoàn tất. Tài khoản Microsoft đã đăng nhập ở bước 2 được tự động liên kết với tài khoản CloudThinker đã nhấn Connect with Microsoft, nên nếu hai người cùng thiết lập, yêu cầu của quản trị viên Microsoft đó sẽ chạy dưới danh nghĩa admin CloudThinker. Không có thao tác hủy liên kết cho từng user; Disconnect from Teams gỡ mọi tài khoản đã liên kết.Hỏi CloudThinker trong Teams
Bắt đầu mỗi yêu cầu mới bằng@CloudThinker trong kênh của team. Sau đó, bạn viết yêu cầu giống hệt như khi gõ trong web app.
Giao tiếp với các agent bằng ngôn ngữ tự nhiên. Cú pháp đầy đủ là:
@agent(tùy chọn) — bỏ qua thì CloudThinker sẽ trả lời, hoặc nhắc một trong các agent tùy chỉnh của workspace.#connection(tùy chọn) — kết nối cần dùng, ví dụ tài khoản AWS hoặc một cluster Kubernetes./(tùy chọn) — chạy một skill hoặc một command.- Yêu cầu của bạn — điều bạn cần, bằng lời của chính bạn. Thêm bất kỳ ngữ cảnh nào trực tiếp trong câu.
CloudThinker chỉ hoạt động trong kênh của team. Trong chat cá nhân hoặc chat nhóm, CloudThinker không chạy yêu cầu, và trả lời I can only respond in team channels khi không tìm thấy team. CloudThinker đọc phần text trong tin nhắn, nên hãy dán nội dung bạn muốn CloudThinker đọc thay vì đính kèm file.
Gửi thông báo tới Teams
1
Mở cài đặt thông báo
Trên trang Teams, trong Configure notifications, nhấn Go to notification settings. Bạn cũng có thể vào More → Workspace settings → Notifications.
2
Chọn kênh mặc định cho workspace
Trong Delivery channels, tìm thẻ Teams (thẻ hiển thị Pick a channel cho tới khi bạn chọn kênh). Nhấn biểu tượng cài đặt (Change Teams channel), rồi tìm và chọn một kênh trong Teams Notification Channel. Chỉ kênh standard được liệt kê. Kênh private và shared không nhận được thông báo của bot.
3
Ghi đè theo loại thông báo (không bắt buộc)
Trong What to notify me about, bật ô Teams cho một sự kiện, rồi nhấn chip kênh → bên cạnh để gửi sự kiện đó tới kênh khác. Các dòng Alerts và Keepers còn có bộ chọn mức độ nghiêm trọng. Xem Thông báo để biết danh sách đầy đủ các loại.Trạng thái thành công: sự kiện khớp tiếp theo được đăng dưới dạng thẻ trong kênh đã chọn.
Thông báo code review
Khi Review hoàn tất một pull request hoặc merge request trên repository đã kết nối, CloudThinker có thể đăng một Adaptive Card lên Teams:- Bảng phát hiện theo mức độ nghiêm trọng
- Tối đa 5 phát hiện chưa xử lý, mỗi phát hiện kèm tiêu đề, mức độ nghiêm trọng, đường dẫn file và số dòng
- Số phát hiện trước đó nay đã được xử lý
- Nút View Review mở review trong CloudThinker
- No issues found khi review không có vấn đề
Bảo mật và quyền
Quản lý kết nối
Khắc phục sự cố
Missing required permissions khi thêm team
Missing required permissions khi thêm team
Tài khoản Microsoft chưa cấp admin consent. Đăng nhập lại bằng quản trị viên Microsoft 365 và tick Consent on behalf of your organization, hoặc cấp admin consent cho CloudThinker trong Microsoft Entra ID.
Bot không cài được vào team
Bot không cài được vào team
Cài đặt quản trị Teams có thể đang chặn custom app. Trong Teams admin center, vào Teams apps → Manage apps và tìm CloudThinker, custom app do nhà phát triển CloudThinker xuất bản cho tổ chức của bạn. Nếu trạng thái là blocked, hãy đặt thành allowed, và kiểm tra app permission policy không chặn app. Sau đó nhấn Add team lần nữa.
This tenant is already connected
This tenant is already connected
Microsoft tenant của bạn đã kết nối với một tổ chức CloudThinker khác. Hãy ngắt kết nối ở đó trước.
This team isn't linked to any workspace
This team isn't linked to any workspace
Team chưa được ánh xạ tới workspace nào. Trên trang Teams, đặt Select workspace trên dòng của team, hoặc nhấn Add team nếu team chưa được liệt kê.
Bot không trả lời
Bot không trả lời
Kiểm tra bạn đã đăng trong kênh standard của một team đã thêm, và đã mention
@CloudThinker trong một tin nhắn mới. Tin nhắn không có mention chỉ được trả lời bên trong thread mà CloudThinker đã bắt đầu.Một kênh không xuất hiện trong bộ chọn thông báo
Một kênh không xuất hiện trong bộ chọn thông báo
Chỉ kênh standard được liệt kê. Hãy chọn một kênh standard trong cùng team, hoặc kiểm tra team có xuất hiện trên trang Teams hay không.
Bước tiếp theo
Lệnh và cú pháp prompt
Viết yêu cầu sắc gọn hơn và lưu lại những yêu cầu đội bạn hay lặp lại
Thông báo
Chọn sự kiện nào tới Teams và ở mức độ nghiêm trọng nào
Approvals
Quyết định thao tác nào cần một người trước khi CloudThinker chạy
Slack
Thiết lập cùng quy trình trong Slack