Run the agent using the ADK's Web UI

Check my progress

/ 40

Run an agent programmatically

Check my progress

/ 40

Preview a multi-agent example

Check my progress

/ 20

This lab may incorporate AI tools to support your learning.
注意:為了確保一致且高效能的體驗,本實驗室可能會針對某些模型要求提供快取的回應。

GENAI104

Google Cloud 自學實驗室

總覽

想要建構複雜的代理應用程式,通常需要協調多種專用模型、整合管理工具,並對執行作業追蹤記錄進行偵錯,這些作業可能需要耗費大量人力,且難以調度資源。

Agent Development Kit (ADK) 可提供模組框架,協助建構、測試及部署多代理系統,解決上述難題。您可以透過 ADK,在階層結構中組合專用代理、為代理提供預先建構或自訂的工具,並運用可預測管道和動態 LLM 轉送功能,管理自動化調度工作流程。

在本實驗室中,您將使用 ADK 建構研究助理,運用 分析資料並生成結構化報表。您也將瞭解如何動態管理這些依附元件,確保新模型發布時,代理式工作流程仍可保持穩定。

目標

在本實驗室中,您將瞭解如何執行下列工作:

  • 說明 ADK 架構 (代理、工具和工作階段)。
  • 為代理應用程式設定本機開發環境。
  • 定義具有動態模型和自訂工具存取權的代理。
  • 使用 ADK 瀏覽器 UI、Python 程式碼和 CLI 聊天介面,執行及檢查代理。

ADK 的優點

使用 ADK 建構代理應用程式,可以為開發人員帶來以下主要好處:

  • 多代理系統:在階層結構中組合專用代理,建構可擴充的模組化應用程式。
  • 豐富的工具生態系統:為代理提供預先建構的工具和自訂功能,也可整合 LangChain 和 CrewAI 等框架。
  • 靈活的自動化調度管理機制:使用工作流程代理定義可預測的管道,或使用 LLM 創造靈活動態的轉送。
  • 整合式開發人員體驗:使用功能強大的 CLI 和互動式 UI,在本機開發及偵錯,並逐步檢查執行作業。
  • 內建評估功能:與測試案例比較,評估回覆品質和執行軌跡,有系統地判斷效能。
  • 隨時都可部署:在 Vertex AI Agent Engine、Cloud Run 或自訂 Docker 基礎架構,輕鬆將代理容器化並調度相關資源。

雖然其他 SDK 也可查詢模型,但 ADK 提供更高階的框架,可協助處理多種模型之間的複雜協調作業。

設定和需求

瞭解以下事項後,再點選「Start Lab」按鈕

請詳閱以下操作說明。實驗室活動會計時,且中途無法暫停。點選「Start Lab」後就會開始計時,顯示可使用 Google Cloud 資源的時間。

您將在真正的雲端環境完成實作實驗室活動,而不是模擬或示範環境。為此,我們會提供新的暫時憑證,供您在實驗室活動期間登入及存取 Google Cloud。

為了順利完成這個實驗室,請先確認:

  • 可以使用標準的網際網路瀏覽器 (Chrome 瀏覽器為佳)。
注意事項:請使用無痕模式 (建議選項) 或私密瀏覽視窗執行此實驗室,這可以防止個人帳戶和學員帳戶之間的衝突,避免個人帳戶產生額外費用。
  • 是時候完成實驗室活動了!別忘了,活動一旦開始將無法暫停。
注意事項:務必使用實驗室專用的學員帳戶。如果使用其他 Google Cloud 帳戶,可能會產生額外費用。

如何開始研究室及登入 Google Cloud 控制台

  1. 點選「Start Lab」按鈕。如果實驗室會產生費用,畫面上會出現選擇付款方式的對話方塊。左側的「Lab Details」窗格會顯示下列項目:

    • 「Open Google Cloud console」按鈕
    • 剩餘時間
    • 必須在這個研究室中使用的臨時憑證
    • 完成這個實驗室所需的其他資訊 (如有)
  2. 點選「Open Google Cloud console」;如果使用 Chrome 瀏覽器,也能按一下滑鼠右鍵,選取「在無痕視窗中開啟連結」

    接著,實驗室會啟動相關資源,並開啟另一個分頁,顯示「登入」頁面。

    提示:您可以在不同的視窗中並排開啟分頁。

    注意:如果頁面中顯示「選擇帳戶」對話方塊,請點選「使用其他帳戶」
  3. 如有必要,請將下方的 Username 貼到「登入」對話方塊。

    {{{user_0.username | "Username"}}}

    您也可以在「Lab Details」窗格找到 Username。

  4. 點選「下一步」

  5. 複製下方的 Password,並貼到「歡迎使用」對話方塊。

    {{{user_0.password | "Password"}}}

    您也可以在「Lab Details」窗格找到 Password。

  6. 點選「下一步」

    重要事項:請務必使用實驗室提供的憑證,而非自己的 Google Cloud 帳戶憑證。 注意:如果使用自己的 Google Cloud 帳戶來進行這個實驗室,可能會產生額外費用。
  7. 按過後續的所有頁面:

    • 接受條款及細則。
    • 由於這是臨時帳戶,請勿新增救援選項或雙重驗證機制。
    • 請勿申請免費試用。

Google Cloud 控制台稍後會在這個分頁開啟。

注意:如要使用 Google Cloud 產品和服務,請點選「導覽選單」,或在「搜尋」欄位輸入服務或產品名稱。「導覽選單」圖示和搜尋欄位

工作 1:安裝 ADK 並設定環境

在這項工作中,您將設定 Cloud Shell 編輯器、初始化專案,並安裝 Agent Development Kit (ADK),為代理應用程式建構和測試作業準備環境。

啟用建議的 API

在本實驗室環境,Vertex AI APITelemetry API 已啟用。在您的專案中,您需要啟用這兩個 API 才能查詢模型,並將遙測資料傳送至 Cloud Logging。

準備 Cloud Shell 編輯器分頁

  1. 在 Google Cloud 控制台標題列,點按「啟用 Cloud Shell」圖示 (啟用 Cloud Shell)。

    注意:您也可以選取控制台瀏覽器分頁,然後依序按下 G 和 S 鍵,開啟 Cloud Shell 終端機。
  2. 點按「繼續」

  3. 系統提示您授權 Cloud Shell 時,點按「授權」

  4. 在 Cloud Shell 終端機動作列中,點按「在新視窗開啟」圖示 「在新視窗開啟」按鈕

  5. 在 Cloud Shell 編輯器中,點按動作列的「開啟編輯器」圖示 「編輯」鉛筆圖示 來檢視檔案。

  6. 點按左側窗格中的「Explorer」圖示 「Explorer」圖示,開啟檔案總管。

  7. 點按「開啟資料夾」

  8. 系統顯示「開啟資料夾」對話方塊後,點按「確定」,選取 Google Skills 學員帳戶的主資料夾。

  9. 關閉畫面右側的其他教學課程或 Gemini 面板,為程式碼編輯器騰出更多空間。

操作這個實驗室其餘步驟時,您可以全程將這個視窗當成 IDE 使用,搭配 Cloud Shell 編輯器和 Cloud Shell 終端機作業。

下載並安裝本實驗室的 ADK 和程式碼範例

  1. 將下列指令貼到 Cloud Shell 終端機,從 Cloud Storage bucket 複製含有本實驗室所需程式碼的專案目錄:

    gcloud storage cp -r gs://{{{project_0.project_id| YOUR_GCP_PROJECT_ID}}}-bucket/* .
  2. 在 Cloud Shell 終端機執行下列指令,更新 PATH 環境變數,加入使用者本機環境並安裝 ADK (包括用於記錄和遙測的 OpenTelemetry (OTel) 外掛程式) 和其他實驗室所需項目:

    export PATH=$PATH:"/home/${USER}/.local/bin" python3 -m pip install google-adk[otel-gcp]==1.30.0 -r adk_project/requirements.txt

工作 2:查看 ADK 專案目錄的核心概念和結構

檢視 ADK 的核心概念和基礎構成元素,包括代理、工具和自動調度管理模式,瞭解這些設計原則如何建構出高效率且富有彈性的多代理系統:

  • 代理:核心構成元素,專門用來完成特定工作,並會透過 LLM 推論、規劃及使用工具達成目標,甚至能共同處理複雜專案。
  • 工具:代理可以透過工具執行對話以外的動作,例如與外部 API 互動、搜尋資訊、執行程式碼或呼叫其他服務。
  • 工作階段服務:負責處理一段對話 (Session) 的背景資訊,包括對話記錄 (Events),以及代理保有的對話相關工作記憶 (State)。
  • 回呼:您提供的自訂程式碼片段,可在代理的特定程序點執行,用於檢查、記錄或修改行為。
  • 構件管理:代理可透過構件儲存、載入及管理與工作階段或使用者相關的檔案或二進位資料 (例如圖片或 PDF)。
  • 執行元件:管理執行流程的引擎,可根據事件自動調度管理代理互動,並與後端服務協作。

接下來,請檢視 ADK 專案的標準配置,瞭解這些概念的實際整合方式:

  1. 在 Cloud Shell 編輯器的檔案總管窗格,點按「adk_project」,開啟目錄。

  2. 請注意,adk_project 中有四個代理目錄:adk_utilsapp_agentllm_auditormy_google_search_agent,每個分別代表不同的代理。將代理各自放在專案目錄對應的位置,即可提供組織架構,讓 ADK 瞭解有哪些代理。

  3. 點按「my_google_search_agent」,瀏覽代理目錄。

    注意:請確認您目前位於 adk_project/my_google_search_agent 目錄。
  4. 點按「init.py」即可查看內容,請留意目錄中也有 agent.py 檔案。

  5. 您也會發現 init.py 檔案只有從 agent.py 檔案匯入的一行程式碼。ADK 會使用這行程式碼,將這個目錄指定為代理套件:

    from . import agent
  6. 點按「agent.py」,查看搭載 Google 搜尋工具的簡易代理程式碼。

    • google.adk 匯入的項目包括 Agent 類別和 tools 模組中的 google_search 工具。
    • 請詳閱程式碼註解,瞭解這個簡單代理的設定參數。
  7. 將匯入的 google_search 工具傳遞給代理,即可使用這個工具。在 agent.py 檔案,找到 Agent 物件建立程式碼尾端的指定位置 (約第 34 行),並貼上下列程式碼:

    tools=[google_search]
  8. 儲存 agent.py 檔案。

代理可透過工具,執行生成文字以外的動作。在這個案例中,代理可透過 google_search 工具判斷何時可能需要訓練資料以外的資訊,然後編寫搜尋查詢、使用 Google 搜尋在網路尋找資訊,並根據搜尋結果回覆使用者。

模型擷取額外資訊做為回覆依據的程序,稱為「建立基準」,而這整個程序則稱為「檢索增強生成」(RAG)。

工作 3:使用 ADK 開發 UI 執行代理

ADK 具備可在本機執行的開發 UI,可協助開發及測試代理。開發 UI 會提供各類圖表,方便您瞭解每個代理的活動,以及多個代理之間的互動情形。在這項工作中,您將探索開發 UI。

注意:執行代理時,ADK 必須知道是誰要求模型 API 呼叫。您可以透過下列兩種方式提供這項資訊:

  1. 提供 Gemini API 金鑰
  2. 使用 Google Cloud 憑證驗證環境,並將模型 API 呼叫與 Vertex AI 專案和位置建立關聯。

在本實驗室中,您將採用第二種方式,透過 Vertex AI 專案進行驗證。

  1. 前往 Cloud Shell 終端機執行下列指令,寫入 .env 檔案來設定環境變數,指示代理使用您的專案和全域端點:

    cd ~/adk_project cat << EOF > my_google_search_agent/.env GOOGLE_GENAI_USE_VERTEXAI=TRUE GOOGLE_CLOUD_PROJECT={{{project_0.project_id| YOUR_GCP_PROJECT_ID}}} GOOGLE_CLOUD_LOCATION=global MODEL={{{project_0.startup_script.gemini_flash_model_id | gemini_flash_model_id}}} OTEL_SERVICE_NAME=adk-agent OTEL_PYTHON_LOGGING_AUTO_INSTRUMENTATION_ENABLED=true OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT=true EOF

    這些變數的用途如下:

    • GOOGLE_GENAI_USE_VERTEXAI=TRUE:表示您使用 Vertex AI 進行驗證,而非 Gemini API 金鑰。
    • GOOGLE_CLOUD_PROJECTGOOGLE_CLOUD_LOCATION:提供要與模型呼叫建立關聯的專案和位置。
    • MODEL:這不是必要變數,存放在這裡的用途是做為環境變數供系統載入,方便您在不同部署環境嘗試不同模型。
    • OTEL_SERVICE_NAMEOTEL_PYTHON_LOGGING_AUTO_INSTRUMENTATION_ENABLEDOTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT:用於設定 OpenTelemetry (OTel),收集代理提供的 ADK 專屬遙測資料。

    ADK 開發 UI 和 CLI 對話介面會自動載入 .env 檔案的設定。如果沒有這類檔案,這些介面會使用名稱相符的系統環境變數。

  2. 在 Cloud Shell 終端機執行下列指令,確認您位於 adk_project 目錄,也就是代理子目錄所在位置:

    cd ~/adk_project
  3. 透過下列指令推出 ADK 開發 UI,並加上一些實用標記。這個指令會執行下列動作:

    • 透過 ADK 開發 UI 推出 Fast API 網路伺服器
    • 允許 Cloud Shell 網頁預覽查詢您的代理
    • 將遙測資料傳送至 Cloud Logging
    • 偵測到程式碼有所變更時,重新載入代理
    adk web \ --allow_origins "regex:https://.*\.cloudshell\.dev" \ --otel_to_cloud \ --reload_agents

    輸出內容

    INFO: Started server process [2434] INFO: Waiting for application startup. +-------------------------------------------------------+ | ADK Web Server started | | | | For local testing, access at http://localhost:8000. | +-------------------------------------------------------+ INFO: Application startup complete. INFO: Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)

    系統最後會顯示 ADK 開發 UI 網址,因為開發 UI 目前正在執行中。

  4. 點按終端機輸出內容中的「http://127.0.0.1:8000」連結,在新分頁開啟網頁介面。系統會透過 Proxy,將您連結至這個在本機 Cloud Shell 執行個體執行的應用程式。您會看到開發 UI 在新分頁執作。

  5. 在左側的「選取代理」選單中,選取「my_google_search_agent」

    開發 UI

  6. 如要提示代理使用 Google Search 搜尋工具,請輸入以下問題:

    我知道 2028 年會舉辦夏季奧運,請告訴我有哪些國家/地區會參加,以及會舉辦哪些賽事。

    請注意,代理會使用 Google 搜尋擷取即時資訊,略過預先訓練模型的知識截點。

    注意:採用以 Google 搜尋強化事實基礎功能的回覆包含可立即顯示的 HTML「搜尋建議」,和代理回覆底部顯示的內容類似。因此,以 Google 搜尋強化事實基礎時,須顯示這些建議,讓使用者能進一步查看模型做為回覆依據的資訊。
  7. 請注意,左側窗格預設會顯示「追蹤記錄」分頁。點按上次的查詢文字 (我知道 2028 年會舉辦夏季奧運,請告訴我有哪些國家/地區會參加,以及會舉辦哪些賽事。),即可查看追蹤記錄,瞭解查詢各部分花了多少時間執行。

    您可以根據記錄,對工具呼叫相關的複雜執行作業偵錯,瞭解各個程序與回覆延遲之間的關聯。

    代理呼叫的追蹤記錄
  8. 返回視窗的對話討論部分,再前往右側窗格,點按代理回覆旁的代理圖示 (agent_icon),即可檢查代理傳回的事件,包括 content (傳回給使用者的內容) 以及 groundingMetadata (回覆所依據的搜尋結果詳細資訊)。

  9. 探索完 ADK 開發 UI 後,關閉這個瀏覽器分頁。

  10. 返回 Cloud Shell 終端機的瀏覽器分頁,點按終端機窗格。

  11. 按下 CTRL+C 鍵,停止網路伺服器。

點選「Check my progress」,確認目標已達成。 使用 ADK 網路 UI 執行代理。

工作 4:透過程式執行代理

雖然 ADK 開發 UI 適合用來測試及偵錯,但在正式環境中,最好不要向多名使用者顯示您的代理。

如要在大型應用程式中執行代理,則必須在 agent.py 指令碼加入一些額外元件。在上一項工作中,這些元件是由網頁應用程式處理。請按照下列步驟,開啟並檢查含有這些元件的指令碼。

  1. 如果代理目錄中沒有 .env 檔案,即可為所有代理設定環境變數。在 Cloud Shell 終端機執行下列指令,匯出環境變數:

    export GOOGLE_GENAI_USE_VERTEXAI=TRUE export GOOGLE_CLOUD_PROJECT={{{project_0.project_id| YOUR_GCP_PROJECT_ID}}} export GOOGLE_CLOUD_LOCATION=global export MODEL={{{project_0.startup_script.gemini_flash_model_id | gemini_flash_model_id}}}
  2. 在 Cloud Shell 編輯器檔案瀏覽器中,點按「adk_project/app_agent」

  3. 點按這個目錄中的「agent.py」檔案。

  4. 這個代理的用途是做為應用程式的一部分來執行,因此請詳閱 agent.py 的程式碼註解,並特別留意程式碼中的下列元件:

    • InMemoryRunner() (約第 68 行):可監督代理執行功能。Runner 程式碼會負責接收使用者查詢,並傳送給合適的代理,然後接收代理回覆事件、傳回呼叫應用程式或 UI,觸發後續事件。詳情請參閱 ADK 事件迴圈說明文件
    • runner.session_service.create_session() (約第 71 行):可查看對話歷史記錄和共用狀態。Session 元件可讓代理保留狀態,記住項目清單、工作目前的狀態或其他現有資訊。為簡單起見,本實驗室選擇建立本機工作階段服務,但在正式環境中,這項服務可由資料庫處理。
    • types.Content()types.Part() (約第 78 和 79 行):結構化多模態訊息功能。系統不會向代理傳遞簡單的字串,而是傳遞 Content 物件,其中可能包含多個 Part。如此一來,您就可以用特定順序,將包括文字和多模態內容的複雜訊息傳遞給代理。
    注意:如果使用 ADK 開發 UI 執行代理,系統會為您建立工作階段服務、構件服務和執行元件。不過,若是自行編寫並透過程式部署代理,建議您提供以上元件做為外部服務,而不是使用記憶體內的版本。

    您會發現指令碼包含一個給代理的硬式編碼查詢 (約第 93 行),內容為「法國的首都在哪裡?」。

  5. 在 Cloud Shell 終端機執行下列指令,透過程式執行這個代理:

    python3 app_agent/agent.py

    輸出內容節錄:

    ** 使用者提問:法國的首都在哪裡? ... ** trivia_agent:法國的首都是巴黎。

新增 Pydantic 結構定義類別

您也可以為代理指定特定的輸入和/或輸出內容結構定義,如下所示:

  1. 在第 28 行附近,為 Pydantic 結構定義類別BaseModel」和「Field」新增下列匯入陳述式,藉此指定結構定義類別:

    from pydantic import BaseModel, Field class CountryCapital(BaseModel): capital: str = Field(description="A country's capital.")
  2. root_agentAgent 定義中 (約第 62 行),設定 output_schema 參數,以便使用您在上方程式碼中指定的 CountryCapital 結構定義。

    output_schema=CountryCapital
  3. 再次執行代理指令碼,查看 output_schema 後的回覆:

    python3 app_agent/agent.py

    輸出內容節錄:

    ** 使用者提問:法國的首都在哪裡? ... ** trivia_agent: {"首都": "巴黎"}

點選「Check my progress」,確認目標已達成。 透過程式執行代理。

工作 5:透過指令列介面與代理對話

您還可以在本機開發環境中,使用指令列介面與代理對話。開發代理時,這項功能可幫助您快速偵錯及測試。

與網頁介面相同,指令列介面也會建立代理的工作階段服務、構件服務和執行元件。

請按照下列步驟,使用指令列介面執行互動工作階段:

  1. 在 Cloud Shell 終端機執行下列指令:

    adk run my_google_search_agent

    輸出內容

    Log setup complete: /tmp/agents_log/agent.20250322_010300.log To access latest log: tail -F /tmp/agents_log/agent.latest.log Running agent basic_search_agent, type exit to exit. user:
  2. 輸入下列訊息:

    今年在印度上映的熱門電影有哪些?

    輸出內容範例 (可能會與您的輸出內容略有不同):

    [google_search_agent]:以下是印度在過去一個月 (2026 年 1 月至 2026 年 2 月初) 上映的電影: * **2026 年 1 月 16 日**:《Bihu Attack》、《Happy Patel: Khatarnak Jasoos》。 * **2026 年 1 月 23 日**:《Border 2》。 * **2026 年 1 月 30 日**:《Mardaani 3》、《Mayasabha - The Hall of Illusion》。 * **2026 年 2 月 5 日**:《Vadh 2》、《Haunted 3D: Ghosts Of The Past》。 * **2026 年 2 月 13 日**:《Tu Yaa Main》、《O'Romeo》、《Swayambhu》。 * **2026 年 2 月 19 日**:《Veer Murarbaji》、《Do Deewane Seher Mein》。 * **2026 年 2 月 20 日**:《Epic: Elvis Presley In Concert》、《Hamnet》。 * **2026 年 2 月 26 日**:《The Kerala Story 2 Goes Beyond》。
  3. 在指令列介面與代理對話完畢時,於後續的使用者提示詞輸入「exit」,即可結束對話。

工作 6:多代理範例預覽

在這項工作中,您將探索多代理系統,瞭解核心 ADK 功能。

這個代理系統會評估 LLM 是否以事實做為回覆基準,並加以改善。這個系統使用以下代理:

  • critic_agent:可自動查核事實
  • reviser_agent:如需根據驗證後的發現項目修正錯誤,會重新編寫回覆

請按照下列步驟探索代理:

  1. 透過 Cloud Shell 編輯器的檔案總管,前往 adk_project/llm_auditor 目錄。

  2. 點按 llm_auditor 目錄中的「agent.py」

  3. 這個多代理範例有幾項重點需要注意:

    • SequentialAgent 是一種工作流程類別,可在代理間依序傳遞對話控管權限,無需使用者輸入內容。執行時,critic_agentreviser_agent 會自動依序回覆。
    • 這些子代理都是從 sub_agents 目錄中對應的目錄匯入。
    • 子代理目錄包含 init.pyagent.pyprompt.py。使用 prompt.py 單獨管理複雜提示詞,再匯入 agent.py。
  4. 複製您稍早建立的 .env 檔案,供這個代理使用,並在 Cloud Shell 終端機執行下列指令,再次啟動 ADK 開發 UI:

    cd ~/adk_project cp my_google_search_agent/.env llm_auditor/.env adk web \ --allow_origins "regex:https://.*\.cloudshell\.dev" \ --otel_to_cloud \ --reload_agents 注意:如未關閉先前的 adk web 工作階段,預設通訊埠 8000 會遭到封鎖,但您可以使用 adk web --port 8001 等指令,啟動開發 UI 並啟用新的通訊埠。
  5. 點按終端機輸出內容中的 http://127.0.0.1:8000 連結。新的瀏覽器分頁會隨即開啟,並顯示 ADK 開發 UI。

  6. 在左側的「選取代理」選單中,選取「llm_auditor」

  7. 輸入下列錯誤敘述展開對話:

    查證以下敘述:與火星相比,地球距離太陽更遠。

您應該會在對話區看到代理的兩則回覆:

  • 首先是 critic_agent 的詳細回覆。該代理會使用 Google 搜尋查核事實,然後根據結果確認敘述是否為真。
  • 其次是 reviser_agent 修正您輸入的錯誤敘述後,輸出的簡要敘述,例如「與火星相比,地球距離太陽更近」。
  1. 點按每則回覆旁的代理圖示 (agent_icon),即可開啟該回覆的事件面板,您也可以在「事件」面板找出並選取相應編號的事件。

事件檢視畫面頂端會以圖表呈現這個多代理系統中,代理與工具之間的關係。系統會醒目顯示負責這則回覆的代理。

  1. 進一步探索程式碼,或在開發 UI 提出其他事實查核範例問題。例如,您可以嘗試再提出以下問題:

    問:為什麼天空是藍的?答:因為天空反射海洋的顏色。
  2. 如要重設對話,請點按工作階段標題列的「新增工作階段」,即可重新啟動對話。

  3. 向這個代理提問完畢後,請關閉瀏覽器分頁,並在終端機中按下 CTRL + C 鍵停止伺服器。

注意:雖然這個範例使用 SequentialAgent 工作流程代理,但可以視為人機迴圈模式。

SequentialAgent 結束序列時,對話會返回上層代理 (在本例中為 llm_auditor),取得新的使用者輸入內容,再將對話傳回其他代理。

點選「Check my progress」,確認目標已達成。 多代理範例預覽。

恭喜!

您已順利完成 Agent Development Kit (ADK) 的基礎實驗室,除了分析代理和工具的核心架構、初始化標準化開發環境,還將 設為動態模型依附元件。您操作自訂工具和結構化輸出結構定義,控管代理行為,並在瀏覽器 UI、Python 指令碼和 CLI 執行工作流程。您可以運用這些基本技能,建構及擴展穩定、可用於正式環境的代理應用程式。

後續步驟/瞭解詳情

如要進一步瞭解 ADK,請參閱以下資源:

Google Cloud 教育訓練與認證

協助您瞭解如何充分運用 Google Cloud 的技術。我們的課程會介紹專業技能和最佳做法,讓您可以快速掌握要領並持續進修。我們提供從基本到進階等級的訓練課程,並有隨選、線上和虛擬課程等選項,方便您抽空參加。認證可協助您驗證及證明自己在 Google Cloud 技術方面的技能和專業知識。

使用手冊上次更新日期:2026 年 4 月 15 日

實驗室上次測試日期:2026 年 4 月 15 日

Copyright 2026 Google LLC 保留所有權利。Google 和 Google 標誌是 Google LLC 的商標,其他公司和產品名稱則有可能是其關聯公司的商標。

Before you begin

  1. Labs create a Google Cloud project and resources for a fixed time
  2. Labs have a time limit and no pause feature. If you end the lab, you'll have to restart from the beginning.
  3. On the top left of your screen, click Start lab to begin

Use private browsing

  1. Copy the provided Username and Password for the lab
  2. Click Open console in private mode

Sign in to the Console

  1. Sign in using your lab credentials. Using other credentials might cause errors or incur charges.
  2. Accept the terms, and skip the recovery resource page
  3. Don't click End lab unless you've finished the lab or want to restart it, as it will clear your work and remove the project

This content is not currently available

We will notify you via email when it becomes available

Great!

We will contact you via email if it becomes available

One lab at a time

Confirm to end all existing labs and start this one

Use private browsing to run the lab

Using an Incognito or private browser window is the best way to run this lab. This prevents any conflicts between your personal account and the Student account, which may cause extra charges incurred to your personal account.

Complete this quick step to start your lab.