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

編碼等級： 先進的
期間45 分鐘
項目類型：Google Workspace 插件擴充聊天，Gmail ，日曆，駕駛，文件、表格和投影片。

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

總覽

在本教學課程中，您將從 Agent Development Kit (ADK) 部署 Travel Concierge 範例。旅遊服務專員是會話式多代理程式 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 代理程式，根據所選電子郵件的內容規劃旅遊行程。

目標

  • 設定環境。
  • 部署人工智慧代理。
  • 設定項目。
  • 部署至 Gmail、Google 日曆、雲端硬碟、文件、試算表、簡報。
  • 部署到聊天。
  • 測試該解決方案。

認識這項解決方案

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

聊天應用程式和非聊天應用程式（Gmail、行事曆、雲端硬碟、文件、表格、投影片）的圖形使用者介面設計不同，以考慮到它們的特定功能和限制。

功能

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

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

  • 富文本訊息: 使用者發送文字訊息並接收帶有富文本和卡片元件的回覆。

  • 錯誤處理: 使用可設定的重試和回應狀態優雅地處理意外錯誤。

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 應用程式會使用使用者訊息中的附件完成內容，並依時間順序傳送一組訊息，其中包含子代理程式互動記錄和最終整體答案。
  • 非聊天應用程式的架構圖。
    圖 4. 非聊天應用程式透過使用者的 Google 個人資料和專案選擇來完善上下文，並按時間倒序顯示一組部分，其中包含子代理互動的歷史記錄和最終的總體答案。

必要條件

準備環境

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

建立 Google Cloud 專案

Google Cloud 控制台

  1. 在 Google Cloud 控制台中，前往「選單」。 > 身分與存取管理 > 創建專案。

    前往「建立專案」

  2. 在項目名稱請在此輸入項目的描述性名稱。

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

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

gcloud CLI

在以下開發環境之一中，造訪 Google Cloud CLI (gcloud):

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

啟用雲端項目的計費功能

Google Cloud 控制台

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

    前往我的專案結算頁面

  2. 在 選擇組織 中，選擇與您的 Google Cloud 項目相關聯的組織。
  3. 在項目行中，開啟 操作 選單 ()，點選 變更結算，然後選擇雲結算帳戶。
  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 外掛程式 API。

    啟用 API

  2. 確認您正在正確的雲端專案中啟用 API，然後按一下 下一步。

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

Apps Script

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

    啟用 API

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

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

取得 Google Maps Platform 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 控制台中，依序前往「選單」圖示 >「IAM 與管理」 >「服務帳戶」。

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

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

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

  5. 點選「關閉」。

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

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

  1. 前往 Google Cloud 控制台，依序點選「選單」圖示 > Google Auth platform >「品牌」。

    前往「品牌宣傳」

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

部署 Travel Concierge 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 替換為您要使用的不重複值區名稱。
    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. 在「記憶體」欄位中，選取「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. 使用您先前複製的 端點 URL 進行 BASE_URL 操作。

Apps Script

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

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

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

  3. 為 Apps Script 專案副本命名：

    1. 點選 複製旅行禮賓 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 Agent 的引擎 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 Agent 的項目編號，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. 在「觸發條件」下方，選取「為所有觸發條件使用通用的 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 擴充應用程式提供給 Your Workspace 網域中的特定使用者和群組」，然後輸入電子郵件地址。
    9. 在「記錄」下方，選取「將錯誤記錄至 Logging」。
    10. 按一下 [儲存]。

Apps Script

使用主要部署作業 ID 將 Apps Script 專案安裝至 Chat，以便進行測試。

  1. 在 Apps Script 專案中，依序點選「部署」>「測試部署作業」，然後按一下「Head Deployment ID」(正式版部署作業 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. 在 Deployment ID 欄位中，貼上您先前複製的 Head deployment ID。
    6. 註冊一個完全實現的聊天應用程式所使用的快速命令：
      1. 在 指令 下，按一下 新增指令。
      2. 在「Command ID」(指令 ID) 中，輸入 1。
      3. 在「說明」中輸入 Reset session。
      4. 在「指令類型」下方，選取「快速指令」。
      5. 在「Name」(名稱) 中輸入 Reset session。
      6. 按一下「完成」，快速指令已註冊並列出。
    7. 在「瀏覽權限」下方，選取「將這個 Chat 擴充應用程式提供給 Your Workspace 網域中的特定使用者和群組」，然後輸入電子郵件地址。
    8. 在「記錄」下方，選取「將錯誤記錄至 Logging」。
    9. 按一下 [儲存]。

現在可以透過 Google Chat 存取該應用程式。

  1. 開啟 Google Chat。

    前往 Google Chat

  2. 建立聊天私訊空間：

    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. 點選開啟聊天即可跳到聊天私訊空間。

  7. 點選 + > 重設會話。

    您收到一則新訊息，確認操作已完成：OK, let's start from the beginning, what can I help you with?

  8. 發送訊息 Give me ideas。

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

    聊天集思廣益

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

    您將收到包含代理人回覆的新訊息。

    從聊天附件中取得位置詳情

限制

HTTP

在聊天以外的 Google Workspace 應用程式中，AI 代理程式存在以下限制：

  • 它是同步的: 側邊欄只能回應使用者互動而更新，因此 AI 代理程式的回應僅在完全完成後才會顯示（無串流）。

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

Chat 則沒有這些限制。

Apps Script

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

  • 它是同步的:人工智慧代理的回應僅在完全完成後返回（無串流）。

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

自訂

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

Python

  • main.py: 定義主要使用者介面和使用者互動邏輯（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: 在聊天和非聊天應用程式的特定情況下，實作 VertexAi.gs 中定義的 Vertex AI 特定介面。 一個典型的擴充功能是新增按鈕，讓使用者可以發送關於人工智慧代理回應的回饋。

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

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

清除所用資源

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

  1. 在 Google Cloud 控制台中，前往 管理資源 頁面。點選選單 > 身分與存取管理 > 管理資源。

    前往 Resource Manager

  2. 在項目清單中，選擇要刪除的項目，然後按一下 刪除 。
  3. 在對話方塊中，輸入項目 ID，然後按一下 關閉 刪除項目。