Passages en inhoudsformaten

Web Search en News Search retourneren de inhoud van elk resultaat in het veld content. U kiest wat die inhoud is met contentFormat en maxLength. Stel beide in voor elk verzoek. Gebruik passages ter onderbouwing.

Passages

Stel contentFormat in op passage om voor elk resultaat de delen van het document op te halen die het meest relevant zijn voor uw query, tot maxLength tekens. Web IQ verwerkt het hele document aan zijn kant en retourneert een op de query gericht extract, zodat uw model geen niet-gerelateerde alinea's hoeft te lezen om de relevante zin te vinden.

  • Tokenbesparingen: uw model ontvangt een fractie van het document in plaats van alles.
  • Betere feitelijkheid: met minder inhoud buiten het onderwerp in de context zal het model zich minder snel baseren op een tangentiĆ«le alinea.

Passages werken voor elke toepassing. Een goed startpunt is maxResults = 10,passagecontentFormat = en maxLength = 3000. Van daaruit kunt u afstemmen op uw use case; zie Hoe moet ik maxResults en maxLength afstemmen?

Volledig document

Web IQ retourneert de oorspronkelijke webpagina niet. Tijdens het indexeren wordt een gestructureerd document samengesteld op basis van de zinvolle inhoud van elke pagina en worden passages uit dat document geselecteerd. Toepassingen met volledige toegang tot documenten kunnen het hele document aanvragen in plaats van passages:

contentFormat Returns
passage De delen van het document die het meest relevant zijn voor de query, maximaal maxLength tekens.
text Het volledige document als tekst zonder opmaak, maximaal maxLength tekens.
html Het volledige document als HTML, maximaal maxLength tekens.
markdown Het volledige document als Markdown, maximaal maxLength tekens.

Documenten die langer zijn dan maxLength worden afgebroken. Als u een volledig document wilt ophalen, stelt u maxLength hoog genoeg in.

Als uw toepassing geen volledige documenttoegang heeft, retourneert een aanvraag die text, html of markdown instelt HTTP 403 met de foutcode AuthContentFormatForbidden. Passages blijven de aanbevolen indeling voor onderbouwing.

Volledige documenttoegang aanvragen

Als u volledige documenttoegang wilt aanvragen, opent u een Web IQ Support-aanvraag via Azure Ondersteuning en kiest u de categorie Volledige pagina-inhoud. Toepassingen die al html of text gebruiken, blijven werken zoals vandaag.

Standaardwaarden en limieten

Wat u krijgt, is afhankelijk van of uw toepassing volledige toegang tot documenten heeft. Als u telkens dezelfde resultaten wilt ophalen, stelt u contentFormat en maxLength in op elke aanvraag.

Zonder volledige documenttoegang Met volledige toegang tot documenten
Beschikbare indelingen passage passage,text,html,markdown
contentFormat als je het weglaat passage html (Zoeken op internet), text (Nieuws zoeken)
maxLength als je het weglaat 3000 10000
Maximaal content per resultaat 3000 tekens (grotere maxLength waarden retourneren maximaal 3.000) maxLength, maximaal 500.000 tekens

Bekijk

Bladeren retourneert het volledige document voor een URL die u kiest, zoals text, htmlof markdown, tot maxLength tekens. Het biedt geen ondersteuning voor passage, omdat er geen query is om tegen te extraheren.