Google 搜尋工具

Google 搜尋工具可讓代理程式根據網路上的最新資訊回覆, 有效運用真實世界資料做為對話基準。 這項工具非常適合需要世界知識、時事或各種主題的案例。

設定

建立工具時,請設定下列項目:

  • 名稱: 工具執行個體的顯示名稱 (例如:search_web)。
  • 說明: 簡要說明工具的用途。推論代理會依據這段說明,判斷何時要叫用工具。
  • 排除的網域: 要從搜尋結果中排除的網域清單 (最多 2000 個)。 例如:「www.example.com」或「example.com」
  • 偏好的網域: 限制搜尋結果的網域清單 (最多 20 個)。 例如:「www.example.com」或「example.com」
  • 脈絡資料網址: 要擷取的特定網址,用於提供脈絡資訊 (最多 20 個)。 模型會直接使用這些頁面的內容。 例如:「example.com/page/path」
  • 模式: 自訂代理程式處理及摘要不同模式搜尋結果的方式:
    • 文字提示詞:在文字對話中處理搜尋結果的指示。
    • 語音提示:在語音對話中處理搜尋結果的指示 (例如,讓答案簡潔自然,避免朗讀原始網址)。

設定優先順序

網域和網址設定會依下列順序套用:

  1. 排除網域:優先順序最高。即使網域列於「提供背景資訊的網址」或「偏好的網域」中,也會遭到排除。
  2. 網址 (提供背景資訊):系統會擷取內容,除非網域遭到排除。
  3. 偏好網域:優先順序最低。

執行階段脈絡資料網址

除了工具設定中提供的脈絡網址外,您也可以指示代理程式在執行階段動態插入網址。

舉例來說,您可以在代理程式指令中加入下列內容: none If the user query is about x, look into these urls url1, url2, url3 using the 'Product Information Search' tool.

引用內容和文內引用

當代理程式使用 Google 搜尋工具做為回覆依據時,執行階段回覆會包含 SessionOutput.citations 中的引用中繼資料,可將生成的陳述內容追溯至網路來源。

引用文獻中繼資料包含兩個主要部分:

  • 引用的區塊 (cited_chunks): 用於基礎的來源文件清單,包括來源 uri、 網頁 title、摘要 text 和 requires_attribution 指標。
  • 內嵌引文 (inline_citations): 回應文字中的精確位元組範圍偏移 (start_index 和 end_index),直接對應至 cited_chunk_indices。您可以在用戶端應用程式中使用內嵌引文,根據代理程式回覆中的特定聲明,顯示互動式上標徽章、註腳或內嵌連結。

出處註明規範

從網路基礎模型傳回的引文可能需要標註原始來源:

  • 檢查每個 CitedChunk 的 requires_attribution 欄位。
  • 如果 requires_attribution 為 true,用戶端應用程式必須向使用者顯示來源出處,並連結至來源 URI。