網路搜尋與新聞搜尋會在每個結果的 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,因為沒有可據以擷取的查詢。