Passagens e formatos de conteúdo

Pesquisa na Web e Pesquisa de Notícias retornam o conteúdo de cada resultado em seu content campo. Você escolhe com contentFormat o que é esse conteúdo e maxLength. Defina ambos em cada solicitação. Para embasamento, use trechos.

Passagens

Defina contentFormat como passage para obter, para cada resultado, as partes do documento mais relevantes para sua consulta, até maxLength caracteres. Web IQ processa todo o documento do seu lado e retorna um trecho direcionado à consulta, para que seu modelo não precise passar por parágrafos não relacionados para encontrar a frase relevante.

  • Economia de token: seu modelo recebe uma fração do documento em vez de tudo.
  • Melhor factualidade: com menos conteúdo fora do tópico no contexto, o modelo tem menos probabilidade de ancorar em um parágrafo tangencial.

As chaves de acesso funcionam para cada aplicativo. Um bom ponto de partida é maxResults = 10passagecontentFormat = e maxLength = 3000. A partir daí, ajuste para seu caso de uso; Ver como devo ajustar maxResults e maxLength?

Documento completo

O IQ da Web não retorna a página da Web original. Durante a indexação, ele cria um documento estruturado com base no conteúdo significativo de cada página e as passagens são selecionadas nesse documento. Aplicativos com acesso completo a documentos podem solicitar todo o documento em vez de trechos:

contentFormat Returns
passage As partes do documento mais relevantes para a consulta, até maxLength caracteres.
text O documento completo como texto sem formatação, 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 truncados. Para obter um documento completo, defina maxLength como suficientemente alto.

Se o aplicativo não tiver acesso completo ao documento, uma solicitação que define text, html ou markdown retorna HTTP 403 com o código de erro AuthContentFormatForbidden. As passagens continuam sendo o formato recomendado para fundamentação.

Solicitar acesso completo ao documento

Para solicitar acesso completo ao documento, abra uma solicitação de Web IQ Support por meio do Azure Support e escolha a categoria de conteúdo de página inteira. Aplicativos que já usam html ou text continuam funcionando como hoje.

Valores padrão e limites

O que você obtém depende se seu aplicativo tem acesso completo ao documento. Para obter os mesmos resultados todas as vezes, defina contentFormat e maxLength em cada solicitação.

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

Navegar

Browse retorna o documento completo para uma URL que você escolher, como text, html ou markdown, até maxLength caracteres. Ele não dá suporte a passage, porque não há consulta na qual extrair.