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

Mức độ 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 Trò chuyện, Gmail, Lịch, Drive, Tài liệu, Trang tính và Trang trình bày.

Hướng dẫn này chỉ cho bạn cách xuất bản 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 điểm cuối HTTP. Sau khi bạn phát hành 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 Travel Concierge từ Bộ phát triển tác nhân (ADK). Travel Concierge là một AI đa tác nhân đàm thoại sử dụng các công cụ như Google Maps Platform Places API, Google Search Grounding và 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 tác nhân AI từ Chat để đưa ra ý tưởng du lịch.
    Hình 1. Sử dụng tác nhân AI từ Chat để lên ý tưởng du lịch.
  • Sử dụng tác nhân AI từ Gmail để lập kế hoạch du lịch dựa trên ngữ cảnh trong email đã chọn.
    Hình 2. Sử dụng tác nhân AI từ Gmail để lập kế hoạch du lịch 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 tới Gmail, Lịch, Drive, Docs, Sheets, Slides.
  • Triển khai vào Chat.
  • Kiểm tra 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 đều có trên 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 chia sẻ 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à 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 có tệp đính kèm, bao gồm âm thanh và video được ghi trực tiếp từ không gian Trò chuyện.

  • Phản hồi trực quan tiên tiến hơn: Có thể tạo phản hồi bằng các tiện ích tiên tiến hơn như vòng quay có hình ảnh bằng cách dựa vào các tính năng chỉ dành cho trò chuyện của khung Card và không gian hiển thị rộng hơn.

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

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

  • 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 bổ sung của Google Workspace từ các ứng dụng Google Workspace, sử dụng Vertex AI để nhắc nhở tác nhân ADK AI và quản lý phiên của người dùng, đồng thời dựa vào Google Cloud và Google Workspace API để thu thập ngữ cảnh và hiển thị phản hồi.

Sơ đồ sau đây hiển thị luồng người dùng chính: gửi tin nhắn đến tác nhân AI.

HTTP

  • Sơ đồ cấu trúc cho ứng dụng Chat.
    Hình 3. Ứng dụng Trò chuyện hoàn thiện ngữ cảnh bằng các tệp đính kèm từ tin nhắn của người dùng và gửi một tập hợp tin nhắn có lịch sử 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ơ đồ kiến 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 và gửi một nhóm tin nhắn có nhật ký tương tác của các trợ lý ảo và câu trả lời chung cuối cùng theo thứ tự thời gian.
  • Sơ đồ kiến trúc cho các ứng dụng không phải 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 một dự án Google Cloud

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

  1. Trong bảng điều khiển Google Cloud, hãy vào Menu > IAM & 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.

    Tùy chọn: Để chỉnh sửa ID dự án, hãy nhấp vào Chỉnh sửa. ID dự án không thể thay đổi sau khi dự án được tạo, vì vậy hãy chọn ID đá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 Vị trí, hãy nhấp vào Duyệt để hiển thị các vị trí tiềm năng cho dự án của bạ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 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, hãy truy cập Google Cloud CLI (gcloud):

  • Cloud Shell: Để sử dụng thiết bị đầu cuối trực tuyến với gcloud CLI đã được thiết lập, 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 tạo gcloud CLI.
    Để tạo dự á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 ID cho dự án bạn muốn tạo.

Cho phép thanh toán cho dự án Cloud

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

  1. Trong bảng điều khiển Google Cloud, hãy chuyển đến mục Thanh toán. Nhấp vào Menu > Thanh toán > Dự án của tôi.

    Đi tới mục 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ở menu Hành động (), nhấp vào Thay đổi thanh toán và 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 khả dụng, hãy chạy: 
    gcloud billing accounts list
  2. Liên kết tài khoản thanh toán với dự án Google Cloud: 
    gcloud billing projects link PROJECT_ID --billing-account=BILLING_ACCOUNT_ID

    Thay thế nội dung sau:

    • PROJECT_ID là ID dự án cho dự án Cloud mà bạn muốn bật tính năng thanh toán.
    • BILLING_ACCOUNT_ID là ID tài khoản thanh toán để liên kết với dự á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 tài khoản dịch vụ mới với 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 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. Tùy chọn: 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 tài nguyên của dự án Google Cloud. Để biết thêm chi tiết, hãy tham khảo 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 xuống khóa riêng tư 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 vào Menu > IAM & 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 khóa 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 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 khóa này. Để biết thông tin về cách lưu trữ khóa an toàn, hãy xem Quản lý khóa 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 Thông tin ứng dụng, trong 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ó 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 mục Thông tin liên hệ, hãy nhập Địa chỉ email để bạn có thể nhận thông báo về bất kỳ thay đổi nào đố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 ADK AI Agent của Travel Concierge

  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 thế PROJECT_ID bằng ID của dự án Cloud mà bạn đã tạo.

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

    Tải xuống

  3. Trong môi trường phát triển cục bộ mà bạn muốn, hãy giải nén 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 với ID của dự án Cloud mà bạn đã tạo.
    3. PROJECT_LOCATION với vị trí của dự á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 với tên của thùng 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. Lấy số dự án và ID 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, bạn sẽ cần cả hai thông tin này sau để cấu hình dự án.

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

Xem lại mã mẫu

Ngoài ra, trước khi thiết lập dự án, 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.

Python

Xem trên GitHub

Apps Script

Xem trên GitHub

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

Python

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

    Tải xuống

  2. Trong môi trường phát triển cục bộ mà bạn muốn, hãy giải nén 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 bảng điều khiển Google Cloud, hãy truy cập 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 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, chọn Cho phép truy cập công khai.
    6. Trong phần Container, Volume, Networking, Security, trong mục Resources:
      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 ưa thích, hãy triển khai mã 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 với vị trí của hàm Cloud Run mà bạn đã tạo trước đó.
    2. LOCATION bằng vị trí của dự án Google Cloud được tạo ở các bước trước, PROJECT_LOCATION.
    3. PROJECT_NUMBER với số dự án của Travel Concierge ADK AI Agent được triển khai ở các bước trước đó.
    4. ENGINE_ID với ID công cụ của Travel Concierge ADK AI Agent được triển khai ở 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

Để tạo dự án Apps Script và cấu hình dự án đó để sử dụng tác nhân Travel Concierge ADK AI đã triển khai của bạn:

  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, sau đó 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 dự án Apps Script của bạn:

    1. Nhấp vào Bản sao của ADK AI Agent của Travel Concierge.
    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 của bạn, hãy nhấp vào Biểu tượng cho chế độ cài đặt dự án Trình chỉnh sửa và di chuyển tệp VertexAi.gs lên cho đến khi tệp này ở trên tệp AgentHandler.gs bằng cách sử dụng hành động 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 chế độ 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 với vị trí của dự án trên Google Cloud được 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 với khóa JSON từ tài khoản dịch vụ đã tải xuống ở các bước trước đó như { ... }.

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

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

  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 tới Gmail, Lịch, Drive, Docs, Sheets, Slides

Python

Sử dụng triển khai tiện ích bổ sung Google Workspace để cài đặt dự án mẫu vào tất cả các ứng dụng Google Workspace (trừ Google Chat) để có thể thử nghiệm.

  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ừ mã nguồn 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 triển khai tiện ích bổ sung 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 triển khai tiện ích bổ sung Google Workspace:

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

Apps Script

Cài đặt dự án Apps Script vào tất cả các ứng dụng Google Workspace (trừ Google Chat) để cho phép thử nghiệm.

  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 để trò chuyện

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 kiếm Google Chat API, nhấp vào Google Chat API, sau đó nhấp vào Quản lý và Cấu hình.

    Truy cập trang Cấu hình API Google Chat

  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 Hiển thị, hãy chọn Cho phép những người và nhóm cụ thể trong Miền không gian làm việc của bạn sử dụng ứng dụng Trò chuyện này và nhập địa chỉ email của bạn.
    9. Trong Nhật ký, 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 kiếm Google Chat API, nhấp vào Google Chat API, sau đó nhấp vào Quản lý và Cấu hình.

    Truy cập trang Cấu hình API Google Chat

  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 ID triển khai, hãy dán ID triển khai Head 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 Hiển thị, hãy chọn Cho phép những người và nhóm cụ thể trong Miền không gian làm việc của bạn sử dụng ứng dụng Trò chuyện này và nhập địa chỉ email của bạn.
    8. Trong Nhật ký, chọn Ghi lỗi vào Nhật ký.
    9. Nhấp vào Lưu.

Hiện có thể truy cập ứng dụng này từ 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 đóng lại và không gian tin nhắn trực tiếp trò chuyện 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 Gmail

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

    • Chủ đề: 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ên thanh bên.

  4. Nhấp vào Cấp quyền để hoàn tất việc thiết lập tiện ích bổ sung.

  5. Nhấp vào Gửi sau khi cấu hình yêu cầu sau cho tác nhân:

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

    Thanh bên được cập nhật với phản hồi của tác nhân.

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

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

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

    Động não từ Trò chuyện

  9. Gửi tin nhắn I want to go there! sau khi tải lên ảnh của bất kỳ địa điểm nào 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, tác nhân AI có những 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 hạn chế này không tồn tại trong Chat.

Apps Script

Trong tất cả các ứng dụng Google Workspace, tác nhân AI gọi Vertex AI REST API 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ể tạm dừng: Tác nhân AI yêu cầu tạm dừng khi mất hơn một phút để hoàn thành.

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

  • 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 mở rộng thông thường là bật tính năng ngữ cảnh cho tài liệu Drive trong ứng dụng Drive, tương tự như những gì được thực hiện với tin nhắn Gmail trong ứ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 cụ thể của Vertex AI để triển khai nhằm hỗ trợ tương tác của tác nhân và hiển thị phản hồi. Các tiện ích mở rộng thông thường sẽ là thêm hỗ trợ cho 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à không phải Chat. Một tiện ích mở rộng điển hình là thêm các nút để người dùng gửi phản hồi về phản hồi của tác nhân 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 chi 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, chúng tôi khuyên bạn nên xóa dự á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.

    Đi tới 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 xóa, sau đó nhấp vào Xóa .
  3. Trong hộp thoại, hãy nhập mã dự án rồi nhấp vào Tắt để xoá dự án.