快速入門導覽課程:使用 Agent Studio 向 Gemini 傳送文字提示

您可以使用 Agent Studio 設計、測試及管理提示,然後傳送給 Google 的 Gemini 大型語言模型 (LLM)、合作夥伴模型和開放式模型。Agent Studio 支援 Agent Platform 提供的特定合作夥伴和開放式模型,這些模型是以模型即服務 (MaaS) 的形式提供,例如 Anthropic Claude 模型和 Meta 的 Llama 模型。

在本快速入門導覽課程中,執行以下操作:

  • 使用生成式 AI 提示詞庫中的範例,將這些提示詞傳送至 Agent Platform API,包括:
    • 摘要文字提示詞
    • 程式碼生成提示
  • 查看用於生成回覆的程式碼

Agent Studio 的提示範例

提示是提交給語言模型的自然語言要求,用來引導模型提供回覆。提示可以包含問題、指令、背景資訊、少量樣本,以及部分輸入內容,供模型補全。模型收到提示後,會根據使用的模型類型,生成文字、嵌入、程式碼、圖片、影片、音樂等內容。

Agent Studio 提示詞庫中的範例提示詞經過預先設計,可協助展示模型功能。每個提示都已預先設定指定的模型和參數值,因此您可以開啟範例提示,然後按一下「Submit」(提交) 即可生成回覆。

使用摘要文字提示詞測試 Gemini 模型

將摘要文字提示詞傳送至 Agent Platform API。摘要工作會從文字中擷取最重要的資訊。您可以在提示中提供資訊,協助模型建立摘要,或要求模型自行建立摘要。

  1. 前往 Google Cloud 控制台的「Agent Platform」部分,然後前往「Prompt Gallery」(提示庫) 頁面。
    前往提示詞庫

  2. 在「Tasks」(工作) 下拉式選單中,選取「Summarize」(重點摘要)。

  3. 開啟「語音摘要」資訊卡。

    這則範例提示包含音訊檔案,並要求以項目符號清單摘要檔案內容。

  4. 請注意,在設定面板中,模型的預設值設為 gemini-3.7-flash。您可以在「Model settings」(模型設定) 面板中選擇其他 Gemini 模型。

  5. 按一下「Submit」 即可生成摘要。

    輸出內容會顯示在回覆中。

  6. 如要查看用於生成轉錄稿摘要的 Gemini Enterprise Agent Platform 程式碼,請按一下「Code」(程式碼)。

    在「Get code」(取得程式碼) 面板中,您可以選擇偏好的語言,取得提示的程式碼範例,也可以在 Colab Enterprise 筆記本中開啟 Python 程式碼。

使用程式碼生成提示測試 Gemini 模型

將程式碼生成提示詞傳送至 Agent Platform API。程式碼生成工作會使用自然語言說明生成程式碼。

  1. 前往 Google Cloud 控制台的「Agent Platform」部分,然後前往「Prompt Gallery」(提示庫) 頁面。
    前往提示詞庫

  2. 在「Tasks」(工作) 下拉式選單中,選取「Code」(程式碼)。

  3. 開啟「Generate code from comments」(根據註解生成程式碼) 卡片。

    這個範例提示包含系統指令,可指示模型如何回應,以及一些不完整的 Java 方法。

  4. 請注意,在設定面板中,模型的預設值設為 gemini-3.7-flash。您可以在「Model settings」(模型設定) 面板中選擇其他 Gemini 模型。

  5. 如要完成每個方法,請在標示為 <WRITE CODE HERE> 的區域中生成程式碼,然後按一下「Submit」。

    輸出內容會顯示在回覆中。

  6. 如要查看用於生成程式碼的 Gemini Enterprise Agent Platform 程式碼,請按一下「Code」(程式碼)。

    在「Get code」(取得程式碼) 面板中,您可以選擇偏好的語言,取得提示的程式碼範例,也可以在 Colab Enterprise 筆記本中開啟 Python 程式碼。

在提示工作區自動偵測意圖

在 Agent Studio 中對話或測試提示時,背景意圖偵測功能會自動評估每則提交的訊息,判斷您是否要建構自主代理或應用程式。如果偵測到意圖,系統會顯示情境橫幅,只要按一下即可將要求轉移至適當的建構工具。

意圖偵測功能的運作方式

每當您在對話提示工作區提交訊息,背景評估作業就會處理輸入內容:

  • 偵測到代理意圖:顯示橫幅,並提供「建立代理」動作。

    • 如果偵測引擎有足夠的背景資訊,可判斷您要建構的代理類型,就會將您導向代理設計工具,並自動提交種子提示,立即開始建構代理。

    • 畫布隨即開啟,其中包含生成的指令、系統設定和預先附加的工具,可供進一步編輯。

  • 偵測到應用程式意圖:橫幅會顯示「Create app」動作。

    • 點選動作按鈕後,系統會前往 App Builder 介面。

    • 如果情境可用,提示欄位會預先填入提示詳細資料。

    • 與代理流程不同,App Builder 不會自動提交建構作業,而是會停在頁面上,讓您查看並手動提交提示。

計費和定價

每次背景意圖偵測評估都會向您的 Google Cloud帳戶收費:

  • 使用模型:意圖偵測功能採用 Gemini 3.5 Flash Lite,這是經過最佳化的輕量模型。

  • 費用:由於模型輕量,每次偵測的費用極低。每則訊息評估費用約為 $0.002 美元。

  • 主要提示和回覆會另外收取標準推論費用。

使用意圖偵測功能建立代理

如要使用自動意圖偵測功能,從對話工作階段建立代理,請按照下列步驟操作:

  1. 在 Google Cloud 控制台,
    前往 Agent Platform

  2. 在導覽選單中,依序點選「Studio」 >「+ 新增」 >「對話」 >「新增對話」。

  3. 在工作區底部的提示詞欄位中,輸入提示詞,清楚說明您要建構代理,並描述代理的用途和工作。

  4. 點按「提交」圖示 。

  5. 回覆開始時,請找出提示欄位上方的意圖偵測橫幅。

  6. 點按橫幅中的「建立代理」。

  7. 在確認對話方塊中,按一下即可繼續。Agent Studio 會在「Agent Designer」中開啟視覺畫布,並初始化代理流程。

  8. 在側邊面板中,查看並調整已填入的設定:

    • 詳細資料:編輯代理名稱和說明。

    • 指令:查看並調整系統指令。

    • 工具:驗證及設定附加工具 (例如 Google 搜尋)。

使用意圖偵測功能建立應用程式

如要使用自動意圖偵測功能,透過對話工作階段建立應用程式,請按照下列步驟操作:

  1. 在 Google Cloud 控制台,
    前往 Agent Platform

  2. 在導覽選單中,依序點選「Studio」 >「+ 新增」 >「對話」 >「新增對話」。

  3. 在工作區底部的提示詞欄位中,輸入提示詞,清楚說明您要建構應用程式,並附上應用程式說明。

  4. 點按「提交」圖示 。

  5. 提示詞欄位上方顯示意圖偵測橫幅時,請按一下「Create app」(建立應用程式)。Agent Studio 會開啟「App Builder」(應用程式建構工具) 工作區,並在輸入欄位預先填入提示詞。

  6. 視需要查看及編輯提示文字。

  7. 在提示欄位中,按一下「Submit」(提交) ,開始建構應用程式。

停用意圖偵測

如要避免背景評估,並在對話時避免產生偵測費用,請按照下列步驟操作:

  1. 在 Google Cloud 控制台,
    前往 Agent Platform

  2. 在導覽選單中,依序點選「Studio」 >「+ 新增」 >「對話」 >「新增對話」。

  3. 在工作區標題中,按一下「設定」 (齒輪圖示)。

  4. 在設定選單中,找到「偵測建構意圖」設定。

  5. 將切換鈕設為關閉。

停用後,系統不會在背景執行偵測作業、不顯示建議橫幅,也不會收取偵測費用。

後續步驟

總覽

瞭解如何在 Google Agent Platform 建構代理。

指南

瞭解 Agent Studio 的功能。

指南

按照指南操作,透過 Agent Studio 將提示詞部署為網頁應用程式。