Hướng dẫn này cho biết cách tạo một ứng dụng Google Chat phản hồi các sự cố theo thời gian thực. Khi phản hồi một sự cố, ứng dụng sẽ tạo và điền sẵn một không gian Chat, hỗ trợ giải quyết sự cố bằng tin nhắn, lệnh gạch chéo và hộp thoại, đồng thời sử dụng AI để tóm tắt phản hồi sự cố trong một tài liệu trên Google Tài liệu.
Sự cố là một sự kiện cần được một nhóm người chú ý ngay lập tức để giải quyết. Sau đây là một số ví dụ về các sự cố:
- Trường hợp có giới hạn thời gian được tạo trong Quản lý quan hệ khách hàng (CRM) nền tảng này yêu cầu nhóm dịch vụ cộng tác để tìm ra giải pháp.
- Một hệ thống chuyển sang chế độ ngoại tuyến, cảnh báo cho một nhóm kỹ sư quản lý độ tin cậy của trang web (SRE) để họ có thể cùng nhau đưa sản phẩm trở lại trực tuyến.
- Một trận động đất có cường độ lớn xảy ra và nhân viên cứu hộ cần phối hợp phản ứng.
Trong phạm vi hướng dẫn này, cảnh báo sự cố bắt đầu khi có người báo cáo sự cố bằng một lượt nhấp vào nút trên trang web. Trang web này mô phỏng sự cố bằng cách yêu cầu người dùng nhập thông tin cơ bản về sự cố: tiêu đề, nội dung mô tả và địa chỉ email của người trả lời.
Xem ứng dụng Chat quản lý sự cố trong thực tế:
-
Hình 2. Thông báo về việc tạo không gian Chat cho sự cố. -
Hình 3. Phòng Chat phản hồi sự cố. -
Hình 4. Giải quyết sự cố bằng lệnh dấu gạch chéo. -
Hình 5. Hộp thoại giải quyết sự cố. -
Hình 6. Tài liệu trên Google Tài liệu về giải quyết sự cố được chia sẻ trong không gian. -
Hình 7. Tài liệu trên Google Tài liệu về cách giải quyết sự cố tóm tắt bằng AI.
Điều kiện tiên quyết
Nếu bạn cần bật bất kỳ điều kiện tiên quyết nào trong số này cho tổ chức của mình, hãy hỏi quản trị viên Google Workspace của bạn để bật các tính năng này:
- Doanh nghiệp Tài khoản Google Workspace có quyền truy cập vào Google Chat.
- Để bật tính năng Danh bạ (chia sẻ thông tin liên hệ) cho Google Workspace. Ứng dụng sự cố sử dụng danh bạ để tra cứu thông tin về nhân viên ứng cứu sự cố thông tin liên hệ, chẳng hạn như tên và địa chỉ email. Người phản hồi sự cố phải là người dùng có tài khoản Google Chat trong tổ chức Google Workspace của bạn.
Mục tiêu
- Xây dựng một ứng dụng trong Chat có khả năng phản hồi các sự cố.
- Giúp người dùng ứng phó với sự cố bằng cách làm những việc sau:
- Tạo không gian ứng phó sự cố.
- Đăng thông báo tóm tắt các sự cố và biện pháp phản hồi.
- Hỗ trợ cộng tác bằng các tính năng tương tác của ứng dụng Chat.
- Tóm tắt các cuộc trò chuyện và giải pháp bằng Vertex AI.
Kiến trúc
Sơ đồ dưới đây thể hiện cấu trúc của Google Workspace và Tài nguyên của Google Cloud được sử dụng trong quy trình ứng phó sự cố Ứng dụng Google Chat.
Cấu trúc cho thấy cách ứng phó sự cố Ứng dụng Google Chat xử lý sự cố và giải quyết sự cố.
Người dùng bắt đầu một sự cố từ một trang web bên ngoài được lưu trữ trên Apps Script.
Trang web gửi một yêu cầu HTTP không đồng bộ đến ứng dụng Google Chat, cũng được lưu trữ trên Apps Script.
Ứng dụng Google Chat phản hồi sự cố sẽ xử lý yêu cầu:
Dịch vụ SDK dành cho quản trị viên của Apps Script sẽ nhận thông tin về thành viên trong nhóm, chẳng hạn như mã nhận dạng người dùng và địa chỉ email.
Với một tập hợp các yêu cầu HTTP đến Chat API bằng cách sử dụng dịch vụ Chat nâng cao của Apps Script, ứng dụng Google Chat phản hồi sự cố sẽ tạo một không gian Chat sự cố, điền vào không gian đó bằng các thành viên trong nhóm và gửi tin nhắn đến không gian đó.
Các thành viên trong nhóm thảo luận về sự việc trong phòng Chat.
Một thành viên trong nhóm gọi một lệnh dấu gạch chéo để báo hiệu giải pháp cho sự cố.
Lệnh gọi HTTP đến API Chat bằng dịch vụ Chat nâng cao của Apps Script sẽ liệt kê tất cả tin nhắn của không gian Chat.
Vertex AI nhận các tin nhắn có trong danh sách và tạo bản tóm tắt.
Dịch vụ
DocumentApp
của Apps Script sẽ tạo một tài liệu trên Docs và thêm bản tóm tắt của Vertex AI vào tài liệu đó.Ứng dụng Google Chat phản hồi sự cố gọi Chat API để gửi thông báo chia sẻ đường liên kết đến tài liệu tóm tắt trên Tài liệu.
Chuẩn bị môi trường
Phần này trình bày cách tạo và định cấu hình dự án Google Cloud cho Ứng dụng Chat.
Tạo dự án trên Google Cloud
Google Cloud Console
- Trong Google Cloud Console, hãy chuyển đến Trình đơn > Quản trị viên và IAM > Tạo dự án.
-
Trong trường Project Name (Tên dự án), hãy nhập tên mô tả cho dự án của bạn.
Không bắt buộc: Để chỉnh sửa Mã dự án, hãy nhấp vào Chỉnh sửa. Không thể thay đổi mã dự án sau khi tạo dự án, vì vậy, hãy chọn một mã đáp ứng nhu cầu của bạn trong suốt thời gian dự án.
- Trong trường Vị trí, hãy nhấp vào Duyệt qua để hiển thị các vị trí tiềm năng cho dự án. Sau đó, hãy nhấp vào Chọn.
- Nhấp vào Tạo. Bảng điều khiển Google Cloud sẽ chuyển đến trang Trang tổng quan và dự án của bạn sẽ được tạo trong vòng vài phút.
Giao diện dòng lệnh (CLI) của gcloud
Trong một trong các môi trường phát triển sau, hãy truy cập vào Google Cloud CLI (gcloud
):
-
Cloud Shell: Để sử dụng thiết bị đầu cuối trực tuyến với gcloud CLI
đã thiết lập, hãy kích hoạt Cloud Shell.
Kích hoạt Cloud Shell -
Local Shell: Để sử dụng môi trường phát triển cục bộ,
cài đặt và
khởi động
giao diện dòng lệnh (CLI) của gcloud.
Để tạo dự án trên Cloud, hãy sử dụng lệnhgcloud projects create
: Thay thế PROJECT_ID bằng cách đặt mã nhận dạng cho dự án bạn muốn tạo.gcloud projects create PROJECT_ID
Bật tính năng thanh toán cho dự án trên Google Cloud
bảng điều khiển Google Cloud
- Trong Google Cloud Console, hãy chuyển đến phần Thanh toán. Nhấp vào biểu tượng Trình đơn > Thanh toán > Dự án của tôi.
- Trong phần Chọn một tổ chức, hãy chọn tổ chức được liên kết với dự án Google Cloud của bạn.
- Trong hàng dự án, hãy mở trình đơn Hành động ( ), hãy nhấp vào Thay đổi thông tin thanh toán rồi chọn Tài khoản thanh toán Cloud.
- Nhấp vào Đặt tài khoản.
Giao diện dòng lệnh (CLI) của gcloud
- Để liệt kê các tài khoản thanh toán hiện có, hãy chạy:
gcloud billing accounts list
- Liên kết tài khoản thanh toán với một dự án trên Google Cloud:
gcloud billing projects link PROJECT_ID --billing-account=BILLING_ACCOUNT_ID
Thay thế nội dung sau:
PROJECT_ID
là Mã dự án của Dự án trên đám mây mà bạn muốn bật tính năng thanh toán.BILLING_ACCOUNT_ID
là mã tài khoản thanh toán để liên kết với dự án trên Google Cloud.
Bật API
bảng điều khiển Google Cloud
Trong Google Cloud Console, hãy bật API Google Chat, API Google Docs, API SDK dành cho quản trị viên và API Vertex AI.
Xác nhận rằng bạn đang bật các API trong đúng dự án trên Google Cloud, sau đó nhấp vào Tiếp theo.
Xác nhận rằng bạn đang bật đúng API, sau đó nhấp vào Bật.
gcloud CLI
Nếu cần, hãy đặt dự án Cloud hiện tại thành dự án bạn đã tạo bằng lệnh
gcloud config set project
:gcloud config set project PROJECT_ID
Thay thế PROJECT_ID bằng Mã dự án của Dự án trên đám mây mà bạn đã tạo.
Bật API Google Chat, API Google Tài liệu, API SDK dành cho quản trị viên và API Vertex AI bằng lệnh
gcloud services enable
:gcloud services enable chat.googleapis.com docs.googleapis.com admin.googleapis.com aiplatform.googleapis.com
Thiết lập tính năng xác thực và uỷ quyền
Xác thực và uỷ quyền cho phép Các tài nguyên truy cập vào ứng dụng Chat trong Google Workspace và Google Cloud để xử lý phản hồi khi có sự cố.
Trong hướng dẫn này, bạn xuất bản ứng dụng trong nội bộ nên có thể sử dụng phần giữ chỗ của bạn. Trước khi phát hành ứng dụng ra bên ngoài, hãy thay thế phần giữ chỗ có thông tin thực cho màn hình xin phép.
Trong Google Cloud Console, hãy chuyển đến Trình đơn > API và dịch vụ > Màn hình đồng ý OAuth.
Trong mục Loại người dùng, hãy chọn Nội bộ, rồi nhấp vào Tạo.
Trong App name (Tên ứng dụng), hãy nhập
Incident Management
.Trong phần Email hỗ trợ người dùng, hãy chọn địa chỉ email của bạn hoặc một nhóm Google phù hợp.
Trong mục Thông tin liên hệ của nhà phát triển, hãy nhập địa chỉ email của bạn.
Nhấp vào Lưu và tiếp tục.
Nhấp vào Add or Remove Scopes (Thêm hoặc xoá phạm vi). Một bảng điều khiển sẽ xuất hiện với danh sách các phạm vi cho từng API mà bạn đã bật trong dự án trên Google Cloud.
Trong phần Thêm phạm vi theo cách thủ công, hãy dán các phạm vi sau:
https://www.googleapis.com/auth/chat.spaces.create
https://www.googleapis.com/auth/chat.memberships
https://www.googleapis.com/auth/chat.memberships.app
https://www.googleapis.com/auth/chat.messages
https://www.googleapis.com/auth/documents
https://www.googleapis.com/auth/admin.directory.user.readonly
https://www.googleapis.com/auth/script.external_request
https://www.googleapis.com/auth/userinfo.email
https://www.googleapis.com/auth/cloud-platform
Nhấp vào Thêm vào bảng.
Nhấp vào Cập nhật.
Nhấp vào Lưu và tiếp tục.
Xem lại thông tin tóm tắt về quá trình đăng ký ứng dụng, sau đó nhấp vào Quay lại trang tổng quan.
Tạo và triển khai ứng dụng Chat
Trong phần sau, bạn sao chép và cập nhật toàn bộ Dự án Apps Script chứa tất cả ứng dụng cần thiết mã cho ứng dụng Chat, nên bạn không cần sao chép và hãy dán từng tệp.
Một số hàm có chứa dấu gạch dưới ở cuối tên, chẳng hạn như
processSlashCommand_()
từ ChatApp.gs
. Dấu gạch dưới ẩn hàm
từ trang web khởi tạo sự cố khi trang web mở trong trình duyệt. Để biết thêm
thông tin, xem
Hàm riêng tư.
Apps Script hỗ trợ hai loại tệp, tập lệnh .gs
và tệp .html
. Để tuân thủ sự hỗ trợ này, JavaScript phía máy khách của ứng dụng sẽ được đưa vào
bên trong thẻ <script />
và CSS của thẻ đó được bao gồm trong các thẻ <style />
bên trong
tệp HTML.
Bạn có thể xem toàn bộ dự án trên GitHub (không bắt buộc).
Dưới đây là tổng quan về từng tệp:
Consts.gs
Xác định các hằng số được tham chiếu bởi các tệp mã khác, bao gồm mã dự án trên Cloud, mã vị trí Vertex AI và dấu gạch chéo mã nhận dạng lệnh để đóng sự cố.
Xem mã
Consts.gs
ChatApp.gs
Xử lý các sự kiện tương tác trong Chat, bao gồm cả thông báo, lượt nhấp vào thẻ, lệnh gạch chéo và hộp thoại. Phản hồi lệnh dấu gạch chéo
/closeIncident
bằng cách mở một hộp thoại để thu thập thông tin chi tiết về cách giải quyết sự cố. Đọc tin nhắn trong không gian bằng cách gọi Phương thứcspaces.messages.list
trong API Chat. Lấy mã nhận dạng người dùng bằng cách sử dụng dịch vụ Thư mục SDK dành cho quản trị viên trong Apps Script.Xem mã
ChatApp.gs
ChatSpaceCreator.gs
Nhận dữ liệu biểu mẫu mà người dùng nhập trên trang web khởi chạy sự cố và sử dụng dữ liệu đó để thiết lập không gian Chat bằng cách tạo và điền dữ liệu vào không gian đó, sau đó đăng thông báo về sự cố.
Xem mã
ChatSpaceCreator.gs
DocsApi.gs
Gọi API Google Tài liệu để tạo tài liệu Google Tài liệu trong Google Drive của người dùng và ghi bản tóm tắt thông tin về sự cố (được tạo trong
VertexAiApi.gs
) vào tài liệu.Xem mã
DocsApi.gs
VertexAiApi.gs
Tóm tắt cuộc trò chuyện trong không gian Chat bằng Vertex AI. Bản tóm tắt này được đăng trong một tài liệu được tạo riêng trong
DocsAPI.gs
.Xem mã
VertexAiApi.gs
WebController.gs
Cung cấp trang web xử lý sự cố.
Xem mã
WebController.gs
Index.html
HTML bao gồm trang web khởi chạy sự cố.
Xem mã
Index.html
JavaScript.html
Xử lý hành vi của biểu mẫu, bao gồm cả việc gửi, lỗi và xoá, cho trang web khởi chạy sự cố. Hàm này được đưa vào
Index.html
bằng hàminclude
tuỳ chỉnh trongWebController.gs
.Xem mã
JavaScript.html
Stylesheet.html
Dịch vụ so sánh giá (CSS) cho trang web hỗ trợ khắc phục sự cố. Hàm này được đưa vào
Index.html
bằng hàminclude
tuỳ chỉnh trongWebController.gs
.Xem mã
Stylesheet.html
Tìm mã và số dự án trên Cloud của bạn
Trong Google Cloud Console, hãy chuyển đến dự án trên Cloud.
Nhấp vào Cài đặt và tiện ích > Cài đặt dự án.
Lưu ý các giá trị trong các trường Project number (Số dự án) và Project ID (Mã dự án). Bạn sẽ sử dụng các lớp này trong các phần sau.
Tạo dự án Apps Script
Cách tạo dự án Apps Script và kết nối dự án đó với dự án trên Cloud:
- Nhấp vào nút sau để mở dự án Apps Script Phản hồi sự cố bằng Google Chat.
Mở dự án - Nhấp vào Tổng quan.
- Trên trang tổng quan, hãy nhấp vào Tạo bản sao.
Đặt tên cho bản sao dự án Apps Script:
Nhấp vào Bản sao của bài viết Phản hồi sự cố bằng Google Chat.
Trong Project title (Tên dự án), hãy nhập
Incident Management Chat app
.Nhấp vào Đổi tên.
Trong bản sao dự án Apps Script, hãy chuyển đến tệp
Consts.gs
và thay thếYOUR_PROJECT_ID
bằng mã nhận dạng của dự án trên Google Cloud.
Thiết lập dự án trên Cloud của dự án Apps Script
- Trong dự án Apps Script, hãy nhấp vào Project Settings (Cài đặt dự án).
- Trong mục Dự án Google Cloud Platform (GCP), hãy nhấp vào Thay đổi dự án.
- Trong mục Số dự án trên GCP, hãy dán số dự án của dự án trên Cloud.
- Nhấp vào Đặt dự án. Dự án trên đám mây và dự án Apps Script hiện đã được kết nối.
Tạo một lượt triển khai Apps Script
Giờ đây, toàn bộ mã đã sẵn sàng, hãy triển khai Apps Script dự án. Bạn sử dụng mã triển khai khi định cấu hình ứng dụng Chat trong Google Cloud.
Trong Apps Script, hãy mở dự án của ứng dụng phản hồi sự cố.
Nhấp vào Triển khai > Triển khai mới.
Nếu bạn chưa chọn Tiện ích bổ sung và Ứng dụng web, bên cạnh Chọn loại, nhấp vào loại triển khai rồi chọn Tiện ích bổ sung và Ứng dụng web.
Trong phần Mô tả, hãy nhập nội dung mô tả cho phiên bản này, chẳng hạn như
Complete version of incident management app
.Trong phần Thực thi dưới dạng, hãy chọn Người dùng truy cập vào ứng dụng web
Trong phần Người có quyền truy cập, hãy chọn Mọi người trong tổ chức Workspace của bạn, trong đó "tổ chức Workspace của bạn" là tên của tổ chức Google Workspace.
Nhấp vào Triển khai. Apps Script báo cáo việc triển khai thành công và cung cấp mã nhận dạng triển khai và URL cho trang web khởi chạy sự cố.
Ghi lại URL Ứng dụng web để truy cập sau khi bạn bắt đầu sự cố. Sao chép Mã triển khai. Bạn sử dụng mã này trong khi định cấu hình ứng dụng Chat trong Google Cloud Console.
Nhấp vào Xong.
Định cấu hình ứng dụng Chat trong bảng điều khiển Google Cloud
Phần này trình bày cách định cấu hình API Google Chat trong bảng điều khiển Google Cloud kèm theo thông tin về ứng dụng Chat của bạn, bao gồm cả Mã của phiên bản triển khai mà bạn vừa tạo từ Apps Script dự án.
Trong Google Cloud Console, hãy nhấp vào Trình đơn > Các sản phẩm khác > Google Workspace > Thư viện sản phẩm > Google Chat API > Quản lý > Cấu hình.
Trong Tên ứng dụng, hãy nhập
Incident Management
.Trong Avatar URL (URL hình đại diện), hãy nhập
https://developers.google.com/chat/images/quickstart-app-avatar.png
.Trong mục Mô tả, hãy nhập
Responds to incidents.
.Nhấp vào nút bật/tắt Bật tính năng tương tác để chuyển sang vị trí bật.
Trong phần Chức năng, hãy chọn Nhận tin nhắn 1:1, Tham gia không gian và cuộc trò chuyện nhóm.
Trong phần Connection settings (Cài đặt kết nối), hãy chọn Apps Script.
Trong mục Deployment ID (Mã triển khai), hãy dán ID triển khai Apps Script mà bạn đã sao chép trước đó từ dự án Apps Script triển khai.
Đăng ký một lệnh dấu gạch chéo mà ứng dụng Chat đã triển khai đầy đủ sử dụng:
Trong phần Lệnhlash, hãy nhấp vào Thêm lệnh dấu gạch chéo.
Trong Name (Tên), hãy nhập
/closeIncident
.Trong Command ID, nhập
1
.Trong phần Mô tả, hãy nhập
Closes the incident being discussed in the space.
Chọn Mở hộp thoại.
Nhấp vào Xong. Lệnh gạch chéo được đăng ký và liệt kê.
Trong phần Chế độ hiển thị, hãy chọn Cung cấp ứng dụng Chat này cho những người và nhóm cụ thể trong Workspace rồi nhập địa chỉ email của bạn.
Trong Logs (Nhật ký), hãy chọn Log error to Logging (Ghi nhật ký vào nhật ký).
Nhấp vào Lưu. Thông báo cấu hình đã lưu sẽ xuất hiện, tức là ứng dụng đã sẵn sàng để thử nghiệm.
Kiểm thử ứng dụng Chat
Để kiểm thử ứng dụng Chat quản lý sự cố, hãy bắt đầu một sự cố từ trang web và xác minh rằng ứng dụng Chat hoạt động như mong đợi:
Chuyển đến URL của ứng dụng web triển khai Apps Script.
Khi Apps Script yêu cầu quyền truy cập vào dữ liệu của bạn, nhấp vào Xem xét quyền, đăng nhập bằng một Tài khoản Google thích hợp trong miền Google Workspace của bạn, rồi nhấp vào Cho phép.
Trang web về khởi tạo sự cố sẽ mở ra. Nhập thông tin thử nghiệm:
- Trong Tiêu đề sự cố, hãy nhập
The First Incident
. - Trong phần Người phản hồi sự cố, bạn có thể nhập địa chỉ email của những người phản hồi sự cố khác. Họ phải là người dùng có Tài khoản Google Chat trong tổ chức Google Workspace của bạn hoặc không tạo được không gian. Đừng nhập địa chỉ email của riêng bạn vì địa chỉ này sẽ được tự động thêm vào.
- Trong Thông báo ban đầu, hãy nhập
Testing the incident management Chat app.
- Trong Tiêu đề sự cố, hãy nhập
Nhấp vào Tạo không gian trò chuyện. Một thông báo
creating space
sẽ xuất hiện.Sau khi tạo không gian, một thông báo
Space created!
sẽ xuất hiện. Nhấp chuột Mở không gian: Thao tác này sẽ mở không gian trong Chat trong một thẻ mới.Bạn và những người khác phụ trách xử lý sự cố có thể gửi tin nhắn trong không gian này (không bắt buộc). Ứng dụng tóm tắt các tin nhắn này bằng Vertex AI và chia sẻ tài liệu hồi tố.
Để kết thúc quá trình ứng phó sự cố và bắt đầu quá trình giải quyết, trong Phòng Chat, nhập
/closeIncident
. Hộp thoại quản lý sự cố sẽ mở ra.Trong phần Đóng sự cố, hãy nhập nội dung mô tả về cách giải quyết sự cố, chẳng hạn như
Test complete
.Nhấp vào Đóng sự cố.
Ứng dụng Quản lý sự cố liệt kê các tin nhắn trong không gian, tóm tắt các tin nhắn đó bằng Vertex AI, dán bản tóm tắt vào tài liệu Google Tài liệu và chia sẻ tài liệu đó trong không gian.
Dọn dẹp
Để tránh bị tính phí cho tài khoản Google Cloud của bạn đối với các tài nguyên được sử dụng trong hướng dẫn này, bạn nên xoá dự án trên Google Cloud.
- Trong bảng điều khiển Google Cloud, hãy chuyển đến trang Quản lý tài nguyên. Nhấp vào biểu tượng Trình đơn > IAM và quản trị > Quản lý tài nguyên.
- Trong danh sách dự án, hãy chọn dự án mà bạn muốn xoá rồi nhấp vào Xoá .
- Trong hộp thoại, hãy nhập mã dự án rồi nhấp vào Tắt để xoá dự án.
Chủ đề có liên quan
- Trả lời câu hỏi dựa trên các cuộc trò chuyện trong Chat bằng ứng dụng Gemini AI Chat
- Quản lý dự án bằng Google Chat, Vertex AI và Firestore
- Ứng dụng phản hồi sự cố xác thực bằng thông tin xác thực của người dùng để gọi API và gọi các dịch vụ của Google Cloud, chẳng hạn như API Chat và API Vertex AI.
Tức là người dùng khởi tạo sự cố phải có quyền truy cập vào
luôn miễn phí. Để ứng dụng hoạt động hiệu quả hơn, hãy cân nhắc gọi API Vertex AI bằng tài khoản dịch vụ thay vì thông tin xác thực người dùng của người dùng gọi lệnh gạch chéo
/closeIncident
. Để được trợ giúp khi thiết lập tài khoản dịch vụ đối với API AI của Vertex, hãy xem Sử dụng tài khoản dịch vụ tuỳ chỉnh.