Hướng dẫn này trình bày cách tạo một ứng dụng Google Chat mà một nhóm có thể sử dụng để quản lý dự án theo thời gian thực. Ứng dụng Chat sử dụng Vertex AI giúp các nhóm viết câu chuyện của người dùng (thể hiện các tính năng của hệ thống phần mềm từ quan điểm của một người dùng để nhóm phát triển) và duy trì các câu chuyện trong cơ sở dữ liệu Firestore.
-
Hình 1. Charlie thảo luận với nhóm về việc phát triển tính năng trong phòng Chat. Khi bạn đề cập đến quản lý dự án, ứng dụng Chat sẽ nhắc ứng dụng Chat hỗ trợ. -
Hình 2. Bằng cách sử dụng lệnh dấu gạch chéo /createUserStory
, Charlie sẽ tạo một câu chuyện. -
Hình 3. Ứng dụng Chat quản lý dự án sử dụng Vertex AI để viết nội dung mô tả câu chuyện, sau đó chia sẻ câu chuyện trong không gian. -
Hình 4. Charlie nhấp vào Chỉnh sửa để hoàn tất thông tin chi tiết của câu chuyện. Nội dung mô tả của AI là chính xác, nhưng Charlie muốn biết thêm thông tin chi tiết nên Charlie nhấp vào Mở rộng để yêu cầu Vertex AI thêm các yêu cầu vào nội dung mô tả câu chuyện. Charlie tự gán câu chuyện, đặt trạng thái là bắt đầu, chọn mức độ ưu tiên và kích thước phù hợp, sau đó nhấp vào Lưu. -
Hình 5. Charlie có thể xem và quản lý tất cả câu chuyện người dùng của nhóm bất cứ lúc nào bằng lệnh dấu gạch chéo /manageUserStories
.
Điều kiện tiên quyết
- Doanh nghiệp Tài khoản Google Workspace có quyền truy cập vào Google Chat.
Truy cập vào các dịch vụ của Google Cloud để thực hiện những việc sau:
- Tạo một dự án trên Google Cloud.
- Liên kết một tài khoản thanh toán Google Cloud với dự án Cloud. Người nhận hãy tìm hiểu xem bạn có quyền truy cập hay không, hãy xem Cần có quyền để bật tính năng thanh toán.
Sử dụng lệnh gọi Hàm Google Cloud chưa được xác thực, bạn có thể xác minh thông tin này bằng cách xác định xem gói thuê bao Google Cloud của mình tổ chức sử dụng tính năng chia sẻ bị hạn chế trong miền.
Nếu cần, hãy yêu cầu quản trị viên Google Cloud cấp quyền truy cập hoặc quyền.
Nếu sử dụng Google Cloud CLI, Node.js môi trường phát triển được định cấu hình để hoạt động với gcloud CLI. Xem Thiết lập quá trình phát triển Node.js môi trường.
Mục tiêu
- Xây dựng một ứng dụng Chat quản lý phần mềm linh hoạt dự án.
- Giúp người dùng viết câu chuyện của người dùng bằng công nghệ tạo sinh
Các công cụ viết truyện có sử dụng AI và sử dụng công nghệ của Vertex AI:
- Tạo và tạo lại nội dung mô tả câu chuyện.
- Mở rộng phần mô tả tin bài từ phần ghi chú để hoàn thành các yêu cầu.
- Sửa ngữ pháp để sửa lỗi chính tả.
- Luôn cập nhật công việc bằng cách ghi và đọc từ cơ sở dữ liệu Firestore.
- Hỗ trợ cộng tác trong phòng Chat bằng cách cho phép người dùng tạo, chỉnh sửa, giao và bắt đầu tin bài ngay từ cuộc trò chuyện.
Sản phẩm đã sử dụng
Ứng dụng quản lý dự án sử dụng các dịch vụ Google Workspace và Các sản phẩm của Google Cloud:
- API Chat: API để phát triển những ứng dụng Google Chat có khả năng nhận và phản hồi Sự kiện tương tác trong cuộc trò chuyện, chẳng hạn như tin nhắn. Quản lý dự án Ứng dụng Google Chat dùng API Chat để nhận và trả lời các sự kiện tương tác do Chat gửi và để định cấu hình các thuộc tính xác định cách bài đăng đó xuất hiện trong Chat, chẳng hạn như tên và hình đại diện.
- API Vertex AI: Một nền tảng AI tạo sinh. Quản lý dự án Ứng dụng Google Chat sử dụng Vertex AI API để viết câu chuyện của người dùng tiêu đề và nội dung mô tả.
- Khôi phục: Cơ sở dữ liệu tài liệu không máy chủ. Quản lý dự án Ứng dụng Google Chat sử dụng Firebase để lưu trữ dữ liệu về câu chuyện của người dùng.
Chức năng đám mây: Dịch vụ điện toán không máy chủ nhẹ cho phép bạn tạo Các chức năng độc lập, mục đích duy nhất có thể phản hồi Chat các sự kiện tương tác mà không cần quản lý máy chủ hoặc môi trường thời gian chạy. Chiến lược phát hành đĩa đơn quản lý dự án Ứng dụng Google Chat sử dụng Cloud Functions để lưu trữ điểm cuối HTTP mà Chat gửi các sự kiện tương tác đến và dưới dạng một nền tảng điện toán để chạy logic xử lý và phản hồi các sự kiện này.
Cloud Functions sử dụng các sản phẩm sau đây của Google Cloud để xây dựng, xử lý các sự kiện tương tác và tài nguyên điện toán trên máy chủ lưu trữ:
- Cloud Build: Một nền tảng triển khai, phân phối và tích hợp liên tục được quản lý toàn diện chạy các bản dựng tự động.
- Pub/Sub: Dịch vụ nhắn tin không đồng bộ và có thể mở rộng giúp tách các dịch vụ tạo tin nhắn từ các dịch vụ xử lý những tin nhắn đó.
- API Quản trị của Cloud Run: Môi trường được quản lý toàn diện để chạy các ứng dụng trong vùng chứa.
Kiến trúc
Cấu trúc ứng dụng Google Chat quản lý dự án nhận và xử lý các sự kiện tương tác trong Chat tại một điểm cuối HTTP, sử dụng Vertex AI để giúp viết câu chuyện của người dùng và lưu trữ thông tin chi tiết về câu chuyện người dùng trong cơ sở dữ liệu Firestore. Chiến lược phát hành đĩa đơn sơ đồ dưới đây thể hiện cấu trúc của Google Workspace và Tài nguyên Google Cloud đã sử dụng.
Ứng dụng Google Chat quản lý dự án hoạt động như sau:
Người dùng gửi tin nhắn trong Chat và gọi quản lý dự án ứng dụng Google Chat bằng cách gửi tin nhắn cho ứng dụng trực tiếp, đề cập đến câu lệnh trong dấu cách hoặc nhập lệnh dấu gạch chéo.
Chat gửi yêu cầu HTTP đồng bộ đến Điểm cuối HTTP.
Ứng dụng Google Chat quản lý dự án sẽ xử lý HTTP yêu cầu:
Vertex AI giúp bạn viết hoặc cập nhật câu chuyện của người dùng.
Cơ sở dữ liệu Firestore lưu trữ, truy xuất, cập nhật hoặc xoá câu chuyện người dùng .
Cloud Functions trả về phản hồi HTTP cho Chat hiển thị thông báo với người dùng dưới dạng thông báo hoặc hộp thoại.
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 một dự án trên Google Cloud
bảng điều khiển Google Cloud
- Trong bảng điều khiển Google Cloud, hãy chuyển đến Trình đơn > IAM và Quản trị > Tạo dự án.
-
Trong trường 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 đó 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
Truy cập vào Google Cloud ở một trong các môi trường phát triển sau đây 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 một dự án trên đám mây, hãy dùng lệnh "gcloud Projects create":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 bảng điều khiển Google Cloud, hãy chuyển đến phần Thanh toán. Nhấp chuột Thực đơn > Thanh toán > Dự án của tôi.
- Trong phần Chọn 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ế đoạn mã 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 dự án Google Cloud.
Bật các API
bảng điều khiển Google Cloud
Trong bảng điều khiển Google Cloud, hãy bật API Google Chat, Vertex AI API Cloud Functions API, Firestore API, Cloud Build API, API Pub/Sub và API Quản trị Cloud Run.
Xác nhận rằng bạn đang bật các API theo đúng cách Dự án trên đám mây, rồi 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.
Giao diện dòng lệnh (CLI) của gcloud
Nếu cần, hãy đặt dự án hiện tại trên Google Cloud thành dự án bạn được 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, Vertex AI API, Cloud Functions API API Firestore, API Cloud Build, API Pub/Sub và API Quản trị của Cloud Run bằng lệnh
gcloud services enable
:gcloud services enable chat.googleapis.com \ aiplatform.googleapis.com \ cloudfunctions.googleapis.com \ firestore.googleapis.com \ cloudbuild.googleapis.com \ pubsub.googleapis.com \ run.googleapis.com
API Quản trị Cloud Build, Pub/Sub và Cloud Run là điều kiện tiên quyết để Chức năng đám mây.
Xác thực và uỷ quyền
Không cần định cấu hình xác thực và uỷ quyền để tuân thủ của chúng tôi.
Để gọi các API Firestore và Vertex AI, hướng dẫn này sẽ sử dụng Thông tin đăng nhập mặc định của ứng dụng bằng tài khoản dịch vụ mặc định được liên kết với Chức năng đám mây mà bạn không cần thiết lập. Trong ngữ cảnh của môi trường sản xuất, bạn nên thường gặp tạo và đính kèm một tài khoản dịch vụ sang Cloud Function.
Tạo và triển khai ứng dụng Google Chat
Sau khi tạo và định cấu hình dự án trên Google Cloud, bạn đã sẵn sàng để tạo bản dựng và triển khai ứng dụng Google Chat. Trong phần này, bạn sẽ thực hiện sau:
- Tạo cơ sở dữ liệu Firestore để lưu trữ và truy xuất câu chuyện của người dùng.
- Nếu muốn, hãy xem lại mã mẫu.
- Tạo một Hàm đám mây để lưu trữ và chạy Mã của ứng dụng Chat để phản hồi sự kiện nhận được từ Chat dưới dạng yêu cầu HTTP.
- Tạo và triển khai ứng dụng Google Chat trên API Google Chat .
Tạo cơ sở dữ liệu Firestore
Trong phần này, bạn sẽ tạo một cơ sở dữ liệu Firestore để lưu trữ và truy xuất
câu chuyện của người dùng, nhưng bạn không xác định mô hình dữ liệu. Mô hình dữ liệu đã được đặt
ngầm ẩn trong mã mẫu bằng cách sử dụng model/user-story.js
và model/user.js
tệp.
Cơ sở dữ liệu của ứng dụng Chat quản lý dự án sử dụng một NoSQL mô hình dữ liệu dựa trên FiKhôi phục mô hình dữ liệu.
giấy tờ được sắp xếp thành bộ sưu tập. Để tìm hiểu thêm, hãy xemBiểu đồ dưới đây là tổng quan về hoạt động quản lý dự án Mô hình dữ liệu của ứng dụng Google Chat:
Tập hợp gốc là spaces
, trong đó mỗi tài liệu đại diện cho một không gian mà
Ứng dụng Chat đã tạo câu chuyện trong. Mỗi câu chuyện người dùng
được biểu thị bằng một tài liệu trong tập hợp con userStories
và mỗi người dùng
được biểu thị bằng một tài liệu trong tập hợp con users
.
Xem bộ sưu tập, tài liệu và định nghĩa các trường
spaces
Các không gian mà ứng dụng Chat đã tạo tin bài trong đó.
Trường | |
---|---|
Document ID | String Mã nhận dạng duy nhất của một không gian cụ thể nơi tạo tin bài. Tương ứng với tên tài nguyên của không gian trong API Chat. |
userStories | Subcollection of Documents ( Các câu chuyện do ứng dụng Chat và người dùng ứng dụng tạo ra. Tương ứng với Document ID của userStories trong Firebase. |
users | Subcollection of Documents (user) Người dùng đã tạo hoặc được giao câu chuyện. |
displayName | String Tên hiển thị của không gian trong API Chat. Không được đặt cho tin nhắn trực tiếp với người dùng. |
userStories
Tin bài do ứng dụng Chat và người dùng tạo.
Trường | |
---|---|
Document ID | String Mã nhận dạng duy nhất cho một câu chuyện người dùng cụ thể do ứng dụng Chat và người dùng trong ứng dụng tạo ra. |
assignee | Document (user) Tên tài nguyên của người dùng được giao để hoàn thành câu chuyện. Tương ứng với Document ID của tài liệu users và với tên tài nguyên của người dùng trong API Chat. |
description | String Nội dung mô tả tính năng phần mềm từ góc nhìn của người dùng. |
priority | Enum Tính cấp bách khi hoàn thành công việc. Các giá trị có thể là Low , Medium hoặc High . |
size | Enum Khối lượng công việc. Các giá trị có thể là Small , Medium hoặc Large . |
status | Enum Giai đoạn làm việc. Các giá trị có thể là OPEN , STARTED hoặc COMPLETED . |
title | String Tiêu đề câu chuyện; bản tóm tắt ngắn gọn. |
users
Những người dùng đã tạo hoặc được giao câu chuyện.
Trường | |
---|---|
Document ID | String Mã nhận dạng duy nhất của một người dùng cụ thể. Tương ứng với assignee của userStories trong Firebase và với tên tài nguyên của người dùng trong API Chat. |
avatarUrl | String URL lưu trữ hình đại diện của người dùng trong Chat. |
displayName | String Tên hiển thị của người dùng trong Chat. |
Dưới đây là cách tạo cơ sở dữ liệu Firestore:
bảng điều khiển Google Cloud
Trong bảng điều khiển Google Cloud, hãy chuyển đến Firestore. Nhấp chuột Thực đơn > Firestore.
Nhấp vào Tạo cơ sở dữ liệu.
Trong phần Chọn chế độ Firestore, hãy nhấp vào Chế độ gốc.
Nhấp vào Tiếp tục.
Định cấu hình cơ sở dữ liệu:
Trong phần Đặt tên cho cơ sở dữ liệu, hãy để Mã cơ sở dữ liệu là
(default)
.Trong mục Loại vị trí, hãy chỉ định một khu vực cho cơ sở dữ liệu của bạn, chẳng hạn như
us-central1
. Để có hiệu suất tốt nhất, hãy chọn cùng một vị trí hoặc lân cận vị trí làm Chức năng đám mây của ứng dụng Chat.
Nhấp vào Tạo cơ sở dữ liệu.
Giao diện dòng lệnh (CLI) của gcloud
Tạo cơ sở dữ liệu Firestore ở chế độ Gốc bằng Lệnh
gcloud firestore databases create
:gcloud firestore databases create \ --location=LOCATION \ --type=firestore-native
Thay thế LOCATION bằng tên của Firestore khu vực, chẳng hạn như dưới tên
us-central1
.
Xem lại mã mẫu
Trước khi tạo Chức năng đám mây, hãy dành chút thời gian để xem lại và làm quen với mã mẫu được lưu trữ trên GitHub.
Dưới đây là tổng quan về từng tệp:
env.js
- Biến cấu hình môi trường để triển khai Ứng dụng trong Chat với một dự án cụ thể trên Google Cloud và . Bạn phải cập nhật các biến cấu hình trong tệp này.
package.json
vàpackage-lock.json
- Chế độ cài đặt và phần phụ thuộc của dự án Node.js.
index.js
- Điểm truy cập cho Chức năng đám mây của ứng dụng Chat. Nó đọc Sự kiện trò chuyện từ yêu cầu HTTP, gọi trình xử lý ứng dụng và đăng phản hồi HTTP dưới dạng một Đối tượng JSON.
controllers/app.js
- Logic chính của ứng dụng. Xử lý
sự kiện tương tác bằng cách xử lý
Ứng dụng Chat đề cập và dấu gạch chéo.
Để phản hồi các lượt nhấp vào thẻ, hàm này sẽ gọi
app-action-handler.js
. controllers/app-action-handler.js
- Logic ứng dụng để xử lý thao tác nhấp vào thẻ Sự kiện tương tác trò chuyện.
services/space-service.js
,services/user-service.js
vàservices/user-story-service.js
- Các tệp này chứa các phần của
logic ứng dụng dành riêng cho việc xử lý phòng Chat,
người dùng và câu chuyện của người dùng. Các hàm trong các tệp này được gọi bằng
app.js
hoặcapp-action-handler.js
. Để thực hiện các thao tác với cơ sở dữ liệu, các hàm trong các tệp này gọi hàm trongfirestore-service.js
. services/firestore-service.js
- Xử lý các thao tác với cơ sở dữ liệu.
Các hàm trong tệp này được gọi bởi
services/space-service.js
,services/user-service.js
vàservices/user-story-service.js
. services/aip-service.js
- Gọi Vertex AI API để lấy văn bản AI tạo sinh cụm từ gợi ý.
model/*.js
- Các tệp này chứa định nghĩa lớp và enum mà ứng dụng các dịch vụ dùng để lưu trữ và truyền dữ liệu giữa các hàm. Họ thiết lập mô hình dữ liệu cho cơ sở dữ liệu Firestore.
views/*.js
- Mỗi tệp trong thư mục này sẽ tạo thực thể một đối tượng thẻ mà thuộc tính Sau đó, ứng dụng Chat gửi lại Chat dưới dạng thông báo thẻ hoặc phản hồi tác vụ hộp thoại.
views/widgets/*.js
- Mỗi tệp sẽ tạo thực thể
một loại tiện ích
mà ứng dụng dùng để tạo thẻ trong thư mục
views/
. test/**/*.test.js
- Mỗi tệp trong thư mục này và các thư mục con của tệp đều chứa các bài kiểm thử đơn vị
cho chức năng, bộ điều khiển, dịch vụ, chế độ xem hoặc tiện ích tương ứng.
Bạn có thể thực thi tất cả các bài kiểm thử đơn vị bằng cách chạy
npm run test
khi ở thư mục gốc của dự án.
Tạo và triển khai Chức năng đám mây
Trong phần này, bạn sẽ tạo và triển khai một Hàm đám mây bao gồm logic ứng dụng của ứng dụng Chat quản lý dự án.
Hàm đám mây chạy để phản hồi đến một yêu cầu HTTP từ Chat có chứa Chat sự kiện tương tác. Khi chạy, mã Cloud Function sẽ xử lý sự kiện và trả về phản hồi cho Chat mà Chat hiển thị dưới dạng thông báo, hộp thoại hoặc loại tương tác khác của người dùng. Nếu có, Cloud Hàm cũng đọc hoặc ghi vào cơ sở dữ liệu Firestore.
Dưới đây là cách tạo Hàm đám mây:
bảng điều khiển Google Cloud
Tải mã từ GitHub xuống dưới dạng tệp zip.
Giải nén tệp zip đã tải xuống.
Thư mục đã trích xuất chứa toàn bộ mẫu Google Workspace kho lưu trữ.
Trong thư mục đã giải nén, hãy chuyển đến
google-chat-samples-main/node/project-management-app/
, sau đó nén thư mụcproject-management-app
vào tệp zip.Thư mục gốc của tệp zip phải chứa những thông tin sau tệp và thư mục:
env.js
README.md
gcloudignore.text
package-lock.json
package.json
index.js
model/
controllers/
views/
services/
Trong bảng điều khiển Google Cloud, hãy truy cập vào trang Cloud Functions:
Kiểm tra để đảm bảo dự án trên Google Cloud dành cho Ứng dụng nhắn tin đã được chọn.
Nhấp vào
Create Function (Tạo hàm).Trên trang Tạo hàm, hãy thiết lập hàm của bạn:
- Trong mục Môi trường, hãy chọn thế hệ thứ 2.
- Trong Tên hàm, hãy nhập
project-management-tutorial
. - Trong phần Khu vực, hãy chọn một khu vực.
- Trong phần Xác thực, hãy chọn Cho phép lệnh gọi chưa được xác thực.
- Nhấp vào Tiếp theo.
Trong Thời gian chạy, hãy chọn Node.js 20.
Trong mục Điểm truy cập, hãy xoá văn bản mặc định rồi nhập
projectManagementChatApp
.Trong Mã nguồn, chọn Tải lên ZIP.
Trong Bộ chứa đích, tạo hoặc chọn một nhóm:
- Nhấp vào Duyệt xem.
- Chọn một bộ chứa.
- Nhấp vào Chọn.
Google Cloud tải tệp zip lên và giải nén các tệp thành phần trong bộ chứa này. Sau đó, Cloud Functions sao chép các tệp thành phần vào Chức năng đám mây.
Trong Tệp zip, hãy tải tệp zip mà bạn đã tải xuống từ GitHub lên, đã trích xuất và nén lại:
- Nhấp vào Duyệt xem.
- Di chuyển đến và chọn tệp zip.
- Nhấp vào Mở.
Nhấp vào Triển khai.
Trang chi tiết về Chức năng đám mây sẽ mở ra và hàm của bạn sẽ xuất hiện có hai chỉ báo tiến trình: một chỉ báo cho bản dựng và một chỉ báo dịch vụ. Khi cả hai chỉ báo tiến trình biến mất và được thay thế bằng dấu kiểm đánh dấu, chức năng của bạn đã được triển khai và sẵn sàng.
Chỉnh sửa mã mẫu để đặt hằng số:
- Trên trang Chi tiết về Chức năng đám mây, hãy nhấp vào Chỉnh sửa.
- Nhấp vào Tiếp theo.
- Trong Mã nguồn, chọn Trình chỉnh sửa cùng dòng.
- Trong trình chỉnh sửa cùng dòng, hãy mở tệp
env.js
. - Thay thế project-id bằng mã dự án trên Cloud của bạn.
- Không bắt buộc: Cập nhật us-central1 bằng một vị trí được hỗ trợ cho chức năng đám mây của bạn.
Nhấp vào Triển khai.
Khi hàm này hoàn tất việc triển khai, hãy sao chép URL của điều kiện kích hoạt:
- Trên trang Thông tin chi tiết về hàm, hãy nhấp vào Điều kiện kích hoạt.
- Sao chép URL. Bạn cần nó để định cấu hình ứng dụng Chat trong phần sau.
Giao diện dòng lệnh (CLI) của gcloud
Sao chép mã lấy từ GitHub:
git clone https://github.com/googleworkspace/google-chat-samples.git
Chuyển sang thư mục lưu giữ mã cho dự án này ứng dụng Chat quản lý:
cd google-chat-samples/node/project-management-app
Chỉnh sửa tệp
env.js
để đặt các biến môi trường:- Thay thế project-id bằng mã dự án trên Google Cloud.
- Thay thế us-central1 bằng vị trí dự án trên Google Cloud.
Triển khai hàm đám mây cho Google Cloud:
gcloud functions deploy project-management-tutorial \ --gen2 \ --region=REGION \ --runtime=nodejs20 \ --source=. \ --entry-point=projectManagementChatApp \ --trigger-http \ --allow-unauthenticated
Thay thế REGION bằng Vị trí của Hàm đám mây nơi lưu trữ cơ sở hạ tầng, chẳng hạn như
us-central1
.
- Khi hàm này hoàn tất việc triển khai, hãy sao chép thuộc tính
url
qua của bạn. Đây là URL kích hoạt mà bạn sử dụng trong mục sau để định cấu hình ứng dụng Google Chat.
Định cấu hình ứng dụng Google 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 Chat trong bảng điều khiển Google Cloud với thông tin về ứng dụng Chat của bạn, bao gồm tên của ứng dụng Chat, dấu gạch chéo được hỗ trợ và URL kích hoạt của Đám mây của ứng dụng Chat Hàm mà hàm gửi sự kiện tương tác trong Chat.
Trong bảng điều khiển Google Cloud, hãy nhấp vào Trình đơn > Sản phẩm khác > Google Workspace > Thư viện sản phẩm > API Google Chat > Quản lý > Cấu hình.
Trong Tên ứng dụng, hãy nhập
Project Manager
.Trong URL hình đại diện, hãy nhập
https://developers.google.com/chat/images/quickstart-app-avatar.png
.Trong phần Description (Nội dung mô tả), hãy nhập
Manages projects with user stories.
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 mục Cài đặt kết nối, hãy chọn URL ứng dụng.
Trong URL ứng dụng, hãy dán URL điều kiện kích hoạt mà bạn đã sao chép từ Đám mây Triển khai hàm, được định dạng là
https://
REGION-
PROJECT_ID.cloudfunctions.net/project-management-tutorial
. Nếu bạn đã triển khai Chức năng đám mây bằng gcloud CLI, thì đây làurl
thuộc tính này.Đăng ký ứng dụng Chat lệnh dấu gạch chéo. Cách đăng ký lệnh dấu gạch chéo:
- Trong phần Lệnhlash, hãy nhấp vào Thêm lệnh dấu gạch chéo.
Đối với mỗi lệnh dấu gạch chéo được nêu chi tiết trong bảng sau, nhập Tên, Mã lệnh, Mô tả và chọn xem lệnh dấu gạch chéo Mở hộp thoại, sau đó nhấp vào Xong:
Tên Mã lệnh Mô tả Mở hộp thoại /createUserStory
1 Tạo một câu chuyện có tiêu đề đã chỉ định. Đã bỏ chọn /myUserStories
2 Liệt kê tất cả tin bài đã chỉ định cho người dùng. Đã bỏ chọn /userStory
3 Hiển thị trạng thái hiện tại của tin bài được chỉ định. Đã bỏ chọn /manageUserStories
4 Mở một hộp thoại để bạn chỉnh sửa các tin bài. Đã chọn /cleanupUserStories
5 Xoá tất cả tin bài trong không gian. Đã bỏ chọn
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 phần Logs (Nhật ký), hãy chọn Log lỗi to Logging (Ghi nhật ký lỗi vào nhật ký) (không bắt buộc).
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 Chat là sẵn sàng để thử nghiệm.
Kiểm thử ứng dụng Chat
Kiểm thử ứng dụng Chat quản lý dự án bằng cách nhắn tin cho ứng dụng đó cũng như sử dụng lệnh dấu gạch chéo để tạo, chỉnh sửa và xoá câu chuyện của người dùng.
Mở Google Chat bằng tài khoản Google Workspace mà bạn khi bạn tự thêm chính mình làm người kiểm tra đáng tin cậy.
- Nhấp vào Cuộc trò chuyện mới.
- Trong trường Thêm 1 hoặc nhiều người, nhập tên của Ứng dụng Chat.
Chọn ứng dụng Chat của bạn trong kết quả. Người trực tiếp tin nhắn sẽ mở ra.
- Trong tin nhắn trực tiếp mới với ứng dụng, hãy nhập
Hello
và nhấnenter
. Quản lý dự án Ứng dụng Chat phản hồi bằng một trình đơn trợ giúp nêu chi tiết những gì ứng dụng có thể làm. - Để tạo story, hãy nhập
/createUserStory Test story
vào thanh tin nhắn và gửi tin nhắn đó. Quản lý dự án Ứng dụng Chat trả lời bằng một thông báo dạng thẻ nêu chi tiết câu chuyện người dùng mà dịch vụ này tạo cho bạn bằng AI tạo sinh của Vertex AI. Trong bảng điều khiển, hãy kiểm tra cơ sở dữ liệu Firestore để xem xét bản ghi không gian mà bạn đã thêm Trò chuyện với ứng dụng, với những người dùng đã tương tác với ứng dụng đó, và câu chuyện người dùng mà bạn đã tạo.
Quay lại Google Chat.
- Nếu bạn muốn chỉnh sửa câu chuyện, hãy nhấp vào Chỉnh sửa. Khi bạn hài lòng với câu chuyện đó, hãy nhấp vào Lưu.
- Kiểm thử từng lệnh dấu gạch chéo mà ứng dụng hỗ trợ. Để xem các đề xuất này, hãy nhập
/
hoặc đề cập đến ứng dụng Chat. - Xoá câu chuyện người dùng thử nghiệm bằng cách phát hành
/cleanupUserStories
lệnh dấu gạch chéo. Ngoài ra, xoá hoặc gỡ cài đặt ứng dụng. Khi bị xoá, ứng dụng này sẽ xoá tất cả câu chuyện của người dùng được tạo trong không gian đó.
Khắc phục sự cố
Khi một ứng dụng Google Chat hoặc card trả về một lỗi, thì phương thức Giao diện Chat hiển thị một thông báo với nội dung "Đã xảy ra lỗi". hoặc "Không thể xử lý yêu cầu của bạn". Đôi khi, giao diện người dùng của Chat không hiện thông báo lỗi nào ngoài ứng dụng Chat hoặc thẻ tạo ra kết quả không mong muốn; ví dụ: thông báo thẻ có thể không xuất hiện.
Mặc dù thông báo lỗi có thể không xuất hiện trong giao diện người dùng Chat, thông báo lỗi mô tả và dữ liệu nhật ký luôn có sẵn để giúp bạn sửa lỗi khi tính năng ghi nhật ký lỗi cho các ứng dụng trong Chat được bật. Để được trợ giúp xem, gỡ lỗi và sửa lỗi, hãy xem Khắc phục lỗi và khắc phục lỗi của Google Chat.
Dọn dẹp
Để tránh phát sinh phí đối với tài khoản Google Cloud của bạn cho tài nguyên được sử dụng trong hướng dẫn này, chúng tôi khuyên bạn nên xóa Dự án trên đám mây.
- Trong bảng điều khiển Google Cloud, hãy chuyển đến trang Quản lý tài nguyên. Nhấp chuột Thực đơn > IAM và Quản trị viên > 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
- Ứng phó với sự cố liên quan đến Google Chat, Vertex AI và Apps Script