Google 搜尋工具可讓代理程式根據網路上的最新資訊回覆, 有效運用真實世界資料做為對話基準。 這項工具非常適合需要世界知識、時事或各種主題的案例。
設定
建立工具時,請設定下列項目:
- 名稱:
工具執行個體的顯示名稱 (例如:
search_web)。 - 說明: 簡要說明工具的用途。推論代理會依據這段說明,判斷何時要叫用工具。
- 排除的網域: 要從搜尋結果中排除的網域清單 (最多 2000 個)。 例如:「www.example.com」或「example.com」
- 偏好的網域: 限制搜尋結果的網域清單 (最多 20 個)。 例如:「www.example.com」或「example.com」
- 脈絡資料網址: 要擷取的特定網址,用於提供脈絡資訊 (最多 20 個)。 模型會直接使用這些頁面的內容。 例如:「example.com/page/path」
- 模式:
自訂代理程式處理及摘要不同模式搜尋結果的方式:
- 文字提示詞:在文字對話中處理搜尋結果的指示。
- 語音提示:在語音對話中處理搜尋結果的指示 (例如,讓答案簡潔自然,避免朗讀原始網址)。
設定優先順序
網域和網址設定會依下列順序套用:
- 排除網域:優先順序最高。即使網域列於「提供背景資訊的網址」或「偏好的網域」中,也會遭到排除。
- 網址 (提供背景資訊):系統會擷取內容,除非網域遭到排除。
- 偏好網域:優先順序最低。
執行階段脈絡資料網址
除了工具設定中提供的脈絡網址外,您也可以指示代理程式在執行階段動態插入網址。
舉例來說,您可以在代理程式指令中加入下列內容:
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。