Lên kế hoạch đi du lịch bằng một trợ lý AI có thể truy cập trên Google Workspace

Trình độ lập trình: Nâng cao
Thời lượng: 45 phút
Loại dự án: Tiện ích bổ sung Google Workspace mở rộng Chat, Gmail, Lịch, Drive, Tài liệu, Trang tính và Trang trình bày.

Hướng dẫn này cho bạn biết cách xuất bản các tác nhân AI lên Google Workspace dưới dạng tiện ích bổ sung của Google Workspace, bằng cách sử dụng Apps Script hoặc các điểm cuối HTTP. Sau khi bạn xuất bản tiện ích bổ sung, người dùng có thể tương tác với các tác nhân AI trong quy trình làm việc của họ.

Tổng quan

Trong hướng dẫn này, bạn sẽ triển khai mẫu Trợ lý du lịch từ Bộ công cụ phát triển (ADK) dành cho tác nhân. Travel Concierge là một AI đàm thoại có nhiều tác nhân, sử dụng các công cụ như Places API của Nền tảng Google Maps, Google Search Grounding và một máy chủ Model Context Protocol (MCP).

Theo mặc định, ADK cung cấp giao diện trò chuyện và văn bản cho nhà phát triển. Trong hướng dẫn này, bạn sẽ thêm Giao diện người dùng đồ hoạ (GUI) vào các ứng dụng Google Workspace mà người dùng có thể truy cập trực tiếp trong Chat, Gmail, Lịch, Drive, Tài liệu, Trang tính và Trang trình bày.

  • Sử dụng đặc vụ AI trong Chat để lên ý tưởng du lịch.
    Hình 1. Sử dụng trợ lý AI trong Chat để lên ý tưởng du lịch.
  • Sử dụng tác nhân AI trong Gmail để lên kế hoạch cho chuyến đi dựa trên ngữ cảnh trong email đã chọn.
    Hình 2. Sử dụng tác nhân AI trong Gmail để lên kế hoạch cho chuyến đi dựa trên ngữ cảnh trong email đã chọn.

Mục tiêu

  • Thiết lập môi trường.
  • Triển khai tác nhân AI.
  • Thiết lập dự án.
  • Triển khai cho Gmail, Lịch, Drive, Tài liệu, Trang tính, Trang trình bày.
  • Triển khai cho Chat.
  • Kiểm thử giải pháp.

Giới thiệu về giải pháp này

Giải pháp này dựa trên các công nghệ cốt lõi sau: ADK, Google Cloud và Google Workspace API, Vertex AI Agent Engine và khung Card.

GUI được thiết kế khác nhau cho các ứng dụng Chat và không phải Chat (Gmail, Lịch, Drive, Tài liệu, Trang tính, Trang trình bày) để tính đến các tính năng và hạn chế cụ thể của chúng.

Tính năng

Các tính năng sau đây của ứng dụng Travel Concierge là điểm chung của tất cả các ứng dụng Google Workspace:

  • Phiên người dùng liên tục: Các phiên được Vertex AI quản lý để duy trì tính liên tục. Mỗi người dùng sẽ dùng chung một phiên trên tất cả các ứng dụng Workspace. Người dùng có thể đặt lại phiên theo cách thủ công để bắt đầu một cuộc trò chuyện mới.

  • Nhắn tin đa dạng: Người dùng gửi tin nhắn văn bản và nhận phản hồi bằng văn bản đa dạng và các tiện ích thẻ.

  • Xử lý lỗi: Các lỗi không mong muốn được xử lý một cách hiệu quả bằng cách sử dụng các trạng thái và số lần thử lại có thể định cấu hình trong các phản hồi.

Ứng dụng Chat có các tính năng bổ sung sau:

  • Nhắn tin đa phương thức cho người dùng: Người dùng có thể gửi tin nhắn kèm tệp đính kèm, bao gồm cả âm thanh và video được ghi trực tiếp từ không gian Chat.

  • Phản hồi trực quan hơn: Bạn có thể tạo phản hồi bằng các tiện ích nâng cao hơn, chẳng hạn như băng chuyền có hình ảnh bằng cách dựa vào các tính năng chỉ dành cho Chat của Khung thẻ và nhiều không gian hiển thị hơn.

Các ứng dụng khác có những tính năng bổ sung sau:

  • Bối cảnh hồ sơ trên Google: Người dùng có thể gửi tin nhắn kèm theo thông tin hồ sơ của họ (trong mẫu này, thông tin chỉ giới hạn ở ngày sinh).

  • Bối cảnh Gmail: Người dùng có thể gửi thư bằng email (trong mẫu này, chỉ có một tiêu đề và nội dung).

  • Quyền truy cập vào không gian trò chuyện của nhân viên hỗ trợ: Người dùng có thể mở không gian tin nhắn trực tiếp (DM) của ứng dụng Chat trong một thẻ mới chỉ bằng một lần nhấp vào nút.

Kiến trúc

Ứng dụng Travel Concierge nhận và xử lý các sự kiện tương tác của tiện ích bổ sung Google Workspace từ các ứng dụng Google Workspace, sử dụng Vertex AI để nhắc tác nhân AI ADK và quản lý các phiên người dùng, đồng thời dựa vào các API của Google Cloud và Google Workspace để thu thập bối cảnh và hiển thị các phản hồi.

Sơ đồ sau đây cho thấy quy trình chính của người dùng: gửi tin nhắn cho tác nhân AI.

HTTP

  • Sơ đồ cấu trúc cho ứng dụng Chat.
    Hình 3. Ứng dụng Chat hoàn tất ngữ cảnh bằng các tệp đính kèm trong tin nhắn của người dùng, đồng thời gửi một nhóm tin nhắn có nhật ký tương tác của các tác nhân phụ và câu trả lời chung cuối cùng theo thứ tự thời gian.
  • Sơ đồ cấu trúc cho các ứng dụng không phải là Chat.
    Hình 4. Các ứng dụng không phải ứng dụng Chat sẽ hoàn tất bối cảnh bằng hồ sơ Google và lựa chọn mặt hàng của người dùng, đồng thời hiển thị một nhóm các phần có nhật ký tương tác của trợ lý và câu trả lời tổng thể cuối cùng theo thứ tự thời gian đảo ngược.

Apps Script

  • Sơ đồ cấu trúc cho ứng dụng Chat.
    Hình 3. Ứng dụng Chat hoàn tất ngữ cảnh bằng các tệp đính kèm trong tin nhắn của người dùng, đồng thời gửi một nhóm tin nhắn có nhật ký tương tác của các tác nhân phụ và câu trả lời chung cuối cùng theo thứ tự thời gian.
  • Sơ đồ cấu trúc cho các ứng dụng không phải là Chat.
    Hình 4. Các ứng dụng không phải ứng dụng Chat sẽ hoàn tất bối cảnh bằng hồ sơ Google và lựa chọn mặt hàng của người dùng, đồng thời hiển thị một nhóm các phần có nhật ký tương tác của trợ lý và câu trả lời tổng thể cuối cùng theo thứ tự thời gian đảo ngược.

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

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

Phần này hướng dẫn cách tạo và định cấu hình một dự án trên Google Cloud.

Tạo 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 Trình đơn > IAM và Quản trị > Tạo dự án.

    Chuyển đến phần 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. 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 tồn tại của dự án.

  3. Trong trường Location (Vị trí), hãy nhấp vào Browse (Duyệt xem) để hiện 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. Bảng điều khiển Google Cloud sẽ chuyển đến trang Tổng quan và dự án của bạn sẽ được tạo trong vòng vài phút.

gcloud CLI

Trong một trong các môi trường phát triển sau đây, 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: Để sử dụng môi trường phát triển cục bộ, hãy cài đặt và khởi động CLI gcloud.
    Để tạo một dự án trên 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

  1. Trong bảng điều khiển Google Cloud, hãy chuyển đến phần Thanh toán. Nhấp vào 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 trên Google Cloud của bạn.
  3. Trong hàng dự án, hãy mở trình đơn Thao tác (), nhấp vào Thay đổi thông tin thanh toán rồi chọn tài khoản thanh toán trên đám mây.
  4. Nhấp vào Thiết lập tài khoản.

gcloud CLI

  1. Để liệt kê các tài khoản thanh toán hiện có, hãy chạy lệnh: 
    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ế nội dung sau:

    • PROJECT_ID là Mã 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_ID là mã tài khoản thanh toán cần liên kết với dự án trên Google Cloud.

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

HTTP

  1. Trong bảng điều khiển Google Cloud, hãy bật Vertex AI, Places, People, Google Chat, Gmail, Cloud Build, Cloud Functions, Cloud Pub/Sub, Cloud Logging, Artifact Registry, Cloud Run và API tiện ích bổ sung Google Workspace.

    Bật các API

  2. Xác nhận rằng bạn đang bật các API trong dự án Cloud chính xác, 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.

Apps Script

  1. Trong bảng điều khiển Google Cloud, hãy bật Vertex AI, Places, People, Google Chat API.

    Bật các API

  2. Xác nhận rằng bạn đang bật các API trong dự án Cloud chính xác, 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.

Lấy khoá Places API của Nền tảng Google Maps

  1. Trong Bảng điều khiển Google Cloud, hãy chuyển đến trang Nền tảng Google Maps > Khoá và thông tin đăng nhập.

    Chuyển đến phần Khoá và thông tin xác thực

  2. Hộp thoại Bắt đầu sử dụng Google Maps Platform sẽ hiển thị khoá API mới tạo của bạn (một chuỗi gồm cả chữ và số). Bạn sẽ cần chuỗi này trong các phần tiếp theo.

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.
  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ụ. Tiếp theo, hãy tạo một khoá riêng tư cho 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 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.

Tiện ích bổ sung của Google Workspace yêu cầu phải có cấu hình màn hình đồng ý. Việc định cấu hình màn hình đồng ý OAuth của tiện ích bổ sung sẽ xác định nội dung mà Google hiển thị cho người dùng.

  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.

Triển khai Trợ lý du lịch ADK AI

  1. Nếu chưa thực hiện, hãy xác thực bằng tài khoản Google Cloud của bạn và định cấu hình Google Cloud CLI để sử dụng dự án Google Cloud của bạn.

    gcloud auth application-default login
gcloud config set project PROJECT_ID
gcloud auth application-default set-quota-project PROJECT_ID

    Thay PROJECT_ID bằng mã nhận dạng của dự án trên Cloud mà bạn đã tạo.

  2. Tải kho lưu trữ này trên GitHub xuống

    Tải xuống

  3. Trong môi trường phát triển cục bộ mà bạn muốn, hãy trích xuất tệp lưu trữ đã tải xuống và mở thư mục adk-samples/python/agents/travel-concierge.

    unzip adk-samples-main.zip
cd adk-samples-main/python/agents/travel-concierge

  4. Tạo một bộ chứa Cloud Storage mới dành riêng cho tác nhân AI ADK.

    gcloud storage buckets create gs://CLOUD_STORAGE_BUCKET_NAME --project=PROJECT_ID --location=PROJECT_LOCATION

    Thay thế nội dung sau:

    1. CLOUD_STORAGE_BUCKET_NAME bằng tên bộ chứa riêng biệt mà bạn muốn sử dụng.
    2. PROJECT_ID bằng mã nhận dạng của dự án trên Đám mây mà bạn đã tạo.
    3. PROJECT_LOCATION có vị trí của dự án trên Cloud mà bạn đã tạo.

  5. Thiết lập các biến môi trường sau:

    export GOOGLE_GENAI_USE_VERTEXAI=1
export GOOGLE_CLOUD_PROJECT=PROJECT_ID
export GOOGLE_CLOUD_LOCATION=PROJECT_LOCATION
export GOOGLE_PLACES_API_KEY=PLACES_API_KEY
export GOOGLE_CLOUD_STORAGE_BUCKET=CLOUD_STORAGE_BUCKET_NAME
export TRAVEL_CONCIERGE_SCENARIO=travel_concierge/profiles/itinerary_empty_default.json

    Thay thế nội dung sau:

    1. PROJECT_ID bằng mã nhận dạng của dự án trên Đám mây mà bạn đã tạo.
    2. PROJECT_LOCATION có vị trí của dự án trên Cloud mà bạn đã tạo.
    3. PLACES_API_KEY bằng chuỗi khoá API mà bạn đã tạo.
    4. CLOUD_STORAGE_BUCKET_NAME bằng tên của nhóm mà bạn đã tạo.

  6. Cài đặt và triển khai tác nhân AI ADK.

    uv sync --group deployment
uv run python deployment/deploy.py --create

  7. Truy xuất số dự án và mã nhận dạng công cụ từ nhật ký được in gần đây nhất dưới dạng PROJECT_NUMBER và ENGINE_ID tương ứng. Sau này, bạn sẽ cần cả hai thông tin này để định cấu hình dự án.

    Created remote agent: projects/PROJECT_NUMBER/locations/us-central1/reasoningEngines/ENGINE_ID

Xem lại mã mẫu

Nếu muốn, trước khi thiết lập dự án, hãy dành chút thời gian để xem xét và làm quen với mã mẫu được lưu trữ trên GitHub.

Python

Xem trên GitHub

Apps Script

Xem trên GitHub

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

Python

  1. Tải kho lưu trữ này trên GitHub xuống

    Tải xuống

  2. Trong môi trường phát triển cục bộ mà bạn muốn, hãy trích xuất tệp lưu trữ đã tải xuống và mở thư mục add-ons-samples/python/travel-adk-ai-agent.

    unzip add-ons-samples-main.zip
cd add-ons-samples-main/python/travel-adk-ai-agent

  3. Di chuyển tệp khoá JSON credentials.json từ tài khoản dịch vụ đã tải xuống ở các bước trước vào thư mục dự án.

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

    Chuyển đến Cloud Run

  5. Nhấp vào Viết một hàm.

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

    1. Trong trường Tên dịch vụ, hãy nhập travel-concierge-app.
    2. Trong danh sách Khu vực, hãy chọn vị trí của dự án trên Cloud mà bạn đã tạo, PROJECT_LOCATION.
    3. Trong phần URL điểm cuối, hãy nhấp vào Biểu tượng tạo bản sao.
    4. Trong danh sách Runtime (Thời gian chạy), hãy chọn phiên bản Python gần đây nhất.
    5. Trong phần Xác thực, hãy chọn Cho phép truy cập công khai.
    6. Trong mục Vùng chứa, ổ đĩa, mạng, bảo mật, trong phần Tài nguyên:
      1. Trong trường Bộ nhớ, hãy chọn 1 GiB.
      2. Trong trường CPU, hãy chọn 2.
    7. Nhấp vào Tạo rồi đợi Cloud Run tạo dịch vụ. Bảng điều khiển sẽ chuyển hướng bạn đến thẻ Nguồn.

  7. Trong môi trường phát triển cục bộ mà bạn muốn, hãy triển khai nguồn của dự án:

    gcloud run deploy travel-concierge-app --quiet --source . \
    --region PROJECT_LOCATION  \
    --function adk_ai_agent  \
    --set-env-vars LOCATION=LOCATION,PROJECT_NUMBER=PROJECT_NUMBER,ENGINE_ID=ENGINE_ID,BASE_URL=BASE_URL

    Thay thế nội dung sau:

    1. PROJECT_LOCATION có vị trí của hàm Cloud Run mà bạn đã tạo trước đó.
    2. LOCATION cùng với vị trí của dự án Google Cloud được tạo ở các bước trước, PROJECT_LOCATION.
    3. PROJECT_NUMBER có số dự án của Travel Concierge ADK AI Agent được triển khai trong các bước trước.
    4. ENGINE_ID bằng mã nhận dạng công cụ của Trợ lý AI ADK Travel Concierge được triển khai trong các bước trước.
    5. BASE_URL bằng URL điểm cuối mà bạn đã sao chép trước đó.

Apps Script

Cách tạo một dự án Apps Script và định cấu hình dự án đó để sử dụng tác nhân AI ADK Travel Concierge đã triển khai:

  1. Nhấp vào nút sau để mở dự án Travel Concierge ADK AI Agent (Đại lý du lịch ảo ADK AI) trong Apps Script.
    Mở dự án

  2. Nhấp vào Tổng quan, rồi nhấp vào Biểu tượng tạo bản sao Tạo bản sao.

  3. Đặt tên cho bản sao của dự án Apps Script:

    1. Nhấp vào Bản sao của Travel Concierge ADK AI Agent.
    2. Trong phần Tiêu đề dự án, hãy nhập Travel Concierge ADK AI Agent.
    3. Nhấp vào Đổi tên.

  4. Trong dự án Apps Script, hãy nhấp vào Biểu tượng cho phần cài đặt dự án Trình chỉnh sửa rồi di chuyển tệp VertexAi.gs lên cho đến khi tệp này nằm phía trên tệp AgentHandler.gs bằng cách sử dụng thao tác với tệp Di chuyển tệp lên.

  5. Trong dự án Apps Script, hãy nhấp vào Biểu tượng cho phần cài đặt dự án Cài đặt dự án, nhấp vào Chỉnh sửa thuộc tính tập lệnh, sau đó nhấp vào Thêm thuộc tính tập lệnh để thêm các thuộc tính tập lệnh sau:

  6. ENGINE_ID bằng mã nhận dạng công cụ của Trợ lý AI ADK Travel Concierge được triển khai ở các bước trước, ENGINE_ID.

  7. LOCATION bằng vị trí của dự án trên Google Cloud đã tạo ở các bước trước, PROJECT_LOCATION.

  8. PROJECT_NUMBER bằng số dự án của Travel Concierge ADK AI Agent được triển khai ở các bước trước, PROJECT_NUMBER.

  9. 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ư { ... }.

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

  11. Trong dự án Apps Script, hãy nhấp vào Biểu tượng cho phần cài đặt dự án Cài đặt dự án.

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

  13. Trong GCP project number (Số dự án GCP), hãy dán số dự án của Travel Concierge ADK AI Agent (Trợ lý AI ADK của Travel Concierge) đã triển khai ở các bước trước, PROJECT_NUMBER.

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

Triển khai cho Gmail, Lịch, Drive, Tài liệu, Trang tính, Trang trình bày

Python

Sử dụng một bản triển khai tiện ích bổ sung của Google Workspace để cài đặt dự án mẫu cho tất cả các ứng dụng Google Workspace (ngoại trừ Google Chat) để bật tính năng kiểm thử.

  1. Trong môi trường phát triển cục bộ mà bạn muốn, hãy mở tệp deployment.json từ nguồn mã của dự án và thay thế tất cả các lần xuất hiện của $BASE_URL bằng giá trị của BASE_URL, URL điểm cuối mà bạn đã sao chép ở các bước trước.

  2. Tạo một bản triển khai tiện ích bổ sung của Google Workspace có tên travel-concierge-addon:

    gcloud workspace-add-ons deployments create travel-concierge-addon \
    --deployment-file=deployment.json

  3. Cài đặt việc triển khai tiện ích bổ sung của Google Workspace:

    gcloud workspace-add-ons deployments install travel-concierge-addon

Apps Script

Cài đặt dự án Apps Script cho tất cả các ứng dụng Google Workspace (ngoại trừ Google Chat) để bật tính năng kiểm thử.

  1. Trong dự án Apps Script, hãy nhấp vào Triển khai > Kiểm thử bản triển khai, sau đó nhấp vào Cài đặt.

Giờ đây, bạn có thể truy cập vào tiện ích bổ sung này từ thanh bên của ứng dụng Google Workspace.

Triển khai cho Chat

Python

Cài đặt dự án mẫu vào Chat bằng URL điểm cuối để bật tính năng kiểm thử.

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

    Chuyển đến trang Cấu hình Google Chat API

  2. Thiết lập ứng dụng Chat:

    1. Trong trường Tên ứng dụng, hãy nhập Travel ADK AI Agent.
    2. Trong trường URL hình đại diện, hãy nhập https://goo.gle/3SfMkjb.
    3. Trong trường Description (Nội dung mô tả), hãy nhập Travel ADK AI Agent.
    4. Trong phần Connection settings (Chế độ cài đặt kết nối), hãy chọn HTTP endpoint URL (URL điểm cuối HTTP).
    5. Trong mục Triggers (Trình kích hoạt), hãy chọn Use a common HTTP endpoint URL for all triggers (Sử dụng một URL điểm cuối HTTP chung cho tất cả trình kích hoạt).
    6. Trong trường URL điểm cuối HTTP, hãy dán URL điểm cuối mà bạn đã sao chép trước đó, BASE_URL.
    7. Đăng ký một Lệnh nhanh mà ứng dụng Chat đã triển khai đầy đủ sử dụng:
      1. Trong phần Lệnh, hãy nhấp vào Thêm lệnh.
      2. Trong Command ID (Mã lệnh), hãy nhập 1.
      3. Trong phần Nội dung mô tả, hãy nhập Reset session.
      4. Trong mục Loại lệnh, hãy chọn Lệnh nhanh.
      5. Trong Name (Tên), hãy nhập Reset session.
      6. Nhấp vào Xong. Lệnh nhanh đã được đăng ký và liệt kê.
    8. Trong mục 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 miền Workspace của bạn rồi nhập địa chỉ email của bạn.
    9. Trong mục Nhật ký, hãy chọn Ghi lỗi vào Nhật ký.
    10. Nhấp vào Lưu.

Apps Script

Cài đặt dự án Apps Script vào Chat bằng cách sử dụng Mã nhận dạng bản triển khai chính để bật tính năng kiểm thử.

  1. Trong dự án Apps Script, hãy nhấp vào Triển khai > Kiểm thử bản triển khai, sau đó nhấp vào Sao chép Biểu tượng để sao chép Mã triển khai tiêu đề trong mục Mã nhận dạng bản triển khai chính.

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

    Chuyển đến trang Cấu hình Google Chat API

  3. Thiết lập ứng dụng Chat:

    1. Trong trường Tên ứng dụng, hãy nhập Travel ADK AI Agent.
    2. Trong trường URL hình đại diện, hãy nhập https://goo.gle/3SfMkjb.
    3. Trong trường Description (Nội dung mô tả), hãy nhập Travel ADK AI Agent.
    4. Trong phần Cài đặt kết nối, hãy chọn Apps Script.
    5. Trong trường Mã nhận dạng lượt triển khai, hãy dán Mã nhận dạng lượt triển khai đầu tiên mà bạn đã sao chép trước đó.
    6. Đăng ký một Lệnh nhanh mà ứng dụng Chat đã triển khai đầy đủ sử dụng:
      1. Trong phần Lệnh, hãy nhấp vào Thêm lệnh.
      2. Trong Command ID (Mã lệnh), hãy nhập 1.
      3. Trong phần Nội dung mô tả, hãy nhập Reset session.
      4. Trong mục Loại lệnh, hãy chọn Lệnh nhanh.
      5. Trong Name (Tên), hãy nhập Reset session.
      6. Nhấp vào Xong. Lệnh nhanh đã được đăng ký và liệt kê.
    7. Trong mục 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 miền Workspace của bạn rồi nhập địa chỉ email của bạn.
    8. Trong mục Nhật ký, hãy chọn Ghi lỗi vào Nhật ký.
    9. Nhấp vào Lưu.

Giờ đây, bạn có thể truy cập vào ứng dụng này thông qua Google Chat.

  1. Mở Google Chat.

    Chuyển đến Google Chat

  2. Tạo không gian tin nhắn trực tiếp trên Chat:

    1. Nhấp vào biểu tượng Cuộc trò chuyện mới.
    2. Nhập rồi chọn ứng dụng Travel ADK AI Agent trong phần tìm kiếm.
    3. Trong hộp thoại Install app, hãy nhấp vào Cài đặt ứng dụng.
    4. Hộp thoại Install app sẽ đóng và không gian Chat DM mới tạo sẽ được chọn.

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

Kiểm thử nhân viên hỗ trợ

  1. Mở Gmail.

    Truy cập vào Gmail

  2. Gửi email sau đây cho chính bạn:

    • Tiêu đề: You need to travel to Paris
    • Nội dung: Please be there between 11/25/2025 and 11/30/2025!

  3. Mở tiện ích bổ sung Travel ADK AI Agent (Trợ lý AI của Travel ADK) trên thanh bên.

  4. Nhấp vào Cấp quyền để hoàn tất quá trình thiết lập tiện ích bổ sung.

  5. Nhấp vào Gửi sau khi định cấu hình yêu cầu sau đây cho trợ lý:

    • Nội dung: Please help me plan this travel!
    • Bối cảnh: chọn Email hiện tại

    Thanh bên sẽ được cập nhật theo phản hồi của đặc vụ.

    Lên kế hoạch du lịch qua Gmail

  6. Nhấp vào Mở Chat để được chuyển hướng đến không gian tin nhắn trực tiếp trên Chat.

  7. Nhấp vào + > Đặt lại phiên.

    Bạn sẽ nhận được một thông báo mới xác nhận rằng yêu cầu đã được xử lý: OK, let's start from the beginning, what can I help you with?

  8. Gửi tin nhắn Give me ideas.

    Bạn nhận được tin nhắn mới kèm theo câu trả lời của nhân viên hỗ trợ.

    Lên ý tưởng từ Chat

  9. Gửi tin nhắn I want to go there! sau khi tải ảnh của một địa điểm bất kỳ lên, chẳng hạn như Tháp Eiffel.

    Bạn nhận được tin nhắn mới kèm theo câu trả lời của nhân viên hỗ trợ.

    Nhận thông tin chi tiết về vị trí từ tệp đính kèm trong cuộc trò chuyện

Các điểm hạn chế

HTTP

Trong các ứng dụng Google Workspace khác ngoài Chat, đặc vụ AI có các hạn chế sau:

  • Đồng bộ: Thanh bên chỉ có thể được cập nhật để phản hồi các hoạt động tương tác của người dùng, vì vậy, câu trả lời của tác nhân AI chỉ xuất hiện sau khi hoàn tất (không truyền trực tuyến).

  • Có thể hết thời gian chờ: Thanh bên sẽ hết thời gian chờ khi mất hơn vài phút để hoàn tất quá trình cập nhật.

Những điểm hạn chế này không có trong Chat.

Apps Script

Trong tất cả các ứng dụng Google Workspace, tác nhân AI gọi các API REST của Vertex AI bằng UrlFetchApp, điều này gây ra những hạn chế sau:

  • Đồng bộ: Các câu trả lời của tác nhân AI chỉ được trả về sau khi hoàn tất (không truyền trực tuyến).

  • Có thể hết thời gian chờ: Các yêu cầu của AI agent sẽ hết thời gian chờ khi mất khoảng hơn một phút để hoàn tất.

Tuỳ chỉnh

Giải pháp này hỗ trợ các tác nhân AI ADK được lưu trữ trong Vertex AI Agent Engine, một tập hợp con của giao diện người dùng ứng dụng Google Workspace và các bản kết xuất phản hồi dành riêng cho các phản hồi của mẫu Trợ lý du lịch. Giải pháp này sử dụng một khung có thể mở rộng, vì vậy bạn có thể tuỳ chỉnh giải pháp bằng cách sửa đổi các tệp sau:

Python

  • main.py: Xác định các giao diện người dùng chính và logic tương tác của người dùng (trình xử lý sự kiện Google Workspace). Một tiện ích điển hình sẽ là cho phép tài liệu trên Drive làm tính năng ngữ cảnh cho ứng dụng Drive, tương tự như những gì đã thực hiện với thư trong Gmail cho ứng dụng Gmail.

  • vertex_ai.py: Quản lý các phiên, câu trả lời, lỗi của tác nhân AI và xác định các giao diện dành riêng cho Vertex AI để triển khai nhằm hỗ trợ các hoạt động tương tác của tác nhân và việc hiển thị câu trả lời. Các tiện ích thông thường sẽ là thêm tính năng hỗ trợ nhiều phiên cho các cuộc trò chuyện riêng biệt của người dùng và các nền tảng quản lý tác nhân AI khác.

  • agent_handler.py: Triển khai các giao diện dành riêng cho Vertex AI được xác định trong vertex_ai.py trong các trường hợp cụ thể của ứng dụng Chat và ứng dụng không phải Chat. Một tiện ích điển hình là thêm các nút để người dùng gửi ý kiến phản hồi về câu trả lời của nhân viên hỗ trợ AI.

  • google_workspace.py: Triển khai các hoạt động tương tác với nền tảng quản lý tác nhân không phải AI bằng cách sử dụng các lệnh gọi API. Chỉ các API Google Workspace được dùng trong mẫu này để thu thập thông tin chi tiết về bối cảnh và thực hiện các hành động. Một tiện ích điển hình sẽ là thêm các hàm để truy xuất dữ liệu doanh nghiệp từ Lịch Google hoặc một hệ thống Quản lý quan hệ khách hàng (CRM).

  • travel_agent_ui_render.gs: Triển khai các bản kết xuất phản hồi dành riêng cho Trợ lý du lịch cho các ứng dụng phụ và ứng dụng Workspace. Các tiện ích điển hình sẽ là thêm tính năng hỗ trợ cho các bản kết xuất phản hồi mới để hiển thị các lựa chọn chuyến bay bằng đồ hoạ và các tác nhân AI khác.

Apps Script

  • Code.gs: Xác định các giao diện người dùng chính và logic tương tác của người dùng (trình xử lý sự kiện Google Workspace). Một tiện ích điển hình sẽ cho phép các tài liệu trên Drive hoạt động như một tính năng ngữ cảnh cho ứng dụng Drive, tương tự như những gì đã được thực hiện với thư Gmail cho ứng dụng Gmail.

  • VertexAi.gs: Quản lý các phiên, phản hồi, lỗi của tác nhân AI và xác định các giao diện dành riêng cho Vertex AI để triển khai nhằm hỗ trợ các lượt tương tác của tác nhân và việc hiển thị phản hồi. Các tiện ích thông thường sẽ là thêm tính năng hỗ trợ nhiều phiên cho các cuộc trò chuyện riêng biệt của người dùng và các nền tảng quản lý tác nhân AI khác.

  • AgentHandler.gs: Triển khai các giao diện dành riêng cho Vertex AI được xác định trong VertexAi.gs trong các trường hợp cụ thể của ứng dụng Chat và ứng dụng không phải Chat. Một tiện ích điển hình là thêm các nút để người dùng gửi ý kiến phản hồi về câu trả lời của nhân viên hỗ trợ AI.

  • GoogleWorkspace.gs: Triển khai các hoạt động tương tác không phải của nền tảng quản lý tác nhân AI bằng cách sử dụng các lệnh gọi API. Chỉ các API Google Workspace được dùng trong mẫu này để thu thập thông tin chi tiết về bối cảnh và thực hiện các hành động. Một tiện ích điển hình sẽ là thêm các hàm để truy xuất dữ liệu doanh nghiệp từ Lịch Google hoặc một hệ thống Quản lý quan hệ khách hàng (CRM).

  • TravelAgentUiRender.gs: Triển khai các bản kết xuất phản hồi dành riêng cho Trợ lý du lịch cho các ứng dụng phụ và ứng dụng Workspace. Các tiện ích điển hình sẽ là thêm tính năng hỗ trợ cho các bản kết xuất phản hồi mới để hiển thị các lựa chọn chuyến bay bằng đồ hoạ và các tác nhân AI khác.

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.

  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.