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

Se o código de classificação semântica tiver sido gravado em APIs de visualização antecipada, este artigo identificará as alterações de código necessárias para migrar para versões de API mais recentes. Alterações interruptivas para o classificador semântico são limitadas à lógica de consulta em APIs recentes, mas se o código foi gravado na versão de visualização inicial, talvez você também precise alterar a configuração semântica.

Alterações da falha

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

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

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

Se você estiver usando SDKs do Azure, várias APIs foram renomeada 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 do SDK para confirmar qual fornece classificação semântica. As versões de API a seguir têm algum nível de suporte para classificação semântica.

Tipo de Versão	Versão da API REST	Atualizações do classificador semântico
inicial	2020-06-30-preview	Adiciona queryType=semantic para pesquisar os documentos
preview	2021-04-30-preview	Adiciona semanticConfiguration para criar ou atualizar o índice
preview	2023-07-01-preview	Atualiza semanticConfiguration. A partir de 14 de julho de 2023, as atualizações dos modelos semânticos hospedados pela Microsoft tornaram a linguagem semântica do classificador independente, desativando efetivamente a propriedade queryLanguage para classificação semântica. Não há nenhuma alteração interruptiva no código, mas a propriedade é ignorada. Os clientes foram aconselhados a remover essa propriedade do código.
preview	2023-10-01-preview	Adiciona semanticQuery para enviar uma consulta usada apenas para fins de reclassificador.
estável	2023-11-01	Em disponibilidade geral. Alterações introduzidas no semanticConfiguration que progrediu para a versão estável. Se o código for direcionado a essa versão ou posterior, ele será compatível com versões de API mais recentes, a menos que você adote novas versões prévias do recurso.
preview	2024-05-01-preview	Nenhuma alteração
estável	01-07-2024	Nenhuma alteração
preview	2024-09-01-preview	Nenhuma alteração
preview	2024-11-01-preview	Adiciona reescrita de consulta. A propriedade queryLanguage agora é necessária se você usar reescrita de consulta (versão prévia).

Alterar logs para SDKs do Azure

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

• Log de alterações do SDK do Azure para .NET
• Log de alterações do SDK do Azure para Python
• Log de alterações do SDK do Azure para Java
• Log de alterações do SDK do Azure para JavaScript

2024-11-01-preview

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

2024-09-01-preview

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

01-07-2024

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

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

2024-05-01-preview

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

2024-03-01-preview

Nenhuma alteração na sintaxe de classificação semântica da versão 2023-10-01-preview, mas as consultas vetoriais são introduzidas. A classificação semântica agora se aplica a respostas de consultas híbridas e vetoriais. Você pode aplicar o reclassificado 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-preview

• Adiciona semanticQuery

2023-07-01-preview

• Adiciona semanticErrorHandling, semanticMaxWaitInMilliseconds.
• Adiciona vários campos semânticos à resposta, como SemanticDebug e SemanticErrorMode.
• Ignora queryLanguage, ela não é mais usada na classificação semântica.

A partir de 14 de julho de 2023, a classificação semântica é independente da linguagem. Nas versões prévias, a classificação semântica desprioriza os resultados diferentes de querylanguage especificada pelo analisador de campo. No entanto, a propriedade queryLanguage ainda é aplicável à correção ortográfica e à breve lista de idiomas compatíveis com esse recurso.

2021-04-30-preview

• O suporte semântico é por meio de Pesquisar documentos e Criar ou Atualizar Índice chamadas de API de versão prévia.
• Adicione semanticConfiguration a um índice de pesquisa Uma configuração semântica tem um nome e uma lista de campo priorizada:
• Adiciona ''prioritizedFields".

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

2020-06-30-preview

• O suporte semântico é por meio de uma chamada à API de visualização documentos de pesquisa.
• Adiciona queryType=semantic à solicitação de consulta.
• Adapta searchFields para que, se o tipo de consulta for semântico, a propriedade searchFields determinará a ordem de prioridade das entradas de campo para o classificador semântico.
• Adiciona captions, answers e highlights à resposta de consulta.

Próximas etapas

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

Criar uma consulta semântica