Trechos e formatos de conteúdo

A Pesquisa Web e a Pesquisa de Notícias devolvem o conteúdo de cada resultado no seu content campo. Escolhes qual é esse conteúdo com contentFormat e maxLength. Defina ambos em cada requisição. Para ligação à terra, usa vias.

Passagens

Defina contentFormat como passage para obter, para cada resultado, as partes do documento mais relevantes para a sua consulta, até maxLength caracteres. O Web IQ processa o documento inteiro do seu lado e devolve um excerto direcionado para a consulta, para que o seu modelo não tenha de ler parágrafos não relacionados para encontrar a frase relevante.

  • Poupança de tokens: o seu modelo recebe uma fração do documento em vez do documento completo.
  • Melhor factualidade: com menos conteúdo fora do tema no contexto, é menos provável que o modelo se fixe num parágrafo tangencial.

Passages funcionam para todas as aplicações. Um bom ponto de partida é maxResults = 10,passagecontentFormat = , e maxLength = 3000. A partir daí, afina para o teu caso de uso; vê Como devo afinar maxResults e maxLength?

Documento completo

O Web IQ não devolve a página web original. Durante a indexação, constrói um documento estruturado a partir do conteúdo significativo de cada página, e as passagens são selecionadas desse documento. As aplicações com acesso total ao documento podem solicitar o documento completo em vez de passagens:

contentFormat Returns
passage As partes do documento mais relevantes para a consulta, até maxLength caracteres.
text O documento completo em texto simples, até maxLength caracteres.
html O documento completo como HTML, até maxLength caracteres.
markdown O documento completo como Markdown, até maxLength caracteres.

Documentos mais longos do que maxLength são cortados. Para obter um documento completo, defina maxLength para um valor suficientemente alto.

Se a sua aplicação não tiver acesso total a documentos, um pedido que defina text, markdown ou AuthContentFormatForbidden devolve HTTP 403 com o código de erro html. As passagens continuam a ser o formato recomendado para grounding.

Solicite acesso completo ao documento

Para solicitar acesso completo ao documento, abra um pedido de Suporte Web IQ através do Suporte do Azure e escolha a categoria de conteúdo de página completa. Aplicações que já usam html ou text continuam a funcionar atualmente.

Predefinições e limites

O que recebes depende de a tua aplicação ter acesso total ao documento. Para obter os mesmos resultados sempre, define contentFormat e maxLength em cada solicitação.

Sem acesso total ao documento Com acesso total a documentos
Formatos disponíveis passage passage, text, html, markdown
contentFormat o deixares de fora passage html (Pesquisa na Web), text (Pesquisa de Notícias)
maxLength se o deixares de fora 3000 10000
Mais content por resultado 3.000 caracteres (valores maiores maxLength retornam no máximo 3.000) maxLength, até 500.000 caracteres

Navegar

Browse devolve o documento completo para um URL que escolheres, como text, html, ou markdown, até maxLength caracteres. Não suporta passage, porque não há nenhuma consulta em relação à qual extrair.