Trang này được dịch bởi Cloud Translation API.

Quản lý dự án bằng Google Chat, Vertex AI và Firestore

Hướng dẫn này cho biết cách tạo một ứng dụng Google Chat mà nhóm có thể 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 người dùng (thể hiện các tính năng của một hệ thống phần mềm theo quan điểm của 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ề việc phát triển tính năng trong một không gian trên Chat với nhóm của mình. Khi bạn đề cập đến ứng dụng Chat quản lý dự án, ứng dụng Chat sẽ đưa ra đề nghị trợ giúp.
Hình 2. Charlie tạo một câu chuyện bằng lệnh dấu gạch chéo /createUserStory.
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 về câu chuyện. Mô tả do AI tạo ra 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 để Vertex AI thêm các yêu cầu vào nội dung mô tả câu chuyện. Charlie tự chỉ định câu chuyện cho mình, đặt trạng thái thành đã bắt đầu, chọn mức độ ưu tiên và quy mô phù hợp, sau đó nhấp vào Lưu.
Hình 5. Bất cứ lúc nào, Charlie cũng có thể xem và quản lý tất cả câu chuyện người dùng của nhóm bằng lệnh /manageUserStories/
.

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

Tài khoản Google Workspace Business hoặc Enterprise có quyền truy cập vào Google Chat.
Quyền 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 tài khoản thanh toán Google Cloud với dự án trên Cloud. Để biết bạn có quyền truy cập hay không, hãy xem bài viết Các quyền cần thiết để bật tính năng thanh toán.
- Sử dụng lệnh gọi Google Cloud Function chưa được xác thực mà bạn có thể xác minh bằng cách xác định xem tổ chức Google Cloud của bạn có sử dụng chế độ chia sẻ bị hạn chế theo miền hay không.
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, bạn cần có một môi trường phát triển Node.js được định cấu hình để hoạt động với gcloud CLI. Xem phần Thiết lập môi trường phát triển Node.js.

Mục tiêu

Tạo một ứng dụng Chat để quản lý các dự án phần mềm linh hoạt.
Giúp người dùng viết câu chuyện người dùng bằng các công cụ viết câu chuyện có sự hỗ trợ của AI tạo sinh dựa trên 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ả câu chuyện từ ghi chú để hoàn thành các yêu cầu.
- Sửa lỗi ngữ pháp để khắc phục lỗi chính tả.
Luôn cập nhật công việc bằng cách ghi vào và đọc từ cơ sở dữ liệu Firestore.
Tạo điều kiện cộng tác trong không gian Chat bằng cách cho phép người dùng tạo, chỉnh sửa, giao và bắt đầu câu chuyện ngay trong cuộc trò chuyện.

Các sản phẩm được sử dụng

Ứng dụng quản lý dự án sử dụng các sản phẩm sau đây của Google Workspace và Google Cloud:

API Chat: Một API để phát triển các ứng dụng Google Chat nhận và phản hồi các sự kiện tương tác trong Chat, chẳng hạn như tin nhắn. Ứng dụng Google Chat để quản lý dự án sử dụng Chat API để nhận và phản hồi các sự kiện tương tác do Chat gửi, đồng thời định cấu hình các thuộc tính xác định cách ứng dụng xuất hiện trong Chat, chẳng hạn như tên và hình đại diện.
Vertex AI API: Nền tảng AI tạo sinh. Ứng dụng Google Chat quản lý dự án sử dụng Vertex AI API để viết tiêu đề và nội dung mô tả cho câu chuyện người dùng.
Firestore: Cơ sở dữ liệu tài liệu không máy chủ. Ứng dụng Google Chat quản lý dự án sử dụng Firebase để lưu trữ dữ liệu về câu chuyện người dùng.
Cloud Functions: Một dịch vụ điện toán không máy chủ gọn nhẹ cho phép bạn tạo các hàm độc lập, có mục đích duy nhất có thể phản hồi các sự kiện tương tác trên Chat mà không cần quản lý máy chủ hoặc môi trường thời gian chạy. Ứng dụng Google Chat quản lý dự án 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, đồng thời sử dụng Cloud Functions làm 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 để tạo, xử lý các sự kiện tương tác và lưu trữ tài nguyên điện toán:
- Cloud Build: Nền tảng tích hợp, phân phối và triển khai liên tục được quản lý hoàn toàn, chạy các bản dựng tự động.
- Pub/Sub: Một dịch vụ nhắn tin không đồng bộ và có khả năng mở rộng, giúp tách các dịch vụ tạo tin nhắn khỏi các dịch vụ xử lý những tin nhắn đó.
- Cloud Run Admin API: Một môi trường được quản lý hoàn toàn để chạy các ứng dụng nằm trong vùng chứa.

Kiến trúc

Cấu trúc ứng dụng Google Chat để quản lý dự án sẽ nhận và xử lý các sự kiện tương tác trên Chat tại một điểm cuối HTTP, sử dụng Vertex AI để giúp viết câu chuyện 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. Sơ đồ sau đây cho thấy cấu trúc của Google Workspace và các tài nguyên được dùng trên Google Cloud.

Sơ đồ cấu trúc cho ứng dụng quản lý dự án trên Google Chat

Ứng dụng quản lý dự án trên Google Chat hoạt động như sau:

Người dùng gửi tin nhắn trong Chat và gọi ứng dụng quản lý dự án Google Chat bằng cách nhắn tin trực tiếp cho ứng dụng đó, đề cập đến ứng dụng đó trong một không gian hoặc nhập lệnh dấu gạch chéo.
Chat gửi một yêu cầu HTTP đồng bộ đến điểm cuối HTTP của Cloud Functions.
Ứng dụng Google Chat quản lý dự án sẽ xử lý yêu cầu HTTP:
1. Vertex AI giúp viết hoặc cập nhật câu chuyện người dùng.
2. Cơ sở dữ liệu Firestore lưu trữ, truy xuất, cập nhật hoặc xoá dữ liệu câu chuyện người dùng.
Cloud Functions trả về một phản hồi HTTP cho Chat. Phản hồi này sẽ hiển thị cho người dùng dưới dạng tin nhắn hoặc hộp thoại.

Chuẩn bị môi trường

Phần này hướng dẫn cách tạo và định cấu hình một dự án trê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 Google Cloud Console, hãy chuyển đến phần Trình đơn > IAM và Quản trị > Tạo dự án.
Chuyển đến phần 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. Bạn không thể thay đổi mã dự án sau khi tạo dự án, vì vậy, hãy chọn một mã dự án đáp ứng nhu cầu của bạn trong suốt thời gian tồn tại của dự án.
Trong trường Location (Vị trí), hãy nhấp vào Browse (Duyệt xem) để hiện các vị trí tiềm năng cho dự án của bạn. Sau đó, hãy nhấp vào Chọn.
Thận trọng: Bạn không tìm thấy tổ chức của mình trên Google Workspace?
Điều này có nghĩa là bạn chưa đăng nhập vào tài khoản Google Workspace. Một số tính năng được mô tả trong tài liệu dành cho nhà phát triển Google Workspace chỉ dành cho những dự án được liên kết với một tổ chức.
Nhấp vào Tạo. Bảng điều khiển Google Cloud sẽ chuyển đến trang Tổng quan và dự án của bạn sẽ được tạo trong vòng vài phút.

gcloud CLI

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 một thiết bị đầu cuối trực tuyến đã thiết lập gcloud CLI, 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ộ, hãy cài đặt và khởi động CLI gcloud.
Để tạo một dự án trên Cloud, hãy dùng lệnh gcloud projects create:
```
gcloud projects create PROJECT_ID
```
Thay thế PROJECT_ID bằng cách đặt mã nhận dạng cho dự án mà bạn muốn tạo.

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 Trình đơn > Thanh toán > Dự án của tôi.
Chuyển đến phần Thanh toán cho 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 (), nhấp vào Thay đổi thông tin thanh toán rồi chọn tài khoản thanh toán trên đám mây.
Nhấp vào Thiết lập tài khoản.

gcloud CLI

Để liệt kê các tài khoản thanh toán hiện có, hãy chạy lệnh:
```
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 cho 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 cần liên kết với dự án trên Google Cloud.

Bật các API

Bảng điều khiển Google Cloud

Trong Google Cloud Console, hãy bật Google Chat API, Vertex AI API, Cloud Functions API, Firestore API, Cloud Build API, Pub/Sub API và Cloud Run Admin API.

Bật các API
Xác nhận rằng bạn đang bật các API trong dự án Cloud chính xác, 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 hiện tại trên Cloud thành dự án mà bạn đã tạo bằng lệnh gcloud config set project:
```
gcloud config set project PROJECT_ID
```
Thay PROJECT_ID bằng Mã dự án của dự án trên Cloud mà bạn đã tạo.
Bật Google Chat API, Vertex AI API, Cloud Functions API, Firestore API, Cloud Build API, Pub/Sub API và Cloud Run Admin API 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ị của Cloud Build, Pub/Sub và Cloud Run là các điều kiện tiên quyết của Cloud Functions.

Xác thực và uỷ quyền

Bạn không cần phải thiết lập cấu hình xác thực và uỷ quyền để làm theo hướng dẫn này.

Để gọi API Firestore và Vertex AI, hướng dẫn này sử dụng Thông tin đăng nhập mặc định của ứng dụng với tài khoản dịch vụ mặc định được đính kèm vào Cloud Function mà bạn không cần thiết lập. Trong bối cảnh của môi trường sản xuất, bạn thường tạo và đính kèm tài khoản dịch vụ vào Cloud Function.

Tạo và triển khai ứng dụng Google Chat

Giờ đây, khi đã tạo và định cấu hình dự án Google Cloud, bạn đã sẵn sàng tạo và triển khai ứng dụng Google Chat. Trong phần này, bạn sẽ thực hiện những việc sau:

Tạo một cơ sở dữ liệu Firestore để duy trì và truy xuất các câu chuyện của người dùng.
Bạn có thể xem lại mã mẫu (không bắt buộc).
Tạo một Cloud Function để lưu trữ và chạy mã của ứng dụng Chat để phản hồi các sự kiện nhận được từ Chat dưới dạng yêu cầu HTTP.
Tạo và triển khai một ứng dụng Google Chat trên trang cấu hình 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 để duy trì và truy xuất các 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 một cách gián tiếp trong mã mẫu bằng các tệp model/user-story.js và model/user.js.

Cơ sở dữ liệu của ứng dụng Chat quản lý dự án sử dụng mô hình dữ liệu NoSQL dựa trên tài liệu được sắp xếp thành các bộ sưu tập. Để tìm hiểu thêm, hãy xem Mô hình dữ liệu Firestore.

Sơ đồ sau đây là thông tin tổng quan về mô hình dữ liệu của ứng dụng Google Chat để quản lý dự án:

Mô hình dữ liệu của cơ sở dữ liệu Firestore.

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. 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 định nghĩa về bộ sưu tập, tài liệu và trường

`spaces`

Không gian mà ứng dụng Chat tạo câu chuyện.

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 ra các tin. Tương ứng với tên tài nguyên của không gian trong API Chat.
`userStories`	`Subcollection of Documents (userStories)` Những câu chuyện do ứng dụng Chat và người dùng tạo. Tương ứng với `Document ID` của một `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`

Câu chuyện do ứng dụng Chat và người dùng tạo.

Trường
`Document ID`	`String` Mã nhận dạng riêng biệt của một câu chuyện cụ thể do ứng dụng Chat và người dùng tạo ra.
`assignee`	`Document (user)` Tên tài nguyên của người dùng được chỉ định 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 Chat API.
`description`	`String` Nội dung mô tả về tính năng phần mềm theo quan điểm của người dùng.
`priority`	`Enum` Mức độ khẩn cấp để hoàn thành công việc. Các giá trị có thể là `Low`, `Medium` hoặc `High`.
`size`	`Enum` Lượng công việc. Các giá trị có thể là `Small`, `Medium` hoặc `Large`.
`status`	`Enum` Giai đoạn của công việc. Các giá trị có thể là `OPEN`, `STARTED` hoặc `COMPLETED`.
`title`	`String` Tiêu đề của câu chuyện; nội dung 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 riêng biệ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 Chat API.
`avatarUrl`	`String` URL lưu trữ hình ả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 Google Cloud Console, hãy chuyển đến Firestore. Nhấp vào Trình đơn > Firestore.

Chuyển đế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:
1. Trong phần Đặt tên cho cơ sở dữ liệu của bạn, hãy để Mã cơ sở dữ liệu là (default).
2. Trong 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 vị trí giống hoặc gần với vị trí của Cloud Function trong ứng dụng Chat.
Nhấp vào Tạo cơ sở dữ liệu.

gcloud CLI

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 một khu vực Firestore, chẳng hạn như us-central1.

Xem lại mã mẫu

Bạn có thể dành chút thời gian xem xét và làm quen với mã mẫu được lưu trữ trên GitHub trước khi tạo Cloud Function.

Xem trên GitHub

Sau đây là thông tin tổng quan về từng tệp:

env.js: Các biến cấu hình môi trường để triển khai ứng dụng Chat vào một dự án và khu vực cụ thể trên Google Cloud. 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 dự án và các phần phụ thuộc của Node.js.
index.js: Điểm truy cập cho Cloud Function 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 đối tượng JSON.
controllers/app.js: Logic ứng dụng chính. Xử lý các sự kiện tương tác bằng cách xử lý các lệnh dấu gạch chéo và lượt đề cập đến ứng dụng Chat. Để phản hồi các lượt nhấp vào thẻ, phương thức này sẽ gọi app-action-handler.js.
controllers/app-action-handler.js: Logic ứng dụng để xử lý lượt nhấp vào thẻ Sự kiện tương tác trong cuộ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 những phần logic ứng dụng dành riêng cho việc làm việc với các phòng Chat, người dùng và câu chuyện người dùng. Các hàm trong những tệp này được gọi bằng app.js hoặc app-action-handler.js. Để thực hiện các thao tác cơ sở dữ liệu, các hàm trong những tệp này sẽ gọi các hàm trong firestore-service.js.
services/firestore-service.js: Xử lý các thao tác trên 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 để dự đoán văn bản bằng AI tạo sinh.
model/*.js: Các tệp này chứa định nghĩa về các lớp và enum mà các dịch vụ ứng dụng 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 một đối tượng thẻ mà ứng dụng Chat sau đó gửi lại cho Chat dưới dạng thông báo thẻ hoặc phản hồi hành động của hộp thoại.
views/widgets/*.js: Mỗi tệp sẽ khởi tạo một loại đối tượng widget mà ứng dụng dùng để tạo các 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 thư mục này đều chứa các kiểm thử đơn vị cho hàm, bộ điều khiển, dịch vụ, khung hiển thị hoặc tiện ích tương ứng. Bạn có thể thực thi tất cả các kiểm thử đơn vị bằng cách chạy npm run test trong thư mục gốc của dự án.

Tạo và triển khai Cloud Functions

Trong phần này, bạn sẽ tạo và triển khai một Cloud Function bao gồm logic ứng dụng của ứng dụng Chat quản lý dự án.

Cloud Function chạy để phản hồi một yêu cầu HTTP từ Chat có chứa một sự kiện tương tác trên Chat. Khi chạy, mã Cloud Functions sẽ xử lý sự kiện và trả về một phản hồi cho Chat. Chat sẽ hiển thị phản hồi này dưới dạng một thông báo, hộp thoại hoặc loại hình tương tác khác của người dùng. Nếu có thể, Cloud Function cũng đọc hoặc ghi vào cơ sở dữ liệu Firestore.

Dưới đây là cách tạo Cloud Function:

Bảng điều khiển Google Cloud

Tải mã xuống từ GitHub dưới dạng tệp zip.

Tải tệp zip xuống
Giải nén tệp zip đã tải xuống.

Thư mục được trích xuất chứa toàn bộ kho lưu trữ mẫu Google Workspace.
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ục project-management-app thành một tệp ZIP.

Thư mục gốc của tệp zip phải chứa các tệp và thư mục sau:
- env.js
- README.md
- gcloudignore.text
- package-lock.json
- package.json
- index.js
- model/
- controllers/
- views/
- services/
Trong Google Cloud Console, hãy chuyển đến trang Cloud Functions:

Chuyển đến Cloud Functions

Đảm bảo rằng bạn đã chọn dự án trên Google Cloud cho ứng dụng trò chuyện.
Nhấp vào Tạo hàm.
Trên trang Tạo hàm, hãy thiết lập hàm của bạn:
1. Trong Environment (Môi trường), hãy chọn Cloud Run Function (Hàm Cloud Run).
2. Trong Tên hàm, hãy nhập project-management-tutorial.
3. Trong phần Khu vực, hãy chọn một khu vực.
4. 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.
5. Nhấp vào Tiếp theo.
Trong Runtime (Thời gian chạy), hãy chọn Node.js 20.
Trong Điểm truy cập, hãy xoá văn bản mặc định rồi nhập projectManagementChatApp.
Trong phần Mã nguồn, hãy chọn Tải tệp ZIP lên.
Trong Destination bucket (Nhóm đích), hãy tạo hoặc chọn một nhóm:
1. Nhấp vào Duyệt xem.
2. Chọn một nhóm.
3. Nhấp vào Chọn.
Google Cloud tải tệp zip lên và trích xuất các tệp thành phần trong vùng chứa này. Sau đó, Cloud Functions sẽ sao chép các tệp thành phần vào Cloud Function.
Trong Tệp ZIP, hãy tải tệp zip mà bạn đã tải xuống từ GitHub, giải nén và nén lại lên:
1. Nhấp vào Duyệt xem.
2. Di chuyển đến tệp zip rồi chọn tệp này.
3. Nhấp vào Mở.
Nhấp vào Triển khai.

Trang Chi tiết về Cloud Functions sẽ mở ra và hàm của bạn sẽ xuất hiện cùng với 2 chỉ báo tiến trình: một cho bản dựng và một cho dịch vụ. Khi cả hai chỉ báo tiến trình đều biến mất và được thay thế bằng dấu kiểm, tức là hàm của bạn đã được triển khai và sẵn sàng.
Chỉnh sửa mã mẫu để đặt hằng số:
1. Trên trang Chi tiết về Cloud Function, hãy nhấp vào Chỉnh sửa.
2. Nhấp vào Tiếp theo.
3. Trong Source code (Mã nguồn), hãy chọn Inline editor (Trình chỉnh sửa nội tuyến).
4. Trong trình chỉnh sửa nội tuyến, hãy mở tệp env.js.
5. Thay thế project-id bằng mã dự án trên Cloud.
6. Không bắt buộc: Cập nhật us-central1 bằng vị trí được hỗ trợ cho Cloud Function của bạn.
Nhấp vào Triển khai.
Khi hàm triển khai xong, hãy sao chép URL của trình kích hoạt:
1. Trên trang Chi tiết về hàm, hãy nhấp vào Trình kích hoạt.
2. Sao chép URL. Bạn cần có mã này để định cấu hình ứng dụng Chat trong phần sau.

gcloud CLI

Sao chép mã nguồn trên GitHub:

git clone https://github.com/googleworkspace/google-chat-samples.git

Chuyển sang thư mục chứa mã cho ứng dụng Chat quản lý dự án này:
```
cd google-chat-samples/node/project-management-app
```
Chỉnh sửa tệp env.js để thiết lập các biến môi trường:
1. Thay project-id bằng mã dự án trên Google Cloud.
2. Thay thế us-central1 bằng vị trí dự án của bạn trên Google Cloud.

Triển khai Cloud Functions lên 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 Cloud Functions nơi lưu trữ cơ sở hạ tầng của vị trí đó, chẳng hạn như us-central1.

Khi hàm hoàn tất việc triển khai, hãy sao chép thuộc tính url từ phản hồi. Đây là URL kích hoạt mà bạn dùng trong phần 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 Chat API trong bảng điều khiển Google Cloud bằng thông tin về ứng dụng Chat của bạn, bao gồm tên ứng dụng Chat, các lệnh gạch chéo được hỗ trợ và URL kích hoạt của Cloud Function của ứng dụng Chat mà ứng dụng này gửi các sự kiện tương tác trên Chat đến.

Trong bảng điều khiển Google Cloud, 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.

Chuyển đến phần cấu hình Chat API
Trong phần 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 Mô tả, hãy nhập Manages projects with user stories.
Nhấp vào nút bật/tắt Bật các 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 Tham gia không gian và cuộc trò chuyện nhóm.
Trong phần Connection settings (Chế độ cài đặt kết nối), hãy chọn HTTP endpoint URL (URL điểm cuối HTTP).
Trong URL điểm cuối HTTP, hãy dán URL kích hoạt mà bạn đã sao chép từ việc triển khai Cloud Functions, được định dạng là https://REGION-PROJECT_ID.cloudfunctions.net/project-management-tutorial. Nếu bạn triển khai Cloud Functions bằng gcloud CLI, thì đây là thuộc tính url.

Đăng ký lệnh dấu gạch chéo của ứng dụng Chat. Cách đăng ký lệnh dấu gạch chéo:

Trong phần Lệnh, hãy nhấp vào Thêm lệnh.

Đối với mỗi lệnh gạch chéo được nêu chi tiết trong bảng sau, hãy nhập Tên, Mã lệnh, Nội dung mô tả và chọn xem lệnh gạch chéo có Mở hộp thoại hay không, rồi nhấp vào Xong:

Tên	Mã lệnh	Mô tả	Loại lệnh	Tên lệnh dấu gạch chéo	Mở hộp thoại
Tạo một câu chuyện người dùng	1	Tạo một câu chuyện có tiêu đề được chỉ định.	Lệnh dấu gạch chéo	`/createUserStory`	Đã bỏ chọn
Câu chuyện người dùng của tôi	2	Liệt kê tất cả các câu chuyện được chỉ định cho người dùng.	Lệnh dấu gạch chéo	`/myUserStories`	Đã bỏ chọn
Câu chuyện người dùng	3	Hiển thị trạng thái hiện tại của tin trong ngày được chỉ định.	Lệnh dấu gạch chéo	`/userStory`	Đã bỏ chọn
Quản lý câu chuyện người dùng	4	Mở một hộp thoại để chỉnh sửa tin.	Lệnh dấu gạch chéo	`/manageUserStories`	Đã chọn
Dọn dẹp câu chuyện người dùng	5	Xoá tất cả tin trong không gian.	Lệnh dấu gạch chéo	`/cleanupUserStories`	Đã 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 miền Workspace của bạn rồi nhập địa chỉ email của bạn.
Bạn cũng có thể chọn Ghi lỗi vào Logging trong phần 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 Chat đã sẵn sàng để kiểm thử.

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 này và sử dụng các lệnh gạch chéo của ứng dụng để tạo, chỉnh sửa và xoá các câu chuyện người dùng.

Mở Google Chat bằng tài khoản Google Workspace mà bạn đã cung cấp khi thêm chính mình làm người kiểm thử tin cậy.

Truy cập vào Google Chat
Nhấp vào biểu tượng Cuộc trò chuyện mới.
Trong trường Thêm một hoặc nhiều người, hãy nhập tên của ứng dụng Chat.
Chọn ứng dụng Chat trong kết quả. Một tin nhắn trực tiếp sẽ mở ra.

Lưu ý: Nếu bạn không thấy ứng dụng Chat trong danh sách kết quả, hãy đảm bảo rằng bạn đã thêm tài khoản Google Workspace vào chế độ cài đặt Chế độ hiển thị của trang Cấu hình Chat API trong Google Cloud Console.
Trong tin nhắn trực tiếp mới với ứng dụng, hãy nhập Hello rồi nhấn enter. Ứng dụng Chat quản lý dự án sẽ phản hồi bằng một trình đơn trợ giúp nêu chi tiết những việc mà ứng dụng này có thể làm.
Để tạo một câu chuyện, hãy nhập /createUserStory Test story vào thanh tin nhắn rồi gửi. Ứng dụng Chat quản lý dự án sẽ phản hồi bằng một thông báo dạng thẻ, trong đó nêu chi tiết câu chuyện người dùng mà ứng dụng tạo cho bạn bằng AI tạo sinh từ Vertex AI.
Trong bảng điều khiển, hãy kiểm tra cơ sở dữ liệu Firestore để xem xét các bản ghi mà cơ sở dữ liệu này đã tạo về không gian mà bạn đã thêm ứng dụng Chat vào, những người dùng đã tương tác với không gian đó và câu chuyện người dùng mà bạn đã tạo.

Chuyển đến Firestore
Quay lại Google Chat.

Truy cập vào Google Chat
Bạn có thể nhấp vào Chỉnh sửa để chỉnh sửa tin bài. 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 có dấu gạch chéo mà ứng dụng hỗ trợ. Để xem các lệnh 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 lệnh /cleanupUserStories. Hoặc xoá hoặc gỡ cài đặt ứng dụng. Khi bị xoá, ứng dụng sẽ xoá tất cả câu chuyện 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 thẻ trả về lỗi, giao diện Chat sẽ hiển thị thông báo "Đã 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 Chat không hiển thị bất kỳ thông báo lỗi nào, nhưng ứng dụng hoặc thẻ Chat lại 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, nhưng bạn có thể sử dụng thông báo lỗi mô tả và dữ liệu nhật ký để khắc phục lỗi khi bật tính năng ghi nhật ký lỗi cho ứng dụng Chat. Để được trợ giúp xem, gỡ lỗi và khắc phục lỗi, hãy xem bài viết Khắc phục lỗi trong Google Chat.

Dọn dẹp

Để tránh phát sinh phí cho tài khoản Google Cloud của bạn đối với các tài nguyên được dùng trong hướng dẫn này, bạn nên xoá dự án trên Cloud.

Thận trọng: Thao tác xoá dự án sẽ gây ra những tác động sau:

Mọi nội dung trong dự án sẽ bị xoá. Nếu đã dùng một dự án hiện có cho hướng dẫn này, thì khi xoá dự án đó, bạn cũng sẽ xoá mọi công việc khác mà bạn đã thực hiện trong dự án.
Mã dự án tuỳ chỉnh sẽ bị mất. Khi tạo dự án này, có thể bạn đã tạo một mã dự án tuỳ chỉnh mà bạn muốn sử dụng trong tương lai. Để giữ lại những URL sử dụng mã dự án (chẳng hạn như URL trên appspot.com), hãy xoá các tài nguyên đã chọn trong dự án thay vì xoá toàn bộ dự án.

Nếu bạn dự định khám phá nhiều hướng dẫn và hướng dẫn bắt đầu nhanh, thì việc sử dụng lại các dự án có thể giúp bạn tránh vượt quá hạn mức dự án.

Trong Google Cloud Console, hãy chuyển đến trang Quản lý tài nguyên. Nhấp vào Trình đơn > IAM và Quản trị viên > Quản lý tài nguyên.
Chuyển đến Resource Manager
Trong danh sách dự án, hãy chọn dự án bạn muốn xoá rồi nhấp vào biểu tượng Xoá .
Trong hộp thoại, hãy nhập mã dự án rồi nhấp vào Tắt để xoá dự án.

Quản lý dự án bằng Google Chat, Vertex AI và Firestore Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

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

Mục tiêu

Các sản phẩm được sử dụng

Kiến trúc

Chuẩn bị môi trường

Tạo một dự án trên Google Cloud

Bảng điều khiển Google Cloud

gcloud CLI

Bật tính năng thanh toán cho dự án trên Google Cloud

Bảng điều khiển Google Cloud

gcloud CLI

Bật các API

Bảng điều khiển Google Cloud

gcloud CLI

Xác thực và uỷ quyền

Tạo và triển khai ứng dụng Google Chat

Tạo cơ sở dữ liệu Firestore

Xem định nghĩa về bộ sưu tập, tài liệu và trường

spaces

userStories

users

Bảng điều khiển Google Cloud

gcloud CLI

Xem lại mã mẫu

Tạo và triển khai Cloud Functions

Bảng điều khiển Google Cloud

gcloud CLI

Định cấu hình ứng dụng Google Chat trong bảng điều khiển Google Cloud

Kiểm thử ứng dụng Chat

Khắc phục sự cố

Dọn dẹp

Chủ đề có liên quan

Quản lý dự án bằng Google Chat, Vertex AI và Firestore

`spaces`

`userStories`

`users`