Versões da API REST (Pesquisa de IA do Azure)
Este artigo lista as versões atuais e anteriores das APIs REST Pesquisa para Pesquisa de IA do Azure.
Documentos da API com versão
Os documentos da API REST estão agora em versão. Quando abre uma página de referência da API, é apresentado um seletor de versões acima do índice. Certifique-se de que a referência da API é da pastaPlano de Dados de Referência>.
Versões estáveis
| Versão da API | Especificação | Atualizações da API |
|---|---|---|
2023-11-01 (Mais recente) |
Especificação do Swagger | Nota de versão |
2020-06-30 |
Especificação do Swagger | Nota de versão |
2019-05-06 |
Especificação do Swagger | Adiciona tipos complexos. |
2017-11-11 |
Especificação do Swagger | Adiciona conjuntos de competências e melhoramento de IA. |
2016-09-01 |
Especificação do Swagger | Adiciona indexadores. |
2015-02-28 |
Não suportado após 10-10-2020 | Primeira versão geralmente disponível. |
Versões de pré-visualização
As versões de pré-visualização são lançadas para testar novas funcionalidades, recolher feedback e detetar e corrigir problemas. As APIs de pré-visualização estão disponíveis em Termos De Utilização Suplementares para Pré-visualizações do Microsoft Azure.
| Versão da API | Especificação | Atualizações da API |
|---|---|---|
2024-03-01-Preview (Mais recente) |
Especificação do Swagger | Nota de versão |
2023-10-01-Preview |
Especificação do Swagger | Nota de versão |
2023-07-01-Preview (preterido) |
Especificação do Swagger | Nota de versão |
2021-04-30-Preview |
Especificação do Swagger | Nota de versão |
2020-06-30-Preview |
Especificação do Swagger | Nota de versão |
2019-05-06-Preview |
Especificação do Swagger | Nota de versão |
2017-11-11-Preview |
Especificação do Swagger | Versão de pré-visualização associada à versão estável. |
2016-09-01-Preview |
Especificação do Swagger | Versão de pré-visualização associada à versão estável. |
2015-02-28-Preview (descontinuado) |
Não suportado após 10-10-2020 | Versão de pré-visualização associada à versão estável. |
2014-10-20-Preview (descontinuado) |
Não suportado após 10-10-2020 | Segunda pré-visualização pública. |
2014-07-31-Preview (descontinuado) |
Não suportado após 10-10-2020 | Primeira pré-visualização pública. |
Notas de versão
03-03-01-Preview 2024
Esta versão de pré-visualização baseia-se ao 2023-10-01-preview adicionar as seguintes APIs de pré-visualização que o ajudam a poupar espaço:
- Novos tipos de dados estreitos para campos de vetor se tiver modelos de incorporação que os suportem ou lógica de quantização que produz vetores mais pequenos.
- Novas propriedades de quantização de vetor para compressão de vetor incorporada num índice de pesquisa.
- Nova propriedade armazenadabooleana num campo de vetor que determina se uma cópia extra do campo está armazenada. A cópia extra é o conteúdo recuperável desse campo. Se não o armazenar, o campo ainda é utilizado em consultas, mas não pode ser devolvido num resultado de pesquisa. Pode definir esta propriedade para poupar espaço no serviço de pesquisa ou na quota de vetor num índice de pesquisa.
- A partir de 29 de março de 2024: as respostas GET já não devolvem cadeias de ligação ou chaves. Veja Alterações interruptivas do código de cliente que lê as informações de ligação para obter detalhes.
2023-11-01
Esta versão fornece funcionalidades geralmente disponíveis, incluindo:
- Classificação semântica no Pesquisa Pedidos post.
- Indexação de pesquisa de vetores em pedidos de Create ou Índice de Atualização e consultas de vetor em pedidos Pesquisa Post.
- A partir de 29 de março de 2024: as respostas GET já não devolvem cadeias de ligação ou chaves. Veja Alterações interruptivas do código de cliente que lê as informações de ligação para obter detalhes.
2023-10-01-Pré-visualização
Esta versão inclui todas as funcionalidades introduzidas em pré-visualizações anteriores, além de adições e modificações às APIs de pesquisa de vetores. Atualizações para as APIs de pesquisa de vetores são uma alteração interrupnte de 2023-07-01-Preview. Veja Adicionar campos de vetor e Create uma consulta de vetor para obter ajuda de migração.
Se planeia utilizar a nova capacidade de pré-filtro, tem de utilizar um índice criado após 2023-10-01.
Create ou Índice de Atualização:
vectorSearchtem definições paraalgorithms,profilesevectorizers:algorithmscontinua a suportarhnswe agora também suporta , em referência ao Hierárquico Navigable Small World (HNSW) e aos vizinhoseknnK mais próximos (eKNN) exaustivos. Na secção algoritmo, pode definir várias combinações nomeadas de parâmetros HNSW e eKNN. Isto substituialgorithmConfigurationsnavectorSearchpropriedade em 2023-07-01-Preview.profilesé uma nova definição que especifica a configuração do algoritmo. Por exemplo, suponha que tem configurações de algoritmo com o nome HNSW-1, HSNW-2 eKNN-1. Um perfil pode especificar HNSW-1.vectorizersé definido num índice, mas utilizado no momento da consulta para incorporar uma cadeia de consulta de texto. Um vetor referencia um modelo de incorporação. O serviço de pesquisa faz uma chamada para o modelo de incorporação para vetorizar a cadeia de consulta de texto e, em seguida, transmite o resultado para o motor de busca de uma consulta de vetor.
Em campos de vetor,
vectorSearchProfilesubstituivectorSearchConfiguration. AvectorSearchProfilepropriedade especifica o perfil de pesquisa de vetores a utilizar no campo.Nos índices criados antes desta versão da API, ao chamar a API 2023-10-01-Preview, no seu pedido, tem de alterar o campo para especificar um
vectorSearchProfile, desde que o perfil especifique o mesmo algoritmo especificado anteriormente novectorSearchConfiguration. Por exemplo, se a definição de campo existente especificar"vectorSearchConfiguration": "myHnsw", tem de substituí-la por"vectorSearchProfile": "your profile name"e o perfil tem de ser definido para referenciar o mesmo"algorithm": "myHnsw".
vectorQueriesvectorssubstitui em 2023-07-01-PreviewvectorQueries.vectorsvectors.valuessubstitui em 2023-07-01-Preview.- A consulta vetor é agora uma estrutura polimórfica.
kindtem de ser especificado para denotar o tipo de consulta de vetor que está a ser pedida."kind": "vector"significa que a consulta é um vetor, pelo que o autor da chamada já deve ter vetorizado a cadeia de consulta de pesquisa numa incorporação de vetor. "exhaustive": "true"é uma nova propriedade especifica se deve fazer uma pesquisa exaustiva (força bruta) k-vizinho mais próxima em todos os vetores dentro do índice de vetor.vectorFilterModeé um novo parâmetro para especificar pré-filtro (predefinição para índices criados após 2023-10-01) ou pós-filtro (predefinição em índices anteriores) na consulta.
A partir de 29 de março de 2024: as respostas GET já não devolvem cadeias de ligação ou chaves. Veja Alterações interruptivas do código de cliente que lê as informações de ligação para obter detalhes.
07-07-01-Preview 2023
Importante
A descontinuação desta versão de pré-visualização foi anunciada a 15 de abril de 2024 e será descontinuada a 8 de julho de 2024. Para obter ajuda com a migração, veja Atualizar AS APIs REST no Azure AI Pesquisa.
Esta versão tem funcionalidades de pré-visualizações anteriores, além do suporte de pesquisa de vetores:
- No índice de pesquisa, atribua
Collection(Edm.Single)o tipo de dados em campos que contenham uma matriz de números de vírgula flutuante de precisão única. Este é o tipo de dados da nova capacidade de pesquisa de vetores, utilizada para armazenar uma incorporação gerada por campo de documento. Também no índice de pesquisa, especifique as propriedades de configuração do vetor. Veja Create ou Atualizar Índice para estas APIs. - As cargas de trabalho de indexação são atualizadas para aceitar dados de vetor. Consulte Adicionar, Atualizar ou Eliminar Documentos.
- Parâmetros de consulta para pesquisa de vetores. Veja Pesquisa Documentos para estes parâmetros.
- Obter Estatísticas de Serviço: devolve a quota do índice de vetor e a utilização do serviço.
- Obter Estatísticas de Índice: devolve a quota do índice de vetor e a utilização do índice de pesquisa.
- A partir de 29 de março de 2024: as respostas GET já não devolvem cadeias de ligação ou chaves. Veja Alterações interruptivas do código de cliente que lê as informações de ligação para obter detalhes.
2021-04-30-Preview
Esta versão de pré-visualização inclui todas as funcionalidades introduzidas em 2020-06-30-Preview, além de adições às seguintes APIs:
- O alias de índice adiciona um nome secundário utilizado para referenciar índices em pedidos de consulta e indexação. As operações de alias incluem criar, atualizar, eliminar, obter e lista.
- Identidades geridas para ligações de saída. Os novos valores para cadeias de ligação em Create ou Atualizar Origem de Dados suportam ligações com Microsoft Entra ID autenticação e funções em vez de credenciais ou chaves de base de dados codificadas.
- O suporte de identidade gerida também é suportado para ligações do cofre de chaves, para soluções de pesquisa que complementam a encriptação predefinida com encriptação gerida pelo cliente.
- Mais idiomas para a competência cognitiva de Tradução de Texto.
- Mais consultasLanguages para pesquisa semântica e ortográfico no Pesquisa Documents (pré-visualização).
- Um parâmetro de legendas para solicitar opcionalmente legendas da pesquisa semântica em Documentos Pesquisa (pré-visualização).
- As configurações semânticas são especificadas no Create ou no Índice de Atualização. Uma configuração semântica determina que campos devem ser utilizados para classificação semântica, legendas, destaques e respostas.
- Um parâmetro semânticoConfiguration necessário para consultas semânticas no Pesquisa Documents (pré-visualização).
- A partir de 29 de março de 2024: as respostas GET já não devolvem cadeias de ligação ou chaves. Veja Alterações interruptivas do código de cliente que lê as informações de ligação para obter detalhes.
2020-06-30
Esta versão fornece funcionalidades geralmente disponíveis, incluindo:
- Controlo de acesso baseado em funções do Azure para operações do plano de dados
- Classificação por relevância (BM25)
- Arquivos de conhecimento
- Origem de dados do indexador para Azure Data Lake Storage (ADLS) Gen2
- Competência de Pesquisa de Entidades Personalizadas
- Indexadores em execução num sistema ou identidade gerida pelo utilizador através de Microsoft Entra ID
- A partir de 29 de março de 2024: as respostas GET já não devolvem cadeias de ligação ou chaves. Veja Alterações interruptivas do código de cliente que lê as informações de ligação para obter detalhes.
2020-06-30-Preview
Esta versão de pré-visualização inclui todas as funcionalidades introduzidas em 2019-05-06-Preview, além das seguintes adições:
- Pesquisa semântica, uma funcionalidade premium que é executada nos serviços de escalão Standard e que invoca a classificação semântica.
- Origem de dados do indexador para conectores de Power Query
- Origem de dados do indexador para MySQL
- Origem de dados do Indexador para a API do Gremlin do Cosmos DB
- Origem de dados do Indexador para o SharePoint Online
- Propriedade normalizador para normalização de texto, para filtragem, ordenação e ordenação não sensíveis a maiúsculas e minúsculas
- Repor Documentos para indexação baseada em indexador para atualizar especificamente documentos específicos por ID
- Competência cognitiva de Associação de Entidades (v3)
- Competência cognitiva de Reconhecimento de Entidades (v3)
- Competência cognitiva da Análise de Sentimentos (v3)
- A partir de 29 de março de 2024: as respostas GET já não devolvem cadeias de ligação ou chaves. Veja Alterações interruptivas do código de cliente que lê as informações de ligação para obter detalhes.
05-05-06-Preview de 2019
- Suporte da origem de dados do Indexador para a API mongoDB do Cosmos DB
- Origem de dados do indexador para eliminação recuperável de blobs nativos no Armazenamento de Blobs
- featuresMode parâmetro que devolve informações detalhadas sobre uma classificação de relevância
- Competência cognitiva do Azure Machine Learning (AML)
- Competência cognitiva de deteção de identificação pessoal
- Colocar em cache documentos melhorados para preservar e reutilizar o processamento de imagens (e outros melhoramentos de IA)
- A partir de 29 de março de 2024: as respostas GET já não devolvem cadeias de ligação ou chaves. Veja Alterações interruptivas do código de cliente que lê as informações de ligação para obter detalhes.