Partilhar via

Migrar código de classificação semântica de versões anteriores

  • Artigo

Se o código de classificação semântica foi escrito em relação às APIs de visualização antecipada, este artigo identifica as alterações de código necessárias para migrar para versões mais recentes da API. As alterações de quebra para o classificador semântico são limitadas à lógica de consulta em APIs recentes, mas se o código foi escrito em relação à versão de visualização inicial, talvez seja necessário alterar a configuração semântica também.

Alterações interruptivas

Há duas alterações significativas para o classificador semântico nas versões da API REST:

  • searchFields foi substituído por semanticConfiguration em 2021-04-30-preview
  • queryLanguage foi ignorado a partir de 2023-07-01-preview, mas restabelecido para reescrita de consulta em 2024-11-01-preview

Outras atualizações específicas da versão dizem respeito a novos recursos, mas não quebram o código existente e, portanto, não interrompem as alterações.

Se você estiver usando SDKs do Azure, várias APIs foram renomeadas ao longo do tempo. Os logs de alteração do SDK fornecem os detalhes.

Versões de API que fornecem classificação semântica

Verifique seu código para a versão da API REST ou a versão do pacote SDK para confirmar qual fornece classificação semântica. As seguintes versões de API têm algum nível de suporte para classificação semântica.

Tipo de versão Versão da API REST Atualizações do ranker semântico
inicial 2020-06-30-pré-visualização Adiciona queryType=semantic a documentos de pesquisa
preview 2021-04-30-pré-visualização Adiciona semanticConfiguration ao índice Criar ou Atualizar
preview 2023-07-01-visualização Atualizações semanticConfiguration. A partir de 14 de julho de 2023, as atualizações dos modelos semânticos hospedados pela Microsoft tornaram o ranker semântico agnóstico à linguagem, desativando efetivamente a queryLanguage propriedade para classificação semântica. Não há nenhuma alteração no código, mas a propriedade é ignorada. Os clientes foram aconselhados a remover esta propriedade do código.
preview 2023-10-01-visualização Adiciona semanticQuery para enviar uma consulta usada apenas para fins de reclassificação.
estável 2023-11-01 Geralmente disponível. Introduziu alterações para semanticConfiguration que progrediu para a versão estável. Se o seu código tiver como alvo esta versão ou posterior, ele será compatível com versões mais recentes da API, a menos que você adote novos recursos de visualização.
preview 2024-05-01-pré-visualização Sem alterações
estável 2024-07-01 Sem alterações
preview 2024-09-01-visualização Sem alterações
preview 2024-11-01-pré-visualização Adiciona a regravação da consulta. A queryLanguage propriedade agora é necessária se você usar a regravação de consulta (visualização).

Alterar logs para SDKs do Azure

Os SDKs do Azure estão em um cronograma de lançamento independente. Você deve verificar os logs de alterações para determinar quais pacotes fornecem recursos semânticos e se alguma API foi renomeada.

2024-11-01-pré-visualização

  • Adiciona a reconfiguração de consulta à Pesquisa de Documentos.
  • Requer queryLanguage cargas de trabalho de regravação de consulta. Para obter uma lista de valores válidos, consulte a API REST.

2024-09-01-visualização

Nenhuma alteração na sintaxe de classificação semântica da versão estável 2024-07-01.

2024-07-01

Não há alterações na sintaxe de classificação semântica da versão 2024-05-01-preview .

Não use esta versão da API. Ele implementa uma sintaxe de consulta vetorial que é incompatível com qualquer versão mais recente da API.

2024-05-01-pré-visualização

Nenhuma alteração na sintaxe de classificação semântica da versão 2024-03-01-preview

2024-03-01-visualização

Não há alterações na sintaxe de classificação semântica da versão 2023-10-01-preview, mas consultas vetoriais são introduzidas. A classificação semântica agora se aplica a respostas de consultas híbridas e vetoriais. Você pode aplicar a reclassificação em qualquer campo de texto legível por humanos na resposta, supondo que os campos estejam listados em prioritizedFields.

2023-11-01

  • Exclui SemanticDebug e semanticQuery, caso contrário, o mesmo que a versão 2023-10-01-preview .

2023-10-01-visualização

  • Adiciona semanticQuery

2023-07-01-visualização

  • Acrescenta semanticErrorHandling, semanticMaxWaitInMilliseconds.
  • Adiciona vários campos relacionados à semântica à resposta, como SemanticDebug e SemanticErrorMode.
  • Ignora queryLanguage, ele não é mais usado no ranking semântico.

A partir de 14 de julho de 2023, o ranker semântico é agnóstico de linguagem. Em versões de visualização, a classificação semântica despriorizaria resultados diferentes dos querylanguage especificados pelo analisador de campo. No entanto, a queryLanguage propriedade ainda é aplicável à correção ortográfica e à pequena lista de idiomas suportados por esse recurso.

2021-04-30-pré-visualização

A searchFields propriedade não é mais usada para priorizar campos. Em todas as versões futuras, semanticConfiguration.prioritizedFields substitui searchFields como o mecanismo para especificar quais campos usar para a classificação L2.

2020-06-30-pré-visualização

  • O suporte semântico é feito por meio de uma chamada à API de visualização de Documentos de Pesquisa.
  • Adiciona queryType=semantic à solicitação de consulta.
  • Adapta-se searchFields de modo que, se o tipo de consulta for semântico, a searchFields propriedade determine a ordem de prioridade das entradas de campo para o classificador semântico.
  • Adiciona captions, answerse highlights à resposta da consulta.

Próximos passos

Teste a migração da configuração semântica executando uma consulta semântica.

Criar uma consulta semântica