Web 検索とニュース検索では、各結果の内容が content フィールドに返されます。
contentFormatとmaxLengthでそのコンテンツを何にするかを選択します。 すべてのリクエストで両方を設定します。 接地には、導体を使用します。
文章
contentFormatをpassageに設定して、各結果について、クエリに最も関連するドキュメントの部分を最大maxLength文字まで取得します。 Web IQ は、ドキュメント全体を Web IQ 側で処理し、クエリに応じた抽出結果を返します。そのため、関連する文を見つけるために、モデルが無関係な段落を読み進める必要はありません。
- トークンの節約: モデルは、文書全体ではなく、その一部だけを受け取ります。
- 事実性の向上: コンテキスト内のトピック外のコンテンツが少ないほど、モデルは本筋からそれた段落に固定される可能性が低くなります。
Passages は、すべてのアプリケーションで機能します。 適切な開始点は、 maxResults = 10、 contentFormat = passage、 maxLength = 3000 です。 そこから、ユース ケースに合わせて調整します。「maxResultsとmaxLengthを調整する方法」を参照してください。
完全なドキュメント
Web IQ は元の Web ページを返しません。 インデックス作成中に、各ページの意味のあるコンテンツから構造化されたドキュメントが作成され、そのドキュメントから一節が選択されます。 完全なドキュメント アクセス権を持つアプリケーションは、一節ではなくドキュメント全体を要求できます。
contentFormat |
Returns |
|---|---|
passage |
クエリに最も関連するドキュメントの部分 (最大 maxLength 文字)。 |
text |
テキスト形式の完全なドキュメント(最大 maxLength 文字)。 |
html |
HTML 形式の完全なドキュメント(最大 maxLength 文字)。 |
markdown |
Markdown (最大 maxLength 文字) としての完全なドキュメント。 |
maxLengthより長いドキュメントは途中で切れます。 完全なドキュメントを取得するには、maxLength を十分高い値に設定します。
アプリケーションに完全なドキュメント アクセス権がない場合、 text、 html、または markdown を設定する要求は、エラー コード AuthContentFormatForbiddenを含む HTTP 403 を返します。 パッセージは、グラウンディングに推奨される形式のままです。
ドキュメントへの完全アクセスをリクエスト
ドキュメントへのフル アクセスを要求するには、Azure Support から Web IQ サポート要求を開き、ページ全体のコンテンツ カテゴリを選択します。
htmlまたはtextを既に使用しているアプリケーションは、現在も動作し続けます。
既定値と制限
取得する内容は、アプリケーションに完全なドキュメント アクセスがあるかどうかによって異なります。 毎回同じ結果を得るには、すべての要求に contentFormat と maxLength を設定してください。
| 完全なドキュメント アクセス権がない | ドキュメントへのフルアクセス権を持つ | |
|---|---|---|
| 使用可能な形式 | passage |
passage、text、html、markdown |
contentFormat 省略した場合 |
passage |
html (Web 検索)、 text (ニュース検索) |
maxLength それを省略する場合 |
3000 | 10000 |
結果あたりの最大 content |
3,000 文字 (大きい maxLength 値は最大 3,000 文字を返します) |
maxLength、最大 500,000 文字 |
ブラウズ
Browse すると、text、html、または markdownとして選択した URL の完全なドキュメントが、最大 maxLength 文字で返されます。 抽出対象のクエリがないため、 passageはサポートされていません。