Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Este artigo lista as versões atuais e anteriores das APIs REST de Pesquisa para o Azure AI Search.
Documentos de API versionados
Os documentos da API REST agora estão versionados. Quando você abre uma página de referência de API, um seletor de versão aparece acima do índice. O seletor fica disponível quando você escolhe uma página da pasta Plano de Dados de Referência>.
Versões estáveis
| Versão da API | Especificação | Atualizações da API |
|---|---|---|
2025-09-01 (mais recente) |
Especificação Swagger | Nota de lançamento |
2024-07-01 |
Especificação Swagger | Nota de lançamento |
2023-11-01 |
Especificação Swagger | Nota de lançamento |
2020-06-30 |
Especificação Swagger | Nota de lançamento |
2019-05-06 |
Especificação Swagger | Adiciona tipos complexos. |
Versões de pré-visualização
Todos os novos recursos são introduzidos nas APIs de visualização antes da transição para uma versão estável. 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 |
|---|---|---|
2025-11-01-preview (mais recente) |
Especificação Swagger | Nota de lançamento |
2025-08-01-preview |
Especificação Swagger | Nota de lançamento |
2025-05-01-preview |
Especificação Swagger | Nota de lançamento |
2025-03-01-preview |
Especificação Swagger | Nota de lançamento |
2024-11-01-preview |
Especificação Swagger | Nota de lançamento |
2024-09-01-preview |
Especificação Swagger | Nota de lançamento |
2024-05-01-preview |
Especificação Swagger | Nota de lançamento |
2024-03-01-preview |
Especificação Swagger | Nota de lançamento |
2023-10-01-preview |
Especificação Swagger | Nota de lançamento |
2023-07-01-preview (preterido) |
Especificação Swagger | Nota de lançamento |
2021-04-30-preview |
Especificação Swagger | Nota de lançamento |
2020-06-30-preview |
Especificação Swagger | Nota de lançamento |
2019-05-06-preview |
Especificação Swagger | Nota de lançamento |
Notas de versão
2025-11-01-preview
Esta pré-visualização baseia-se no 2025-08-01-preview e inclui todas as funcionalidades atualmente em pré-visualização.
Se você usou o 2025-08-01-preview para criar um agente de conhecimento, que desde então foi renomeado para a base de dados de conhecimento, esta visualização introduz alterações de rutura. Para obter ajuda com a migração, consulte Migrar código de recuperação agentic para a versão mais recente.
Para obter mais informações sobre essas atualizações, consulte Novidades no Azure AI Search.
| Característica | Atualizar | API REST aplicável |
|---|---|---|
| Bases de conhecimento (anteriormente agentes de conhecimento) | Os agentes de conhecimento foram renomeados para bases de conhecimento, o que altera várias rotas:
As bases de conhecimento agora fazem referência a fontes de conhecimento apenas pelo nome, com todas as configurações movidas para a solicitação de recuperação.
|
Bases de Conhecimento |
| Fontes de conhecimento | Novos tipos de fontes de conhecimento:
As fontes de conhecimento indexadas agora oferecem suporte |
Fontes de Conhecimento |
| Recuperação de conhecimento | Os parâmetros de solicitação (rerankerThreshold, alwaysQuerySource, includeReferences) agora são passados por fonte de conhecimento via knowledgeSourceParams. Suporta respostas parciais com códigos de status HTTP 206 e saídas de erro opcionais em registros de atividade. O minimal modo de raciocínio usa um intent objeto (consultas de pesquisa direta) em vez de um LLM para planejamento de consultas. |
Recuperação de Conhecimento |
| Habilidade de Compreensão de Conteúdo do Azure | Nova habilidade que encapsula o Entendimento de Conteúdo do Azure nas Ferramentas de Fundição para extrair Markdown estruturado de texto, imagens, PDFs, Microsoft PowerPoint, Microsoft Word e muito mais. Para fontes de conhecimento indexadas, essa habilidade está disponível através da propriedade dentro de contentExtractionModeingestionParameters. |
Skillsets - Criar ou Atualizar |
| Suporte à ACL do indexador do SharePoint | Suporte estendido a ACL para fluir permissões básicas do SharePoint para documentos indexados, permitindo o controle de acesso no nível do documento. | Índices - Criar ou Atualizar, Fontes de Dados - Criar ou Atualizar e Documentos - Pesquisar Post |
| Permissões de leitura elevadas para ACLs | Novo recurso para atribuir permissões de leitura elevadas a administradores para investigar problemas com configurações de ACL usadas no controle de acesso a documentos. | Documentos - Pesquisar Post |
| Indexação de rótulos de sensibilidade no nível do documento | Nova integração com o Microsoft Purview para sincronizar rótulos de sensibilidade de documentos com o índice, honrando seus rótulos e proteção no momento da consulta para governança de dados. | Índices - Criar ou Atualizar, Fontes de Dados - Criar ou Atualizar e Documentos - Pesquisar Post |
| Atualizações de indexação do SharePoint | Novos recursos de indexador do SharePoint, incluindo opções de autenticação aprimoradas, atualizações incrementais e tratamento básico de permissões de documentos. | Fontes de dados - Criar ou atualizar |
| Agregação da função de pontuação | Nova capacidade de combinar e agregar várias funções de pontuação, permitindo uma personalização de relevância mais sofisticada e uma combinação de sinal ponderado. | Índices - Criar ou Atualizar |
| Agregações de facetas | Novas operações de agregação de facetas, incluindo mínimo, máximo, média e cardinalidade, fornecem análises aprimoradas em experiências de pesquisa facetadas. | Índices - Criar ou Atualizar |
2025-09-01
Esta versão da API é a API REST estável mais recente para o Azure AI Search. Ele se baseia na versão estável anterior (2024-07-01) e adiciona as atualizações de API listadas na tabela a seguir.
Alguns outros recursos geralmente disponíveis, como integração de aplicativos lógicos e suporte a perfis de pontuação semântica, não afetam o contrato de API e não são refletidos na tabela. Consulte O que há de novo na Pesquisa de IA do Azure para obter a lista completa de anúncios.
| Característica | Atualizar | API REST aplicável |
|---|---|---|
| Indexador OneLake | Automatiza a recuperação e indexação de dados de um lago do Microsoft OneLake. | Criar ou atualizar fontes de dados |
| Habilidade de layout de documentos | Fragmenta o texto com base na estrutura do documento. | Criar ou atualizar o conjunto de habilidades |
| Propriedade do normalizador | Suporta filtragem, facetagem e classificação que não diferenciam maiúsculas de minúsculas. | Criar ou atualizar de índice |
| Propriedade de descrição do índice | Descreve um índice, que é útil para engenharia imediata em cargas de trabalho RAG. | Criar ou atualizar de índice |
| Opções de repontuação para vetores compactados | Repontua os resultados da pesquisa vetorial com vetores originais em vez de vetores compactados. Aplica-se a HNSW e algoritmos vetoriais KNN exaustivos, usando compressão binária e escalar. | Criar ou atualizar de índice |
| Dimensões truncadas | Aplica-se aos modelos text-embedding-3-small e text-embedding-3-large, retreinados na quantização Matryoshka Representation Learning (MRL). | Criar ou atualizar de índice |
| Parâmetro de depuração e subscores de consulta | Descompacta uma pontuação de resultado de pesquisa híbrida em suas partes componentes. | Pesquisa de documentos |
2025-08-01-preview
Esta pré-visualização baseia-se no 2025-05-01-preview e inclui todas as funcionalidades atualmente em pré-visualização.
Se você usou o 2025-05-01-preview para criar um agente de conhecimento, esta visualização introduz alterações de rutura. Para obter ajuda com a migração, consulte Migrar código de recuperação agentic para a versão mais recente.
Para obter mais informações sobre essas atualizações, consulte Novidades no Azure AI Search.
| Característica | Atualizar | API REST aplicável |
|---|---|---|
| Agentes do conhecimento | Mudanças arquitetônicas na definição do agente de conhecimento, que agora requer um ou mais knowledgeSources em vez de targetIndexes e deprecia.defaultMaxDocsForRerankerAdiciona várias propriedades para maior controle sobre o planejamento e a execução da consulta, incluindo |
Agentes de conhecimento - Criar ou atualizar |
| Fontes de conhecimento | Novas APIs REST para criar e gerenciar fontes de conhecimento, que suportam searchIndex (um ou vários índices) e azureBlob tipos. |
Fontes de Conhecimento |
| Pós-filtragem rigorosa para consultas vetoriais | Novo strictPostFilter valor para vectorFilterMode, que aplica filtros depois que os resultados globais do vetor superiork são identificados. |
Documentos - Pesquisar Post |
| Aumento das dimensões máximas para campos vetoriais | O máximo dimensions por campo vetorial agora 4096é . Esta atualização aplica-se a todas as versões estáveis e pré-visualizadas da API REST que suportam vetores e não introduzem alterações de quebra. |
Índices - Criar ou atualizar |
| Informações de rastreamento de tempo de execução do indexador aprimoradas | Obter Estatísticas de Serviço agora retorna informações de processamento de indexador cumulativo para todo o serviço de pesquisa. Obter status - Os indexadores fornecem as mesmas informações para indexadores individuais. | Obter estatísticas de serviço e obter status - Indexadores |
2025-05-01-preview
Esta pré-visualização baseia-se no 2025-03-01-preview e inclui todas as funcionalidades atualmente em pré-visualização. Você pode atualizar as versões da API REST de para com 2025-03-01-preview alterações mínimas de 2025-05-01-preview código.
Essa visualização adiciona suporte para recuperação de agente, indexação multimodal, herança de permissões no nível do documento e integração mais profunda com modelos de linguagem grandes em cargas de trabalho de indexação e consulta. Para obter mais informações, consulte Novidades na Pesquisa de IA do Azure.
| Característica | Atualizar | API REST aplicável |
|---|---|---|
| Recuperação agentica | Adiciona expansão de consulta usando modelos de linguagem conversacional para planejamento inteligente de consultas. Ele também gera uma resposta complexa que inclui dados de aterramento para aplicativos de bate-papo downstream. A resposta inclui um plano de consulta e dados de referência com base em documentos de origem. | Agentes do Conhecimento e Recuperação de Conhecimento |
| Habilidade GenAI Prompt | Permite especificar prompts e um LLM para gerar novo conteúdo de campo. | Criar ou atualizar o conjunto de habilidades |
| Habilidade de layout de documentos | Agora suporta deteção de imagem e preservação de contexto para indexação multimodal. | Criar ou atualizar o conjunto de habilidades |
| Integração de Aplicativos Lógicos do Azure | Expande os tipos de fonte de dados suportados para indexação baseada em indexador que são executados fora de fluxos de trabalho. | Criar ou atualizar fontes de dados |
| Herança de permissão no nível do documento | Suporta resultados de pesquisa com permissão por usuário. |
Criar ou atualizar índices (filtros de permissão) Criar ou atualizar fontes de dados (opções de permissão) |
2025-03-01-preview
Esta pré-visualização baseia-se no 2024-11-01-preview e inclui todas as funcionalidades atualmente em pré-visualização. Você pode atualizar as versões da API REST de para com 2024-11-01-preview alterações mínimas de 2025-03-01-preview código.
Há apenas algumas atualizações de API de plano de dados nesta visualização, mas mais recursos estão disponíveis no serviço de pesquisa quando seu código chama essa versão de API de visualização. Para obter mais informações, consulte Novidades na Pesquisa de IA do Azure.
| Atualizar | API REST aplicável |
|---|---|
| Hierarquias de facetas, agregação e filtros, usados para gerar estruturas de navegação de facetas sobre facetas hierárquicas, agregadas e filtradas. | Pesquisar Documentos, novos parâmetros de faceta no pedido. |
| Opção de classificação semântica para modelos a bordo | Criar ou atualizar índice, nova propriedade booleana flightingOptIn na seção de configuração semântica. Se um modelo de classificação semântica de pré-lançamento estiver disponível na região do serviço de pesquisa, ele será usado em vez da versão estável para classificação secundária. Esta propriedade destina-se a desenvolvedores que desejam testar os modelos de classificação mais recentes em código de não produção. |
2024-11-01-preview
Esta pré-visualização baseia-se no 2024-09-01-preview e inclui todas as funcionalidades atualmente em pré-visualização. Você pode atualizar as versões da API REST de para com 2024-09-01-preview alterações mínimas de 2024-11-01-preview código.
| Atualizar | API REST aplicável |
|---|---|
| Reescrita de consulta no reranker semântico, usado para refinar consultas enviadas para o classificador L2. | de Pesquisa de Documentos , o novo QueryRewritesType propriedade na solicitação. |
| habilidade Layout de Documento usada para analisar um documento quanto à estrutura. | Criar ou atualizarSkillset, nova habilidade de DocumentIntelligenceLayoutSkill. |
| Identidade gerenciada para anexar um recurso multisserviço de IA do Azure. | |
| modo de análise Markdown, usado para indexar arquivos Markdown no Armazenamento do Azure. | |
| Opções de repontuação para vetores compactados, usadas para remarcar com vetores originais em vez de vetores compactados. Aplica-se a HNSW e algoritmos vetoriais KNN exaustivos, usando compressão binária e escalar. | enableRescoring mapas de propriedades para rerankWithOriginalVectors introduzido em 2024-03-01-preview. |
2024-09-01-preview
Esta pré-visualização baseia-se no 2024-05-01-preview e inclui todas as funcionalidades atualmente em pré-visualização. Você pode atualizar do 2024-05-01-preview para o 2024-09-01-preview sem a necessidade de alterações de código. Para obter mais informações, consulte Atualizar as APIs REST.
| Atualizar | API REST aplicável |
|---|---|
| Dimensões truncadas para modelos de incorporação de texto-3-pequeno e texto-incorporação-3-grande retreinados na quantização Matryoshka Representation Learning (MRL). | Create or Update Index, novo parâmetro truncationDimension |
| Subpontuações ou detalhes de pontuação para descompactar resultados de pesquisa híbridos pontuados por Reciprocal Rank Fusion (RRF). | |
| Filtragem de destino para a parte vetorial de uma consulta de pesquisa híbrida . | de Pesquisa de Documentos , novo parâmetro de filterOverride em RawVectorQuery, VectorizableTextQuery, VectorizableImageUrlQuery, VectorizableImageBinaryQuery. |
| Fragmentação de token em habilidade Divisão de texto, em vez de apenas caracteres. |
2024-07-01
Esta versão fornece atualizações geralmente disponíveis para vetorização integrada (habilidades e vetorizadores), quantização escalar e quantização binária. Consulte Novidades na Pesquisa de IA do Azure para obter detalhes.
| Atualizar | API REST aplicável |
|---|---|
| Geralmente disponível - tipos de dados vetoriais | Criar ou atualizar de índice |
| Geralmente disponível - propriedades de quantização vetorial para quantização escalar ou binária interna em um índice de pesquisa. | Criar ou atualizar de índice |
| Geralmente disponível - propriedade armazenada em um campo de vetor que determina se uma cópia extra do campo é armazenada. A cópia extra é o conteúdo recuperável desse campo. Se você não armazená-lo, o campo ainda será usado em consultas, mas não poderá ser retornado em um resultado de pesquisa. Você pode definir essa propriedade para economizar espaço em seu serviço de pesquisa ou cota vetorial em um índice de pesquisa. | Criar ou atualizar de índice |
| Geralmente disponível - VectorizableTextQuery parâmetros para ajuste de relevância. Os parâmetros de consulta híbridos (MaxTextSizeRecall) ainda estão em visualização. | Pesquisa de documentos |
| Geralmente disponível - AzureOpenAIEmbedding habilidade para suportar mais modelos do que apenas text-embedding-ada-002 para vetorização integrada durante a indexação. Defina o nome do modelo e as propriedades de dimensões para direcionar um modelo específico. | Criar ou atualizar o conjunto de habilidades |
| Disponível ao público em geral - Vetorizador de incorporação do Azure OpenAI para vetorização integrada durante consultas. As propriedades do vetorizador suportam mais modelos. | Criar ou atualizar de índice |
| A partir de 29 de março de 2024: as respostas GET não retornam mais cadeias de conexão ou chaves. Consulte Alteração de quebra para o código do cliente que lê informações de conexão para obter detalhes. | Todas as versões |
2024-05-01-preview
Esta visualização adiciona suporte para indexação OneLake, ajuste de relevância e integração mais profunda com mais modelos de incorporação durante a indexação e consultas. Baseia-se no 2024-03-01-preview e inclui todas as funcionalidades atualmente em pré-visualização.
Para atualizar do 2024-03-01-preview ou 2023-10-01-preview, atualize a habilidade AzureOpenAIEmbedding ou vetorizador para incluir o nome e as dimensões do modelo. Para atualizar a partir de 2023-07-01-preview (preterido) ou para obter instruções passo a passo, consulte Atualizar APIs REST.
Aqui estão as atualizações nesta visualização. Também recomendamos Novidades no Azure AI Search.
| Atualizar | API REST aplicável |
|---|---|
| Fonte de dados do indexador para arquivos e atalhos do OneLake. | Criar ou atualizar de fonte de dados |
Collection(Edm.Byte), um tipo de dados binários para incorporar modelos que os suportam. As definições de campo vetorial suportam esse tipo de dados. |
Criar ou atualizar de índice |
| Vários parâmetros de consulta vetoriais e híbridos para ajuste de relevância. Defina limites para excluir resultados de pontuação baixa. Consultas de vetor de peso. Para consultas híbridas, defina o máximo de documentos a serem recuperados na parte de texto de uma consulta híbrida. | Pesquisa de documentos |
| Nova habilidade do Azure AI Vision para vetorização integrada multimodal durante a indexação. Essa habilidade chama a API multimodal do Azure AI Vision. | Criar ou atualizar o conjunto de habilidades |
| Novo vetorizador Azure AI Vision para consultas multimodais. Um vetorizador é especificado em definições de índice, mas usado durante a execução da consulta. | Criar ou atualizar de índice |
| Habilidade AzureOpenAIEmbedding atualizada para suportar mais modelos do que apenas text-embedding-ada-002 para vetorização integrada durante a indexação. Defina o nome do modelo e as propriedades de dimensões para direcionar um modelo específico. | Criar ou atualizar o conjunto de habilidades |
| Vetorizador de incorporação do Azure OpenAI atualizado para vetorização integrada durante consultas. As propriedades do vetorizador suportam mais modelos. | Criar ou atualizar de índice |
| A partir de 29 de março de 2024: as respostas GET não retornam mais cadeias de conexão ou chaves. Consulte Alteração de quebra para o código do cliente que lê informações de conexão para obter detalhes. | Todas as versões |
2024-03-01-preview
Esta versão de pré-visualização baseia-se em 2023-10-01-preview adicionando APIs de pré-visualização que melhoram o armazenamento vetorial. Consulte Novidades na Pesquisa de IA do Azure para obter detalhes.
| Atualizar | API REST aplicável |
|---|---|
| Novos tipos de dados estreitos para campos vetoriais se você tiver modelos de incorporação que os suportem ou lógica de quantização que produza vetores menores. | Criar ou atualizar de índice |
| Novas propriedades de quantização vetorial para compactação vetorial interna em um índice de pesquisa. | Criar ou atualizar de índice |
| Nova propriedade booleana |
Criar ou atualizar de índice |
| A partir de 29 de março de 2024: as respostas GET não retornam mais cadeias de conexão ou chaves. Consulte Alteração de quebra para o código do cliente que lê informações de conexão para obter detalhes. | Todas as versões |
2023-11-01
Esta versão fornece recursos geralmente disponíveis. Consulte Novidades na Pesquisa de IA do Azure para obter detalhes.
| Atualizar | API REST aplicável |
|---|---|
| Classificação semântica em solicitações de publicação de pesquisa. | Pesquisa de documentos |
| Configuração de pesquisa vetorial para indexação de campos vetoriais | Criar ou atualizar de índice |
| Consultas vetoriais em solicitações de postagem de pesquisa. | Pesquisa de documentos |
| A partir de 29 de março de 2024: as respostas GET não retornam mais cadeias de conexão ou chaves. Consulte Alteração de quebra para o código do cliente que lê informações de conexão para obter detalhes. | Todas as versões |
2023-10-01-preview
Esta versão inclui todos os recursos introduzidos em visualizações anteriores, além de adições e modificações nas APIs de pesquisa vetorial. As atualizações das APIs de pesquisa vetorial são uma mudança radical a partir de 2023-07-01-Preview. Consulte Adicionar campos vetoriais e Criar um de consulta vetorial para obter ajuda sobre migração.
Se você planeja usar o novo recurso de pré-filtragem, deverá usar um índice criado após 2023-10-01.
vectorSearchtem definições paraalgorithms,profilesevectorizers:algorithmscontinua a apoiarhnswe agora também suportaeknn, em referência ao Hierarchical Navigable Small World (HNSW) e ao exaustivo K-nearest neighbors (eKNN). Dentro da seção de algoritmo, você pode definir várias combinações nomeadas de parâmetros HNSW e eKNN. Esta substituialgorithmConfigurationsdentro da propriedadevectorSearchem 2023-07-01-Preview.profilesé uma nova definição que especifica a configuração do algoritmo. Por exemplo, suponha que você tenha configurações de algoritmo chamadas HNSW-1, HSNW-2, eKNN-1. Um perfil pode especificar HNSW-1.vectorizersé definido em um índice, mas usado no momento da consulta para incorporar uma cadeia de caracteres de consulta de texto. Um vetorizador faz referência a um modelo de incorporação. O serviço de pesquisa faz uma chamada para o modelo de incorporação para vetorizar a cadeia de caracteres de consulta de texto e, em seguida, passa o resultado para o mecanismo de pesquisa para uma consulta vetorial.
Em campos vetoriais,
vectorSearchProfilesubstituivectorSearchConfiguration. A propriedadevectorSearchProfileespecifica qual perfil de pesquisa vetorial usar no campo.Em índices criados antes desta versão da API, ao chamar a API 2023-10-01-Preview, em sua solicitação, você deve alterar o campo para especificar uma
vectorSearchProfile, desde que o perfil especifique exatamente o mesmo algoritmo especificado anteriormente novectorSearchConfiguration. Por exemplo, se a definição de campo existente especificar"vectorSearchConfiguration": "myHnsw", você deverá substituí-la por"vectorSearchProfile": "your profile name", e o perfil deverá ser definido para fazer referência à mesma"algorithm": "myHnsw".
-
vectorQueriessubstituivectorsem 2023-07-01-Preview -
vectorQueries.vectorssubstituivectors.valuesem 2023-07-01-Preview. - A consulta vetorial é agora uma estrutura polimórfica.
kinddeve ser especificado para indicar o tipo de consulta vetorial que está sendo solicitada."kind": "vector"significa que a consulta é um vetor, portanto, o chamador já deve ter vetorizado a cadeia de caracteres de consulta de pesquisa em uma incorporação vetorial. -
"exhaustive": "true"é uma nova propriedade especifica se deve ser feita uma pesquisa exaustiva (força bruta) de vizinhos k-nearest em todos os vetores dentro do índice de vetores. -
vectorFilterModeé um novo parâmetro para especificar pré-filtragem (padrão para índices criados após2023-10-01) ou pós-filtragem (padrão em índices anteriores) na consulta.
A partir de 29 de março de 2024: as respostas GET não retornam mais cadeias de conexão ou chaves. Consulte Alteração de quebra para o código do cliente que lê informações de conexão para obter detalhes.
2023-07-01-preview
Importante
Não use esta versão da API. A preterição desta versão de pré-visualização foi anunciada em 15 de abril de 2024 e não é mais suportada após 8 de julho de 2024. Para obter ajuda com a migração, consulte Atualizar APIs REST no Azure AI Search.
Esta versão introduziu suporte vetorial e usa uma configuração vetorial que é incompatível com versões mais recentes da API.
- Adicionado um tipo de dados
Collection(Edm.Single)em campos que contêm uma matriz de números de ponto flutuante de precisão única. Este é o tipo de dados para vetores, usado para armazenar uma incorporação gerada por campo de documento. O índice de pesquisa também especifica as propriedades de configuração do vetor. - Cargas de trabalho de indexação atualizadas para aceitar dados vetoriais.
- Adicionados parâmetros de consulta para pesquisa vetorial. Consulte Pesquisar documentos para obter esses parâmetros.
- Obter estatísticas de serviço: retorna a cota de índice vetorial e o uso do serviço.
- Obter estatísticas de índice: retorna a cota de índice vetorial e o uso para o índice de pesquisa.
- A partir de 29 de março de 2024: as respostas GET não retornam mais cadeias de conexão ou chaves. Consulte Alteração de quebra para o código do cliente que lê informações de conexão para obter detalhes.
2021-04-30-preview
Esta versão de pré-visualização inclui todas as funcionalidades introduzidas no 2020-06-30-Preview, além de adições às seguintes APIs:
- O alias de índice adiciona um nome secundário usado para referenciar índices em solicitações de consulta e indexação. As operações de alias incluem criar, atualizar, excluir, obter e listar.
- Identidades gerenciadas para conexões de saída. Novos valores para cadeias de conexão em Criar ou Atualizar Fonte de Dados suportam conexões usando a autenticação e funções do Microsoft Entra ID em vez de credenciais ou chaves de banco de dados codificadas.
- O suporte de identidade gerenciada também é suportado para conexões de cofre de chaves, para soluções de pesquisa que complementam a criptografia padrão com criptografia gerenciada pelo cliente.
- Mais idiomas para a habilidade cognitiva de Tradução de Texto.
- Mais queryLanguages para pesquisa semântica e ortografia em Pesquisar Documentos.
- Um parâmetro captions para, opcionalmente, solicitar legendas da pesquisa semântica em Pesquisar Documentos.
- As configurações semânticas são especificadas em Criar ou Atualizar Índice. Uma configuração semântica determina quais campos devem ser usados para classificação semântica, legendas, destaques e respostas.
- Um parâmetro semanticConfiguration que é necessário para consultas semânticas em Documentos de Pesquisa.
- A partir de 29 de março de 2024: as respostas GET não retornam mais cadeias de conexão ou chaves. Consulte Alteração de quebra para o código do cliente que lê informações de conexão para obter detalhes.
2020-06-30
Esta versão fornece recursos geralmente disponíveis, incluindo:
- Controle de acesso baseado em função do Azure para operações de plano de dados
- Pontuação de relevância (BM25)
- Armazenamentos de conhecimento
- Fonte de dados do indexador para o Azure Data Lake Storage (ADLS) Gen2
- Habilidade de pesquisa de entidade personalizada
- Indexadores em execução sob um sistema ou identidade gerenciada pelo usuário por meio do ID do Microsoft Entra
- A partir de 29 de março de 2024: as respostas GET não retornam mais cadeias de conexão ou chaves. Consulte Alteração de quebra para o código do cliente que lê informações de conexã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, um recurso premium que é executado em serviços de camada padrão e que invoca a classificação semântica.
- Fonte de dados do indexador para conectores do Power Query
- Fonte de dados do indexador para MySQL
- Fonte de dados do indexador para a API Gremlin do Cosmos DB
- Fonte de dados do indexador para o SharePoint Online
- Propriedade Normalizer para normalização de texto, para filtragem, facetagem e classificação que não diferenciam maiúsculas de minúsculas
- Redefinir documentos para indexação baseada em indexador para atualizar especificamente documentos específicos por ID
- Habilidade cognitiva de vinculação de entidade (v3)
- Habilidade cognitiva de Reconhecimento de Entidades (v3)
- Habilidade cognitiva de Análise de Sentimento (v3)
- A partir de 29 de março de 2024: as respostas GET não retornam mais cadeias de conexão ou chaves. Consulte Alteração de quebra para o código do cliente que lê informações de conexão para obter detalhes.
2019-05-06-preview
- Suporte de fonte de dados do indexador para a API MongoDB do Cosmos DB
- Fonte de dados do indexador para exclusão suave no Armazenamento de Blobs
- parâmetro featuresMode que retorna informações detalhadas sobre uma pontuação de relevância
- Habilidade cognitiva do Azure Machine Learning (AML)
- Habilidade cognitiva de deteção de identificação pessoal
- Armazenar documentos enriquecidos em cache para preservar e reutilizar o processamento de imagens (e outros enriquecimentos de IA)
- A partir de 29 de março de 2024: as respostas GET não retornam mais cadeias de conexão ou chaves. Consulte Alteração de quebra para o código do cliente que lê informações de conexão para obter detalhes.