透過 Google Workspace 存取的 AI 代理程式規劃旅遊行程

程式碼程度：進階
時間長度：45 分鐘
專案類型：Google Workspace 外掛程式 擴充 Chat、 Gmail、 Google 日曆、 雲端硬碟、 文件、試算表和簡報。

本教學課程說明如何使用 Apps Script 或 HTTP 端點，將 AI 代理程式發布至 Google Workspace 做為 Google Workspace 外掛程式。外掛程式發布後，使用者就能在工作流程中與 AI 代理互動。

總覽

在本教學課程中，您將從 Agent Development Kit (ADK) 部署旅遊服務專員範例。旅遊服務專員是會話式多代理程式 AI，使用 Google 地圖平台 Places API、Google 搜尋 Grounding 和 Model Context Protocol (MCP) 伺服器等工具。

ADK 預設會為開發人員提供即時通訊和文字介面。在本教學課程中，您將在 Google Workspace 應用程式中新增圖形使用者介面 (GUI)，使用者可以直接在 Chat、Gmail、日曆、雲端硬碟、Google 文件、試算表和簡報中存取。

  • 使用 Chat 的 AI 代理構思旅遊點子。
    圖 1. 使用 Chat 的 AI 代理激發旅遊靈感。
  • 使用 Gmail 的 AI 代理程式，根據所選電子郵件的內容規劃旅遊行程。
    圖 2. 使用 Gmail 中的 AI 代理程式，根據所選電子郵件的內容規劃旅遊行程。

目標

  • 設定環境。
  • 部署 AI 代理程式。
  • 設定專案。
  • 部署至 Gmail、Google 日曆、雲端硬碟、文件、試算表、簡報。
  • 部署至 Chat。
  • 測試解決方案。

認識這項解決方案

這項解決方案採用下列核心技術：ADK、Google Cloud 和 Google Workspace API、Vertex AI Agent Engine，以及 Card 架構。

Chat 和非 Chat (Gmail、日曆、雲端硬碟、文件、試算表、簡報) 應用程式的 GUI 設計不同，這是因為要考量到這些應用程式的特定功能和限制。

功能

Travel Concierge 應用程式的下列功能與所有 Google Workspace 應用程式相同：

  • 持續性使用者工作階段：工作階段由 Vertex AI 管理，可持續存在。每位使用者在所有 Workspace 應用程式中都會共用一個工作階段。 使用者可以手動重設工作階段，開始新的對話。

  • 豐富訊息：使用者傳送訊息並接收回覆時，會看到豐富的文字和資訊卡小工具。

  • 錯誤處理：使用可設定的重試次數和回應狀態，妥善處理非預期錯誤。

Chat 應用程式提供下列額外功能：

  • 多模式使用者訊息：使用者可以傳送附有附件的訊息，包括直接從 Chat 聊天室錄製的音訊和影片。

  • 更進階的視覺化回覆：回覆可使用更進階的小工具 (例如含有圖片的輪轉介面) 生成，這類小工具採用 Card 架構的純聊天功能，並提供更多算繪空間。

其他應用程式則提供下列額外功能：

  • Google 個人資料內容：使用者可以傳送含有個人資料資訊的訊息 (本範例僅限生日)。

  • Gmail 內容：使用者可以透過電子郵件傳送訊息 (本範例僅限一個主旨和內文)。

  • 專員的 Chat 聊天室存取權：使用者只要按一下按鈕，即可在新分頁中開啟 Chat 應用程式的即時訊息 (DM) 聊天室。

架構

旅遊服務專員應用程式會接收及處理 Google Workspace 應用程式的 Google Workspace 外掛程式互動事件、使用 Vertex AI 提示 ADK AI 代理程式和管理使用者工作階段，並依賴 Google Cloud 和 Google Workspace API 收集背景資訊及顯示回覆。

下圖顯示主要使用者流程：傳送訊息給 AI 代理程式。

HTTP

  • Chat 應用程式的架構圖。
    圖 3. Chat 應用程式會使用使用者訊息中的附件完成情境，並依時間順序傳送一組訊息，其中包含子代理程式互動記錄和最終整體答案。
  • 非 Chat 應用程式的架構圖。
    圖 4. 非 Chat 應用程式會使用使用者的 Google 個人資料和項目選取內容完成情境，並以反向時間順序顯示一組章節，當中包含子代理程式互動記錄和最終整體答案。

Apps Script

  • Chat 應用程式的架構圖。
    圖 3. Chat 應用程式會使用使用者訊息中的附件完成情境，並依時間順序傳送一組訊息，其中包含子代理程式互動記錄和最終整體答案。
  • 非 Chat 應用程式的架構圖。
    圖 4. 非 Chat 應用程式會使用使用者的 Google 個人資料和項目選取內容完成情境，並以反向時間順序顯示一組章節，當中包含子代理程式互動記錄和最終整體答案。

必要條件

準備環境

本節說明如何建立及設定 Google Cloud 專案。

建立 Google Cloud 專案

Google Cloud 控制台

  1. 前往 Google Cloud 控制台的「選單」 >「IAM 與管理」 >「建立專案」。

    前往「建立專案」

  2. 在「Project Name」(專案名稱) 欄位中，輸入專案的描述性名稱。

    選用：如要編輯「專案 ID」，請按一下「編輯」。專案建立後就無法變更專案 ID，因此請選用符合專案執行期間需求的 ID。

  3. 在「Location」(位置) 欄位中，按一下「Browse」(瀏覽)，即可顯示專案的可能位置。然後按一下「選取」。
  4. 按一下「建立」，Google Cloud 控制台會前往「資訊主頁」頁面，並在幾分鐘內建立專案。

gcloud CLI

在下列其中一種開發環境中存取 Google Cloud CLI (gcloud)：

  • Cloud Shell：如要使用已設定 gcloud CLI 的線上終端機，請啟用 Cloud Shell。
    啟用 Cloud Shell
  • 本機殼層：如要使用本機開發環境，請安裝並初始化 gcloud CLI。
    如要建立 Cloud 專案，請使用 gcloud projects create 指令： 
    gcloud projects create PROJECT_ID
     將 PROJECT_ID 替換為要建立的專案 ID。

啟用 Cloud 專案的計費功能

Google Cloud 控制台

  1. 前往 Google Cloud 控制台的「帳單」頁面。依序點選「選單」「帳單」「我的專案」。

    前往「我的專案」的帳單頁面

  2. 在「選取機構」中，選擇與 Google Cloud 專案相關聯的機構。
  3. 在專案列中開啟「動作」選單 ()，按一下「變更帳單」，然後選擇 Cloud 帳單帳戶。
  4. 按一下 [設定帳戶]。

gcloud CLI

  1. 如要列出可用的帳單帳戶，請執行下列指令： 
    gcloud billing accounts list
  2. 將帳單帳戶連結至 Google Cloud 專案： 
    gcloud billing projects link PROJECT_ID --billing-account=BILLING_ACCOUNT_ID

    更改下列內容：

    • PROJECT_ID 是要啟用計費功能的 Cloud 專案的專案 ID。
    • BILLING_ACCOUNT_ID 是要連結至 Google Cloud 專案的帳單帳戶 ID。

啟用 Google Cloud API

HTTP

  1. 在 Google Cloud 控制台中，啟用 Vertex AI、Places、People、Google Chat、Gmail、Cloud Build、Cloud Functions、Cloud Pub/Sub、Cloud Logging、Artifact Registry、Cloud Run、Google Workspace 外掛程式和 Cloud Resource Manager API。

    啟用 API

  2. 確認您要在正確的 Cloud 專案中啟用 API，然後按一下「下一步」。

  3. 確認要啟用的 API 正確無誤，然後按一下「啟用」。

Apps Script

  1. 在 Google Cloud 控制台中，啟用 Vertex AI、Places、People、Google Chat 和 Cloud Resource Manager API。

    啟用 API

  2. 確認您要在正確的 Cloud 專案中啟用 API，然後按一下「下一步」。

  3. 確認要啟用的 API 正確無誤，然後按一下「啟用」。

取得 Google 地圖平台 Places API 金鑰

  1. 在 Google Cloud 控制台中，前往「Google Maps Platform」>「Keys & Credentials」(金鑰和憑證) 頁面。

    前往「金鑰和憑證」

  2. 「開始使用 Google 地圖平台」對話方塊會顯示您新建立的 API 金鑰 (英數字串)。您會在下一個章節中用到這個字串。

在 Google Cloud 控制台中建立服務帳戶

按照下列步驟，建立具備 Vertex AI User 角色的新服務帳戶：

Google Cloud 控制台

  1. 在 Google Cloud 控制台中，依序前往「選單」圖示 >「IAM 與管理」 >「服務帳戶」。

    前往「Service Accounts」(服務帳戶) 頁面

  2. 按一下「建立服務帳戶」。
  3. 填寫服務帳戶詳細資料，然後按一下「建立並繼續」。
  4. 選用步驟：將角色指派給服務帳戶，授予 Google Cloud 專案資源的存取權。詳情請參閱「授予、變更及撤銷資源的存取權」。
  5. 按一下「繼續」。
  6. 選用：輸入可管理這個服務帳戶及執行動作的使用者或群組。詳情請參閱「管理服務帳戶模擬功能」。
  7. 按一下「完成」，請記下服務帳戶的電子郵件地址。

gcloud CLI

  1. 建立服務帳戶： 
    gcloud iam service-accounts create SERVICE_ACCOUNT_NAME \
  --display-name="SERVICE_ACCOUNT_NAME"
  2. 選用步驟：將角色指派給服務帳戶，授予 Google Cloud 專案資源的存取權。詳情請參閱「授予、變更及撤銷資源的存取權」。

服務帳戶會顯示在服務帳戶頁面。接著，請為服務帳戶建立私密金鑰。

建立私密金鑰

如要建立及下載服務帳戶的私密金鑰，請按照下列步驟操作：

  1. 在 Google Cloud 控制台中，依序前往「Menu」(選單) >「IAM & Admin」(IAM 與管理) >「Service Accounts」(服務帳戶)。

    前往「Service Accounts」(服務帳戶) 頁面

  2. 選取服務帳戶。
  3. 依序點選「金鑰」>「新增金鑰」>「建立新的金鑰」。
  4. 選取「JSON」，然後按一下「建立」。

    接著，系統就會為您產生一對新的公開/私密金鑰，並以新檔案的形式下載至您的電腦中。將下載的 JSON 檔案儲存為工作目錄中的 credentials.json。這個檔案是這組金鑰的唯一副本，如要瞭解如何安全儲存金鑰，請參閱「管理服務帳戶金鑰」一文。

  5. 點選「關閉」。

如要進一步瞭解服務帳戶，請參閱 Google Cloud IAM 說明文件中的服務帳戶。

Google Workspace 外掛程式需要設定同意畫面。設定外掛程式的 OAuth 同意畫面，可定義 Google 向使用者顯示的內容。

  1. 在 Google Cloud 控制台中，依序前往「Menu」(選單) > Google Auth platform >「Branding」(品牌)。

    前往「Branding」(品牌宣傳)

  2. 如果您已設定 Google Auth platform，可以在「Branding」(品牌)、「Audience」(目標對象) 和「Data Access」(資料存取權) 中設定下列 OAuth 同意畫面設定。如果看到「Get Started」(尚未設定)Google Auth platform 訊息，請按一下「開始使用」：
    1. 在「App Information」(應用程式資訊) 下方的「App name」(應用程式名稱) 欄位中，輸入應用程式名稱。
    2. 在「User support email」(使用者支援電子郵件) 中，選擇支援電子郵件地址，方便使用者在同意聲明方面有任何疑問時與您聯絡。
    3. 點選 [Next] (下一步)。
    4. 在「Audience」(目標對象) 下方，選取「Internal」(內部)。
    5. 點選 [Next] (下一步)。
    6. 在「Contact Information」(聯絡資訊) 下方，輸入可接收專案異動通知的電子郵件地址。
    7. 點選 [Next] (下一步)。
    8. 在「Finish」(完成) 部分，請詳閱《Google API 服務使用者資料政策》，然後選取「我同意《Google API 服務：使用者資料政策》」。
    9. 按一下 [Continue] (繼續)。
    10. 按一下「Create」(建立)。
  3. 目前可以略過新增範圍。 日後建立應用程式供 Google Workspace 機構以外的使用者使用時，請務必將「使用者類型」變更為「外部」。然後新增應用程式需要的授權範圍。詳情請參閱完整的「設定 OAuth 同意畫面」指南。

部署旅遊服務專員 ADK AI 代理

  1. 如果尚未完成，請使用 Google Cloud 帳戶進行驗證，並設定 Google Cloud CLI 以使用您的 Google Cloud 專案。

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

    將 PROJECT_ID 替換為您建立的 Cloud 專案 ID。

  2. 下載這個 GitHub 存放區

    下載

  3. 在偏好的本機開發環境中，解壓縮下載的封存檔，然後開啟 adk-samples/python/agents/travel-concierge 目錄。

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

  4. 建立專供 ADK AI 代理程式使用的新 Cloud Storage bucket。

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

    更改下列內容：

    1. CLOUD_STORAGE_BUCKET_NAME 替換成您要使用的不重複 bucket 名稱。
    2. 將 PROJECT_ID 替換為您建立的 Cloud 專案 ID。
    3. PROJECT_LOCATION，並填入您建立的 Cloud 專案位置。

  5. 請設定下列環境變數：

    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

    更改下列內容：

    1. 將 PROJECT_ID 替換為您建立的 Cloud 專案 ID。
    2. PROJECT_LOCATION，並填入您建立的 Cloud 專案位置。
    3. 將 PLACES_API_KEY 替換為您建立的 API 金鑰字串。
    4. CLOUD_STORAGE_BUCKET_NAME 替換為您建立的值區名稱。

  6. 安裝及部署 ADK AI 代理程式。

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

  7. 從最後列印的記錄檔中分別擷取專案編號和引擎 ID (PROJECT_NUMBER 和 ENGINE_ID)，稍後設定專案時會用到這兩項資訊。

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

查看程式碼範例

(選用) 設定專案前，請花點時間查看並熟悉 GitHub 上的範例程式碼。

Python

前往 GitHub 查看

Apps Script

前往 GitHub 查看

建立及設定專案

Python

  1. 下載這個 GitHub 存放區

    下載

  2. 在偏好的本機開發環境中，解壓縮下載的封存檔，然後開啟 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. 將先前步驟下載的服務帳戶 JSON 金鑰檔案 credentials.json 移至專案目錄。

  4. 前往 Google Cloud 控制台的「Cloud Run」：

    前往 Cloud Run

  5. 按一下「編寫函式」。

  6. 在「建立服務」頁面中，設定函式：

    1. 在「Service name」(服務名稱) 欄位中輸入 travel-concierge-app。
    2. 在「Region」(區域) 清單中，選取您建立的 Cloud 專案位置「PROJECT_LOCATION」。
    3. 在「端點網址」下方，按一下 建立副本的圖示。
    4. 在「Runtime」清單中，選取最新版本的 Python。
    5. 在「Authentication」(驗證) 專區中，選取「Allow public access」(允許公開存取)。
    6. 在「容器、磁碟區、網路與安全性」部分的「資源」下方：
      1. 在「Memory」(記憶體) 欄位中，選取「1 GiB」。
      2. 在「CPU」欄位中，選取「2」。
    7. 按一下「建立」，然後等待 Cloud Run 建立服務。 控制台會將您重新導向至「來源」分頁。

  7. 在偏好的本機開發環境中，部署專案的來源：

    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

    更改下列內容：

    1. PROJECT_LOCATION，這是您先前建立的 Cloud Run 函式位置。
    2. LOCATION，並提供先前步驟中建立的 Google Cloud 專案位置 PROJECT_LOCATION。
    3. PROJECT_NUMBER 替換為您在先前步驟中部署的 Travel Concierge ADK AI 代理程式專案編號。
    4. ENGINE_ID，並替換成先前步驟中部署的 Travel Concierge ADK AI 代理引擎 ID。
    5. BASE_URL 替換為您先前複製的端點網址。

Apps Script

如要建立 Apps Script 專案，並設定為使用已部署的 Travel Concierge ADK AI 代理程式，請按照下列步驟操作：

  1. 按一下以下按鈕，開啟 Travel Concierge ADK AI Agent Apps Script 專案。
    開啟專案

  2. 依序點按「總覽」和「建立副本」建立副本的圖示。

  3. 為複製的 Apps Script 專案命名：

    1. 按一下「Copy of Travel Concierge ADK AI Agent」(旅遊服務 ADK AI 代理程式副本)。
    2. 在「專案標題」中輸入 Travel Concierge ADK AI Agent。
    3. 按一下 [重新命名]。

  4. 在 Apps Script 專案中，按一下「編輯器」專案設定圖示，然後使用「將檔案上移」檔案動作，將 VertexAi.gs 檔案上移至 AgentHandler.gs 檔案上方。

  5. 在 Apps Script 專案中，依序點按 專案設定圖示「專案設定」「編輯指令碼屬性」「新增指令碼屬性」，然後新增下列指令碼屬性：

  6. ENGINE_ID，其中包含先前步驟中部署的 Travel Concierge ADK AI 代理的引擎 ID。ENGINE_ID

  7. LOCATION，其中包含在上一個步驟中建立的 Google Cloud 專案位置 PROJECT_LOCATION。

  8. PROJECT_NUMBER，其中 PROJECT_NUMBER 是在先前步驟中部署的 Travel Concierge ADK AI 代理程式專案號碼。

  9. SERVICE_ACCOUNT_KEY，其中包含先前步驟下載的服務帳戶 JSON 金鑰，例如 { ... }。

  10. 按一下「儲存指令碼屬性」

  11. 在 Apps Script 專案中，按一下「專案設定」專案設定圖示。

  12. 點選「Google Cloud Platform (GCP) 專案」下方的「變更專案」。

  13. 在「GCP 專案編號」中，貼上先前步驟部署的 Travel Concierge ADK AI 代理程式專案編號，PROJECT_NUMBER。

  14. 點選「設定專案」。Cloud 專案和 Apps Script 專案現已連結。

部署至 Gmail、日曆、雲端硬碟、文件、試算表、簡報

Python

使用 Google Workspace 外掛程式部署作業，將範例專案安裝至所有 Google Workspace 應用程式 (但 Google Chat 除外)，以啟用測試。

  1. 在偏好的本機開發環境中，開啟專案程式碼來源的 deployment.json 檔案，並將所有 $BASE_URL 換成 BASE_URL 的值，也就是您在上一個步驟中複製的端點網址。

  2. 建立名為 travel-concierge-addon 的 Google Workspace 外掛程式部署作業：

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

  3. 安裝 Google Workspace 外掛程式部署作業：

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

Apps Script

將 Apps Script 專案安裝至所有 Google Workspace 應用程式 (Google Chat 除外)，即可啟用測試。

  1. 在 Apps Script 專案中，依序點選「部署」>「測試部署作業」，然後點選「安裝」。

現在可以從 Google Workspace 應用程式的側欄存取外掛程式。

部署至 Chat

Python

使用端點網址將範例專案安裝至 Chat，以便進行測試。

  1. 在控制台中搜尋 Google Chat API，依序點選「Google Chat API」、「管理」和「設定」。

    前往 Google Chat API 設定頁面

  2. 設定 Chat 應用程式：

    1. 在「應用程式名稱」欄位中輸入 Travel ADK AI Agent。
    2. 在「Avatar URL」(虛擬人偶網址) 欄位中，輸入 https://goo.gle/3SfMkjb。
    3. 在「Description」(說明) 欄位輸入 Travel ADK AI Agent。
    4. 在「連線設定」下方，選取「HTTP 端點網址」。
    5. 在「Triggers」(觸發條件) 下方，選取「Use a common HTTP endpoint URL for all triggers」(為所有觸發條件使用通用的 HTTP 端點網址)。
    6. 在「HTTP endpoint URL」欄位中，貼上您先前複製的「Endpoint URL」，即 BASE_URL。
    7. 註冊完全實作的 Chat 應用程式所使用的快速指令：
      1. 在「指令」下方，按一下「新增指令」。
      2. 在「Command ID」(指令 ID) 中，輸入 1。
      3. 在「說明」中輸入 Reset session。
      4. 在「指令類型」下方，選取「快速指令」。
      5. 在「Name」(名稱) 中輸入 Reset session。
      6. 按一下「完成」，快速指令已註冊並列出。
    8. 在「瀏覽權限」下方，選取「將這個 Chat 擴充應用程式提供給『您的 Workspace 網域』中的特定使用者和群組」，然後輸入電子郵件地址。
    9. 在「記錄」下方，選取「將錯誤記錄至 Logging」。
    10. 按一下 [儲存]。

Apps Script

使用首要部署作業 ID 將 Apps Script 專案安裝至 Chat，即可啟用測試。

  1. 在 Apps Script 專案中，依序點選「部署」>「測試部署作業」，然後點選「首要部署作業 ID」下方的「複製」首要部署作業 ID 複製圖示。

  2. 在控制台中搜尋 Google Chat API，依序點選「Google Chat API」、「管理」和「設定」。

    前往 Google Chat API 設定頁面

  3. 設定 Chat 應用程式：

    1. 在「應用程式名稱」欄位中輸入 Travel ADK AI Agent。
    2. 在「Avatar URL」(虛擬人偶網址) 欄位中，輸入 https://goo.gle/3SfMkjb。
    3. 在「Description」(說明) 欄位輸入 Travel ADK AI Agent。
    4. 在「連線設定」下方，選取「Apps Script」。
    5. 在「部署 ID」欄位中，貼上您先前複製的「Head 部署 ID」。
    6. 註冊完全實作的 Chat 應用程式所使用的快速指令：
      1. 在「指令」下方，按一下「新增指令」。
      2. 在「Command ID」(指令 ID) 中，輸入 1。
      3. 在「說明」中輸入 Reset session。
      4. 在「指令類型」下方，選取「快速指令」。
      5. 在「Name」(名稱) 中輸入 Reset session。
      6. 按一下「完成」，快速指令已註冊並列出。
    7. 在「瀏覽權限」下方，選取「將這個 Chat 擴充應用程式提供給『您的 Workspace 網域』中的特定使用者和群組」，然後輸入電子郵件地址。
    8. 在「記錄」下方，選取「將錯誤記錄至 Logging」。
    9. 按一下 [儲存]。

您現在可以透過 Google Chat 存取這個應用程式。

  1. 開啟 Google Chat。

    前往 Google Chat

  2. 建立 Chat 直接訊息聊天室：

    1. 按一下「發起即時通訊」。
    2. 在搜尋結果中輸入並選取應用程式 Travel ADK AI Agent。
    3. 在 Install app 對話方塊中，按一下「安裝應用程式」。
    4. Install app對話方塊會關閉，並選取新建立的 Chat 直接訊息空間。

Chat 應用程式已準備好回覆訊息。

測試代理

  1. 開啟 Gmail。

    前往 Gmail

  2. 將下列電子郵件寄給自己：

    • 主旨： You need to travel to Paris
    • 內文： Please be there between 11/25/2025 and 11/30/2025!

  3. 從側欄開啟「Travel ADK AI Agent」外掛程式。

  4. 按一下「授予權限」，完成外掛程式設定。

  5. 設定對代理商的要求後，按一下「傳送」：

    • 訊息： Please help me plan this travel!
    • 內容：選取「目前的電子郵件」

    側欄會更新為代理程式的回覆。

    透過 Gmail 規劃旅遊行程

  6. 按一下「開啟 Chat」，系統會將你重新導向至 Chat 即時訊息空間。

  7. 依序點選「+」>「重設工作階段」。

    你會收到確認作業完成的新訊息： OK, let's start from the beginning, what can I help you with?

  8. 傳送訊息 Give me ideas。

    你會收到服務專員回覆的新訊息。

    透過 Chat 發想點子

  9. 上傳任何地點的圖片 (例如艾菲爾鐵塔) 後，傳送 I want to go there! 訊息。

    你會收到服務專員回覆的新訊息。

    從 Chat 附件取得地點詳細資料

限制

HTTP

在 Chat 以外的 Google Workspace 應用程式中，AI 代理程式有下列限制：

  • 同步：側欄只能在回應使用者互動時更新，因此 AI 代理程式的回覆只會在完全完成後顯示 (不會串流)。

  • 可能會逾時：如果側邊欄更新作業需要幾分鐘以上才能完成，就會逾時。

Chat 則沒有這些限制。

Apps Script

在所有 Google Workspace 應用程式中，AI 代理程式都會使用 UrlFetchApp 呼叫 Vertex AI REST API，因此會受到下列限制：

  • 同步：AI 代理程式只會在完整完成後傳回回覆 (不會串流)。

  • 可能會逾時：如果 AI 服務代理人完成要求所需時間超過一分鐘，就會逾時。

自訂

這項解決方案支援 Vertex AI Agent Engine 中代管的 ADK AI 代理程式、Google Workspace 應用程式 UI 的子集，以及專為 Travel Concierge 範例回覆提供的回應呈現方式。這個解決方案採用可擴充的架構，因此您可以修改下列檔案來進行自訂：

Python

  • main.py:定義主要 UI 和使用者互動邏輯 (Google Workspace 事件處理常式)。舉例來說，您可以啟用雲端硬碟文件做為雲端硬碟應用程式的內容功能，類似於 Gmail 應用程式的 Gmail 郵件。

  • vertex_ai.py:管理 AI 代理工作階段、回覆和錯誤，並定義要實作的 Vertex AI 專屬介面，以支援代理互動和回覆算繪。常見的擴充功能包括為個別使用者對話新增多重工作階段支援，以及其他 AI 代理程式管理平台。

  • agent_handler.py：在 Chat 和非 Chat 應用程式的特定情況下，實作 vertex_ai.py 中定義的 Vertex AI 專屬介面。常見的擴充功能是新增按鈕，供使用者傳送有關 AI 代理程式回覆的意見回饋。

  • google_workspace.py:使用 API 呼叫實作非 AI 代理程式管理平台互動。本範例只會使用 Google Workspace API 收集背景資訊詳細資料並採取行動。一般來說，擴充功能會新增函式，以便從 Google 日曆或客戶關係管理 (CRM) 系統擷取商家資料。

  • travel_agent_ui_render.gs:為子代理程式和 Workspace 應用程式實作 Travel Concierge 專屬的回應算繪。常見的擴充功能包括新增支援，以圖形方式顯示航班選項和其他 AI 代理程式。

Apps Script

  • Code.gs:定義主要 UI 和使用者互動邏輯 (Google Workspace 事件處理常式)。舉例來說，您可以啟用雲端硬碟文件做為雲端硬碟應用程式的內容功能，類似於 Gmail 應用程式的 Gmail 郵件。

  • VertexAi.gs:管理 AI 代理工作階段、回覆、錯誤，並定義要實作的 Vertex AI 專屬介面，以支援代理互動和回覆算繪。常見的擴充功能包括為個別使用者對話新增多重工作階段支援，以及其他 AI 代理程式管理平台。

  • AgentHandler.gs：在 Chat 和非 Chat 應用程式的特定案例中，實作 VertexAi.gs 中定義的 Vertex AI 專屬介面。常見的擴充功能是新增按鈕，供使用者傳送有關 AI 代理程式回覆的意見回饋。

  • GoogleWorkspace.gs:使用 API 呼叫實作非 AI 代理程式管理平台互動。本範例只會使用 Google Workspace API 收集背景資訊詳細資料並採取行動。一般來說，擴充功能會新增函式，以便從 Google 日曆或客戶關係管理 (CRM) 系統擷取商家資料。

  • TravelAgentUiRender.gs:為子代理程式和 Workspace 應用程式實作 Travel Concierge 專屬的回應算繪。 常見的擴充功能包括新增支援，以圖形方式顯示航班選項和其他 AI 代理程式。

清除所用資源

為避免系統向您的 Google Cloud 帳戶收取本教學課程所用資源的費用，建議您刪除 Cloud 專案。

  1. 在 Google Cloud 控制台中，前往「管理資源」頁面。依序點選「選單」「IAM 與管理」「管理資源」。

    前往 Resource Manager

  2. 在專案清單中選取要刪除的專案，然後按一下「刪除」圖示 。
  3. 在對話方塊中輸入專案 ID，然後按一下「Shut down」(關閉) 即可刪除專案。