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à giao tiếp với một tác nhân AI trong Bộ phát triển tác nhân (ADK) được lưu trữ trong Vertex AI Agent Engine.

Tác nhân AI tự động nhận biết 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ục tiêu đã xác định. Trong hướng dẫn này, bạn sẽ triển khai mẫu đa tác nhân ADK LLM Auditor để phê bình và sửa đổi các sự kiện thực tế bằng cách sử dụng Gemini và liên kết thực tế với Google Tìm kiếm.

Mẫu nhiều tác nhân LLM Auditor dưới dạng ứng dụng Chat.

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

Cấu trúc của một ứng dụng Chat được triển khai bằng tác nhân AI ADK.

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 tác nhân AI ADK có luồng thông tin như sau:

  1. Người dùng gửi tin nhắn đến một ứng dụng Chat, trong tin nhắn trực tiếp hoặc trong một không gian Chat.
  2. Logic ứng dụng Chat được triển khai trong Apps Script hoặc dưới dạng máy chủ web có các điểm cuối HTTP sẽ nhận và xử lý tin nhắn.
  3. Tác nhân AI được triển khai bằng ADK và được lưu trữ bằng Vertex AI Agent Engine sẽ nhận và xử lý tương tác.
  4. Tuỳ ý, ứng dụng Chat hoặc tác nhân AI có thể tích hợp 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 phản hồi không đồng bộ bằng API Google Chat để thông báo tiến trình của tác nhân AI.
  6. Các phản hồ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

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

Bật các API của Google Cloud

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 các 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ả các ứng dụng sử dụng OAuth 2.0 đều yêu cầu cấu hình màn hình xin phép. Việc định cấu hình màn hình xin phép bằng OAuth cho ứng dụng sẽ xác định những gì 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ể phát hành sau này.

  1. Trong Bảng điều khiển API của Google, hãy chuyển đến trình đơn Trình đơn > Nền tảng xác thực của Google > Thương hiệu.

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

  2. Nếu đã định cấu hình nền tảng xác thực của Google, 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 Nền tảng xác thực của Google chưa được định cấu hình, hãy nhấp vào Bắt đầu:
    1. Trong phần Thông tin ứng dụng, ở mục Tên ứng dụng, hãy nhập tên cho ứ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ó câu hỏi 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 lại Chính sách dữ liệu người dùng của các dịch vụ API của Google và 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 các 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 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 API của Google

  1. Trong Bảng điều khiển API của Google, hãy chuyển đến trình đơ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 chi tiết về tài khoản dịch vụ, sau đó nhấp vào Tạo và tiếp tục.
  4. Không bắt buộc: Chỉ định vai trò cho tài khoản dịch vụ để cấp quyền truy cập vào tài nguyên của dự án trên Google Cloud. Để biết thêm thông tin, 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 hành động 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ý việc mạo danh tài khoản dịch vụ.
  7. Nhấp vào Xong. Ghi lại địa chỉ email cho 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ấp quyền truy cập vào tài nguyên của dự án trên Google Cloud. Để biết thêm thông tin, 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ư

Để 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 trình đơ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ụ.
  3. Nhấp vào Khoá > Thêm khoá > Tạo khoá mới.
  4. Chọn JSON, sau đó 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 làm việc của bạn. 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á an toàn, hãy xem bài viết 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 bài viết 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 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 Cho phép 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 giá trị mặc định.

  8. 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 tạo bản sao để sao chép tên tài nguyên của tác nhân mới triển khai từ 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 Apps Script ADK AI Agent Quickstart.

    Mở dự án

  2. Nhấp vào Tổng quan > Biểu tượng tạo bản sao Tạo bản sao.

  3. Trong dự án Apps Script, hãy nhấp vào Biểu tượng cho chế độ cài đặt dự án 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 có tên tài nguyên tác nhân Vertex AI được sao chép trong các bước trước.
    2. SERVICE_ACCOUNT_KEY có khoá JSON từ tài khoản dịch vụ được tải xuống trong 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 API của Google, hãy chuyển đến trình đơn Trình đơn > IAM và Quản trị > Cài đặt.

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

  6. Trong trường Số dự án, hãy sao chép giá trị.

  7. Trong dự án Apps Script, hãy nhấp vào Biểu tượng cho chế độ cài đặt dự án 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 GCP, hãy dán số dự án trên Google Cloud được sao chép trong 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 bản triển khai kiểm thử

Bạn cần có mã 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ã triển khai chính, 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 > Bản triển khai kiểm thử.
  2. Trong phần Mã triển khai chính, hãy nhấp vào biểu tượng Biểu tượng tạo bản sao Sao chép.
  3. Nhấp vào Xong.

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

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 cho mục đích kiểm thử:

  1. Trong Bảng điều khiển API, hãy tìm kiế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 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ã triển khai, hãy dán Mã triển khai chính 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 tin nhắn trực tiếp bằng ứng dụng Chat rồi gửi 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ử đáng tin cậy.

    Chuyển đến Google Chat

  2. Nhấp vào 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 The Eiffel Tower was completed in 1900 rồi nhấnenter.

    Ứng dụng Chat sẽ trả lời bằng các phản hồi của tác nhân phụ Critic và Reviser.

Để thêm người kiểm thử đáng tin cậy và tìm hiểu thêm về cách 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 hoặc thẻ Google Chat 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 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, bạn có thể xem các thông báo lỗi mô tả và dữ liệu nhật ký để giúp bạn 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à sửa lỗi Google Chat.

Dọn dẹp

Để tránh bị tính phí vào tài khoản Google Cloud cho 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 đám mây.

  1. Trong Bảng điều khiển API của Google, 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ị > 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á, sau đó 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.