Bing 自訂搜尋的基礎設定（預覽）（經典版）

註

本文件提及 Microsoft Foundry（經典版）代理程式。

🔍 檢視新的 Bing 搜尋基礎文件。 Agents（經典版）現已棄用，將於 2027 年 3 月 31 日退役。 請使用普遍可用的 Microsoft Foundry Agents Service 中的新代理。 請依照 遷移指南 更新你的工作負載。

Grounding with Bing 自訂搜尋工具整讓您的 Azure AI Agent 能在可設定的公用網域內進行搜尋。 它讓你能定義想要從哪些網頁區域汲取資源，讓使用者只看到你選擇的網域和子網域的相關結果。 你需要先在 Azure 入口網站建立一個 Grounding with Bing 自訂搜尋資源。

資源部署完成後，請在 Microsoft Foundry 入口網站的 Configurations，建立一個設定實例，只包含使用者關心的網站內容。 關於如何建立自訂設定的說明可以在 設定區找到。

工具設定好後，你可以將其連接到你的 Azure AI 代理程式。 當使用者傳送查詢時，Agent 會決定是否應使用「使用 Bing 自訂搜尋進行基礎設置」。 如果是的話，它會用 Bing 搜尋你指定的網域並回傳相關區塊。 最後，Azure AI 代理會利用回傳的區塊產生回應，回傳給使用者

重要

  • 您在使用 Bing 自訂搜尋功能時，Grounding 可能會產生費用。 詳情請參閱價格頁面。
  • 透過以程式碼為先的經驗（如 Azure CLI）建立並使用 Bing 自訂搜尋的 Grounding 資源，或透過部署範本部署，您同意遵守並遵守使用條款，該條款可能會定期更新。
  • 當你使用 Bing 自訂搜尋的 Grounding 時，你的客戶資料會從 Azure 合規邊界之外轉移到 Grounding with Bing 自訂搜尋服務。 [使用 Bing 自訂搜尋進行基礎設置] 的運作不受相同的資料處理條款 (包括處理位置) 的約束，且其合規性標準和認證與 Foundry Agent Service 不同，如 [使用 Bing 自訂搜尋進行基礎設置使用條款] 中所述。 您有責任評估在 Agent 中使用「使用 Bing 自訂搜尋進行基礎設置」是否符合您的需求與要求。

「使用 Bing 自訂搜尋進行基礎設置」的運作方式

使用者查詢是終端使用者發送給客服人員的訊息，例如「目前可用的水瓶是什麼？」（假設你建立 Contoso 產品網站的實例）。 指令是開發者提供系統訊息，用來分享上下文並指示 AI 模型如何使用各種工具或行為。

當使用者發送查詢時，客戶的 AI 模型部署會先依照所提供指示處理該查詢，接著執行 Bing 自訂搜尋查詢（開發者可見）。 「使用 Bing 自訂搜尋進行基礎設置」會將相關搜尋結果傳回至客戶的模型部署，接著由該部署產生最終輸出。

註

當你使用 Bing 自訂搜尋的 Grounding 時，Bing 自訂搜尋查詢、設定實例、工具參數和你的資源金鑰都會傳送到 Bing。 查詢中不包含任何終端使用者特定的資訊。 你把資源金鑰寄到 Bing 僅用於帳單驗證和速率限制。

授權將在 Bing 客製化搜尋服務的 Grounding 和 Foundry Agent 服務之間進行。 任何為了基礎設定而產生及傳送至 Bing 的 Bing 自訂搜尋查詢，都將連同資源金鑰及設定執行個體，傳輸至 Azure 合規性邊界以外的 Grounding with Bing 自訂搜尋服務。 使用 Bing 自訂搜尋的 Grounding 受 Bing 條款約束，且不具備與代理人服務相同的合規標準與認證，詳見 Bing 自訂搜尋使用條款。 您有責任評估在 Agent 中使用「使用 Bing 自訂搜尋進行基礎設置」是否符合您的需求與要求。

開發者和終端用戶無法取得 Bing 自訂搜尋中 Grounding 回傳的原始內容。 然而，模型回應包含引用及連結至用於產生回應的網站，並允許透過代理服務提供的機制儲存。 你可以透過存取已建立的執行緒資料來取得模型回應。 根據「使用 Bing 自訂搜尋進行基礎設置」的使用與顯示需求，這些參考必須以 Microsoft 提供的確切形式予以保留及顯示。

了解代理人回應中的引用

當 Grounding with Bing 自訂搜尋貢獻於客服回應時，回應可包含 URL 引用，幫助使用者驗證答案。

在客戶端 SDK 中，URL 引用會以代理訊息的註解形式回傳。 每個引用都包含標題和網址，您可以以參考資料清單的形式顯示給使用者。

關於從線程訊息列印引用的端對端範例，請參見 程式碼範例。

使用 Grounding with Bing 資源的交易會依每次執行工具呼叫次數計算。 你可以看到從執行步驟中會呼叫多少工具。

設定

註

使用 Bing 搜尋進行基礎設置的工具可在具備網路安全防護的 Foundry 中運作，但該工具不會遵循您的 VPN 或 Foundry 的私用端點。 它會作為公用端點。 使用網路安全的 Foundry 與此工具時，請務必注意安全方面的考量。

  1. 請依照 quickstart 步驟創建 Azure AI 代理。

  2. 在 Azure 入口網站 建立一個 Grounding with Bing 自訂搜尋資源。 你需要在訂閱或資源群組中擁有 擁有者 或 貢獻 者角色才能建立它。 請確保你將這個 Grounding with Bing 自訂搜尋資源建立在與你的 Azure AI 代理、AI Project 及其他資源相同的資源群組中。

  3. 在建立 Grounding with Bing 自訂搜尋資源後，你可以建立一個設定實例。

    1. 移至已建立的「使用 Bing 自訂搜尋進行基礎設置」資源

    2. 在左側面板選擇 資源管理 。

    3. 選擇 配置。

    4. 選擇 建立新設定。

建立或更新設定時，請輸入以下資訊：

  1. 你的配置名稱。 你隨時都可以更改這個名字。

  2. 請在以下至少一個欄位中包含網址以定義您的搜尋切片：

    註

    使用 Bing 自訂搜尋的 Grounding 只會回傳那些由 Bing 公開且已索引的網域和網頁的結果。

    • 域（例如， https://www.microsoft.com）
    • 定義域與路徑（例如， https://www.microsoft.com/surface）
    • 網頁（例如， https://www.microsoft.com/en-us/p/surface-earbuds/8r9cpq146064）

    1. 允許搜尋的網域。 對於允許的網域，如果你想包含子頁面，請確保這些網域最多只有兩層子頁面。

    2. 封鎖的網域，從搜尋空間中排除。

  3. 決定是否要包含子頁面。 子頁面切片指定一個網域路徑。 Bing 會搜尋路徑及其下方的所有內容。 路徑中最多只能指定兩個子資料夾。 例如， www.microsoft.com/windows/。

  4. 必要時調整排名。

  5. 在 Foundry 入口網站中瀏覽至您的代理程式的 [代理程式] 畫面，將右側的 [設定] 窗格向下捲動至 [知識]。 然後選擇 新增。

    這是鑄造廠入口中特工畫面的截圖。

  6. 選取使用 Bing 自訂搜尋進行基礎設置工具。

  7. 選擇建立新連線，或使用現有連線

    1. 若為新連線，請選取您的「使用 Bing 自訂搜尋進行基礎設置」資源。

  8. 連接資源後，選擇設定名稱。

  9. 儲存工具，開始與你的經紀人聊天。

自訂搜尋設定功能

使用 Bing 自訂搜尋進行基礎設置是一項功能強大的工具，可讓您選取 Web 的子空間來限制代理程式的基礎知識。 這裡有幾個建議，幫助你最大化利用這項功能：

  1. 如果你擁有一個公開網站，想納入搜尋但 Bing 尚未索引，請參閱 Bing 網站管理員文件 ，了解如何讓你的網站被收錄的詳細資訊。 網站管理員文件還提供詳細信息，說明在索引過時時，如何讓 Bing 爬取您的網站。

  2. 你只能封鎖特定網域，並對整個網路區域進行搜尋（例如競爭對手的網站）。

可選參數

當您將「使用 Bing 自訂搜尋進行基礎設置」工具新增至 Agent 時，可以傳遞下列參數。 這些參數將會影響「使用 Bing 自訂搜尋進行基礎設置」工具的輸出，且 AI 模型可能不會完全使用所有輸出。 請參閱 程式碼範例 ，了解 API 版本支援及如何傳遞這些參數。

名稱 價值 類型 必須
count 回應中要回傳的搜尋結果數量。 預設值是5，最大值是50。 實際交付的數量可能比申請的少。 多個頁面可能包含一些重疊的結果。 此參數僅影響網頁結果。 AI 模型可能不會使用 Bing 傳回的所有搜尋結果。 UnsignedShort 不
freshness 請依以下大小寫不區分年齡值篩選搜尋結果：
日：回傳 Bing 在過去 24 小時內發現的網頁。
週：返回 Bing 在過去 7 天內發現的網頁。
月份：回傳 Bing 在過去 30 天內發現的網頁。 為了讓文章能在特定時間範圍內被 Bing 發現，請指定這一形式的日期範圍：YYYY-MM-DD..YYYY-MM-DD。 例如， freshness=2019-02-01..2019-05-30。 若要將結果限制在單一日期，請將此參數設為特定日期。 例如， freshness=2019-02-04。		 弦 不
market 這是結果來源的市場。 通常是 mkt 使用者提出請求的國家或地區。 不過，如果使用者不在 Bing 提供結果的國家或地區，可能是不同的國家或地區。 市場必須採用以下格式：<language>-<country/region>。 例如， en-US。 字串不區分大小寫。 關於可能的市場價值列表，請參見 市場代碼。 如果已知，建議你務必指出市場。 指定市場有助於 Bing 路由請求並回傳適當且最佳的回應。 如果您指定的市場未列在市場代碼中，Bing 會依據內部對應機制選擇最接近的市場代碼，而該對應關係可能會隨時間變更。 弦 不
set_lang 用於使用者介面字串的語言。 請使用2字母或4字母代碼來指定語言。 建議使用四字母代碼。
有關支援的語言代碼列表，請參見 Bing 支援語言。
Bing會載入本地化字串，如果setlang包含有效的兩字母中立文化代碼（fr）或有效的四字母特定文化代碼（fr-ca）。 例如，對於 fr-ca，Bing 會載入fr 中性文化代碼字串。
如果 setlang 不有效（例如 zh），或 Bing 不支援該語言（例如 af，）， af-naBing 會預設為 en （英文）。
若要指定兩字母代碼，將此參數設為 ISO 639-1 語言代碼。
要指定四字母代碼，請使用格式， <language>-<country/region> 其中 <language> 是 ISO 639-1 語言代碼（中立文化）， <country/region> 是 ISO 3166 國家或地區（特定文化）代碼。 例如，美式英語用en-US。
雖然可選，但一定要指定語言。 通常會設定 setLang 為與 相同的 mkt 語言，除非使用者希望使用者介面字串以不同語言顯示。		 弦 不
  • Last updated on