Agentgebaseerde ophaalcode migreren naar de nieuwste versie

Opmerking

Azure AI Zoeken is beschikbaar via de Azure-portal, REST API's en Azure-SDK's. Het vormt ook een basis voor Foundry IQ, de beheerde kennislaag die bedrijfsinhoud transformeert in herbruikbare, machtigingsbewuste knowledge bases voor agents in de Microsoft Foundry-portal.

Important

Functies, mogelijkheden of eigenschappen die zijn gemarkeerd (preview) vallen niet onder een service level agreement, worden niet aanbevolen voor productieworkloads en kunnen worden gewijzigd of beperkt voordat ze algemeen beschikbaar worden. De Azure AI Zoeken preview-voorwaarden zijn van toepassing op alle preview-functionaliteit, ongeacht of deze zelfstandig is of deel uitmaakt van een algemeen beschikbare functie.

Als uw agentische ophaalcode is gericht op een eerdere API-versie, wordt in dit artikel uitgelegd wanneer en hoe u migreert naar een nieuwere versie. Ook worden belangrijke en niet-brekende wijzigingen beschreven voor alle API-versies die ondersteuning bieden voor agentisch ophalen.

Migratie-instructies zijn bedoeld om u te helpen bij het uitvoeren van een bestaande oplossing op een nieuwere API-versie. De instructies in dit artikel helpen u bij het oplossen van belangrijke wijzigingen op API-niveau, zodat uw app wordt uitgevoerd zoals voorheen. Voor hulp bij het toevoegen van nieuwe functionaliteit begint u met Wat is er nieuw in Azure AI Zoeken.

Tip

Gebruikt u een Azure SDK in plaats van REST? Voordat u het pakket bijwerken en de relevante migratiewijzigingen toepast, controleert u het wijzigingenlogboek voor uw SDK-taal om de ondersteuning voor uw doel-API-versie te bevestigen.

Wanneer moet worden gemigreerd

De meeste versies die ondersteuning bieden voor agentisch ophalen hebben belangrijke wijzigingen geïntroduceerd. U kunt oudere code ongewijzigd blijven uitvoeren door de WAARDE van de API-versie te behouden, maar om te profiteren van foutoplossingen, verbeteringen en nieuwere functionaliteit, moet u uw code bijwerken.

Als uw code is gericht op een preview-versie, raden we u aan om alleen naar de nieuwste stabiele versie te migreren als uw use-case volledig wordt ondersteund door 2026-04-01. Als u afhankelijk bent van antwoordsynthese, complexe redeneringsinspanningen of berichten met meerdere schakels, controleer de ingrijpende en niet-verstorende wijzigingen voordat u besluit om te migreren. Deze mogelijkheden blijven beschikbaar als preview-versie.

Voordat u gaat migreren

  • Als u het bereik van wijzigingen wilt begrijpen, bekijkt u breaking en nonbreaking wijzigingen voor elke versie.

  • Het ondersteunde migratiepad is incrementeel. Als uw codedoelen 2025-05-01-previewzijn, migreert u eerst naar 2025-08-01-previewen doorloopt u vervolgens elke volgende versie totdat u de doelversie bereikt.

  • Voor een side-by-side migratie maakt u unieke benoemde objecten die het gedrag van de vorige versie implementeren. Met deze benadering blijven bestaande objecten behouden terwijl u vervangingen ontwikkelt en test. Als een object ter plaatse bijwerken ondersteunt, vermelden de versiespecifieke stappen die optie.

  • Voor elk object dat u migreert, moet u eerst de huidige definitie ophalen uit de zoekservice, zodat u bestaande eigenschappen kunt controleren voordat u het nieuwe object opgeeft.

  • Verwijder oudere versies pas nadat uw migratie volledig is getest en geïmplementeerd.

Hoe te migreren

In deze sectie worden migratiestappen voor de volgende API-versies behandeld:

2026-08-01-preview

Als u migreert van 2026-05-01-preview, kunt u rechtstreeks naar 2026-08-01-preview. Voor deze migratie zijn updates vereist voor Werk IQ-kennisbronnen, paginering van lijsten, reactieverwerking, MCP-serverhulpprogramma's en beïnvloede gegenereerde clientoproepen.

  1. Work IQ-kennisbronnen migreren
  2. Paginering van lijsten bijwerken
  3. Verwerking van ophaalantwoorden bijwerken
  4. Code en clients bijwerken

Work IQ-kennisbronnen migreren

Een Work IQ-kennisbron migreren naar de nieuwe verificatieconfiguratie:

  1. Exporteer de huidige definitie.

  2. Werk de bestaande kennisbron bij met Knowledge Sources - Create Or Update, of maak een vervangende versie met een unieke naam voor een parallelle migratie.

  3. Gebruik de API-versie 2026-08-01-preview en configureer workIQParameters.entraAppAuthentication. De applicationId eigenschappen en federatedCredentialId eigenschappen zijn vereist. De tenantId eigenschap is optioneel en wordt standaard ingesteld op de tenant van de zoekservice.

  4. Als u een vervanging hebt gemaakt, werkt u elke knowledge base bij die verwijst naar de vorige kennisbron om de vervangende naam te gebruiken.

  5. Werk ophaalverzoeken bij om de gebruikersassertie door te geven in de x-ms-query-work-iq-source-authorization-header.

Zie Een work IQ-kennisbron (preview) maken voor installatie en voorbeelden.

Paginering van de lijst bijwerken

Op offset gebaseerde paging vervangen door op cursor gebaseerde paging:

  1. Verwijder $top, $skipen $count uit aanvragen voor de kennisbronlijst. Stel pageSize in van 1 tot en met 3.000 om de paginagrootte te bepalen. Als u deze weglaat, kiest de service het paginaformaat.

  2. Als u wilt filteren op naam, stelt u in search en searchType. De enige ondersteunde searchType waarde is prefix, wat ook de standaardwaarde is. De volgende aanvraag retourneert maximaal 100 kennisbronnen waarvan de namen beginnen met contoso.

    GET {{search-endpoint}}/knowledgesources?api-version=2026-08-01-preview&pageSize=100&search=contoso&searchType=prefix
Authorization: Bearer {{search-access-token}}

    Naslaginformatie:Kennisbronnen - Lijst

  3. Als het antwoord @odata.nextLink bevat, stuurt u die URL exact zoals die is geretourneerd. Parseer de voortzettingsstatus ervan niet en wijzig deze niet.

Verwerking van ophaalresponsen bijwerken

De nieuwe Work IQ-referentie en vormen voor door modellen ondersteunde activiteiten verwerken:

  1. Verwijder afhankelijkheden op attributions, WorkIQAttributionen seeMoreWebUrl. Lees metagegevens van vertrouwelijkheidslabels uit searchSensitivityLabelInfo in de Work IQ-referentie.

  2. In query-planning-, antwoordsynthese- en websamenvattingsactiviteitsrecords lees je modelName en deploymentId uit het geneste object model. Het geneste object en beide eigenschappen zijn optioneel.

In de volgende fragmenten ziet u de wijzigingen in de antwoordvorm.

{
  "references": [
    {
      "type": "workIQ",
      "id": "<reference-id>",
      "activitySource": 1,
      "sourceData": {},
      "attributions": [
        {
          "seeMoreWebUrl": "<attribution-url>"
        }
      ]
    }
  ],
  "activity": [
    {
      "type": "modelAnswerSynthesis",
      "id": 2,
      "modelName": "<model-name>"
    }
  ]
}

In 2026-08-01-previewdezelfde fragmenten wordt de volgende vorm gebruikt:

{
  "references": [
    {
      "type": "workIQ",
      "id": "<reference-id>",
      "activitySource": 1,
      "sourceData": {},
      "searchSensitivityLabelInfo": {
        "displayName": "<label-name>",
        "sensitivityLabelId": "<label-id>"
      }
    }
  ],
  "activity": [
    {
      "type": "modelAnswerSynthesis",
      "id": 2,
      "model": {
        "modelName": "<model-name>",
        "deploymentId": "<deployment-id>"
      }
    }
  ]
}

Code en clients bijwerken voor 2026-08-01-preview

Uw migratie voltooien:

  1. Vervang op elk MCP-serveritem tools door inclusionModeresultsProcessing. Wijs reranked toe aan rerank en always aan none. De rerank waarde is de standaardwaarde. De none waarde omzeilt het opnieuw rangschikken en behoudt de onderliggende resultaatvolgorde van het hulpprogramma. Zie Hulpprogramma's configureren voor een kennisbron voor een MCP-server voor de installatie.

  2. Als u een Azure SDK gebruikt, installeert u een pakket dat ondersteuning biedt 2026-08-01-previewen controleert u de aanroepen van de positionele lijst voor wijzigingen in de parametervolgorde. REST-aanroepers worden niet beïnvloed omdat HTTP-parameters worden gesleuteld op naam. Geef in C# de voorkeur aan benoemde argumenten, zoals GetKnowledgeSourcesAsync(search: ..., pageSize: ...). Geef in Python lijstopties door als trefwoordargumenten.

  3. Test Work IQ-authenticatie en referenties, cursorpaginering, deserialisatie van activiteitsrecords, de volgorde van MCP-serverresultaten en gegenereerde clientaanroepen voordat u de productieomgeving bijwerkt.

  4. Als u vervangende Work IQ-kennisbronnen hebt gemaakt, verwijdert u de eerdere bronnen pas nadat de migratie alle tests heeft voltooid, wordt uw bijgewerkte toepassing geïmplementeerd en verwijst er geen knowledge base naar de eerdere namen.

2026-05-01-preview

Als u migreert van 2026-04-01 of 2025-11-01-preview, kunt u rechtstreeks 2026-05-01-previewnaar . Aanvragen, antwoorden en persistente objecten uit deze versies blijven compatibel. De verschillen zijn additieve functies en taal-SDK-namen.

  1. Werk op REST-aanvragen de API-versie bij naar 2026-05-01-preview. SDK-clients gebruiken de standaard-API-versie van het pakket, dus u hoeft geen expliciet serviceVersion argument door te geven. Voer in plaats daarvan een upgrade uit naar het 2026-05-01-preview SDK-pakket.

  2. Als u de Python- of JavaScript-SDK gebruikt, werk dan de retrieve-client bij naar KnowledgeBaseRetrievalClient en roep retrieve(...) aan in plaats van de verouderde retrieveKnowledge(...). Zie Code en clients bijwerken voor 2026-05-01-preview voor de volledige SDK-shapetoewijzing.

  3. (Optioneel) Gebruik de nieuwe 2026-05-01-preview functies, zoals nieuwheidsbewust ophalen, documentlimieten per bron en eindresultaat, persistente standaardwaarden ophalen, CORS en Purview-metagegevens voor vertrouwelijkheidslabels in het ophalen van antwoorden. Geen van deze functies is vereist om een bestaande oplossing te laten werken.

Code en clients bijwerken voor 2026-05-01-preview

De 2026-05-01-preview SDK's introduceren wijzigingen in codevorm in de ondersteunde talen:

Language Migratie-updates
Python Maak de retrieve-client als KnowledgeBaseRetrievalClient(endpoint=..., credential=..., knowledge_base_name=...). Constructeer instantie van redeneringsinspanning, zoals KnowledgeRetrievalLowReasoningEffort() en geef de tekenreeks output_mode="answerSynthesis" door in de knowledge base of haal de aanvraag op. Geef AzureOpenAIVectorizerParameters(resource_url=...) op (hernoemd van resource_uri), via het hoofdendpoint van de resource in plaats van een /openai/v1-endpoint.
.NET Maak de ophaalclient met new KnowledgeBaseRetrievalClient(endpoint, knowledgeBaseName, credential) en geef een AzureKeyCredential of tokengegevens door. Als u een op sleutels gebaseerd Azure OpenAI-model wilt koppelen aan een knowledge base, stelt u de api-sleutel van het model in op AzureOpenAIVectorizerParameters.ApiKey.
Java Gebruik KnowledgeBaseRetrievalClientBuilder om de retrieve-client te maken en de resultaten te lezen als KnowledgeBaseRetrievalResult. KnowledgeBaseRetrievalOptions stelt nu setMessages(...) beschikbaar naast setIntents(...), plus setRetrievalReasoningEffort, setOutputMode, setMaxOutputSize en setMaxOutputDocuments, zodat het ophalen op basis van berichten en de synthese van antwoorden werken zonder een tijdelijke oplossing voor semantische intentie. KnowledgeBasevoegt setOutputMode, setRetrievalReasoningEffort, setRetrievalInstructions, en setAnswerInstructionssetCorsOptions. SearchIndexKnowledgeSourceParams voegt setAlwaysQuerySource, setFailOnError, setMaxOutputDocumentsen setEnableImageServing.
JavaScript en TypeScript Gebruik KnowledgeRetrievalClient.retrieve({ intents: [{ type: "semantic", search: query }] }). De vorige retrieveKnowledge(...) methode wordt verwijderd ten gunste van retrieve(...).

Nadat u de cliëntdefinities hebt bijgewerkt, voert u de volledige stroom uit die de index maakt, documenten uploadt, een kennisbron maakt, een kennisbank maakt, een ophaalaanvraag uitvoert en resources opschoont om de migratie van begin tot eind te verifiëren.

01-04-2026

Als u migreert van 2025-11-01-preview, kunt u rechtstreeks migreren naar 2026-04-01. Uw index en inhoud blijven ongewijzigd. U hoeft alleen het knowledgebase-schema en de structuur van de ophaalaanvraag bij te werken.

  1. Kennisbronnen migreren
  2. De Knowledge Base migreren
  3. De opvraagaanvraag bijwerken
  4. Factureringstoestemming bijwerken
  5. Code en clients bijwerken

Kennisbronnen migreren

In 2026-04-01, de searchIndex, azureBlob, en indexedOneLakeweb kennisbrontypen zijn algemeen beschikbaar. Andere typen kennisbronnen blijven in voorbeeldweergave.

  1. Gebruik Kennisbronnen : Ophalen (REST API) om de huidige definitie op te halen.

    GET {{search-endpoint}}/knowledge-sources/{{knowledge-source-name}}?api-version=2025-11-01-preview
Authorization: Bearer {{search-access-token}}
Content-Type: application/json

  2. Bepaal in het antwoord wat u moet uitvoeren en wat u wilt verwijderen:

    • Voor searchIndex en web, alle eigenschapswaarden doorsturen.

    • Voor azureBlob en indexedOneLake alle eigenschapswaarden doorgeven, maar ingestionPermissionOptions van ingestionParameters weglaten. Deze eigenschap wordt niet ondersteund in 2026-04-01.

  3. Gebruik Kennisbronnen: maken of bijwerken (REST API) om een nieuwe kennisbron te maken met een unieke naam, de API-versie 2026-04-01 en de eigenschapswaarden uit de vorige stap.

    In het volgende voorbeeld ziet u een searchIndex kennisbron. Gebruik een vergelijkbaar patroon voor azureBlob, indexedOneLakeen web kennisbronnen.

    PUT {{search-endpoint}}/knowledge-sources/{{new-knowledge-source-name}}?api-version=2026-04-01
Authorization: Bearer {{search-access-token}}
Content-Type: application/json

{
  "name": "{{new-knowledge-source-name}}",
  "description": "Knowledge source backed by a search index.",
  "kind": "searchIndex",
  "searchIndexParameters": {
    "searchIndexName": "{{index-name}}",
    "sourceDataFields": [
      { "name": "id" },
      { "name": "page_chunk" },
      { "name": "page_number" }
    ]
  }
}

De Knowledge Base migreren

De 2026-04-01 knowledgebase heeft een eenvoudiger schema dan de 2025-11-01-preview-versie: knowledgeSources blijft behouden en instellingen voor antwoordgeneratie vervallen. Controleer de huidige definitie voordat u een nieuw object maakt.

  1. Gebruik Knowledge Bases - Ophalen (REST API) om de huidige definitie op te halen.

    GET {{search-endpoint}}/knowledgebases/{{knowledge-base-name}}?api-version=2025-11-01-preview
Authorization: Bearer {{search-access-token}}
Content-Type: application/json

  2. Bepaal in het antwoord wat u moet uitvoeren en wat u wilt verwijderen:

    • Noteer de knowledgeSources verwijzingen. Draag deze door naar de nieuwe knowledge base.

    • Als deze aanwezig zijn, verwijder outputMode, answerInstructions en retrievalInstructions. Deze eigenschappen worden niet ondersteund in 2026-04-01.

    • Als uw knowledge base gebruikmaakt van een web kennisbron, bewaart u models. Wepophalen vereist een modelondersteunde samenvatting. Verwijder models voor alle andere typen kennisbronnen.

  3. Gebruik Knowledge Bases : MAKEN of bijwerken (REST API) om een nieuwe knowledge base te maken met een unieke naam, de 2026-04-01 API-versie en alleen de ondersteunde eigenschappen.

    PUT {{search-endpoint}}/knowledgebases/{{new-knowledge-base-name}}?api-version=2026-04-01
Authorization: Bearer {{search-access-token}}
Content-Type: application/json

{
  "name": "{{new-knowledge-base-name}}",
  "description": "Minimal knowledge base for search index retrieval.",
  "knowledgeSources": [
    { "name": "{{new-knowledge-source-name}}" }
  ]
}

Het afhaalverzoek bijwerken

De 2026-04-01 aanvraag ophalen heeft een andere vorm dan de preview-versie:

  • Gebruik intents in plaats van messages.

  • Gebruik maxOutputSizeInTokens in plaats van maxOutputSize.

  • Verwijder retrievalReasoningEffort en alwaysQuerySource als deze aanwezig zijn. Deze parameters worden niet ondersteund in 2026-04-01.

  • Voor vervolgvragen verzendt u een nieuwe ophaalaanvraag met een nieuwe semantische intentie. 2026-04-01 onderhoudt geen actieve berichtentranscriptie.

Als u de uitvoer van uw Knowledge Base wilt testen met een query, gebruikt u de 2026-04-01 versie van Knowledge Retrieval - Ophalen (REST API).

POST {{search-endpoint}}/knowledgebases/{{new-knowledge-base-name}}/retrieve?api-version=2026-04-01
Authorization: Bearer {{search-access-token}}
Content-Type: application/json

{
  "intents": [
    {
      "type": "semantic",
      "search": "{{query-text}}"
    }
  ],
  "knowledgeSourceParams": [
    {
      "knowledgeSourceName": "{{new-knowledge-source-name}}",
      "kind": "searchIndex",
      "includeReferences": true,
      "includeReferenceSourceData": true,
      "rerankerThreshold": 2.5
    }
  ],
  "maxRuntimeInSeconds": 30,
  "maxOutputSizeInTokens": 6000
}

Als het antwoord een 200 OK HTTP-code heeft, heeft uw knowledge base inhoud opgehaald uit de kennisbron.

Vanaf de 2026-04-01 API-versie wordt de factureringstoestemming voor agentische gegevensophaling beheerd via een afzonderlijke knowledgeRetrieval-eigenschap, die losstaat van semanticSearch, dat nu alleen van toepassing is op de facturering voor de semantische ranker. knowledgeRetrieval is een eigenschap van het beheervlak, dus u stelt deze in via de REST API van Search Management, niet de REST API van de Search Service.

Gebruik de nieuwste preview-versie van Services : Maken of bijwerken (REST API) om in te stellen knowledgeRetrieval op uw zoekservice.

PATCH https://management.azure.com/subscriptions/{{subscription-id}}/resourcegroups/{{resource-group}}/providers/Microsoft.Search/searchServices/{{search-service-name}}?api-version=2026-03-01-preview
Content-Type: application/json
Authorization: Bearer {{management-access-token}}

{
  "properties": {
    "knowledgeRetrieval": "standard"
  }
}

Zie Facturering voor het in- of uitschakelen van agentic retrieval voor geldige waarden en factureringsgegevens.

Code en clients bijwerken voor 2026-04-01

Uw migratie voltooien:

  1. Werk clientoproepen bij om de 2026-04-01 API-versie te gebruiken.

  2. Werk eventuele hardcoded Knowledge Base- of Knowledge Source-namen in uw code bij om te verwijzen naar de nieuwe objecten die tijdens de migratie zijn gemaakt.

  3. Als u azureBlob of indexedOneLake kennisbronnen hebt gemigreerd, werkt u alle code of scripts bij die verwijzen naar de bijbehorende index, indexeerfunctie, gegevensbron of skillset om te verwijzen naar de nieuwe objecten.

  4. Werk de code bij waarmee antwoorden worden verwerkt. Antwoorden retourneren extractieve, ondersteunende inhoud met activity en references, zoals geen gesynthetiseerde antwoorden.

  5. Verwijder voorbeeldobjecten pas nadat de nieuwe objecten volledig zijn gevalideerd en geïmplementeerd.

2025-11-01-preview

Als u migreert van 2025-08-01-preview, wordt de naam van 'knowledge agent' gewijzigd in 'knowledge base' en worden meerdere eigenschappen verplaatst naar verschillende objecten en niveaus binnen een objectdefinitie.

  1. SearchIndex-kennisbronnen bijwerken
  2. AzureBlob-kennisbronnen bijwerken
  3. Kennisagent vervangen door knowledge base
  4. Werk de retrieve-aanvraag bij en verstuur een query om de wijzigingen te testen
  5. Clientcode bijwerken

Een searchIndex-kennisbron bijwerken

Met deze procedure maakt u een nieuwe 2025-11-01-previewsearchIndex kennisbron op hetzelfde functionele niveau als de vorige 2025-08-01 versie. De onderliggende index zelf vereist geen updates.

  1. Vermeld alle kennisbronnen op naam om uw kennisbron te vinden.

    ### List all knowledge sources by name
GET {{search-endpoint}}/knowledge-sources?api-version=2025-08-01-preview&$select=name
Authorization: Bearer {{search-access-token}}
Content-Type: application/json

  2. Haal de huidige definitie op om bestaande eigenschappen te controleren.

    ### Get a specific knowledge source
GET {{search-endpoint}}/knowledge-sources/search-index-ks?api-version=2025-08-01-preview
Authorization: Bearer {{search-access-token}}
Content-Type: application/json

    Het antwoord moet er ongeveer uitzien als in het volgende voorbeeld.

    {
     "name": "search-index-ks",
     "kind": "searchIndex",
     "description": "This knowledge source pulls from a search index created using the 2025-08-01-preview.",
     "encryptionKey": null,
     "searchIndexParameters": {
     "searchIndexName": "earth-at-night-idx",
     "sourceDataSelect": "id, page_chunk, page_number"
     },
     "azureBlobParameters": null
}

  3. Formuleer een Knowledge Source-aanvraag maken als basis voor uw migratie.

    Begin met de 08-01-preview JSON.

    POST {{search-endpoint}}/knowledge-sources/search-index-ks?api-version=2025-08-01-preview
Authorization: Bearer {{search-access-token}}
Content-Type: application/json

{
    "name": "search-index-ks",
    "kind": "searchIndex",
    "description": "A sample search index knowledge source",
    "encryptionKey": null,
    "searchIndexParameters": {
        "searchIndexName": "my-search-index",
        "sourceDataSelect": "id, page_chunk, page_number"
  }
}

    Voer de volgende updates uit voor een 2025-11-01-preview migratie:

    • Geef de kennisbron een nieuwe naam.

    • Wijzig de API-versie in 2025-11-01-preview.

    • Wijzig sourceDataSelect in sourceDataFields en verander de tekenreeks in een matrix met naam-waardeparen voor elk veld dat u wilt opvragen. Dit zijn de velden die moeten worden geretourneerd in de zoekresultaten, vergelijkbaar met een select component in een klassieke query.

  4. Controleer uw updates en verzend de aanvraag om het object te maken.

    PUT {{search-endpoint}}/knowledge-sources/search-index-ks-11-01?api-version=2025-11-01-preview
Authorization: Bearer {{search-access-token}}
Content-Type: application/json

{
    "name": "search-index-ks-11-01",
    "kind": "searchIndex",
    "description": "knowledge source migrated to 2025-11-01-preview",
    "encryptionKey": null,
    "searchIndexParameters": {
        "searchIndexName": "my-search-index",
        "sourceDataFields": [
            { "name": "id" }, { "name": "page_chunk" }, { "name": "page_number" }
        ]
    }
}

U hebt nu een gemigreerde searchIndex kennisbron die compatibel is met de vorige versie, met behulp van de juiste eigenschapsspecificaties voor de 2025-11-01-preview.

Het antwoord bevat de volledige definitie van het nieuwe object. Voor meer informatie over nieuwe eigenschappen die beschikbaar zijn voor dit kennisbrontype, wat u nu kunt doen via updates, raadpleegt u Hoe u een zoekindexkennisbron maakt.

Een azureBlob-kennisbron bijwerken

Met deze procedure maakt u een nieuwe 2025-11-01-previewazureBlob kennisbron op hetzelfde functionele niveau als de vorige 2025-08-01 versie. Er wordt een nieuwe set gegenereerde objecten gemaakt: gegevensbron, vaardighedenset, indexeerfunctie, index.

  1. Vermeld alle kennisbronnen op naam om uw kennisbron te vinden.

    ### List all knowledge sources by name
GET {{search-endpoint}}/knowledge-sources?api-version=2025-08-01-preview&$select=name
Authorization: Bearer {{search-access-token}}
Content-Type: application/json

  2. Haal de huidige definitie op om bestaande eigenschappen te controleren.

    ### Get a specific knowledge source
GET {{search-endpoint}}/knowledge-sources/azure-blob-ks?api-version=2025-08-01-preview
Authorization: Bearer {{search-access-token}}
Content-Type: application/json

    Als uw werkstroom een model bevat, moet het antwoord vergelijkbaar zijn met het volgende voorbeeld. U ziet dat een antwoord de namen van de gegenereerde objecten bevat. Deze objecten zijn volledig onafhankelijk van de kennisbron en blijven operationeel, zelfs als u de kennisbron bijwerkt of verwijdert.

     {
   "name": "azure-blob-ks",
   "kind": "azureBlob",
   "description": "A sample azure blob knowledge source.",
   "encryptionKey": null,
   "searchIndexParameters": null,
   "azureBlobParameters": {
     "connectionString": "<redacted>",
     "containerName": "blobcontainer",
     "folderPath": null,
     "disableImageVerbalization": false,
     "identity": null,
     "embeddingModel": {
       "name": "embedding-model",
       "kind": "azureOpenAI",
       "azureOpenAIParameters": {
         "resourceUri": "<redacted>",
         "deploymentId": "text-embedding-3-large",
         "apiKey": "<redacted>",
         "modelName": "text-embedding-3-large",
         "authIdentity": null
       },
       "customWebApiParameters": null,
       "aiServicesVisionParameters": null,
       "amlParameters": null
     },
     "chatCompletionModel": {
       "kind": "azureOpenAI",
       "azureOpenAIParameters": {
         "resourceUri": "<redacted>",
         "deploymentId": "gpt-4o-mini",
         "apiKey": "<redacted>",
         "modelName": "gpt-4o-mini",
         "authIdentity": null
       }
 },
     "ingestionSchedule": null,
     "createdResources": {
       "datasource": "azure-blob-ks-datasource",
       "indexer": "azure-blob-ks-indexer",
       "skillset": "azure-blob-ks-skillset",
       "index": "azure-blob-ks-index"
     }
   }
 }

  3. Formuleer een Knowledge Source-aanvraag maken als basis voor uw migratie.

    Begin met de 08-01-preview JSON.

    POST {{search-endpoint}}/knowledge-sources/azure-blob-ks?api-version=2025-08-01-preview
Authorization: Bearer {{search-access-token}}
Content-Type: application/json

{
    "name": "azure-blob-ks",
    "kind": "azureBlob",
    "description": "A sample azure blob knowledge source.",
    "encryptionKey": null,
    "azureBlobParameters": {
        "connectionString": "<redacted>",
        "containerName": "blobcontainer",
        "folderPath": null,
        "disableImageVerbalization": false,
        "identity": null,
        "embeddingModel": {
            "name": "embedding-model",
            "kind": "azureOpenAI",
            "azureOpenAIParameters": {
            "resourceUri": "<redacted>",
            "deploymentId": "text-embedding-3-large",
            "apiKey": "<redacted>",
            "modelName": "text-embedding-3-large",
            "authIdentity": null
            },
            "customWebApiParameters": null,
            "aiServicesVisionParameters": null,
            "amlParameters": null
        },
        "chatCompletionModel": null,
        "ingestionSchedule": null
  }
}

    Voer de volgende updates uit voor een 2025-11-01-preview migratie:

    • Geef de kennisbron een nieuwe naam.

    • Wijzig de API-versie in 2025-11-01-preview.

    • Voeg ingestionParameters toe als een container voor de volgende onderliggende eigenschappen: "embeddingModel", "chatCompletionModel", "ingestionSchedule" en "contentExtractionMode".

  4. Controleer uw updates en verzend de aanvraag om het object te maken. Er worden nieuwe gegenereerde objecten gemaakt voor de indexeerpijplijn.

    PUT {{search-endpoint}}/knowledge-sources/azure-blob-ks-11-01?api-version=2025-11-01-preview
Authorization: Bearer {{search-access-token}}
Content-Type: application/json

{
    "name": "azure-blob-ks",
    "kind": "azureBlob",
    "description": "A sample azure blob knowledge source",
    "encryptionKey": null,
    "azureBlobParameters": {
        "connectionString": "{{blob-connection-string}}",
        "containerName": "blobcontainer",
        "folderPath": null,
        "ingestionParameters": {
            "embeddingModel": {
                "kind": "azureOpenAI",
                "azureOpenAIParameters": {
                    "deploymentId": "text-embedding-3-large",
                    "modelName": "text-embedding-3-large",
                    "resourceUri": "{{aoai-endpoint}}",
                    "apiKey": "{{aoai-key}}"
                }
            },
            "chatCompletionModel": null,
            "disableImageVerbalization": false,
            "ingestionSchedule": null,
            "contentExtractionMode": "minimal"
        }
    }
}

U hebt nu een gemigreerde azureBlob kennisbron die compatibel is met de vorige versie, met behulp van de juiste eigenschapsspecificaties voor de 2025-11-01-preview.

Het antwoord bevat de volledige definitie van het nieuwe object. Zie Een blob-kennisbron maken voor meer informatie over nieuwe eigenschappen die beschikbaar zijn voor dit kennisbrontype. Dit kunt u nu doen via updates.

Kennisagent vervangen door knowledge base

  1. Knowledge bases vereisen een kennisbron. Zorg ervoor dat u een kennisbron hebt die is gericht op 2025-11-01-preview voordat u begint.

  2. Haal de huidige definitie op om bestaande eigenschappen te controleren.

    ### Get a knowledge agent by name
GET {{search-endpoint}}/agents/earth-at-night?api-version=2025-08-01-preview
Authorization: Bearer {{search-access-token}}
Content-Type: application/json

    Het antwoord moet er ongeveer uitzien als in het volgende voorbeeld.

    {
  "name": "earth-at-night",
  "description": "A sample knowledge agent that retrieves from the earth-at-night knowledge source.",
  "retrievalInstructions": null,
  "requestLimits": null,
  "encryptionKey": null,
  "knowledgeSources": [
    {
      "name": "earth-at-night",
      "alwaysQuerySource": null,
      "includeReferences": null,
      "includeReferenceSourceData": null,
      "maxSubQueries": null,
      "rerankerThreshold": 2.5
    }
  ],
  "models": [
    {
      "kind": "azureOpenAI",
      "azureOpenAIParameters": {
        "resourceUri": "<redacted>",
        "deploymentId": "gpt-5-mini",
        "apiKey": "<redacted>",
        "modelName": "gpt-5-mini",
        "authIdentity": null
      }
    }
  ],
  "outputConfiguration": {
    "modality": "answerSynthesis",
    "answerInstructions": null,
    "attemptFastPath": false,
    "includeActivity": null
  }
}

  3. Formuleer een Knowledge Base-aanvraag maken als basis voor uw migratie.

    Begin met de 08-01-preview JSON.

    PUT {{search-endpoint}}/knowledgebases/earth-at-night?api-version=2025-08-01-preview  HTTP/1.1
Authorization: Bearer {{search-access-token}}
Content-Type: application/json

{
    "name": "earth-at-night",
    "description": "A sample knowledge agent that retrieves from the earth-at-night knowledge source.",
    "retrievalInstructions": null,
    "encryptionKey": null,
    "knowledgeSources": [
        {
          "name": "earth-at-night",
          "alwaysQuerySource": null,
          "includeReferences": null,
          "includeReferenceSourceData": null,
          "maxSubQueries": null,
          "rerankerThreshold": 2.5
        }
    ],
    "models": [
        {
            "kind": "azureOpenAI",
            "azureOpenAIParameters": {
                "resourceUri": "<redacted>",
                "apiKey": "<redacted>",
                "deploymentId": "gpt-5-mini",
                "modelName": "gpt-5-mini"
            }
        }
    ],
    "outputConfiguration": {
        "modality": "answerSynthesis"
    }
}

    Voer de volgende updates uit voor een 2025-11-01-preview migratie:

    • Vervang het eindpunt: /knowledgebases/{{knowledge-base-name}}. Geef de knowledge base een unieke naam.

    • Wijzig de API-versie in 2025-11-01-preview.

    • Verwijderen requestLimits. De maxRuntimeInSeconds eigenschappen en maxOutputSize eigenschappen worden nu rechtstreeks op de ophaalaanvraag opgegeven.

    • Bijwerken knowledgeSources:

    • Verplaats alwaysQuerySource, includeReferenceSourceData, includeReferences en rerankerThreshold naar de knowledgeSourceParams sectie van een ophaalactie.

    • Geen wijzigingen voor models.

    • Bijwerken outputConfiguration:

      • Vervangen outputConfiguration door outputMode.

      • Verwijderen attemptFastPath. Het bestaat niet meer. Het equivalente gedrag wordt geïmplementeerd door retrievalReasoningEffort in te stellen op het minimum (zie De redeneerinspanning voor ophalen instellen (preview)).

      • Als de modaliteit is ingesteld op answerSynthesis, moet u ervoor zorgen dat u de inspanning voor het ophalen van de redenering instelt op laag (standaard) of gemiddeld.

    • Voeg ingestionParameters toe als vereiste voor het maken van een 2025-11-01-preview azureBlob-kennisbron.

  4. Controleer uw updates en verzend de aanvraag om het object te maken. Er worden nieuwe gegenereerde objecten gemaakt voor de indexeerpijplijn.

     PUT {{search-endpoint}}/knowledgebases/earth-at-night-11-01?api-version={{api-version}}
 Authorization: Bearer {{search-access-token}}
 Content-Type: application/json

 {
   "name": "earth-at-night-11-01",
   "description": "A sample knowledge base at the same functional level as the previous knowledge agent.",
   "retrievalInstructions": null,
   "encryptionKey": null,
   "knowledgeSources": [
     {
         "name": "earth-at-night-ks"
     }
   ],
   "models": [
     {
       "kind": "azureOpenAI",
       "azureOpenAIParameters": {
           "resourceUri": "<redacted>",
           "apiKey": "<redacted>",
           "deploymentId": "gpt-5-mini",
           "modelName": "gpt-5-mini"
         }
     }
   ],
   "retrievalReasoningEffort": null,
   "outputMode": "answerSynthesis",
   "answerInstructions": "Provide a concise and accurate answer based on the retrieved information."
 }

U hebt nu een knowledge base in plaats van een kennisagent en het object is achterwaarts compatibel met de vorige versie.

Het antwoord bevat de volledige definitie van het nieuwe object. Zie How to create a knowledge base (Een knowledge base maken) voor meer informatie over nieuwe eigenschappen die beschikbaar zijn voor een knowledge base. Dit kunt u nu doen via updates.

Het ophalen bijwerken en testen van de updates voor 2025-11-01-preview

Het ophaalverzoek voor de 2025-11-01-preview is aangepast om meer vormen te ondersteunen, waaronder een eenvoudiger verzoek dat de LLM-verwerking minimaliseert. Zie Gegevens ophalen met behulp van een knowledge base voor meer informatie over het ophalen in deze preview. In deze sectie wordt uitgelegd hoe u uw code bijwerkt.

  1. Wijzig het /agents/retrieve eindpunt in /knowledgebases/retrieve.

  2. Wijzig de API-versie in 2025-11-01-preview.

  3. Er zijn geen wijzigingen aan messages nodig als u low of medium retrieval-redeneerinspanning gebruikt. Vervang messages door intents als u minimal-redenering gebruikt (zie De redeneerinspanning voor ophalen instellen (preview)).

  4. Wijzig knowledgeSourceParams om de eigenschappen op te nemen die verwijderd zijn uit de agent: rerankerThreshold, alwaysQuerySource, includeReferenceSourceData, includeReferences.

  5. Voeg retrievalReasoningEffort in als minimum als u attemptFastPath gebruikte. Als u maxSubQueries gebruikte, is het niet langer beschikbaar. Gebruik de instelling retrievalReasoningEffort om de verwerking van subquery's te specificeren (zie De inspanning voor retrievalredenering instellen (preview)).

Als u de uitvoer van uw Knowledge Base wilt testen met een query, gebruikt u de 2025-11-01-preview functie Knowledge Retrieval - Ophalen (REST API).

### Send a query to the knowledge base
POST {{search-endpoint}}/knowledgebases/earth-at-night-11-01/retrieve?api-version=2025-11-01-preview
Authorization: Bearer {{search-access-token}}
Content-Type: application/json

{
    "messages": [
        {
            "role": "user",
            "content": [
                { "type": "text", "text": "What are some light sources on the ocean at night" }
            ]
        }
    ],
    "includeActivity": true,
    "retrievalReasoningEffort": { "kind": "medium" },
    "outputMode": "answerSynthesis",
    "maxRuntimeInSeconds": 30,
    "maxOutputSize": 6000
}

Als het antwoord een 200 OK HTTP-code heeft, heeft uw knowledge base inhoud opgehaald uit de kennisbron.

Code en clients bijwerken voor 2025-11-01-preview

Voer de volgende opschoonstappen uit om uw migratie te voltooien:

  1. Voor alleen blob-kennisbronnen werkt u clients bij om de nieuwe index te gebruiken. Als u code of script hebt dat een indexeerfunctie uitvoert of verwijst naar een gegevensbron, index of vaardighedenset, moet u ervoor zorgen dat u de verwijzingen naar de nieuwe objecten bijwerkt.

  2. Vervang alle agentverwijzingen door knowledgeBases in configuratiebestanden, code, scripts en tests.

  3. Werk clientoproepen bij om het 2025-11-01-previewte gebruiken.

  4. Wis of genereer definities in de cache die zijn gemaakt met behulp van de oude vormen.

2025-08-01-preview

Als u een kennisagent hebt gemaakt met de preview van 2025-05-01, bevat de definitie van uw agent een inlinematrix targetIndexes en een optionele defaultMaxDocsForReranker eigenschap.

Vanaf API-versie 2025-08-01-preview vervangen herbruikbare kennisbronnen targetIndexes, en wordt defaultMaxDocsForReranker niet langer ondersteund. Voor deze brekende wijzigingen moet u de volgende stappen ondernemen:

  1. De huidige targetIndexes configuratie ophalen
  2. Een equivalente kennisbron maken
  3. De agent bijwerken voor gebruik knowledgeSources in plaats van targetIndexes
  4. Een query verzenden om het ophalen te testen
  5. Code verwijderen die targetIndexes gebruikt en clients bijwerken

De huidige configuratie ophalen

Als u de definitie van uw agent wilt ophalen, gebruikt u de van Knowledge Agents - Get (REST API).

@search-endpoint = <search-endpoint>
@agent-name = <agent-name>
@search-access-token = <search-access-token>

### Get agent definition
GET {{search-endpoint}}/agents/{{agent-name}}?api-version=2025-05-01-preview  HTTP/1.1
    Authorization: Bearer {{search-access-token}}

Het antwoord moet er ongeveer uitzien als in het volgende voorbeeld. Kopieer de indexName, defaultRerankerThresholden defaultIncludeReferenceSourceData waarden voor gebruik in de komende stappen. defaultMaxDocsForReranker is afgeschaft, zodat u de waarde ervan kunt negeren.

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "my-knowledge-agent",
  "description": "My description of the agent",
  "targetIndexes": [
    {
      "indexName": "my-index",
      "defaultRerankerThreshold": 2.5,
      "defaultIncludeReferenceSourceData": true,
      "defaultMaxDocsForReranker": 100
    }
  ]
}

Een kennisbron maken

Als u een searchIndex kennisbron wilt maken, gebruikt u de 2025-08-01-preview van Kennisbronnen - Maken (REST API). Stel searchIndexName in op de waarde die u eerder hebt gekopieerd.

@source-name = <source-name>

### Create a knowledge source
PUT {{search-endpoint}}/knowledgeSources/{{source-name}}?api-version=2025-08-01-preview  HTTP/1.1
    Content-Type: application/json
    Authorization: Bearer {{search-access-token}}

    {
        "name": "{{source-name}}",
        "description": "My description of the knowledge source",
        "kind": "searchIndex",
        "searchIndexParameters": {
            "searchIndexName": "my-index"
        }
    }

In het vorige voorbeeld wordt een kennisbron gemaakt die één index vertegenwoordigt, maar u kunt zich richten op meerdere indexen of een Azure-blob. Zie Een kennisbron maken voor meer informatie.

De agent bijwerken

Als u targetIndexes door knowledgeSources wilt vervangen in de definitie van uw agent, gebruikt u de 2025-08-01-preview van Knowledge Agents - Create or Update (REST API). Stel rerankerThreshold en includeReferenceSourceData op de waarden die u eerder hebt gekopieerd.

### Replace targetIndexes with knowledgeSources
POST {{search-endpoint}}/agents/{{agent-name}}?api-version=2025-08-01-preview  HTTP/1.1
    Content-Type: application/json
    Authorization: Bearer {{search-access-token}}

    {
        "name": "{{agent-name}}",
        "knowledgeSources": [
            {
                "name": "{{source-name}}",
                "rerankerThreshold": 2.5,
                "includeReferenceSourceData": true
            }
        ]
    }

In het vorige voorbeeld wordt de definitie bijgewerkt om te verwijzen naar één kennisbron, maar u kunt zich richten op meerdere kennisbronnen. U kunt ook andere eigenschappen gebruiken om het ophaalgedrag te beheren, zoals alwaysQuerySource. Zie Een kennisagent maken voor meer informatie.

Test het ophalen van updates van 1 augustus 2025-preview.

Om de uitvoer van uw agent met een query te testen, gebruikt u de van Knowledge Retrieval - Retrieve (REST API).

### Send a query to the agent
POST {{search-endpoint}}/agents/{{agent-name}}/retrieve?api-version=2025-08-01-preview  HTTP/1.1
    Content-Type: application/json
    Authorization: Bearer {{search-access-token}}

    {
      "messages": [
            {
                "role": "user",
                "content" : [
                    {
                        "text": "<query-text>",
                        "type": "text"
                    }
                ]
            }
        ]
    }

Als het antwoord een 200 OK HTTP-code heeft, heeft uw agent inhoud opgehaald uit de kennisbron.

Code en clients bijwerken voor 2025-08-01-preview

Voer de volgende opschoonstappen uit om uw migratie te voltooien:

  • Vervang alle targetIndexes verwijzingen door knowledgeSources in configuratiebestanden, code, scripts en tests.
  • Werk clientoproepen bij om het 2025-08-01-previewte gebruiken.
  • Wis of regenereer agentdefinities in de cache die zijn gemaakt met behulp van de oude vorm.

Versiespecifieke wijzigingen

In deze sectie worden compatibiliteitsbrekende en niet-compatibiliteitsbrekende wijzigingen voor de volgende API-versies behandeld:

2026-08-01-preview

De 2026-08-01-preview versie bouwt voort op 2026-05-01-preview en bevat belangrijke wijzigingen voor toepassingen die gebruikmaken van Work IQ-kennisbronnen, offsetgebaseerde lijstpaginering, door model ondersteunde activiteitsrecords, verwerking van MCP-serverresultaten of positionele gegenereerde clientaanroepen.

Als u de REST API-referentiedocumentatie voor deze versie wilt bekijken, selecteert u het 2026-08-01-preview API-versiefilter boven aan de pagina.

  • workIQParameters is vereist voor een Werk IQ-kennisbron en moet deze bevatten entraAppAuthentication. Werk de bron ter plaatse bij, of maak een vervangende versie voor een parallelle migratie. Geef de gebruikersassertie door in de x-ms-query-work-iq-source-authorization-header bij ophaalverzoeken.

  • Work IQ-verwijzingen verwijderen: attributions, de vorm WorkIQAttribution en seeMoreWebUrl. De aangepaste verwijzing maakt searchSensitivityLabelInfo zichtbaar. Verwijder afhankelijkheden van de verwijderde velden en werk de verwijzingsverwerking bij voor de nieuwe vorm voor vertrouwelijkheidslabels.

  • De preview-only $topen $skip$count parameters worden verwijderd. Bewerkingen op verzamelingslijsten gebruiken search, pageSize en searchType. Reacties gebruiken @odata.nextLink voor doorlopende paginering. Werk lijstaanvragen bij en volg elke @odata.nextLink aanvraag precies zoals geretourneerd.

  • Activiteitsrecords voor queryplanning, antwoordsynthese en websamenvatting verwijderen de scalaire waarde modelName. Het vervangende model object bevat modelName en deploymentId. Het geneste model object deserialiseren voor door model ondersteunde activiteitsrecords.

  • McpServerTool.inclusionMode wordt verwijderd. Koppel voor elk item tools op de MCP-server reranked aan resultsProcessing: "rerank" en always aan resultsProcessing: "none". Als dit wordt weggelaten, wordt resultsProcessing standaard ingesteld op rerank; none slaat hernieuwde rangschikking over en behoudt de onderliggende volgorde van resultaten.

  • De nieuwe lijstparameters wijzigen de gegenereerde methodeparametervolgorde, maar hebben geen invloed op REST-parameterbinding. Controleer positionele aanroepen nadat u een SDK-pakket hebt geïnstalleerd dat ondersteuning biedt 2026-08-01-preview. Geef de voorkeur aan benoemde argumenten of opties, indien beschikbaar.

2026-05-01-preview

2026-05-01-preview voegt kennisbank-, kennisbron- en ophaalfuncties toe boven op 2025-11-01-preview, zonder eerder opgeslagen eigenschappen te verwijderen. Bestaande knowledge bases en kennisbronnen die u in eerdere preview-versies hebt gemaakt, blijven werken. Deze versie introduceert vooral nieuwe functionaliteit en draait enkele beperkingen terug die alleen voor previewversies golden.

Als u de REST API-referentiedocumentatie voor deze versie wilt bekijken, selecteert u het 2026-05-01-preview API-versiefilter boven aan de pagina.

Er zijn geen belangrijke wijzigingen tussen 2025-11-01-preview en 2026-05-01-preview. Bestaande aanvragen die het doel hebben 2025-11-01-preview , blijven werken wanneer u de API-versie wijzigt in 2026-05-01-preview.

De taal-SDK's die 2026-05-01-preview ondersteuning bieden, introduceren wijzigingen in codevorm die fouten veroorzaken in de SDK-laag. Zie Code en clients bijwerken voor 2026-05-01-preview voor de volledige toewijzing van SDK-structuren.

01-04-2026

2026-04-01 is de eerste stabiele API-versie voor agentic retrieval. Het stelt een minimaal, extractief-ophaalcontract vast en verwijdert vraagplanning gebaseerd op berichten en antwoordsynthesemogelijkheden uit de voorvertoningsperiode.

Als u de REST API-referentiedocumentatie voor deze versie wilt bekijken, selecteert u het 2026-04-01 API-versiefilter boven aan de pagina.

De volgende wijzigingen zijn van invloed op zowel het Knowledge Base-schema als de aanvraag voor ophalen:

  • retrievalReasoningEffort wordt verwijderd. Kennisbanken die eerder zijn geconfigureerd met medium of low redeneringsinspanning, zijn niet compatibel met 2026-04-01 en moeten opnieuw worden aangemaakt.

  • outputMode wordt verwijderd. Ophalen retourneert standaard extractieve geaarde inhoud. Antwoordsynthese wordt niet ondersteund.

De volgende wijzigingen zijn alleen van invloed op het ophaalverzoek:

  • intents vervangt messages.

  • alwaysQuerySource wordt verwijderd uit knowledgeSourceParams.

  • maxOutputSize is hernoemd naar maxOutputSizeInTokens.

  • De gespreksstatus wordt niet bijgehouden tussen aanvragen. Het messages-gebaseerde patroon voor meerdere beurten wordt niet ondersteund.

De volgende wijziging is van invloed op azureBlob en indexedOneLake kennisbronnen:

  • ingestionPermissionOptions wordt verwijderd uit ingestionParameters. azureBlob en indexedOneLake kennisbronnen die deze eigenschap bevatten, moeten zonder deze eigenschap opnieuw worden gemaakt.

Opmerking

Het verzenden van verwijderde velden retourneert een 400 Bad Request HTTP-code. De opvraagverzoek verwijdert geen velden en tolereert geen velden die niet meer in deze versie bestaan.

2025-11-01-preview

Als u de REST API-referentiedocumentatie voor deze versie wilt bekijken, selecteert u het 2025-11-01-preview API-versiefilter boven aan de pagina.

  • De kennisagent wordt omgedoopt tot kennisbank.

    Vorige route Nieuwe route
    /agents /knowledgebases
    /agents/agent-name /knowledgebases/knowledge-base-name
    /agents/agent-name/retrieve /knowledgebases/knowledge-base-name/retrieve

  • De naam van de Knowledge Agent (base) outputConfiguration wordt gewijzigd in outputMode en gewijzigd van een object in een tekenreeksenumerator. Verschillende eigenschappen worden beïnvloed:

    • includeActivity wordt rechtstreeks van outputConfiguration naar de retrieve-aanvraag verplaatst.
    • attemptFastPath wordt volledig uit outputConfiguration verwijderd. De nieuwe minimal redeneringsinspanning is de vervanging.

  • Kennisagent (basis) requestLimits wordt verwijderd. De subeigenschappen van maxRuntimeInSeconds en maxOutputSize worden rechtstreeks op de retrieve-aanvraag geplaatst.

  • Parameters van knowledge agent (base) knowledgeSources vermelden nu alleen de namen van de kennisbron die door een knowledge base worden gebruikt. Andere onderliggende eigenschappen die voorheen onder knowledgeSources stonden, worden verplaatst naar de eigenschappen van knowledgeSourceParams van het ophaalverzoek:

    • rerankerThreshold
    • alwaysQuerySource
    • includeReferenceSourceData
    • includeReferences

    De maxSubQueries accommodatie is verdwenen. De vervanging is de nieuwe eigenschap voor het ophalen van redeneringen.

  • Ophaalaanvraag voor knowledge agent (base): het semanticReranker activiteitenrecord wordt vervangen door het agenticReasoning activiteitenrecordtype.

  • Kennisbronnen voor zowel azureBlob als searchIndex: eigenschappen op het hoogste niveau voor identity, embeddingModel, chatCompletionModel, en disableImageVerbalizationingestionSchedulemaken nu deel uit van een ingestionParameters object in de kennisbron. Alle kennisbronnen die uit een zoekindex worden opgehaald, hebben een ingestionParameters object.

  • Alleen voor searchIndex kennisbronnen: sourceDataSelect is hernoemd in sourceDataFields en is een matrix die accepteert fieldName en fieldToSearch.

2025-08-01-preview

Als u de REST API-referentiedocumentatie voor deze versie wilt bekijken, selecteert u het 2025-08-01-preview API-versiefilter boven aan de pagina.

  • Introduceert kennisbronnen als de nieuwe manier om gegevensbronnen te definiëren, die zowel searchIndex (één of meerdere indexen) als azureBlob soorten ondersteunen. Zie Een kennisbron voor een zoekindex maken en een blob-kennisbron maken voor meer informatie.

  • Vereist knowledgeSources in plaats van targetIndexes in agentdefinities. Voor migratiestappen, zie Hoe te migreren.

  • Verwijdert defaultMaxDocsForReranker ondersteuning. Deze eigenschap bestond al eerder, targetIndexesmaar er is geen vervanging in knowledgeSources.

2025-05-01-preview

Deze API-versie introduceert agentische ophaal- en kennisagenten. Elke agentdefinitie vereist een targetIndexes matrix die één index en optionele eigenschappen opgeeft, zoals defaultRerankerThreshold en defaultIncludeReferenceSourceData.

Als u de REST API-referentiedocumentatie voor deze versie wilt bekijken, selecteert u het 2025-05-01-preview API-versiefilter boven aan de pagina.

Verwante inhoud

  • Laatst bijgewerkt om