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ể 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 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.

  • Khi bạn đề cập đến ứng dụng quản lý dự án, ứng dụng sẽ đưa ra lời trợ giúp.
    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.
  • Sử dụng lệnh dấu gạch chéo /createUserStory để tạo một câu chuyện.
    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.
  • Ứ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.
    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.
  • Charlie hoàn tất thông tin chi tiết về câu chuyện.
    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.
  • Quản lý tất cả câu chuyện người dùng của nhóm.
    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

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 do Vertex AI cung cấp:
    • Tạo và tạo lại nội dung mô tả cho Story.
    • 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 đượ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:

  • Chat API: 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, 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ả về 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 Cloud Functions để lưu trữ điểm cuối HTTP mà Chat gửi sự kiện tương tác đến và 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 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, 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 đó.
    • 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 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 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:

  1. 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.

  2. Chat 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.

  3. Ứ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 của người dùng.

  4. 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

  1. 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

  2. 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.

  3. Trong trường Vị trí, hãy nhấp vào Duyệt xem để 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.
  4. 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 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
  • 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 CLI gcloud.
    Để tạo dự án trên Cloud, hãy sử 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 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

  1. 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

  2. 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.
  3. 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.
  4. Nhấp vào Đặt tài khoản.

Giao diện dòng lệnh gcloud

  1. Để liệt kê các tài khoản thanh toán hiện có, hãy chạy: 
    gcloud billing accounts list
  2. Cách 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 trên Google Cloud.

Bật API

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

  1. 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

  2. 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.

  3. 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 gcloud

  1. 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 Project ID (Mã dự án) của dự án trên Google Cloud mà bạn đã tạo.

  2. 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:

  1. 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.
  2. Bạn có thể xem lại mã mẫu (không bắt buộc).
  3. 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.
  4. 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 đặt ngầm trong mã mẫu bằng các tệp model/user-story.js và model/user.js.

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 Mô hình dữ liệu Firestore.

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

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

Trường
Document IDString
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.
userStoriesSubcollection 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.
usersSubcollection of Documents (user)
Người dùng đã tạo hoặc được chỉ định tin bài.
displayNameString
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

Story do ứng dụng Chat và người dùng tạo.

Trường
Document IDString
Mã nhận dạng duy nhất của một câu chuyện cụ thể về người dùng do ứng dụng Chat và người dùng tạo ra.
assigneeDocument (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.
descriptionString
Nội dung mô tả tính năng phần mềm theo quan điểm của người dùng.
priorityEnum
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.
sizeEnum
Lượng công việc. Các giá trị có thể là Small, Medium hoặc Large.
statusEnum
Giai đoạn công việc. Các giá trị có thể là OPEN, STARTED hoặc COMPLETED.
titleString
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 IDString
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.
avatarUrlString
URL lưu trữ hình đại diện của người dùng trong Chat.
displayNameString
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

  1. 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

  2. Nhấp vào Tạo cơ sở dữ liệu.

  3. Trong phần Chọn chế độ Firestore, hãy nhấp vào Chế độ gốc.

  4. Nhấp vào Tiếp tục.

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

  6. Nhấp vào Tạo cơ sở dữ liệu.

Giao diện dòng lệnh 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 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

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 đến 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
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 ứng dụng chính. 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ẻ, lớp 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 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 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ề 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 bản sao của một đối tượng thẻ mà sau đó ứ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 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 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 trên đám mây sẽ xử lý sự kiện và trả về phản hồi cho Chat. Chat sẽ hiển thị phản hồi 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ó 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

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

    Tải tệp zip xuống

  2. 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.

  3. 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/

  4. Trong Google Cloud Console, hãy chuyển đến trang Cloud Functions:

    Chuyển đến Cloud Functions

    Đảm bảo bạn đã chọn dự án Google Cloud cho ứng dụng Chat.

  5. Nhấp vào Tạo hàm.

  6. Trên trang Tạo hàm, hãy thiết lập hàm:

    1. Trong Environment (Môi trường), hãy chọn Cloud Run Function (Hàm Cloud Run).
    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.

  7. Trong Thời gian chạy, hãy chọn Node.js 20.

  8. Trong Entry point (Điểm truy cập), hãy xoá văn bản mặc định rồi nhập projectManagementChatApp.

  9. Trong phần Source code (Mã nguồn), hãy chọn Zip upload (Tải tệp ZIP lên).

  10. Trong Destination bucket (Bộ chứa đích), hãy tạo 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.

  11. 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. Chuyển đến và chọn tệp zip.
    3. Nhấp vào Mở.

  12. Nhấp vào Triển khai.

    Trang Chi tiết về Chức năng trên đá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.

  13. Chỉnh sửa mã mẫu để đặt hằng số:

    1. Trên trang Chi tiết về hàm trên đá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.

  14. Nhấp vào Triển khai.

  15. 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.

Giao diện dòng lệnh gcloud

  1. Sao chép mã từ GitHub:

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

  2. 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

  3. Chỉnh sửa tệp env.js để đặt 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 Google Cloud của bạn.

  4. 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.

  1. 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 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.

  1. Trong Google Cloud Console, hãy nhấp vào Trình đơn > Các sản phẩm khác > Google Workspace > Thư viện sản phẩm > Google Chat API > Quản lý > Cấu hình.

    Chuyển đến phần cấu hình Chat API

  2. Trong App name (Tên ứng dụng), hãy nhập Project Manager.

  3. Trong URL hình đại diện, hãy nhập https://developers.google.com/chat/images/quickstart-app-avatar.png.

  4. Trong mục Mô tả, hãy nhập Manages projects with user stories.

  5. 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.

  6. 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.

  7. Trong phần Cài đặt kết nối, hãy chọn URL điểm cuối HTTP.

  8. Trong 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.

  9. Đă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:

    1. 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.

    2. Đố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 trong không gian. Đã bỏ chọn

  10. 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 rồi nhập địa chỉ email của bạn.

  11. Trong phần Nhật ký, bạn có thể chọn Ghi lỗi vào nhật ký.

  12. Nhấp vào Lưu. Một thông báo cấu hình đã lưu sẽ xuất hiện, nghĩa 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 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.

  1. 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

  2. Nhấp vào Cuộc trò chuyện mới.
  3. Trong trường Thêm 1 người trở lên, hãy nhập tên của ứng dụng Chat.

  4. Chọn ứng dụng Chat trong kết quả. Một tin nhắn trực tiếp sẽ mở ra.

  5. 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.
  6. Để tạo một câu chuyện, hãy nhập /createUserStory Test story vào thanh thông báo rồi gử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.

  7. 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

  8. Quay lại Google Chat.

    Chuyển đến Google Chat

  9. 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.
  10. 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.
  11. 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. Ngoài ra, bạn có thể xoá hoặc gỡ cài đặt ứng dụng. Khi bị xoá, ứng dụng sẽ xoá tất cả các câu chuyện do người dùng 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 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à khắc phục lỗi, hãy xem bài viết Khắc phục sự cố và khắc phục lỗi trong 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 Google Cloud.

  1. 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ị > Quản lý tài nguyên.

    Chuyển đến Trình quản lý tài nguyên

  2. 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á .
  3. 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.