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

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

Phần hướng dẫn này chỉ cho bạn cách tạo một ứng dụng Google Chat mà một 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 của người dùng (đại diện cho các tính năng của hệ thống phần mềm từ góc nhìn của người dùng để nhóm phát triển) và lưu trữ 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 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ẽ đề nghị trợ giúp.
Hình 2. Bằng cách sử dụng lệnh dấu gạch chéo /createUserStory, Charlie 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 về 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. 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 dấu gạch chéo /manageUserStories.

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

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

Mục tiêu

Xây dựng 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 của người dùng bằng các công cụ viết truyện dựa trên AI tạo sinh dựa trên 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 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à đọc từ cơ sở dữ liệu Firestore.
Hỗ trợ hoạt động 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 câu chuyện 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 sản phẩm sau đây của Google Workspace và Google Cloud:

API Chat: API để phát triển những ứng dụng Google Chat có chức năng 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. Quản lý dự án Ứng dụng Google Chat dùng API Chat để 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 nội dung hiển thị trong Chat, chẳng hạn như tên và hình đại diện.
Vertex AI API: Một nền tảng AI tạo sinh. Ứng dụng Google Chat quản lý dự án sử dụng API Vertex AI để viết tiêu đề và nội dung mô tả 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 của người dùng.
Chức năng đám mây: 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, mục đích duy nhất và có thể phản hồi các sự kiện tương tác trong 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 Chức năng đám mây để lưu trữ điểm cuối HTTP mà Chat gửi sự kiện tương tác đến và dưới dạng nền tảng tính 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à lưu trữ tài nguyên điện toán:
- Cloud Build: Một nền tảng tích hợp, phân phối và triển khai liên tục được quản lý toàn diệ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ó thể mở rộng, giúp tách biệt các dịch vụ tạo tin nhắn với các dịch vụ xử lý tin nhắn đó.
- API Quản trị của Cloud Run: Một môi trường được quản lý hoàn toàn để chạy các ứng dụng trong vùng chứa.

Kiến trúc

Cấu trúc ứng dụng Google Chat quản lý dự án tiếp 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 của người dùng trong cơ sở dữ liệu Firestore. Sơ đồ sau đây cho thấy cấu trúc của các tài nguyên Google Workspace và Google Cloud được sử dụng.

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

Ứ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 ứng dụng Google Chat quản lý dự án bằng cách nhắn tin trực tiếp cho ứng dụng đó, đề cập đến ứng dụng trong không gian 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 của Hàm đám mây.
Ứ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 của người dùng.
Cloud Functions trả về phản hồi HTTP cho Chat để hiển thị phản hồi đó cho 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ị viên > Tạo dự án.
Chuyển đến trang Create a Project (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. 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ã đáp ứng nhu cầu của bạn trong suốt thời gian hoạt động của dự án.
Trong trường Location (Vị trí), hãy nhấp vào Browse (Duyệt qua) để hiển thị các vị trí tiềm năng cho dự án của bạn. Sau đó nhấp vào Chọn.
Thận trọng: Bạn không tìm được tổ chức Google Workspace của mình?
Đ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 các 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 của Google Cloud sẽ chuyển bạ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

Ở một trong các môi trường phát triển sau đây, 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 (Môi trường shell cục bộ): Để sử dụng môi trường phát triển cục bộ, hãy cài đặt và khởi chạy gcloud CLI.
Để tạo một dự án trên Google 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 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 Actions (Thao tác) (), nhấp vào Change billing (Thay đổi thông tin thanh toán) rồi chọn tài khoản Cloud Billing.
Nhấp vào Đặt 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:
```
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 Google Cloud 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 các API

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

Trong bảng điều khiển của Google Cloud, hãy bật API Google Chat, Vertex AI API, Cloud Functions API, Firestore API, Cloud Build API, Pub/Sub API và Cloud Run Admin API.

Bật API
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 Google Cloud mà bạn đã tạo.
Bật API Google Chat, 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ị Cloud Build, Pub/Sub và Cloud Run là các điều kiện tiên quyết của Hàm trên đám mây.

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

Không cần cấu hình xác thực và uỷ quyền để làm theo hướng dẫn này.

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

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 xây dựng và triển khai ứng dụng Google Chat. Trong phần này, bạn có thể thực hiện những việc 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 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 ứ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 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 các tệp model/user-story.js và model/user.js đặt ngầm trong mã mẫu.

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 bộ sưu tập. Để tìm hiểu thêm, hãy xem bài viết Khôi phục mô hình dữ liệu.

Sơ đồ dưới đâ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 tin bài. Mỗi câu chuyện người dùng được biểu thị bằng một tài liệu trong bộ sưu tập con userStories và mỗi người dùng được biểu thị bằng một tài liệu trong bộ sưu tập con users.

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

`spaces`

Không gian mà ứng dụng Chat đã tạo tin stories.

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 stories. Tương ứng với tên tài nguyên của không gian trong API Chat.
`userStories`	`Subcollection of Documents (userStories)` 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 `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` 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` 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 công việc. Các giá trị có thể là `OPEN`, `STARTED` hoặc `COMPLETED`.
`title`	`String` Tiêu đề 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 chỉ định tin bài.

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 vào biểu tượng 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, 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 Hàm trên đám mây trong ứ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 một Vùng khôi phục dữ liệu, chẳng hạn như us-central1.

Xem lại mã mẫu

Không bắt buộc, trước khi tạo Hàm trên đá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.

Xem trên GitHub

Dưới đâ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 cho 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 và phần phụ thuộc của dự án Node.js.
index.js: Điểm truy cập cho Hàm trên đám mây của ứng dụng Chat. Phương thức này đọc sự kiện Chat 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 chính của ứng dụng. Xử lý các sự kiện tương tác bằng cách xử lý các lệnh đề cập và dấu gạch chéo của ứng dụng Chat. Để 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ý Sự kiện tương tác trò chuyện nhấp vào thẻ.
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ý các 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ặc app-action-handler.js. Để thực hiện các thao tác cơ sở dữ liệu, các hàm trong các 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 với cơ sở dữ liệu. Các hàm trong tệp này được gọi bằng 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 dựa trên 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à dịch vụ ứng dụng sử dụng để lưu trữ và truyền dữ liệu giữa các hàm. Các lớp này 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 tạo thực thể cho một đối tượng thẻ mà sau đó ứng dụng Chat gửi lại cho Chat dưới dạng thông báo thẻ hoặc phản hồi thao tác hộp thoại.
views/widgets/*.js: Mỗi tệp sẽ tạo thực thể cho một loại đối tượng 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 thư mục này chứa các chương trình kiểm thử đơn vị cho hàm, trình điều khiển, dịch vụ, thành phần hiển thị hoặc tiện ích tương ứng. Bạn có thể thực thi tất cả chương trình 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 Chức năng trên đám mây

Trong phần này, bạn sẽ tạo và triển khai một Hàm trên đá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 yêu cầu HTTP từ Chat có chứa sự kiện tương tác trong Chat. Khi chạy, mã Hàm đám mây sẽ xử lý sự kiện và trả về một phản hồi cho Chat mà Chat hiển thị dưới dạng tin nhắn, hộp thoại hoặc loại tương tác khác của người dùng. Nếu có thể, Hàm trên đám mây cũng sẽ đọc từ hoặc ghi vào cơ sở dữ liệu Firestore.

Dưới đây là cách tạo Hàm trên đám mây:

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 đã trích xuất chứa toàn bộ kho lưu trữ các mẫu trên 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 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

Hãy đảm bảo rằng bạn đã chọn dự án Google Cloud cho ứng dụng Chat.
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:
1. Trong mục Môi trường, hãy chọn Chức năng chạy Cloud.
2. Trong Function name (Tên hàm), hãy nhập project-management-tutorial.
3. Trong mục 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 các lệnh gọi chưa 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 Entry point (Đ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, hãy create hoặc chọn một bộ chứa:
1. Nhấp vào Duyệt xem.
2. Chọn một bộ chứa.
3. 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 sẽ sao chép các tệp thành phần vào Cloud Function.
Trong mục 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 và chọn tệp zip.
3. 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ùng với hai chỉ báo tiến trình: một chỉ báo cho bản dựng và một chỉ báo cho 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, 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ề Chức năng đám mây, hãy nhấp vào Chỉnh sửa.
2. Nhấp vào Tiếp theo.
3. Trong Mã nguồn, chọn Trình chỉnh sửa cùng dòng.
4. Trong trình chỉnh sửa cùng dòng, hãy mở tệp env.js.
5. Thay thế project-id bằng mã dự án trên Cloud của bạn.
6. Không bắt buộc: Cập nhật us-central1 bằng một vị trí được hỗ trợ cho Hàm đám mây 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 điều kiện kích hoạt:
1. 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.
2. Sao chép URL. Bạn cần mã này để đị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 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 để đặt các biến môi trường:
1. Thay thế project-id bằng mã dự án trên Google Cloud.
2. Thay thế us-central1 bằng vị trí dự án trên Google Cloud.

Triển khai Hàm trên đá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 Cloud, nơi lưu trữ cơ sở hạ tầng, chẳng hạn như us-central1.

Khi hàm hoàn tất quá trình triển khai, hãy sao chép thuộc tính url từ phản hồi. Đây là URL điều kiện kích hoạt mà bạn sử 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 cho biết cách định cấu hình API Chat 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 cả tên ứng dụng Chat, lệnh dấu gạch chéo được hỗ trợ và URL kích hoạt của Hàm đám mây của ứng dụng Chat mà API này gửi sự kiện tương tác đến.

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.

Chuyển đến phần cấu hình API Chat
Trong App name (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 phần Connection settings (Cài đặt kết nối), hãy chọn HTTP cuối URL (URL điểm cuối HTTP).
Trong URL điểm cuối HTTP, hãy dán URL điều kiện kích hoạt mà bạn đã sao chép trong quá trình triển khai Chức năng đám mây, 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à 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ệnhlash, hãy nhấp vào Thêm lệnh dấu gạch chéo.

Đố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, 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ở 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 miền Workspace của bạn rồi nhập địa chỉ email của bạn.
Trong phần Nhật ký, bạn có thể chọn Ghi lỗi vào tính năng Ghi nhật ký.
Nhấp vào Lưu. Một thông báo đã lưu cấu hình sẽ xuất hiện, tức là ứng dụng Chat đã 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 và 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 đã cung cấp khi thêm chính mình làm người kiểm thử đáng tin cậy.

Truy cập Google Chat
Nhấp vào Cuộc trò chuyện mới.
Trong trường Thêm 1 người trở lên, hãy nhập tên của ứng dụng Chat.
Chọn ứng dụng Chat của bạn 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 của mình trong danh sách kết quả, hãy đảm bảo rằng bạn đã đưa tài khoản Google Workspace của mình vào phần cài đặt Chế độ hiển thị của trang Cấu hình API Chat trong bảng điều khiển Google Cloud.
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 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 story, hãy nhập /createUserStory Test story vào thanh tin nhắn rồi gửi đi. Ứng dụng Chat quản lý dự án phản hồi bằng một thông báo dạng thẻ, trong đó nêu chi tiết về câu chuyện người dùng mà ứng dụng 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 lại 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, 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.

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

Truy cập Google Chat
Nếu muốn chỉnh sửa tin bài, hãy nhấp vào Chỉnh sửa. Khi bạn hài lòng với tin bài, 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 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 kiểm thử bằng cách sử dụng lệnh dấu gạch chéo /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 của người dùng được tạo trong không gian đó.

Khắc phục sự cố

Khi ứ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 của Chat không hiển thị thông báo lỗi nào, nhưng ứng dụng hoặc thẻ Chat lại cho 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 hiển thị trong giao diện người dùng Chat, nhưng bạn có thể xem 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à sửa lỗi, hãy xem bài viết Khắc phục sự cố và sửa lỗi Google Chat.

Dọn dẹp

Để tránh bị tính phí vào tài khoản Google Cloud cho những tài nguyên dùng trong hướng dẫn này, bạn nên xoá dự án Google Cloud đó.

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

Mọi thứ trong dự án sẽ bị xoá. Nếu bạn đã sử dụng một dự án hiện có cho phần 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 đã thực hiện trong dự án.
Mã dự án tuỳ chỉnh bị mất. Khi tạo dự án này, bạn có thể đã tạo một mã dự án tuỳ chỉnh mà bạn muốn sử dụng sau này. Để giữ lại các 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 bê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à các bước bắt đầu nhanh, 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 của dự án.

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ị viên > Quản lý tài nguyên.
Chuyển đến Trình quản lý tài nguyên
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 Shut down (Tắt) để xoá dự án.

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

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

Mục tiêu

Sản phẩm đã 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 bộ sưu tập, tài liệu và định nghĩa các trường

spaces

userStories

users

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

Giao diện dòng lệnh (CLI) của gcloud

Xem lại mã mẫu

Tạo và triển khai Chức năng trên đám mây

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

Giao diện dòng lệnh (CLI) của gcloud

Đị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

`spaces`

`userStories`

`users`