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

Hướng dẫn này trình bày cách tạo một ứng dụng Google Chat mà một nhóm có thể sử dụng để quản lý dự án theo thời gian thực. Ứng dụng Chat sử dụng Vertex AI giúp các nhóm viết câu chuyện của người dùng (thể hiện các tính năng của hệ thống phần mềm từ quan điểm của một người dùng để nhóm phát triển) và duy trì các câu chuyện trong cơ sở dữ liệu Firestore.

  • Việc đề cập đến ứng dụng quản lý dự án sẽ nhắc ứng dụng trợ giúp.
    Hình 1. Charlie thảo luận với nhóm về việc phát triển tính năng trong phòng Chat. Khi bạn đề cập đến quản lý dự án, ứng dụng Chat sẽ nhắc ứng dụng Chat hỗ trợ.
  • Sử dụng lệnh dấu gạch chéo /createUserStory để tạo câu chuyện.
    Hình 2. Bằng cách sử dụng lệnh dấu gạch chéo /createUserStory, Charlie sẽ tạo một câu chuyện.
  • Ứ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 của câu chuyện. Nội dung mô tả của AI là chính xác, nhưng Charlie muốn biết thêm thông tin chi tiết nên Charlie nhấp vào Mở rộng để yêu cầu Vertex AI thêm các yêu cầu vào nội dung mô tả câu chuyện. Charlie tự giao 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.
  • Quản lý tất cả câu chuyện người dùng của nhóm.
    Hình 5. Charlie có thể xem và quản lý tất cả câu chuyện người dùng của nhóm bất cứ lúc nào bằng lệnh dấu gạch chéo /manageUserStories.

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

Mục tiêu

  • Xây dựng một ứng dụng Chat quản lý phần mềm linh hoạt dự án.
  • Giúp người dùng viết câu chuyện của người dùng bằng công nghệ tạo sinh Các công cụ viết truyện có sử dụng AI và sử dụng công nghệ của Vertex AI:
    • Tạo và tạo lại nội dung mô tả câu chuyện.
    • Mở rộng phần mô tả tin bài từ phần ghi chú để hoàn thành các yêu cầu.
    • Sửa ngữ pháp để sửa lỗi chính tả.
  • Luôn cập nhật công việc bằng cách ghi và đọc từ cơ sở dữ liệu Firestore.
  • Hỗ trợ cộng tác trong phòng Chat bằng cách cho phép người dùng tạo, chỉnh sửa, giao và bắt đầu tin bài ngay từ cuộc trò chuyện.

Sản phẩm đã sử dụng

Ứng dụng quản lý dự án sử dụng các dịch vụ Google Workspace và Các sản phẩm của Google Cloud:

  • API Chat: API để phát triển những ứng dụng Google Chat có khả năng nhận và phản hồi Sự kiện tương tác trong cuộc trò chuyện, chẳng hạn như tin nhắn. Quản lý dự án Ứng dụng Google Chat dùng API Chat để nhận và trả lời các sự kiện tương tác do Chat gửi và để định cấu hình các thuộc tính xác định cách bài đăng đó xuất hiện trong Chat, chẳng hạn như tên và hình đại diện.
  • API Vertex AI: Một nền tảng AI tạo sinh. Quản lý dự án Ứng dụng Google Chat sử dụng Vertex AI API để viết câu chuyện của người dùng tiêu đề và nội dung mô tả.
  • Khôi phục: Cơ sở dữ liệu tài liệu không máy chủ. Quản lý dự án Ứng dụng Google Chat sử dụng Firebase để lưu trữ dữ liệu về câu chuyện của người dùng.
  • Chức năng đám mây: Dịch vụ điện toán không máy chủ nhẹ cho phép bạn tạo Các chức năng độc lập, mục đích duy nhất có thể phản hồi Chat các sự kiện tương tác mà không cần quản lý máy chủ hoặc môi trường thời gian chạy. Chiến lược phát hành đĩa đơn quản lý dự án Ứng dụng Google Chat sử dụng Cloud Functions để lưu trữ điểm cuối HTTP mà Chat gửi các sự kiện tương tác đến và dưới dạng một nền tảng điện toán để chạy logic xử lý và phản hồi các sự kiện này.

    Cloud Functions sử dụng các sản phẩm sau đây của Google Cloud để xây dựng, xử lý các sự kiện tương tác và tài nguyên điện toán trên máy chủ lưu trữ:

    • Cloud Build: Một nền tảng triển khai, phân phối và tích hợp liên tục được quản lý toàn diện chạy các bản dựng tự động.
    • Pub/Sub: Dịch vụ nhắn tin không đồng bộ và có thể mở rộng giúp tách các dịch vụ tạo tin nhắn từ các dịch vụ xử lý những tin nhắn đó.
    • API Quản trị của Cloud Run: Môi trường được quản lý toàn diện để chạy các ứng dụng trong vùng chứa.

Kiến trúc

Cấu trúc ứng dụng Google Chat quản lý dự án nhận và xử lý các sự kiện tương tác trong Chat tại một điểm cuối HTTP, sử dụng Vertex AI để giúp viết câu chuyện của người dùng và lưu trữ thông tin chi tiết về câu chuyện người dùng trong cơ sở dữ liệu Firestore. Chiến lược phát hành đĩa đơn sơ đồ dưới đây thể hiện cấu trúc của Google Workspace và Tài nguyên Google Cloud đã sử dụng.

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 quản lý dự án ứng dụng Google Chat bằng cách gửi tin nhắn cho ứng dụng trực tiếp, đề cập đến câu lệnh trong dấu cách hoặc nhập lệnh dấu gạch chéo.

  2. Chat gửi yêu cầu HTTP đồng bộ đến Điểm cuối HTTP.

  3. Ứng dụng Google Chat quản lý dự án sẽ xử lý HTTP yêu cầu:

    1. Vertex AI giúp bạn viết hoặc cập nhật câu chuyện của người dùng.

    2. Cơ sở dữ liệu Firestore lưu trữ, truy xuất, cập nhật hoặc xoá câu chuyện người dùng .

  4. Cloud Functions trả về phản hồi HTTP cho Chat hiển thị thông báo với người dùng dưới dạng thông báo hoặc hộp thoại.

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

Phần này trình bày cách tạo và định cấu hình dự án 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

  1. Trong bảng điều khiển Google Cloud, hãy chuyển đến Trình đơn > IAM và Quản trị > Tạo dự án.

    Chuyển đến trang Create a Project (Tạo dự án)

  2. Trong trường Tên dự án, hãy nhập tên mô tả cho dự án của bạn.

    Không bắt buộc: Để chỉnh sửa Mã dự án, hãy nhấp vào Chỉnh sửa. Không thể thay đổi mã dự án sau khi tạo dự án, vì vậy, hãy chọn một mã đáp ứng nhu cầu của bạn trong suốt thời gian dự án.

  3. Trong trường Vị trí, hãy nhấp vào Duyệt qua để hiển thị các vị trí tiềm năng cho dự án. Sau đó nhấp vào Chọn.
  4. Nhấp vào Tạo. Bảng điều khiển Google Cloud sẽ chuyển đến trang Trang tổng quan và dự án của bạn sẽ được tạo trong vòng vài phút.

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

Truy cập vào Google Cloud ở một trong các môi trường phát triển sau đây CLI (`gcloud`):

  • Cloud Shell: Để sử dụng thiết bị đầu cuối trực tuyến với gcloud CLI đã thiết lập, hãy kích hoạt Cloud Shell.
    Kích hoạt Cloud Shell
  • Local Shell: Để sử dụng môi trường phát triển cục bộ, cài đặtkhởi động giao diện dòng lệnh (CLI) của gcloud.
    Để tạo một dự án trên đám mây, hãy dùng lệnh "gcloud Projects create":
    gcloud projects create PROJECT_ID
    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

  1. Trong bảng điều khiển Google Cloud, hãy chuyển đến phần Thanh toán. Nhấp chuột Thực đơn > Thanh toán > Dự án của tôi.

    Chuyển đến phần Thanh toán cho dự án của tôi

  2. 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.
  3. Trong hàng dự án, hãy mở trình đơn Hành động (), hãy nhấp vào Thay đổi thông tin thanh toán rồi chọn Tài khoản thanh toán Cloud.
  4. Nhấp vào Đặt tài khoản.

Giao diện dòng lệnh (CLI) của 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. 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_IDMã dự án của Dự án trên đám mây mà bạn muốn bật tính năng thanh toán.
    • BILLING_ACCOUNT_IDmã tài khoản thanh toán để liên kết dự án Google Cloud.

Bật các API

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

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

    Bật API

  2. Xác nhận rằng bạn đang bật các API theo đúng cách Dự án trên đám mây, rồi nhấp vào Tiếp theo.

  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 (CLI) của gcloud

  1. Nếu cần, hãy đặt dự án hiện tại trên Google Cloud thành dự án bạn được tạo bằng lệnh gcloud config set project:

    gcloud config set project PROJECT_ID
    

    Thay thế PROJECT_ID bằng Mã dự án của Dự án trên đám mây mà bạn đã tạo.

  2. Bật API Google Chat, Vertex AI API, Cloud Functions API API Firestore, API Cloud Build, API Pub/Sub và API Quản trị của Cloud Run bằng lệnh gcloud services enable:

    gcloud services enable chat.googleapis.com \
    aiplatform.googleapis.com \
    cloudfunctions.googleapis.com \
    firestore.googleapis.com \
    cloudbuild.googleapis.com \
    pubsub.googleapis.com \
    run.googleapis.com
    

    API Quản trị Cloud Build, Pub/Sub và Cloud Run là điều kiện tiên quyết để Chức năng đám mây.

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

Không cần định cấu hình xác thực và uỷ quyền để tuân thủ của chúng tôi.

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

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

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

  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. Nếu muốn, hãy xem lại mã mẫu.
  3. Tạo một Hàm đám mây để lưu trữ và chạy Mã của ứng dụng Chat để phản hồi sự kiện nhận được từ Chat dưới dạng yêu cầu HTTP.
  4. Tạo và triển khai ứng dụng Google Chat trên API Google Chat .

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

Trong phần này, bạn sẽ tạo một cơ sở dữ liệu Firestore để lưu trữ và truy xuất câu chuyện của người dùng, nhưng bạn không xác định mô hình dữ liệu. Mô hình dữ liệu đã được đặt ngầm ẩn trong mã mẫu bằng cách sử dụng model/user-story.jsmodel/user.js tệp.

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

Biểu đồ dưới đây là tổng quan về hoạt động quản lý dự án Mô hình dữ liệu của ứng dụng Google Chat:

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

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

spaces

Các không gian mà ứng dụng Chat đã tạo tin bài trong đó.

Trường
Document IDString
Mã nhận dạng duy nhất của một không gian cụ thể nơi tạo tin bài. Tương ứng với tên tài nguyên của không gian trong API Chat.
userStoriesSubcollection of Documents (userStories)
Các câu chuyện do ứng dụng Chat và người dùng ứng dụng tạo ra. Tương ứng với Document ID của userStories trong Firebase.
usersSubcollection of Documents (user)
Người dùng đã tạo hoặc được giao câu chuyện.
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

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

Trường
Document IDString
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.
assigneeDocument (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.
descriptionString
Nội dung mô tả tính năng phần mềm từ góc nhìn của người dùng.
priorityEnum
Tính cấp bách khi hoàn thành công việc. Các giá trị có thể là Low, Medium hoặc High.
sizeEnum
Khối lượng công việc. Các giá trị có thể là Small, Medium hoặc Large.
statusEnum
Giai đoạn làm việc. Các giá trị có thể là OPEN, STARTED hoặc COMPLETED.
titleString
Tiêu đề câu chuyện; bản tóm tắt ngắn gọn.

users

Những người dùng đã tạo hoặc được giao câu chuyện.

Trường
Document 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 bảng điều khiển Google Cloud, hãy chuyển đến Firestore. Nhấp chuột Thực đơ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(default).

    2. Trong mục Loại vị trí, hãy chỉ định một khu vực cho cơ sở dữ liệu của bạn, chẳng hạn như us-central1. Để có hiệu suất tốt nhất, hãy chọn cùng một vị trí hoặc lân cận vị trí làm Chức năng đám mây của ứng dụng Chat.

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

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

  • Tạo cơ sở dữ liệu Firestore ở chế độ Gốc bằng Lệnh gcloud firestore databases create:

    gcloud firestore databases create \
    --location=LOCATION \
    --type=firestore-native
    

    Thay thế LOCATION bằng tên của Firestore khu vực, chẳng hạn như dưới tên us-central1.

Xem lại mã mẫu

Trước khi tạo Chức năng đám mây, hãy dành chút thời gian để xem lại và làm quen với mã mẫu được lưu trữ trên GitHub.

Xem trên GitHub

Dưới đây là tổng quan về từng tệp:

env.js
Biến cấu hình môi trường để triển khai Ứng dụng trong Chat với một dự án cụ thể trên Google Cloud và . Bạn phải cập nhật các biến cấu hình trong tệp này.
package.jsonpackage-lock.json
Chế độ cài đặt và phần phụ thuộc của dự án Node.js.
index.js
Điểm truy cập cho Chức năng đám mây của ứng dụng Chat. Nó đọc Sự kiện trò chuyện từ yêu cầu HTTP, gọi trình xử lý ứng dụng và đăng phản hồi HTTP dưới dạng một Đối tượng JSON.
controllers/app.js
Logic chính của ứng dụng. Xử lý sự kiện tương tác bằng cách xử lý Ứng dụng Chat đề cập và dấu gạch chéo. Để phản hồi các lượt nhấp vào thẻ, hàm này sẽ gọi app-action-handler.js.
controllers/app-action-handler.js
Logic ứng dụng để xử lý thao tác nhấp vào thẻ Sự kiện tương tác trò chuyện.
services/space-service.js, services/user-service.jsservices/user-story-service.js
Các tệp này chứa các phần của logic ứng dụng dành riêng cho việc xử lý phòng Chat, người dùng và câu chuyện của người dùng. Các hàm trong các tệp này được gọi bằng app.js hoặ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 các tệp này 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ởi services/space-service.js, services/user-service.jsservices/user-story-service.js.
services/aip-service.js
Gọi Vertex AI API để lấy văn bản AI tạo sinh .
model/*.js
Các tệp này chứa định nghĩa lớp và enum mà ứng dụng các dịch vụ dùng để lưu trữ và truyền dữ liệu giữa các hàm. Họ thiết lập mô hình dữ liệu cho cơ sở dữ liệu Firestore.
views/*.js
Mỗi tệp trong thư mục này sẽ tạo thực thể một đối tượng thẻ mà thuộc tính Sau đó, ứng dụng Chat gửi lại Chat dưới dạng thông báo thẻ hoặc phản hồi tác vụ hộp thoại.
views/widgets/*.js
Mỗi tệp sẽ tạo thực thể một loại tiện ích mà ứng dụng dùng để tạo thẻ trong thư mục views/.
test/**/*.test.js
Mỗi tệp trong thư mục này và các thư mục con của tệp đều chứa các bài kiểm thử đơn vị cho chức năng, bộ điều khiển, dịch vụ, chế độ xem hoặc tiện ích tương ứng. Bạn có thể thực thi tất cả các bài kiểm thử đơn vị bằng cách chạy npm run test khi ở thư mục gốc của dự án.

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

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

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

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

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

  1. Tải mã từ GitHub xuống 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ộ mẫu Google Workspace kho lưu trữ.

  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 vào tệp zip.

    Thư mục gốc của tệp zip phải chứa những thông tin sau tệp và thư mục:

    • env.js
    • README.md
    • gcloudignore.text
    • package-lock.json
    • package.json
    • index.js
    • model/
    • controllers/
    • views/
    • services/
  4. Trong bảng điều khiển Google Cloud, hãy truy cập vào trang Cloud Functions:

    Chuyển đến Cloud Functions

    Kiểm tra để đảm bảo dự án trên Google Cloud dành cho Ứng dụng nhắn tin đã được chọn.

  5. Nhấp vào Create Function (Tạo hàm).

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

    1. Trong mục Môi trường, hãy chọn thế hệ thứ 2.
    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.
  7. Trong Thời gian chạy, hãy chọn Node.js 20.

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

  9. Trong Mã nguồn, chọn Tải lên ZIP.

  10. Trong Bộ chứa đích, tạo hoặc chọn một nhóm:

    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 sao chép các tệp thành phần vào Chức năng đám mây.

  11. Trong Tệp zip, hãy tải tệp zip mà bạn đã tải xuống từ GitHub lên, đã trích xuất và nén lại:

    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ở.
  12. Nhấp vào Triển khai.

    Trang chi tiết về Chức năng đám mây sẽ mở ra và hàm của bạn sẽ xuất hiện có hai chỉ báo tiến trình: một chỉ báo cho bản dựng và một chỉ báo dịch vụ. Khi cả hai chỉ báo tiến trình biến mất và được thay thế bằng dấu kiểm đánh dấu, chức năng của bạn đã được triển khai và sẵn sàng.

  13. 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 chức năng đám mây của bạn.
  14. Nhấp vào Triển khai.

  15. Khi hàm này hoàn tất việc triển khai, hãy sao chép URL của điều kiện kích hoạt:

    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 nó để định cấu hình ứng dụng Chat trong phần sau.

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

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

    git clone https://github.com/googleworkspace/google-chat-samples.git
    
  2. Chuyển sang thư mục lưu giữ mã cho dự án này ứng dụng Chat quản lý:

    cd google-chat-samples/node/project-management-app
    
  3. 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.
  4. Triển khai hàm đám mây cho Google Cloud:

    gcloud functions deploy project-management-tutorial \
    --gen2 \
    --region=REGION \
    --runtime=nodejs20 \
    --source=. \
    --entry-point=projectManagementChatApp \
    --trigger-http \
    --allow-unauthenticated
    

    Thay thế REGION bằng Vị trí của Hàm đám mây nơi lưu trữ cơ sở hạ tầng, chẳng hạn như us-central1.

  1. Khi hàm này hoàn tất việc triển khai, hãy sao chép thuộc tính url qua của bạn. Đây là URL kích hoạt mà bạn sử dụng trong mục sau để định cấu hình ứng dụng Google Chat.

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

Phần này trình bày cách định cấu hình API Chat trong bảng điều khiển Google Cloud với thông tin về ứng dụng Chat của bạn, bao gồm tên của ứng dụng Chat, dấu gạch chéo được hỗ trợ và URL kích hoạt của Đám mây của ứng dụng Chat Hàm mà hàm gửi sự kiện tương tác trong Chat.

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

  2. Trong 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 phần Description (Nội dung 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 mục Cài đặt kết nối, hãy chọn URL ứng dụng.

  8. Trong URL ứng dụng, hãy dán URL điều kiện kích hoạt mà bạn đã sao chép từ Đám mây Triển khai hàm, được định dạng là https://REGION-PROJECT_ID.cloudfunctions.net/project-management-tutorial. Nếu bạn đã triển khai Chức năng đám mây bằng gcloud CLI, thì đây là url thuộc tính này.

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

    1. Trong phần Lệnhlash, hãy nhấp vào Thêm lệnh dấu gạch chéo.
    2. Đối với mỗi lệnh dấu gạch chéo được nêu chi tiết trong bảng sau, nhập Tên, Mã lệnh, Mô tả và chọn xem lệnh dấu gạch chéo Mở hộp thoại, sau đó nhấp vào Xong:

      Tên Mã lệnh Mô tả Mở hộp thoại
      /createUserStory 1 Tạo một câu chuyện có tiêu đề đã chỉ định. Đã bỏ chọn
      /myUserStories 2 Liệt kê tất cả tin bài đã chỉ định cho người dùng. Đã bỏ chọn
      /userStory 3 Hiển thị trạng thái hiện tại của tin bài được chỉ định. Đã bỏ chọn
      /manageUserStories 4 Mở một hộp thoại để bạn chỉnh sửa các tin bài. Đã chọn
      /cleanupUserStories 5 Xoá tất cả tin bài trong không gian. Đã bỏ chọn
  10. Trong phần Chế độ hiển thị, hãy chọn Cung cấp ứng dụng Chat này cho những người và nhóm cụ thể trong Workspace rồi nhập địa chỉ email của bạn.

  11. Trong phần Logs (Nhật ký), hãy chọn Log lỗi to Logging (Ghi nhật ký lỗi vào nhật ký) (không bắt buộc).

  12. Nhấp vào Lưu. Thông báo cấu hình đã lưu sẽ xuất hiện, tức là Ứng dụng Chat là sẵn sàng để thử nghiệm.

Kiểm thử ứng dụng Chat

Kiểm thử ứng dụng Chat quản lý dự án bằng cách nhắn tin cho ứng dụng đó cũng như sử dụng lệnh dấu gạch chéo để tạo, chỉnh sửa và xoá câu chuyện của người dùng.

  1. Mở Google Chat bằng tài khoản Google Workspace mà bạn khi bạn tự thêm chính mình làm người kiểm tra đáng tin cậy.

    Truy cập Google Chat

  2. Nhấp vào Cuộc trò chuyện mới.
  3. Trong trường Thêm 1 hoặc nhiều người, nhập tên của Ứng dụng Chat.
  4. Chọn ứng dụng Chat của bạn trong kết quả. Người trực tiếp tin nhắn sẽ mở ra.

  5. Trong tin nhắn trực tiếp mới với ứng dụng, hãy nhập Hello và nhấn enter. Quản lý dự án Ứng dụng Chat phản hồi bằng một trình đơn trợ giúp nêu chi tiết những gì ứng dụng có thể làm.
  6. Để tạo story, hãy nhập /createUserStory Test story vào thanh tin nhắn và gửi tin nhắn đó. Quản lý dự án Ứng dụng Chat trả lời bằng một thông báo dạng thẻ nêu chi tiết câu chuyện người dùng mà dịch vụ này tạo cho bạn bằng AI tạo sinh của Vertex AI.
  7. Trong bảng điều khiển này, hãy kiểm tra cơ sở dữ liệu Firestore để xem xét bản ghi không gian mà bạn đã thêm Trò chuyện với ứng dụng, với những người dùng đã tương tác với ứng dụng đó, và câu chuyện người dùng mà bạn đã tạo.

    Chuyển đến Firestore

  8. Quay lại Google Chat.

    Truy cập Google Chat

  9. Nếu bạn muốn chỉnh sửa câu chuyện, hãy nhấp vào Chỉnh sửa. Khi bạn hài lòng với câu chuyện đó, hãy nhấp vào Lưu.
  10. Kiểm thử từng lệnh dấu gạch chéo mà ứng dụng hỗ trợ. Để xem các đề xuất này, hãy nhập / hoặc đề cập đến ứng dụng Chat.
  11. Xoá câu chuyện người dùng thử nghiệm bằng cách phát hành /cleanupUserStories lệnh dấu gạch chéo. Ngoài ra, xoá hoặc gỡ cài đặt ứng dụng. Khi bị xoá, ứng dụng này sẽ xoá tất cả câu chuyện của người dùng được tạo trong không gian đó.

Khắc phục sự cố

Khi một ứng dụng Google Chat hoặc card trả về một lỗi, thì phương thức Giao diện Chat hiển thị một thông báo với nội dung "Đã xảy ra lỗi". hoặc "Không thể xử lý yêu cầu của bạn". Đôi khi, giao diện người dùng của Chat không hiện thông báo lỗi nào ngoài ứng dụng Chat hoặc thẻ tạo ra kết quả không mong muốn; ví dụ: thông báo thẻ có thể không xuất hiện.

Mặc dù thông báo lỗi có thể không xuất hiện trong giao diện người dùng Chat, thông báo lỗi mô tả và dữ liệu nhật ký luôn có sẵn để giúp bạn sửa lỗi khi tính năng ghi nhật ký lỗi cho các ứng dụng trong Chat được bật. Để được trợ giúp xem, gỡ lỗi và sửa lỗi, hãy xem Khắc phục lỗi và khắc phục lỗi của Google Chat.

Dọn dẹp

Để tránh bị tính phí vào tài khoản Google Cloud của bạn cho tài nguyên được sử dụng trong hướng dẫn này, chúng tôi khuyên bạn nên xóa Dự án trên đám mây.

  1. Trong bảng điều khiển Google Cloud, hãy chuyển đến trang Quản lý tài nguyên. Nhấp chuột Thực đơn > IAM và Quản trị viên > Quản lý tài nguyên.

    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 mà bạn muốn xoá rồi nhấp vào Xoá .
  3. Trong hộp thoại, hãy nhập mã dự án rồi nhấp vào Tắt để xoá dự án.