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 người dùng (đại diện cho các tính năng của hệ thống phần mềm từ quan điểm của người dùng để nhóm phát triển) và lưu 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 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. Vì vậy, 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 chỉ định câu chuyện cho chính mình, đặt trạng thái thành đã 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.
Quyền truy cập vào các dịch vụ của Google Cloud để làm 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 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 Hàm Google Cloud chưa xác thực. Bạn có thể xác minh lệnh gọi này bằng cách xác định xem tổ chức Google Cloud của bạn có sử dụng tính năng chia sẻ có giới hạn về 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, 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

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 câu chuyện tạo sinh có sự hỗ trợ của AI, 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 nội dung 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à đọc từ cơ sở dữ liệu Firestore.
Hỗ trợ 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, chỉ định và bắt đầu tin bài ngay trong 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. Ứ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, cũng như để đị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: 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: Một cơ sở dữ liệu tài liệu không có 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.
Cloud Functions: Một dịch vụ điện toán không máy chủ có trọng lượng 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 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 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: 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 các dịch vụ tạo thông điệp từ các dịch vụ xử lý các thông báo đó.
- Cloud Run Admin API: Một môi trường được quản lý đầy đủ để chạy các ứng dụng được đóng gói 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 gửi tin nhắn trực tiếp, đề cập đến ứng dụng đó trong một không gian hoặc nhập lệnh dấu gạch chéo.
Tính năng trò chuyện sẽ gửi một yêu cầu HTTP đồng bộ đến điểm cuối HTTP của Hàm trên đám mây.
Ứng dụng Google Chat quản lý dự án 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 một tin nhắn 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 dự án trên Google Cloud

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

Trong Google Cloud Console, hãy chuyển đến Trình đơn > Quản trị viên và IAM > Tạo dự án.
Chuyển đến phần 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 đó, hãy nhấp vào Chọn.
Thận trọng: Không tìm thấy tổ chức Google Workspace của bạn?
Đ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. Google Cloud Console 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 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 biểu tượng 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 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ế nội dung 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 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 Vertex AI, API Cloud Functions, API Firestore, API Cloud Build, API Pub/Sub và API Quản trị Cloud Run.

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, API Vertex AI, API Cloud Functions, API Firestore, API Cloud Build, API Pub/Sub và API quản trị 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à 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

Bạn không cần phải định 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 xác thực 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 Hàm trên đá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

Giờ đây, khi dự án Google Cloud đã được tạo và định cấu hình, 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ẽ làm như 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 trên đám mây để lưu trữ và chạy mã của ứng dụng Chat nhằm 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 một cơ sở dữ liệu Firestore để lưu trữ và truy xuất các câu chuyện của người dùng, nhưng 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 ứ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.

Biểu đồ sau đây là thông tin tổng quan về mô hình dữ liệu của ứng dụng Google Chat trong việc 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 stories. 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`

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 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 chỉ định tin bài.
`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 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 API Chat.
`description`	`String` Nội dung mô tả 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 làm 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 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 Google Cloud Console, 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.

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

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ý sự kiện tương tác bằng cách xử lý các lệnh 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ẻ, hàm 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 Chat.
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 với cơ sở dữ liệu, các hàm trong những tệp này sẽ gọi 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 API Vertex AI để 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ề 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. 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 bản sao của một đối tượng thẻ mà ứng dụng Chat sẽ gửi lại cho Chat dưới dạng thông báo thẻ hoặc phản hồi hành động trong hộp thoại.
views/widgets/*.js: Mỗi tệp tạo bản sao cho một loại đối tượng tiện ích mà ứng dụng sử 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 đó chứa các bài kiểm thử đơn vị cho chức năng, 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ả 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 trên đám mây chạy để phản hồi một yêu cầu HTTP từ Chat chứa một sự kiện tương tác trên 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ã từ GitHub xuống 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ữ 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 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 bảng điều khiển Google Cloud, hãy truy cập vào 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 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 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 phần Mã nguồn, hãy chọn Tải tệp ZIP lên.
Trong Destination bucket (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 sẽ tải tệp zip lên và trích xuất 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 hàm trên đám mây.
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 Source code (Mã nguồn), hãy chọn Inline editor (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 project-id bằng mã dự án trên Google Cloud.
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 trên đám mây.
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 Chi tiết hàm, hãy nhấp vào Trình 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.

gcloud CLI

Sao chép mã 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 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 Google Cloud của bạn.

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 một vị trí Chức năng trên đám mây nơi lưu trữ cơ sở hạ tầng của hàm, 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 của đ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 Google Cloud Console

Phần này cho biết 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, 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 Hàm trên đám mây của ứng dụng Chat mà ứng dụng này gửi sự kiện tương tác trên 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.

Chuyển đến phần cấu hình Chat API
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 mục 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 Cài đặt kết nối, hãy chọn URL điểm cuối HTTP.
Trong HTTP endpoint URL (URL điểm cuối HTTP), hãy dán URL của điều kiện kích hoạt mà bạn đã sao chép từ quá trình triển khai Hàm trên đám mây, được định dạng là https://REGION-PROJECT_ID.cloudfunctions.net/project-management-tutorial. Nếu bạn triển khai Hàm trên đá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ệnh dấu gạch chéo, 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ả các câu chuyện được 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 câu chuyện đã chỉ định.	Đã bỏ chọn
`/manageUserStories`	4	Mở một hộp thoại để chỉnh sửa 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 một số người và nhóm 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 gửi tin nhắn cho ứng dụng đó và sử dụng các lệnh 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.

Chuyển đến Google Chat
Nhấp vào Cuộc trò chuyện mới.
Trong trường Thêm 1 hoặc nhiều người, hãy nhập tên ứng dụng của bạn trong 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 API Chat 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 phản hồi bằng một trình đơn trợ giúp nêu chi tiết những việc ứ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. Quản lý dự án Ứng dụng Chat trả lờ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 nhờ 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.

Chuyển đến 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 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 đưa ra lệnh 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 Chat không hiển thị thông báo lỗi nào, nhưng ứng dụng Chat hoặc thẻ 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 của Chat, nhưng chúng tôi cung cấp dữ liệu nhật ký và thông báo lỗi mô tả để giúp bạn khắc phục lỗi khi bật tính năng ghi nhật ký lỗi cho các ứng dụng trong 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 và khắc phục lỗi Google Chat.

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 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 đã sử 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 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 Google Cloud Console, 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 dự án trên Google Cloud

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

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

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 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 Chức năng trên đám mây

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

gcloud CLI

Định cấu hình ứng dụng Google Chat trong Google Cloud Console

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`