Passages et formats de contenu

Recherche web et Recherche d’actualités renvoient le contenu de chaque résultat dans son content champ. Vous choisissez ce que le contenu est avec contentFormat et maxLength. Définissez les deux sur chaque requête. Pour la mise à la terre, utilisez des conducteurs.

Passages

Définissez contentFormat sur passage pour obtenir, pour chaque résultat, les parties du document les plus pertinentes pour votre requête, jusqu’à maxLength caractères. Web IQ traite l’ensemble du document de son côté et retourne un extrait ciblé par la requête, de sorte que votre modèle n’a pas besoin de lire des paragraphes sans rapport pour trouver la phrase appropriée.

  • Économies de jetons : votre modèle reçoit une fraction du document au lieu de l’intégralité du document.
  • Meilleure exactitude factuelle : avec moins de contenu hors sujet dans le contexte, le modèle est moins susceptible de s’ancrer sur un paragraphe tangentiel.

Les Passages fonctionnent pour chaque application. Un bon point de départ est maxResults = 10, contentFormat = passageet maxLength = 3000. À partir de là, ajustez selon votre cas d’usage ; voir Comment dois-je régler maxResults et maxLength?

Document complet

Web IQ ne retourne pas la page web d’origine. Pendant l’indexation, il génère un document structuré à partir du contenu pertinent de chaque page, et les passages sont sélectionnés à partir de ce document. Les applications disposant d’un accès complet aux documents peuvent demander l’intégralité du document au lieu des passages :

contentFormat Returns
passage Les parties du document les plus pertinentes pour la requête, jusqu’à maxLength caractères.
text Document complet sous forme de texte brut, jusqu’à maxLength caractères.
html Document complet au format HTML, jusqu’à maxLength caractères.
markdown Document complet en tant que Markdown, jusqu’à maxLength caractères.

Les documents de plus de maxLength sont coupés. Pour obtenir un document complet, définissez maxLength suffisamment haut.

Si votre application n’a pas d’accès complet au document, une requête qui définit text, htmlou markdown retourne HTTP 403 avec le code AuthContentFormatForbiddend’erreur . Les passages restent le format recommandé pour l’ancrage.

Demander un accès complet au document

Pour demander l’accès complet au document, ouvrez une demande de support Web IQ via Azure Support et choisissez la catégorie Contenu de page entière. Applications qui utilisent html déjà ou text continuent de fonctionner comme aujourd’hui.

Valeurs par défaut et limites

Ce que vous obtenez dépend du fait que votre application dispose d’un accès complet au document. Pour obtenir les mêmes résultats chaque fois, définissez contentFormat et maxLength pour chaque requête.

Sans accès complet aux documents Accès complet aux documents
Formats disponibles passage passage, text, html, markdown
contentFormat si vous l’omettez passage html (Recherche web), text (Recherche d’actualités)
maxLength si vous l’omettez 3000 10000
Le plus content par résultat 3 000 caractères (les valeurs supérieures maxLength retournent au maximum 3 000) maxLength, jusqu’à 500 000 caractères

Parcourir

Parcourir retourne le document complet pour une URL que vous choisissez, en tant que text, htmlou markdown, jusqu’à maxLength caractères. Elle ne prend pas en charge passage, car il n’existe aucune requête sur laquelle effectuer l’extraction.