Tạo một ứng dụng Google Chat bằng tác nhân AI ADK

Trang này giải thích cách tạo một tiện ích bổ sung cho Google Workspace hoạt động trong Google Chat và tương tác với một tác nhân AI Agent Development Kit (ADK) được lưu trữ trong Vertex AI Agent Engine.

Lưu ý: Trong Google Chat, người dùng sẽ thấy các tiện ích bổ sung dưới dạng ứng dụng Google Chat. Bạn cũng có thể tạo ứng dụng Chat bằng các sự kiện tương tác của API Google Chat. Để tìm hiểu thêm, hãy xem bài viết Tổng quan về việc mở rộng Google Chat.

Tác nhân AI tự động nhận diện môi trường, suy luận và thực hiện các hành động phức tạp, nhiều bước để đạt được một mục tiêu đã xác định. Trong hướng dẫn này, bạn sẽ triển khai mẫu nhiều tác nhân ADK LLM Auditor. Mẫu này sẽ phê bình và sửa đổi các dữ kiện bằng cách sử dụng cơ sở của Gemini và Google Tìm kiếm.

Sơ đồ sau đây cho thấy cấu trúc và mẫu nhắn tin:

Trong sơ đồ trước đó, một người dùng tương tác với ứng dụng Chat được triển khai bằng một tác nhân AI ADK sẽ có luồng thông tin sau:

1. Người dùng gửi tin nhắn đến một ứng dụng Chat, có thể là tin nhắn trực tiếp hoặc trong một phòng Chat.
2. Logic của ứng dụng Chat được triển khai trong Apps Script hoặc dưới dạng một máy chủ web có các điểm cuối HTTP sẽ nhận và xử lý thông báo.
3. AI tác nhân được triển khai bằng ADK và lưu trữ bằng Vertex AI Agent Engine sẽ nhận và xử lý hoạt động tương tác.
4. Bạn có thể chọn tích hợp ứng dụng Chat hoặc tác nhân AI với các dịch vụ của Google Workspace, chẳng hạn như Lịch hoặc Trang tính, hoặc các dịch vụ khác của Google, chẳng hạn như Google Maps hoặc YouTube.
5. Ứng dụng Chat gửi các phản hồi không đồng bộ bằng Google Chat API để thông báo tiến trình của tác nhân AI.
6. Các câu trả lời được gửi đến người dùng.

Mục tiêu

• Thiết lập môi trường.
• Triển khai tác nhân AI ADK.
• Triển khai ứng dụng Chat.
• Định cấu hình ứng dụng Chat.
• Kiểm thử ứng dụng Chat.

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

• Tài khoản Google Workspace Business hoặc Enterprise có quyền truy cập vào Google Chat.
• Một dự án trên Google Cloud đã bật tính năng thanh toán. Để kiểm tra xem một dự án hiện có đã bật tính năng thanh toán hay chưa, hãy xem phần Xác minh trạng thái thanh toán của dự án. Để tạo dự án và thiết lập thông tin thanh toán, hãy xem phần Tạo dự án trên Google Cloud.

Thiết lập môi trường

Bật Google Cloud API

Trước khi sử dụng API của Google, bạn cần bật các API đó trong một dự án trên Google Cloud. Bạn có thể bật một hoặc nhiều API trong một dự án trên Google Cloud.

• Trong bảng điều khiển Google Cloud, hãy bật API Google Chat, Vertex AI và Cloud Resource Manager.

  Bật các API

Định cấu hình màn hình xin phép bằng OAuth

Tất cả ứng dụng sử dụng OAuth 2.0 đều phải có cấu hình màn hình đồng ý. Việc định cấu hình màn hình xin phép bằng OAuth của ứng dụng sẽ xác định nội dung hiển thị cho người dùng và người đánh giá ứng dụng, đồng thời đăng ký ứng dụng để bạn có thể xuất bản ứng dụng sau này.

1. Trong bảng điều khiển Google Cloud, hãy chuyển đến phần Trình đơn > Google Auth platform > Thương hiệu.

   Chuyển đến phần Thương hiệu

2. Nếu đã định cấu hình Google Auth platform, bạn có thể định cấu hình các chế độ cài đặt sau đây cho Màn hình xin phép bằng OAuth trong phần Thương hiệu, Đối tượng và Quyền truy cập dữ liệu. Nếu bạn thấy thông báo cho biết Google Auth platform chưa được định cấu hình, hãy nhấp vào Bắt đầu:
1. Trong phần Thông tin về ứng dụng, hãy nhập tên cho ứng dụng trong mục Tên ứng dụng.
2. Trong phần Email hỗ trợ người dùng, hãy chọn một địa chỉ email hỗ trợ mà người dùng có thể liên hệ với bạn nếu họ có thắc mắc về sự đồng ý của mình.
3. Nhấp vào Tiếp theo.
4. Trong phần Đối tượng, hãy chọn Nội bộ.
5. Nhấp vào Tiếp theo.
6. Trong phần Thông tin liên hệ, hãy nhập Địa chỉ email để bạn có thể nhận thông báo về mọi thay đổi đối với dự án của mình.
7. Nhấp vào Tiếp theo.
8. Trong phần Hoàn tất, hãy xem kỹ Chính sách dữ liệu người dùng của dịch vụ API của Google. Nếu bạn đồng ý, hãy chọn Tôi đồng ý với Chính sách dữ liệu người dùng của dịch vụ API của Google.
9. Nhấp vào Tiếp tục.
10. Nhấp vào Tạo.
3. Hiện tại, bạn có thể bỏ qua bước thêm phạm vi. Trong tương lai, khi tạo một ứng dụng để sử dụng bên ngoài tổ chức Google Workspace, bạn phải thay đổi Loại người dùng thành Bên ngoài. Sau đó, hãy thêm các phạm vi uỷ quyền mà ứng dụng của bạn yêu cầu. Để tìm hiểu thêm, hãy xem hướng dẫn đầy đủ về cách Định cấu hình màn hình xin phép bằng OAuth.

Tạo tài khoản dịch vụ trong bảng điều khiển Google Cloud

Tạo một tài khoản dịch vụ mới có vai trò Vertex AI User bằng cách làm theo các bước sau:

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 Trình đơn > IAM và Quản trị > Tài khoản dịch vụ.

   Chuyển đến phần Tài khoản dịch vụ

2. Nhấp vào Tạo tài khoản dịch vụ.
3. Điền thông tin tài khoản dịch vụ, rồi nhấp vào Tạo và tiếp tục.
   Lưu ý: Theo mặc định, Google sẽ tạo một mã nhận dạng tài khoản dịch vụ duy nhất. Nếu bạn muốn thay đổi mã nhận dạng, hãy sửa đổi mã nhận dạng trong trường mã nhận dạng tài khoản dịch vụ.
4. Không bắt buộc: Chỉ định vai trò cho tài khoản dịch vụ của bạn để cấp quyền truy cập vào các tài nguyên của dự án Google Cloud. Để biết thêm thông tin chi tiết, hãy tham khảo bài viết Cấp, thay đổi và thu hồi quyền truy cập vào tài nguyên.
5. Nhấp vào Tiếp tục.
6. Không bắt buộc: Nhập người dùng hoặc nhóm có thể quản lý và thực hiện các thao tác bằng tài khoản dịch vụ này. Để biết thêm thông tin, hãy tham khảo bài viết Quản lý hoạt động mạo danh tài khoản dịch vụ.
7. Nhấp vào Xong. Ghi lại địa chỉ email của tài khoản dịch vụ.

gcloud CLI

1. Tạo tài khoản dịch vụ:

   gcloud iam service-accounts create SERVICE_ACCOUNT_NAME \
     --display-name="SERVICE_ACCOUNT_NAME"

2. Không bắt buộc: Chỉ định vai trò cho tài khoản dịch vụ của bạn để cấp quyền truy cập vào các tài nguyên của dự án Google Cloud. Để biết thêm thông tin chi tiết, hãy tham khảo bài viết Cấp, thay đổi và thu hồi quyền truy cập vào tài nguyên.

Tài khoản dịch vụ sẽ xuất hiện trên trang tài khoản dịch vụ.

Tạo khoá riêng tư

Cảnh báo: Ví dụ này sử dụng khoá tài khoản dịch vụ đã xuất để đảm bảo tính đơn giản. Bạn không nên xuất khoá riêng tư trong quá trình phát hành vì khoá này không được lưu trữ ở một vị trí không an toàn, chẳng hạn như kiểm soát nguồn.

Để tìm hiểu thêm về các phương pháp hay nhất và cách triển khai tài khoản dịch vụ an toàn, hãy xem phần Chọn thời điểm sử dụng tài khoản dịch vụ.

Để tạo và tải khoá riêng tư xuống cho tài khoản dịch vụ, hãy làm theo các bước sau:

1. Trong bảng điều khiển Google Cloud, hãy chuyển đến phần Trình đơn > IAM và Quản trị > Tài khoản dịch vụ.

   Chuyển đến phần Tài khoản dịch vụ

2. Chọn tài khoản dịch vụ của bạn.
3. Nhấp vào Khoá > Thêm khoá > Tạo khoá mới.
4. Chọn JSON, rồi nhấp vào Tạo.

   Cặp khoá công khai/riêng tư mới của bạn sẽ được tạo và tải xuống máy của bạn dưới dạng một tệp mới. Lưu tệp JSON đã tải xuống dưới dạng credentials.json trong thư mục đang hoạt động. Tệp này là bản sao duy nhất của khoá này. Để biết thông tin về cách lưu trữ khoá một cách an toàn, hãy xem phần Quản lý khoá tài khoản dịch vụ.

5. Nhấp vào Close (Đóng).

Để biết thêm thông tin về tài khoản dịch vụ, hãy xem tài khoản dịch vụ trong tài liệu IAM của Google Cloud.

Triển khai tác nhân AI ADK

1. Mở mẫu LLM Auditor trong Vertex AI Agent Garden:

   Mở mẫu

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

3. Nếu được yêu cầu, hãy chọn dự án của bạn trên Google Cloud.

4. Nhấp vào Triển khai trong Cloud Shell.

5. Nếu được yêu cầu, hãy nhấp vào Uỷ quyền và thực hiện quy trình OAuth cho Cloud Shell.

6. Khi Cloud Shell tải xong, hãy nhấn Enter để chạy dòng lệnh được tải sẵn và bắt đầu triển khai.

7. Nếu được yêu cầu nhập khu vực, hãy nhấn Enter để sử dụng khu vực mặc định.

8. Sau khi hoàn tất, hãy chuyển đến Vertex AI Agent Engine:

   Mở Vertex AI Agent Engine

9. Nhấp vào biểu tượng để sao chép tên tài nguyên của tác nhân vừa triển khai trong bảng.

Tạo và định cấu hình dự án ứng dụng Chat

1. Nhấp vào nút sau để mở dự án ADK AI Agent Quickstart (Hướng dẫn nhanh về tác nhân AI ADK) trong Apps Script.

   Mở dự án

2. Nhấp vào Tổng quan > Tạo bản sao.

3. Trong dự án Apps Script, hãy nhấp vào Cài đặt dự án > Chỉnh sửa thuộc tính tập lệnh > Thêm thuộc tính tập lệnh để thêm các thuộc tính tập lệnh sau:

   1. REASONING_ENGINE_RESOURCE_NAME bằng tên tài nguyên của tác nhân Vertex AI đã sao chép ở các bước trước.
   2. SERVICE_ACCOUNT_KEY bằng khoá JSON từ tài khoản dịch vụ đã tải xuống ở các bước trước, chẳng hạn như { ... }.

4. Nhấp vào Lưu thuộc tính của tập lệnh

5. Trong bảng điều khiển Google Cloud, hãy chuyển đến Trình đơn > IAM và quản trị > Cài đặt.

   Chuyển đến phần IAM và Cài đặt quản trị

6. Sao chép giá trị trong trường Số dự án.

7. Trong dự án Apps Script, hãy nhấp vào Cài đặt dự án.

8. Trong phần Dự án trên Google Cloud Platform (GCP), hãy nhấp vào Thay đổi dự án.

9. Trong Số dự án trên Google Cloud, hãy dán số dự án trên Google Cloud mà bạn đã sao chép ở các bước trước.

10. Nhấp vào Đặt dự án. Dự án trên đám mây và dự án Apps Script hiện đã được kết nối.

Tạo một bản triển khai kiểm thử

Bạn cần có một mã nhận dạng triển khai cho dự án Apps Script này để có thể sử dụng mã đó trong bước tiếp theo.

Để lấy mã nhận dạng triển khai đầu, hãy làm như sau:

1. Trong dự án Apps Script của ứng dụng Chat, hãy nhấp vào Triển khai > Triển khai thử nghiệm.
2. Trong mục Mã nhận dạng hoạt động triển khai tiêu đề, hãy nhấp vào Sao chép.
3. Nhấp vào Xong.

Định cấu hình ứng dụng Chat

Khi sử dụng bản triển khai Apps Script, hãy làm theo các bước sau để triển khai ứng dụng Google Chat nhằm kiểm thử:

1. Trong bảng điều khiển, hãy tìm Google Chat API rồi nhấp vào Google Chat API.
2. Nhấp vào Quản lý.

3. Nhấp vào Cấu hình rồi thiết lập ứng dụng Chat:

   1. Trong trường Tên ứng dụng, hãy nhập ADK Quickstart.
   2. Trong trường URL hình đại diện, hãy nhập https://developers.google.com/workspace/add-ons/images/quickstart-app-avatar.png.
   3. Trong trường Description (Nội dung mô tả), hãy nhập ADK Quickstart.
   4. Trong phần Chức năng, hãy chọn Tham gia không gian và cuộc trò chuyện nhóm.
   5. Trong phần Cài đặt kết nối, hãy chọn Dự án Apps Script.
   6. Trong trường Mã hoạt động triển khai, hãy dán mã hoạt động triển khai Head mà bạn đã sao chép trước đó.
   7. Trong phần Chế độ hiển thị, hãy chọn Những người và nhóm cụ thể trong miền của bạn rồi nhập email của bạn.

4. Nhấp vào Lưu.

Ứng dụng Chat đã sẵn sàng phản hồi tin nhắn.

Kiểm thử ứng dụng Chat

Để kiểm thử ứng dụng Chat, hãy mở một không gian nhắn tin trực tiếp bằng ứng dụng Chat rồi gửi một tin nhắn:

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ử tin cậy.

   Chuyển đến Google Chat

2. Nhấp vào biểu tượng Cuộc trò chuyện mới.
3. Trong trường Thêm 1 hoặc nhiều người, 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.

   Lưu ý: Nếu bạn không thấy ứng dụng Chat trong danh sách kết quả, hãy đảm bảo rằng bạn đã thêm tài khoản Google Workspace vào chế độ cài đặt Chế độ hiển thị của trang Cấu hình Chat API trong Google Cloud Console.

5. Trong tin nhắn trực tiếp mới với ứng dụng, hãy nhập The Eiffel Tower was completed in 1900 rồi nhấn enter.

   Ứng dụng Chat trả lời bằng các câu trả lời của trợ lý ảo Nhà phê bình và Người chỉnh sửa.

Để thêm người kiểm thử đáng tin cậy và tìm hiểu thêm về việc kiểm thử các tính năng tương tác, hãy xem bài viết Kiểm thử các tính năng tương tác cho ứng dụng Google Chat.

Khắc phục sự cố

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

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

Dọn dẹp

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

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

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

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

1. Trong Google Cloud Console, hãy chuyển đến trang Quản lý tài nguyên. Nhấp vào Trình đơn > IAM và Quản trị viên > Quản lý tài nguyên.

   Chuyển đến Resource Manager

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 Tắt để xoá dự án.

Chủ đề có liên quan

• Kiểm chứng các câu nói bằng mô hình Gemini và một tác nhân AI ADK
• Lên kế hoạch cho chuyến đi với một trợ lý AI có thể truy cập trên Google Workspace
• Tích hợp các khái niệm cơ bản về AI trong các ứng dụng Chat
• Trả lời câu hỏi dựa trên các cuộc trò chuyện trong ứng dụng Gemini AI Chat
• Ứng phó với sự cố bằng Google Chat, Vertex AI, Apps Script và tính năng xác thực người dùng
• Quản lý dự án bằng Google Chat, Vertex AI và Firestore