段落與內容格式

網路搜尋與新聞搜尋會在每個結果的 content 欄位中回傳其內容。 你可以使用 contentFormat 和 maxLength 選擇該內容為何。 每個請求都設定兩者。 為了建立依據,可以使用文本片段。

段落

設定 contentFormat 為 passage 以取得每個結果中最與你查詢相關的部分,最多可達 maxLength 字元。 Web IQ 會在其端處理整份文件,並回傳一個針對查詢的擷取,讓你的模型不必再讀過無關段落就能找到相關句子。

  • 代幣節省:你的模型接收到文件的一部分,而非全部。
  • 更佳的事實性:語境中離題內容減少,模型較不容易受離題段落牽引。

Passages 適用於所有應用程式。 一個好的起點是 maxResults = 10,passagecontentFormat = ,以及 maxLength = 3000。 接著,根據你的使用情境調整;請參考 我應該如何調整 maxResults 和 maxLength?

完整文件

Web IQ 不會回傳原始網頁。 在索引過程中,它會從每頁有意義的內容建立結構化文件,並從該文件中挑選段落。 擁有完整文件存取權的應用程式可以請求完整文件,而非段落:

contentFormat Returns
passage 文件中與查詢最相關的部分,最多 maxLength 個字元。
text 完整文件以純文字呈現,最多 maxLength 個字元。
html 完整文件以 HTML 格式呈現,最多可包含 maxLength 個字元。
markdown 完整文件以 Markdown 格式,最多 maxLength 個字元。

長度超過 maxLength 的文件會被截斷。 要取得完整文件,將 maxLength 設定得夠高。

如果你的應用程式沒有完整的文件存取權,設定 text、html 或 markdown 的請求會傳回 HTTP 403,錯誤代碼為 AuthContentFormatForbidden。 段落仍是建議作為依據的格式。

要求完整文件存取權限

若要申請完整文件存取,請透過 Azure 支援開啟 Web IQ 支援請求,並選擇 「全頁內容」 類別。 已使用 html 或 text 的應用程式,仍會如同目前一樣繼續運作。

預設值和限制

你得到什麼取決於你的應用程式是否有完整文件存取權。 若要每次都得到相同結果,請在每個要求中設定 contentFormat 和 maxLength。

沒有完整文件存取權 具備完整文件存取權
可用格式 passage passage、text、html、markdown
contentFormat 如果你省略它的話 passage html (網路搜尋)、 text (新聞搜尋)
maxLength 如果你把它省略的話 3000 10000
每個結果最高content 3,000 字元(較大 maxLength 的值最多回傳 3,000 字元) maxLength,最多 500,000 個字元

瀏覽

瀏覽 會回傳你選擇的網址完整文件,格式為 text、html 或 markdown,最多 maxLength 個字元。 它不支援 passage,因為沒有可據以擷取的查詢。