Upgrade na nejnovější rozhraní REST API v Azure AI Vyhledávač

Tento článek slouží k migraci na novější verze rozhraní REST API vyhledávací služby a rozhraní REST API správy vyhledávání pro operace roviny dat a řídicí roviny .

Tady jsou nejnovější verze rozhraní REST API:

Pokyny k upgradu se zaměřují na změny kódu, které vám pomůžou provést zásadní změny z předchozích verzí, aby stávající kód běžel stejně jako předtím, ale na novější verzi rozhraní API. Jakmile je váš kód funkční, můžete se rozhodnout, zda použijete novější funkce. Další informace o nových funkcích najdete v tématu Co je nového v Azure AI Vyhledávač.

Doporučujeme postupně upgradovat verze rozhraní API, projít si jednotlivé verze, dokud se nedostanete na nejnovější verzi.

2023-07-01-preview byla první rozhraní REST API pro podporu vektorů. Tuto verzi rozhraní API nepoužívejte. Už je zastaralý a měli byste migrovat na stabilní nebo novější rozhraní REST API verze Preview okamžitě.

Kdy provést upgrade

Azure AI Vyhledávač přeruší zpětnou kompatibilitu jako poslední možnost. Upgrade je nezbytný v následujících případech:

• Váš kód odkazuje na vyřazenou nebo nepodporovanou verzi rozhraní API a podléhá jedné nebo více zásadním změnám.

• Váš kód selže, když se v odpovědi rozhraní API vrátí nerozpoznané vlastnosti. Osvědčeným postupem je, že aplikace by měla ignorovat vlastnosti, kterým nerozumí.

• Váš kód zachová požadavky rozhraní API a pokusí se je znovu odeslat do nové verze rozhraní API. K tomu může dojít například v případě, že vaše aplikace zachová pokračovací tokeny vrácené z vyhledávacího rozhraní API (další informace najdete @search.nextPageParameters v referenčních informacích k rozhraní API služby Search).

Postup upgradu

1. Pokud upgradujete verzi roviny dat, podívejte se, co bylo vydáno v nové verzi rozhraní API.

2. api-version Aktualizujte parametr zadaný v hlavičce požadavku na novější verzi.

   V kódu aplikace, který provádí přímé volání rozhraní REST API, vyhledejte všechny instance existující verze a pak ji nahraďte novou verzí. Další informace o strukturování volání REST najdete v tématu Rychlý start: Fulltextové vyhledávání pomocí REST.

   Pokud používáte Azure SDK, každý balíček cílí na konkrétní verzi rozhraní REST API. Pokud chcete zjistit, jakou verzi rozhraní REST API váš balíček podporuje, zkontrolujte jeho protokol změn. Aktualizujte na nejnovější verzi balíčku, abyste mohli získat přístup k nejnovějším funkcím a vylepšením rozhraní API.

3. Pokud upgradujete verzi datové roviny, projděte si kritické změny popsané v tomto článku a implementujte řešení, jak to obejít. Začněte s verzí používanou vaším kódem a vyřešte všechny zásadní změny pro každou novější verzi rozhraní API, dokud se nedostanete na nejnovější stabilní verzi nebo verzi Preview.

Zásadní změny

Následující zásadní změny platí pro operace s daty.

Zásadní změny pro agentické vyhledávání

2026-04-01 je první stabilní verze rozhraní REST API pro agentní vyhledávání. Zavádí následující zásadní změny z 2025-11-01-preview:

• Odeberou se syntéza odpovědí, plánování dotazů a konfigurovatelné úsilí o odůvodnění. Načítání vrací pouze extrahovaný a uzemněný obsah.

• Změna podoby žádosti o načtení: messages je nahrazeno intents, a několik parametrů se přejmenuje nebo odebere.

• Filtrování oprávnění na úrovni dokumentu pro objekty blob a zdroje poznatků OneLake není podporováno.

Úplný seznam změn na úrovni vlastností a kroky migrace najdete v tématu Migrace kódu načítání agenta.

Zásadní změny pro agenty znalostí

Agenti znalostí byli představeni2025-05-01-preview. V 2025-08-01-preview, targetIndexes byla nahrazena objektem nového zdroje znalostí a defaultMaxDocsForReranker byla nahrazena jinými rozhraními API. Další zásadní změny byly zavedeny v 2025-11-01-preview.

Úplný seznam změn na úrovni vlastností a kroky migrace najdete v tématu Migrace kódu načítání agenta.

Zásadní změny v kódu klienta, který čte informace o připojení

Platnost od 29. března 2024 a platí pro všechna podporovaná rozhraní REST API:

• Sada dovedností GET, GET Index a GET Indexer už v odpovědi nevrací klíče ani vlastnosti připojení. Jedná se o zásadní změnu, pokud máte podřízený kód, který čte klíče nebo připojení (citlivá data) z odpovědi GET.

• Pokud potřebujete získat klíče API pro správu nebo dotazy pro vaši vyhledávací službu, použijte REST rozhraní pro správu vyhledávání.

• Pokud potřebujete načíst připojovací řetězce jiného Azure prostředku, jako je Azure Storage nebo Azure Cosmos DB, použijte k získání informací rozhraní API daného prostředku a publikované pokyny.

Zásadní změny pro sémantický ranker

Sémantický ranker začal být obecně dostupný v 2023-11-01. Jedná se o zásadní změny z předchozích verzí:

• Ve všech verzích po 2020-06-01-preview: semanticConfiguration nahrazuje searchFields jako mechanismus pro určení polí, která se mají použít pro hodnocení L2.

• U všech verzí rozhraní API došlo 14. července 2023 k aktualizacím sémantických modelů hostovaných společností Microsoft, které učinily sémantické rankery nezávislými na jazyce a efektivně vyřadily z provozu vlastnost queryLanguage. V kódu není žádná změna způsobující chybu, ale vlastnost se ignoruje.

Viz Migrace z verze Preview pro přechod vašeho kódu na použití semanticConfiguration.

Aktualizace datové roviny

Pokyny k upgradu předpokládají upgrade z nejnovější předchozí verze. Pokud je váš kód založený na staré verzi rozhraní API, doporučujeme upgradovat po jednotlivých po sobě jdoucích verzích, abyste získali nejnovější verzi.

Upgrade na verzi 2026-08-01-preview

2026-08-01-preview přináší nové ovládací prvky pro agentní načítání, vylepšení zdrojů znalostí a kurzorové stránkování u operací se seznamy.

Před upgradem zkontrolujte, jestli se na váš kód vztahují některé z následujících 2026-08-01-preview zásadních změn:

• Zásadní změny v agentním načítání zahrnují vnořené objekty model v protokolech aktivit, nahrazení inclusionMode prvkem resultsProcessing pro serverové nástroje ve znalostním zdroji MCP a ověřování pomocí zákazníkem vlastněné aplikace Microsoft Entra pro znalostní zdroje Work IQ. Podrobný postup migrace najdete v tématu Migrace kódu agentního načítání.

• Operace výpisu pro zdroje dat, indexery, indexy, sady dovedností a zdroje znalostí nahrazují $top, $skip a $count stránkováním pomocí kurzoru s využitím pageSize, search a @odata.nextLink. Další informace o novém mechanismu stránkování najdete v tématu Stránkování výsledků seznamu ve službě Azure AI Vyhledávač (verze Preview).

Pro všechna ostatní existující rozhraní API neexistují žádné změny chování. Můžete nasadit novou verzi rozhraní API a váš kód poběží stejně jako předtím.

Upgrade na verzi 2026-05-01-preview

2026-05-01-preview přidává nové typy zdrojů znalostí, nové parametry akce retrieve, nové typy obsahu indexeru SharePoint, možnosti ACL a další funkce.

Neexistují žádné zásadní změny na úrovni drátu od 2025-11-01-preview. Pokud však pro agentní načítání používáte sadu SDK pro Python nebo JavaScript, klient retrieve je přejmenován na KnowledgeBaseRetrievalClient a retrieveKnowledge(...) je nahrazeno za retrieve(...). Pokyny k migraci sady SDK najdete v článku Migrujte svůj kód agentního načítání.

Pro všechna ostatní existující rozhraní API neexistují žádné změny chování. Můžete nasadit novou verzi rozhraní API a váš kód poběží stejně jako předtím.

Aktualizace k 1. 04. 2026

2026-04-01 je nejnovější stabilní verze rozhraní REST API. Podporuje agentní načítání, volbu zdrojů znalostí a několik dovedností a funkcí pro obecnou dostupnost.

Před upgradem zkontrolujte, jestli se na váš kód vztahují některé z následujících 2026-04-01 zásadních změn:

• Z definice dovednosti GenAI Prompt se odebere šest vlastností: httpMethod, timeout, batchSize, degreeOfParallelism, httpHeadersa authResourceId. Před upgradem odeberte tyto vlastnosti. Definice, které tyto vlastnosti stále obsahují, vrací 400 Bad Request chybu.

• Načítání agenta nyní vyžaduje samostatný souhlas s fakturací. Pokud aktuálně máte semanticSearch=standard, musíte před upgradem explicitně nastavit knowledgeRetrieval=standard . Další informace viz Povolení nebo zakázání fakturace pro načítání dat agentem.

• Pokud váš agentní kód načítání cílí na 2025-11-01-preview, 2026-04-01 odebere několik funkcí preview a standardizuje načítání kolem vstupu záměrů, extraktivního výstupu a minimálního uvažování. Další informace naleznete v části Migrace vašeho kódu pro agentické vyhledávání.

Pro všechna ostatní existující rozhraní API neexistují žádné změny chování. Můžete nasadit novou verzi rozhraní API a váš kód poběží stejně jako předtím.

Upgrade na verzi 2025-11-01-preview

2025-11-01-preview zavádí následující zásadní změny v agentním načítání, jak je implementováno v 2025-08-01-preview.

• agents Nahradí za knowledgebases. Několik vlastností souvisejících se zdroji znalostí se přesunulo z definice znalostní báze a do akce načtení.

• Vlastnosti zdroje znalostí se refaktorují a implementují nový ingestionParameters objekt pro zdroje znalostí, které generují potrubí indexeru.

Úplný seznam změn na úrovni vlastností a kroky migrace najdete v tématu Migrace kódu načítání agenta.

Pro všechna ostatní existující rozhraní API neexistují žádné změny chování. Můžete nasadit novou verzi rozhraní API a váš kód poběží stejně jako předtím.

Aktualizace na 1. 9. 2025

2025-09-01 je stabilní verze rozhraní REST API, která přidává obecnou dostupnost indexeru OneLake, dovednosti rozložení dokumentů a dalších rozhraní API.

Pokud upgradujete z 2024-07-01 a nepoužíváte žádné náhledové funkce, nebudou žádné zásadní změny. Pokud chcete použít novou stabilní verzi, změňte verzi rozhraní API a otestujte svůj kód.

Upgrade na verzi 2025-08-01-preview

2025-08-01-preview zavádí následující zásadní změny agentů znalostí vytvořených pomocí 2025-05-01-preview:

• targetIndexes Nahradí za knowledgeSources.
• Odebere defaultMaxDocsForReranker bez nahrazení.

Jinak neexistují žádné změny chování u existujících rozhraní API. Můžete nasadit novou verzi rozhraní API a váš kód poběží stejně jako předtím.

Upgrade na verzi 2025-05-01-preview

2025-05-01-preview poskytuje nové funkce, ale neexistují žádné změny chování u existujících rozhraní API. Můžete nasadit novou verzi rozhraní API a váš kód poběží stejně jako předtím.

Upgrade na verzi 2025-03-01-preview

2025-03-01-preview poskytuje nové funkce, ale neexistují žádné změny chování u existujících rozhraní API. Můžete nasadit novou verzi rozhraní API a váš kód poběží stejně jako předtím.

Upgrade na verzi 2024-11-01-preview

2024-11-01-preview přepsání dotazu, dovednost rozložení dokumentu, fakturace bez klíčů pro zpracování dovedností, režim analýzy Markdownu a možnosti přehodnocování komprimovaných vektorů.

Pokud upgradujete z 2024-09-01-preview, můžete prohodit novou verzi rozhraní API a váš kód se spustí stejně jako předtím.

Nová verze však zavádí změny syntaxe:vectorSearch.compressions

• rerankWithOriginalVectors Nahradí zaenableRescoring
• Přesune defaultOversampling na nový objekt vlastnosti rescoringOptions.

Zpětná kompatibilita je zachována kvůli internímu mapování rozhraní API, ale pokud přijmete novou verzi Preview, doporučujeme změnit syntaxi. Porovnání syntaxe naleznete v tématu Komprese vektorů pomocí skalární nebo binární kvantování.

Upgrade na verzi 2024-09-01-preview

2024-09-01-preview Přidá kompresi Matryoshka Representation Learning (MRL) pro modely vkládání textu-3, cílené filtrování vektorů pro hybridní dotazy, podrobnosti o vektorových subscorech pro ladění a blokování tokenů pro dovednosti Rozdělení textu.

Pokud upgradujete z 2024-05-01-preview, můžete prohodit novou verzi rozhraní API a váš kód se spustí stejně jako předtím.

Aktualizace na 1. 7. 2024

2024-07-01 je veřejná verze. Dříve dostupné funkce ve verzi Preview jsou nyní obecně dostupné: integrované blokování a vektorizace (dovednost Rozdělení textu, dovednost AzureOpenAIEmbedding), vektorizátor dotazů založený na AzureOpenAIEmbedding, komprese vektorů (skalární kvantování, binární kvantování, uložená vlastnost, úzké datové typy).

Pokud upgradujete z 2024-05-01-preview na stabilní, žádné zásadní změny se nezmění. Pokud chcete použít novou stabilní verzi, změňte verzi rozhraní API a otestujte svůj kód.

Pokud provedete upgrade přímo z 2023-11-01, dojde k zásadním změnám. Postupujte podle kroků uvedených pro každou novější verzi Preview a proveďte migraci z 2023-11-01 na 2024-07-01.

Upgrade na verzi 2024-05-01-preview

2024-05-01-preview přidá indexer pro Microsoft OneLake, binární vektory a další vložené modely.

Pokud upgradujete z 2024-03-01-preview, dovednost AzureOpenAIEmbedding teď vyžaduje vlastnost názvu modelu a dimenze.

1. Vyhledejte v kódové základně odkazy na AzureOpenAIEmbedding.

2. Nastavte modelName na text-embedding-ada-002 a nastavte dimensions na 1536.

Upgrade na verzi 2024-03-01-preview

2024-03-01-preview přidává úzké datové typy, skalární kvantování a možnosti úložiště vektorů.

Pokud provádíte upgrade z 2023-10-01-preview, nedochází k žádným zásadním převratným změnám. Existuje však jeden rozdíl v chování: u 2023-11-01 a novějších náhledů se ve vectorFilterMode výchozím nastavení změnil výběr z postfiltru na předfiltr pro výrazy filtru.

1. Vyhledejte v kódové základně odkazy na vectorFilterMode.

2. Pokud je vlastnost explicitně nastavená, nevyžaduje se žádná akce. Pokud jste se spoléhali na výchozí hodnotu, nové výchozí chování je filtrovat před spuštěním dotazu. Pokud chcete filtrovat po dotazu, explicitně nastavte vectorFilterMode postfilter, aby se zachovalo staré chování.

Upgrade na 1. 11. 2023

2023-11-01 je veřejná verze. Dříve dostupné funkce ve verzi preview jsou nyní obecně dostupné: sémantické hodnocení a podpora vektorů.

Neexistují žádné zásadní změny z 2023-10-01-preview, ale existuje více zásadních změn od 2023-07-01-preview do 2023-11-01. Další informace najdete v tématu Upgrade z verze 2023-07-01-preview.

Pokud chcete použít novou stabilní verzi, změňte verzi rozhraní API a otestujte svůj kód.

Upgrade na verzi 2023-10-01-preview

2023-10-01-preview byla první ukázkovou verzí, která přidala integrované členění dat a vektorizaci během indexování a integrovanou vektorizaci dotazů. Podporuje také indexování vektorů a dotazy z předchozí verze.

Pokud upgradujete z předchozí verze, další část obsahuje kroky.

Aktualizace z verze 2023-07-01-preview

Tuto verzi rozhraní API nepoužívejte. Implementuje syntaxi vektorového dotazu, která není kompatibilní s žádnou novější verzí rozhraní API.

2023-07-01-preview je nyní zastaralý, takže byste neměli založit nový kód na této verzi, ani byste neměli upgradovat na tuto verzi za žádných okolností. Tato část vysvětluje cestu migrace z 2023-07-01-preview jakékoli novější verze rozhraní API.

Upgrade portálu pro vektorové indexy

portál Azure podporuje cestu upgradu jedním kliknutím pro indexy 2023-07-01-preview. Detekuje vektorová pole a poskytuje tlačítko Migrovat .

• Cesta migrace je z 2023-07-01-preview do 2024-05-01-preview.
• Aktualizace jsou omezené na definice vektorových polí a konfigurace algoritmů vektorové vyhledávání.
• Aktualizace jsou jednosměrné. Upgrade nejde vrátit zpět. Po upgradu indexu je nutné k dotazování indexu použít 2024-05-01-preview nebo později.

Pro upgrade syntaxe vektorových dotazů neexistuje žádná migrace portálu. Podívejte se na upgrady kódu pro změny syntaxe dotazů.

Než vyberete Možnost Migrovat, vyberte Upravit JSON a nejprve zkontrolujte aktualizované schéma. Měli byste najít schéma, které odpovídá změnám popsaným v části aktualizace kódu. Migrace portálu zpracovává indexy pouze s konfigurací jednoho algoritmu vektorového vyhledávání. Vytvoří výchozí profil, který odpovídá algoritmu vyhledávání 2023-07-01-preview pomocí vektorů. Indexy s konfigurací více vektorových vyhledávání vyžadují ruční migraci.

Upgrade kódu pro vektorové indexy a dotazy

Podpora vektorového vyhledávání byla zavedena ve verzi Create or Update Index (2023-07-01-preview).

Upgrade z 2023-07-01-preview na jakoukoli novější stabilní verzi nebo některou z verzí Preview vyžaduje:

• Přejmenování a restrukturalizace konfigurace vektoru v indexu
• Přepsání vektorových dotazů

Pokyny v této části použijte k migraci vektorových polí, konfigurace a dotazů z 2023-07-01-preview.

1. Zavolejte Get Index pro načtení existující definice.

2. Upravte konfiguraci vektorového vyhledávání. 2023-11-01 a novější verze představují koncept vektorových profilů , které sbalují konfigurace související s vektory pod jedním názvem. Novější verze také přejmenují algorithmConfigurations na algorithms.

   • Přejmenujte algorithmConfigurations na algorithms. Jedná se pouze o přejmenování pole. Obsah je zpětně kompatibilní. To znamená, že můžete použít stávající parametry konfigurace HNSW.

   • Přidejte profiles, zadejte název a konfiguraci algoritmu pro každý z nich.

   Před migrací (2023-07-01-preview):

     "vectorSearch": {
       "algorithmConfigurations": [
           {
               "name": "myHnswConfig",
               "kind": "hnsw",
               "hnswParameters": {
                   "m": 4,
                   "efConstruction": 400,
                   "efSearch": 500,
                   "metric": "cosine"
               }
           }
       ]}
   

   Po migraci (2023-11-01):

     "vectorSearch": {
       "algorithms": [
         {
           "name": "myHnswConfig",
           "kind": "hnsw",
           "hnswParameters": {
             "m": 4,
             "efConstruction": 400,
             "efSearch": 500,
             "metric": "cosine"
           }
         }
       ],
       "profiles": [
         {
           "name": "myHnswProfile",
           "algorithm": "myHnswConfig"
         }
       ]
     }
   

3. Upravte definice vektorových polí a nahraďte vectorSearchConfiguration s vectorSearchProfile. Ujistěte se, že se název profilu přeloží na novou definici vektorového profilu, a ne na název konfigurace algoritmu. Vlastnosti jiných vektorových polí zůstávají beze změny. Nemůžou být například filtrovatelné, řaditelné ani fasetové, ani používat analyzátory nebo normalizátory nebo mapy synonym.

   Před (2023-07-01-preview):

     {
         "name": "contentVector",
         "type": "Collection(Edm.Single)",
         "key": false,
         "searchable": true,
         "retrievable": true,
         "filterable": false,  
         "sortable": false,  
         "facetable": false,
         "analyzer": "",
         "searchAnalyzer": "",
         "indexAnalyzer": "",
         "normalizer": "",
         "synonymMaps": "", 
         "dimensions": 1536,
         "vectorSearchConfiguration": "myHnswConfig"
     }
   

   Po (2023-11-01):

     {
       "name": "contentVector",
       "type": "Collection(Edm.Single)",
       "searchable": true,
       "retrievable": true,
       "filterable": false,  
       "sortable": false,  
       "facetable": false,
       "analyzer": "",
       "searchAnalyzer": "",
       "indexAnalyzer": "",
       "normalizer": "",
       "synonymMaps": "", 
       "dimensions": 1536,
       "vectorSearchProfile": "myHnswProfile"
     }
   

4. Voláním příkazu Vytvořit nebo aktualizovat index publikujte změny.

5. Upravte funkci POST vyhledávání a změňte syntaxi dotazu. Tato změna rozhraní API umožňuje podporu typů dotazů polymorfních vektorů.

   • Přejmenujte vectors na vectorQueries.
   • Pro každý vektorový dotaz přidejte kind, nastavte ho na vector.
   • Pro každý vektorový dotaz přejmenujte value na vector.
   • Volitelně můžete přidat vectorFilterMode , pokud používáte výrazy filtru. Výchozí hodnota je předfiltrována pro indexy vytvořené po 2023-10-01. Indexy vytvořené před tímto datem podporují pouze postfilter bez ohledu na to, jak nastavíte režim filtru.

   Před (2023-07-01-preview):

   {
       "search": "*", //Required by the API but ignored for ranking in vector-only queries
       "vectors": [
         {
           "value": [
               0.103,
               0.0712,
               0.0852,
               0.1547,
               0.1183
           ],
           "fields": "contentVector",
           "k": 5
         }
       ],
       "select": "title, content, category"
   }
   

   Po (2023-11-01):

   {
     "search": "*", //Required by the API but ignored for ranking in vector-only queries
     "vectorQueries": [
       {
         "kind": "vector",
         "vector": [
           0.103,
           0.0712,
           0.0852,
           0.1547,
           0.1183
         ],
         "fields": "contentVector",
         "k": 5
       }
     ],
     "vectorFilterMode": "preFilter",
     "select": "title, content, category"
   }
   

Tento postup dokončí migraci na 2023-11-01 stabilní verzi rozhraní API nebo novější verze rozhraní API ve verzi Preview.

Aktualizace na 30. 6. 2020

V této verzi je jedna zásadní změna a několik rozdílů v chování. Mezi obecně dostupné funkce patří:

• Úložiště znalostí, trvalé úložiště rozšířeného obsahu vytvořeného prostřednictvím sad dovedností, vytvořené pro podřízenou analýzu a zpracování prostřednictvím jiných aplikací. Úložiště znalostí se vytváří prostřednictvím rozhraní REST API Azure AI Vyhledávač, ale nachází se v Azure Storage.

Změna způsobující chybu

Kód pro starší verze rozhraní API přestane fungovat na 2020-06-30 a novějších, pokud kód obsahuje následující funkce:

• Všechny Edm.Date literály (datum složené z rok-měsíc-den, například 2020-12-12) ve výrazech filtru musí odpovídat Edm.DateTimeOffset formátu: 2020-12-12T00:00:00Z. Tato změna byla nezbytná ke zpracování chybných nebo neočekávaných výsledků dotazu kvůli rozdílům v časovém pásmu.

Změny chování

• Algoritmus řazení BM25 nahrazuje předchozí algoritmus řazení novější technologií. Služby vytvořené po roce 2019 tento algoritmus používají automaticky. U starších služeb je nutné nastavit parametry tak, aby používaly nový algoritmus.

• Seřazené výsledky pro null hodnoty se v této verzi změnily tak, že jsou null hodnoty nejprve, pokud je uspořádání asc, a naposledy, pokud je uspořádání desc. Pokud jste napsali kód pro zpracování řazení hodnot null, mějte na paměti tuto změnu.

Upgrade na 06. 5. 2019

Mezi obecně dostupné funkce v této verzi rozhraní API patří:

• Automatické dokončování je funkce pro předvídání textu, která doplní částečně zadaný termín.
• Komplexní typy poskytují nativní podporu strukturovaných dat objektů v indexu vyhledávání.
• JsonLines parsing modes, část indexování Azure Blob, vytvoří jeden vyhledávací dokument pro každou entitu JSON, která je oddělena novým řádkem.
• Obohacení AI poskytuje indexování, které používá moduly pro obohacení AI v rámci Foundry Tools.

Zásadní změny

Kód napsaný proti dřívější verzi rozhraní API přestane fungovat 2019-05-06 a později, pokud obsahuje následující funkcionalitu:

1. Vlastnost typu pro Azure Cosmos DB. U indexerů, které cílí na Azure Cosmos DB pro NoSQL API zdroj dat, změňte "type": "documentdb" na "type": "cosmosdb".

2. Pokud zpracování chyb indexeru obsahuje odkazy na status vlastnost, měli byste ji odebrat. Z odpovědi na chybu jsme odebrali stav, protože neposkytoval užitečné informace.

3. Připojovací řetězce zdroje dat se už v odpovědi nevracejí. Od verzí 2019-05-06 a 2019-05-06-Preview rozhraní API zdroje dat nevrací připojovací řetězce v odpovědi na jakoukoli operaci REST. V předchozích verzích rozhraní API pro zdroje dat vytvořené pomocí post Azure AI Vyhledávač vrátil 201 následovanou odpovědí OData, která obsahovala připojovací řetězec ve formátu prostého textu.

4. Kognitivní dovednost Rozpoznávání pojmenovaných entit je vyřazena. Pokud jste ve svém kódu volali funkci Rozpoznávání názvů entit, volání selže. Náhradní funkce jsou dovednosti pro rozpoznávání entit (V3). Pokud chcete migrovat na podporovanou dovednost, postupujte podle doporučení v zastaralých dovednostech .

Aktualizace složitých typů

Verze 2019-05-06 rozhraní API přidala formální podporu pro komplexní typy. Pokud váš kód implementoval předchozí doporučení pro ekvivalenci komplexního typu v roce 2017–11-11-Preview nebo 2016-09-01-Preview, jsou k dispozici některé nové a změněné limity počínaje verzí 2019-05-06 , o kterých je potřeba vědět:

• Omezení hloubky dílčích polí a počtu složitých kolekcí na index bylo sníženo. Pokud jste vytvořili indexy, které tyto limity překračují pomocí předběžných verzí API, jakýkoli pokus o jejich aktualizaci nebo opětovné vytvoření pomocí verze rozhraní API 2019-05-06 selže. Pokud v této situaci zjistíte sami sebe, musíte přepracovat schéma tak, aby vyhovovalo novým limitům, a pak znovu sestavit index.

• V rámci verze rozhraní API 2019-05-06 se zavádí nový limit na počet prvků složitých kolekcí v jednotlivých dokumentech. Pokud jste vytvořili indexy s dokumenty, které tyto limity překračují pomocí verzí API ve verzi Preview, všechny pokusy o přeindexování těchto dat pomocí verze api-version 2019-05-06 selžou. Pokud se ocitnete v této situaci, musíte před opětovným indexováním dat snížit počet složitých prvků kolekce pro každý dokument.

Další informace najdete v tématu Služby omezení pro Azure AI Vyhledávač.

Postup upgradu staré struktury komplexního typu

Pokud váš kód používá složité typy s jednou ze starších verzí rozhraní API ve verzi Preview, můžete použít formát definice indexu, který vypadá takto:

{
  "name": "hotels",  
  "fields": [
    { "name": "HotelId", "type": "Edm.String", "key": true, "filterable": true },
    { "name": "HotelName", "type": "Edm.String", "searchable": true, "filterable": false, "sortable": true, "facetable": false },
    { "name": "Description", "type": "Edm.String", "searchable": true, "filterable": false, "sortable": false, "facetable": false, "analyzer": "en.microsoft" },
    { "name": "Description_fr", "type": "Edm.String", "searchable": true, "filterable": false, "sortable": false, "facetable": false, "analyzer": "fr.microsoft" },
    { "name": "Category", "type": "Edm.String", "searchable": true, "filterable": true, "sortable": true, "facetable": true },
    { "name": "Tags", "type": "Collection(Edm.String)", "searchable": true, "filterable": true, "sortable": false, "facetable": true, "analyzer": "tagsAnalyzer" },
    { "name": "ParkingIncluded", "type": "Edm.Boolean", "filterable": true, "sortable": true, "facetable": true },
    { "name": "LastRenovationDate", "type": "Edm.DateTimeOffset", "filterable": true, "sortable": true, "facetable": true },
    { "name": "Rating", "type": "Edm.Double", "filterable": true, "sortable": true, "facetable": true },
    { "name": "Address", "type": "Edm.ComplexType" },
    { "name": "Address/StreetAddress", "type": "Edm.String", "filterable": false, "sortable": false, "facetable": false, "searchable": true },
    { "name": "Address/City", "type": "Edm.String", "searchable": true, "filterable": true, "sortable": true, "facetable": true },
    { "name": "Address/StateProvince", "type": "Edm.String", "searchable": true, "filterable": true, "sortable": true, "facetable": true },
    { "name": "Address/PostalCode", "type": "Edm.String", "searchable": true, "filterable": true, "sortable": true, "facetable": true },
    { "name": "Address/Country", "type": "Edm.String", "searchable": true, "filterable": true, "sortable": true, "facetable": true },
    { "name": "Location", "type": "Edm.GeographyPoint", "filterable": true, "sortable": true },
    { "name": "Rooms", "type": "Collection(Edm.ComplexType)" }, 
    { "name": "Rooms/Description", "type": "Edm.String", "searchable": true, "filterable": false, "sortable": false, "facetable": false, "analyzer": "en.lucene" },
    { "name": "Rooms/Description_fr", "type": "Edm.String", "searchable": true, "filterable": false, "sortable": false, "facetable": false, "analyzer": "fr.lucene" },
    { "name": "Rooms/Type", "type": "Edm.String", "searchable": true },
    { "name": "Rooms/BaseRate", "type": "Edm.Double", "filterable": true, "facetable": true },
    { "name": "Rooms/BedOptions", "type": "Edm.String", "searchable": true },
    { "name": "Rooms/SleepsCount", "type": "Edm.Int32", "filterable": true, "facetable": true },
    { "name": "Rooms/SmokingAllowed", "type": "Edm.Boolean", "filterable": true, "facetable": true },
    { "name": "Rooms/Tags", "type": "Collection(Edm.String)", "searchable": true, "filterable": true, "facetable": true, "analyzer": "tagsAnalyzer" }
  ]
}  

Ve verzi 2017-11-11-Previewrozhraní API byl zaveden novější formát podobný stromové struktuře pro definování polí indexu. V novém formátu má každé komplexní pole kolekci polí, ve které jsou definovány jeho dílčí pole. V rozhraní API verze 2019-05-06 se tento nový formát používá výhradně a pokus o vytvoření nebo aktualizaci indexu pomocí starého formátu selže. Pokud máte indexy vytvořené ve starém formátu, budete je muset použít k aktualizaci verze rozhraní API 2017-11-11-Preview na nový formát, aby bylo možné je spravovat pomocí rozhraní API verze 2019-05-06.

Ploché indexy můžete aktualizovat do nového formátu pomocí následujících kroků pomocí verze 2017-11-11-Previewrozhraní API:

1. Proveďte požadavek GET pro načtení indexu. Pokud už je v novém formátu, máte hotovo.

2. Přeloží index z plochého formátu do nového formátu. Pro tento úkol musíte napsat kód, protože v době psaní tohoto textu není k dispozici žádný vzorový kód.

3. Proveďte požadavek PUT na aktualizaci indexu na nový formát. Vyhněte se změnám jiných podrobností indexu, jako jsou prohledávatelnost a filtrování polí, protože rozhraní API pro aktualizaci indexu nepovoluje změny, které ovlivňují fyzický výraz existujícího indexu.

Aktualizace řídicí roviny

Platí pro:2014-07-31-Preview, 2015-02-28a 2015-08-19

Požadavek listQueryKeys GET na starší verze rozhraní API služby Search Management je teď zastaralý. Pokud chcete použít požadavek POST, doporučujeme migrovat na nejnovější stabilní verzi řídicí roviny API.

1. V existujícím api-version kódu změňte parametr na nejnovější verzi (2025-05-01).

2. Přetáčí požadavek z GET do POST:

   POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices/{searchServiceName}/listQueryKeys?api-version=2025-05-01
   Authorization: Bearer {{token}}
   

3. Pokud používáte Azure SDK, doporučujeme upgradovat na nejnovější verzi.

Další kroky

Projděte si referenční dokumentaci k rozhraní REST API služby Search. Pokud narazíte na problémy, požádejte nás o pomoc na Stack Overflow nebo se obraťte na podporu.