Eseguire la migrazione del codice di recupero agentico alla versione più recente

Nota

Azure AI Search è disponibile tramite il portale di Azure, le API REST e Azure SDK. È inoltre alla base di Foundry IQ, il livello di conoscenza gestito che trasforma il contenuto aziendale in knowledge base riutilizzabili e con riconoscimento delle autorizzazioni per gli agenti nel portale di Microsoft Foundry.

Importante

Le funzionalità, le funzionalità o le proprietà contrassegnate (anteprima) non sono coperte da un contratto di servizio, non sono consigliate per i carichi di lavoro di produzione e potrebbero cambiare o essere vincolate prima che diventino disponibili a livello generale. Le condizioni di anteprima Azure AI Search si applicano a tutte le funzionalità di anteprima, indipendente o parte di una funzionalità disponibile a livello generale.

Se il codice di recupero agente è destinato a una versione precedente dell'API, questo articolo spiega quando e come eseguire la migrazione a una versione più recente. Descrive anche le modifiche che causano e non causano un'interruzione per tutte le versioni dell'API che supportano il recupero agentico.

Le istruzioni di migrazione consentono di eseguire una soluzione esistente in una versione più recente dell'API. Le istruzioni contenute in questo articolo consentono di risolvere le modifiche di rilievo a livello di API in modo che l'app venga eseguita come prima. Per informazioni su come aggiungere nuove funzionalità, iniziare con Novità di Azure AI Search.

Suggerimento

Uso di un Azure SDK invece di REST? Prima di aggiornare il pacchetto e applicare le modifiche di migrazione pertinenti, controllare il log delle modifiche per il linguaggio SDK per confermare il supporto per la versione dell'API di destinazione.

Quando eseguire la migrazione

La maggior parte delle versioni che supportano il recupero agentico ha introdotto modifiche di rilievo. È possibile continuare a eseguire il codice meno recente mantenendo il valore della versione dell'API, ma per trarre vantaggio da correzioni di bug, miglioramenti e funzionalità più recenti, è necessario aggiornare il codice.

Se il codice è destinato a una versione di anteprima, è consigliabile eseguire la migrazione alla versione stabile più recente solo se il caso d'uso è completamente supportato da 2026-04-01. Se si fa affidamento sulla sintesi delle risposte, su un impegno di ragionamento non minimo o su messaggi a più turni, esaminare le modifiche che causano e quelle che non causano interruzioni prima di decidere di procedere con la migrazione. Queste funzionalità rimangono in anteprima.

Prima della migrazione

  • Per comprendere l'ambito delle modifiche, esaminare le modifiche che causano un'interruzione e quelle che non la causano per ogni versione.

  • Il percorso di migrazione supportato è incrementale. Se il codice è destinato a 2025-05-01-preview, esegui prima la migrazione a 2025-08-01-preview, quindi prosegui attraverso ciascuna versione successiva fino a raggiungere la versione di destinazione.

  • Per una migrazione side-by-side, creare oggetti denominati in modo univoco che implementano i comportamenti della versione precedente. Questo approccio mantiene gli oggetti esistenti durante lo sviluppo e il test delle sostituzioni. Se un oggetto supporta l'aggiornamento sul posto, i passaggi specifici per la versione segnalano tale opzione.

  • Per ogni oggetto di cui si esegue la migrazione, iniziare recuperando la definizione corrente dal servizio di ricerca in modo da poter esaminare le proprietà esistenti prima di specificarne una nuova.

  • Eliminare le versioni precedenti solo dopo che la migrazione è stata testata e distribuita completamente.

Come eseguire la migrazione

Questa sezione illustra i passaggi di migrazione per le versioni API seguenti:

2026-08-01-preview

Se si esegue la migrazione dalla versione 2026-05-01-preview, è possibile passare direttamente a 2026-08-01-preview. Questa migrazione richiede aggiornamenti alle fonti delle informazioni di Work IQ, al paging degli elenchi, all'elaborazione delle risposte, agli strumenti del server MCP e alle hiamate generate dal client interessate.

  1. Migrare le fonti di conoscenza di Work IQ
  2. Aggiornare il paging degli elenchi
  3. Aggiornare l'elaborazione delle risposte di recupero
  4. Aggiornare codice e client

Migra le fonti di conoscenza di Work IQ

Per migrare una fonte di conoscenza di Work IQ alla nuova configurazione di autenticazione:

  1. Esportare la definizione corrente.

  2. Aggiorna la fonte di conoscenza esistente usando Fonti di conoscenza - Crea o aggiorna, oppure crea una risorsa sostitutiva con un nome univoco per una migrazione affiancata.

  3. Usare la versione dell'API 2026-08-01-preview e configurare workIQParameters.entraAppAuthentication. Le applicationId proprietà e federatedCredentialId sono obbligatorie. La proprietà tenantId è facoltativa e per impostazione predefinita è il tenant del servizio di ricerca.

  4. Se hai creato una sostituzione, aggiorna ogni knowledge base che fa riferimento all'origine di conoscenza precedente in modo che utilizzi il nome della sostituzione.

  5. Aggiornare le richieste di recupero per passare l'asserzione utente nell'intestazione x-ms-query-work-iq-source-authorization .

Per la configurazione e per esempi, vedere Creare una fonte delle informazioni di Work IQ (anteprima).

Aggiornare il paging dell'elenco

Per sostituire il paging basato su offset con il paging basato su cursore:

  1. Rimuovere $top, $skip e $count dalle richieste di elenco delle fonti di conoscenza. Impostare pageSize da 1 a 3.000 per controllare le dimensioni della pagina. Se viene omesso, il servizio sceglie le dimensioni della pagina.

  2. Per filtrare in base al nome, impostare search e searchType. L'unico valore supportato searchType è prefix, che è anche l'impostazione predefinita. La richiesta seguente restituisce fino a 100 origini di conoscenza i cui nomi iniziano con contoso.

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

    Reference:Knowledge Sources - List

  3. Se la risposta contiene @odata.nextLink, inviare l'URL esattamente come restituito. Non analizzare o modificare il relativo stato di continuazione.

Aggiornamento dell'elaborazione della risposta di recupero

Per elaborare il nuovo riferimento Work IQ e le forme di attività supportate dal modello:

  1. Rimuovere le dipendenze da attributions, WorkIQAttributione seeMoreWebUrl. Leggere i metadati delle etichette di riservatezza da searchSensitivityLabelInfo nel riferimento di Work IQ.

  2. Nella pianificazione delle query, nella sintesi di risposte e nei record di attività di riepilogo Web, leggere modelName e deploymentId dall'oggetto annidato model . L'oggetto annidato e entrambe le proprietà sono facoltative.

I frammenti seguenti mostrano le modifiche della forma di risposta.

{
  "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-previewgli stessi frammenti usano la forma seguente:

{
  "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>"
      }
    }
  ]
}

Aggiornare il codice e i client per 2026-08-01-preview

Per completare la migrazione:

  1. In ogni elemento del server tools MCP sostituire inclusionMode con resultsProcessing. Associare reranked a rerank e always a none. Il valore rerank è il valore predefinito. Il none valore ignora il reranking e mantiene l'ordine dei risultati sottostante dello strumento. Per l'installazione, vedere Configurare gli strumenti per un'origine delle informazioni del server MCP.

  2. Se si usa un SDK di Azure, installare un pacchetto che supporti 2026-08-01-preview ed esaminare le chiamate di elenco posizionali per verificare eventuali modifiche nell'ordine dei parametri. I chiamanti REST non sono interessati perché i parametri HTTP vengono chiaveti in base al nome. In C# preferire argomenti denominati, ad esempio GetKnowledgeSourcesAsync(search: ..., pageSize: ...). In Python passare le opzioni elenco come argomenti di parola chiave.

  3. Verificate l'autenticazione e i riferimenti di Work IQ, la paginazione del cursore, la deserializzazione dei record di attività, l'ordinamento dei risultati del server MCP e le chiamate del client generate prima di aggiornare l'ambiente di produzione.

  4. Se hai creato origini di conoscenza sostitutive di Work IQ, elimina le origini precedenti solo dopo che la migrazione ha superato tutti i test, l'applicazione aggiornata è stata distribuita e nessuna knowledge base fa più riferimento ai nomi precedenti.

2026-05-01-anteprima

Se si esegue la migrazione dal 2026-04-01 o 2025-11-01-preview, è possibile passare direttamente a 2026-05-01-preview. Le richieste, le risposte e gli oggetti salvati in modo permanente da tali versioni rimangono compatibili. Le differenze sono le funzionalità aggiuntive e le ridenominazione dell'SDK del linguaggio.

  1. Aggiornare la versione dell'API a 2026-05-01-preview nelle richieste REST. I client SDK utilizzano la versione predefinita dell'API del pacchetto, quindi non è necessario passare un argomento serviceVersion esplicito. Aggiornare invece al pacchetto SDK 2026-05-01-preview.

  2. Se utilizzi l'SDK Python o JavaScript, aggiorna il client retrieve a KnowledgeBaseRetrievalClient e chiama retrieve(...) anziché la versione legacy retrieveKnowledge(...). Per il mapping completo delle forme dell'SDK, vedere Aggiornare il codice e i client per 2026-05-01-preview.

  3. (Facoltativo) Adottare le nuove funzionalità di 2026-05-01-preview, ad esempio il recupero basato sulla freschezza, i limiti ai documenti per origine e per il risultato finale, i valori predefiniti di recupero persistenti, CORS per la knowledge base e i metadati delle etichette di riservatezza di Purview nelle risposte di recupero. Nessuna di queste funzionalità è necessaria per mantenere funzionante una soluzione esistente.

Aggiornare il codice e i client per 2026-05-01-preview

Gli 2026-05-01-preview SDK introducono modifiche alla forma del codice nei linguaggi supportati:

Language Aggiornamenti della migrazione
Python Crea il client di recupero come KnowledgeBaseRetrievalClient(endpoint=..., credential=..., knowledge_base_name=...). Costruire istanze di lavoro di ragionamento, KnowledgeRetrievalLowReasoningEffort() ad esempio e passare la stringa output_mode="answerSynthesis" nella Knowledge Base o recuperare la richiesta. Passare AzureOpenAIVectorizerParameters(resource_url=...) (rinominato da resource_uri), utilizzando l'endpoint della radice delle risorse anziché un endpoint /openai/v1.
.NET Crea il client di recupero come new KnowledgeBaseRetrievalClient(endpoint, knowledgeBaseName, credential) e inserisci un AzureKeyCredential o un token di autenticazione. Per collegare un modello openAI basato su chiave Azure a una knowledge base, impostare la chiave API del modello su AzureOpenAIVectorizerParameters.ApiKey.
Java Usare KnowledgeBaseRetrievalClientBuilder per creare il client di recupero e leggere i risultati come KnowledgeBaseRetrievalResult. KnowledgeBaseRetrievalOptions ora espone setMessages(...) insieme a setIntents(...), oltre a setRetrievalReasoningEffort, setOutputMode, setMaxOutputSize e setMaxOutputDocuments, così che il recupero basato sui messaggi e la generazione delle risposte funzionino senza una soluzione alternativa basata sull'intento semantico. KnowledgeBaseaggiunge setOutputMode, setRetrievalReasoningEffort, setRetrievalInstructionssetAnswerInstructions, e setCorsOptions. SearchIndexKnowledgeSourceParams aggiunge setAlwaysQuerySource, setFailOnError, setMaxOutputDocumentse setEnableImageServing.
JavaScript e TypeScript Utilizzare il KnowledgeRetrievalClient.retrieve({ intents: [{ type: "semantic", search: query }] }). Il metodo precedente retrieveKnowledge(...) viene rimosso a favore di retrieve(...).

Dopo aver aggiornato le strutture del client, eseguire il flusso completo che crea l'indice, carica i documenti, crea una fonte di conoscenza, crea una knowledge base, invia una richiesta di recupero e ripulisce le risorse per verificare la migrazione end-to-end.

01-04-2026

Se si esegue la migrazione dal 2025-11-01-preview, è possibile eseguire la migrazione direttamente a 2026-04-01. L'indice e il contenuto rimangono invariati. È sufficiente aggiornare lo schema della Knowledge Base e la forma di richiesta di recupero.

  1. Eseguire la migrazione delle fonti di conoscenza
  2. Eseguire la migrazione della Knowledge Base
  3. Aggiornare la richiesta di recupero
  4. Aggiornare il consenso alla fatturazione
  5. Aggiornare codice e client

Eseguire la migrazione delle origini delle informazioni

In 2026-04-01, i tipi di origine della conoscenza searchIndex, indexedOneLake, azureBlob e web sono generalmente disponibili. Altri tipi di origine delle informazioni rimangono in anteprima.

  1. Usare Le origini delle informazioni - Ottenere (API REST) per ottenere la definizione corrente.

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

  2. Nella risposta identificare cosa portare avanti e cosa rimuovere:

    • Per searchIndex e web, trasferire tutti i valori delle proprietà.

    • Per azureBlob e indexedOneLake, portare avanti tutti i valori delle proprietà, ma omettere ingestionPermissionOptions da ingestionParameters. Questa proprietà non è supportata in 2026-04-01.

  3. Usa Origini dati di conoscenza - Crea o aggiorna (API REST) per creare una nuova origine dati di conoscenza con un nome univoco, la versione dell'API 2026-04-01 e i valori delle proprietà dal passaggio precedente.

    Nell'esempio seguente viene illustrata un'origine searchIndex delle informazioni. Usare un modello simile per le origini di conoscenza azureBlob, indexedOneLake e web.

    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" }
    ]
  }
}

Eseguire la migrazione della Knowledge Base

La 2026-04-01 Knowledge Base ha uno schema più semplice rispetto alla 2025-11-01-preview versione: mantiene knowledgeSources e elimina le impostazioni di generazione delle risposte. Esaminare la definizione corrente prima di creare un nuovo oggetto.

  1. Usare Knowledge Bases - Get (API REST) per ottenere la definizione corrente.

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

  2. Nella risposta identificare cosa portare avanti e cosa rimuovere:

    • Prendere nota dei knowledgeSources riferimenti. Portare questi dati nella nuova Knowledge Base.

    • Se presente, rimuovere outputMode, answerInstructionse retrievalInstructions. Queste proprietà non sono supportate in 2026-04-01.

    • Se la knowledge base usa un'origine web delle informazioni, mantenere models. Il recupero Web richiede una sintesi supportata da modelli. Per tutti gli altri tipi di origine delle informazioni, rimuovere models.

  3. Usare knowledge base - Creare o aggiornare (API REST) per creare una nuova Knowledge Base con un nome univoco, la versione dell'API 2026-04-01 e solo le proprietà supportate.

    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}}" }
  ]
}

Aggiornare la richiesta di recupero

La 2026-04-01 richiesta di recupero ha una forma diversa rispetto alla versione di anteprima:

  • Usare intents anziché messages.

  • Usare maxOutputSizeInTokens anziché maxOutputSize.

  • Se presente, rimuovere retrievalReasoningEffort e alwaysQuerySource. Questi parametri non sono supportati in 2026-04-01.

  • Per domande di completamento, inviare una nuova richiesta di recupero con una nuova finalità semantica. 2026-04-01 non mantiene una trascrizione dei messaggi in esecuzione.

Per testare l'output della Knowledge Base con una query, usare la 2026-04-01 versione di Recupero informazioni - Recuperare (API REST).

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
}

Se la risposta ha un codice HTTP 200 OK, la base di conoscenza ha recuperato correttamente il contenuto dalla fonte di conoscenza.

A partire dalla versione dell'API, il 2026-04-01 consenso di fatturazione per il recupero agentico è controllato da una proprietà dedicata knowledgeRetrieval separata da semanticSearch, che ora si applica solo alla fatturazione del ranker semantico. knowledgeRetrieval è una proprietà del piano di gestione, quindi la si imposta tramite l'API REST di gestione della ricerca, non l'API REST del servizio di ricerca.

Usare la versione di anteprima più recente di Servizi - Creare o aggiornare (API REST) per impostare knowledgeRetrieval nel servizio di ricerca.

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"
  }
}

Per i valori validi e i dettagli di fatturazione, vedere Abilitare o disabilitare la fatturazione per il recupero agentico.

Aggiornare il codice e i client per 2026-04-01

Per completare la migrazione:

  1. Aggiornare le chiamate client per utilizzare la versione API 2026-04-01.

  2. Aggiornare qualsiasi knowledge base codificata fissa o nomi delle fonti della knowledge base nel codice in modo che faccia riferimento ai nuovi oggetti creati durante la migrazione.

  3. Se sono state migrate le origini delle conoscenze azureBlob o indexedOneLake, aggiornare il codice o gli script che fanno riferimento, per nome, all'indice, all'indicizzatore, all'origine dati o al set di competenze in modo che puntino ai nuovi oggetti.

  4. Aggiornare il codice che elabora le risposte di recupero. Le risposte restituiscono contenuti estrattivi con activity e references, non risposte sintetizzate.

  5. Eliminare gli oggetti di anteprima solo dopo che i nuovi oggetti vengono convalidati e distribuiti completamente.

2025-11-01-preview

Se si esegue la migrazione dal 2025-08-01-preview, "Knowledge Agent" viene rinominato "knowledge base" e più proprietà vengono spostate in oggetti e livelli diversi all'interno di una definizione di oggetto.

  1. Aggiornare le fonti di conoscenza di indice di ricerca
  2. Aggiornare le fonti di conoscenza azureBlob
  3. Sostituire agente di conoscenza con base di conoscenza
  4. Aggiornare la richiesta di recupero e inviare una query per testare gli aggiornamenti
  5. Aggiornare il codice client

Aggiornare una fonte di conoscenza dell'indice di ricerca

Questa procedura crea una nuova 2025-11-01-previewsearchIndex fonte delle informazioni allo stesso livello funzionale della precedente versione 2025-08-01. L'indice sottostante stesso non richiede aggiornamenti.

  1. Elenca tutte le fonti di conoscenza per nome per trovare la tua fonte di conoscenza.

    ### 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. Ottenere la definizione corrente per esaminare le proprietà esistenti.

    ### 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

    La risposta dovrebbe essere simile all'esempio seguente.

    {
     "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. Formulare una richiesta Create Knowledge Source come base per la migrazione.

    Iniziare con il codice JSON 08-01-preview.

    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"
  }
}

    Eseguire gli aggiornamenti seguenti per una 2025-11-01-preview migrazione:

    • Dare un nuovo nome alla fonte di conoscenza.

    • Modificare la versione dell'API in 2025-11-01-preview.

    • Rinomina sourceDataSelect in sourceDataFields e trasforma la stringa in un array con coppie chiave-valore per ogni campo recuperabile che vuoi interrogare. Questi sono i campi da restituire nei risultati della ricerca, in modo analogo a una select clausola in una query classica.

  4. Esaminare gli aggiornamenti e quindi inviare la richiesta per creare l'oggetto.

    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" }
        ]
    }
}

Ora disponi di una fonte di conoscenza migrata searchIndex retrocompatibile con la versione precedente, che utilizza le specifiche di proprietà corrette per 2025-11-01-preview.

La risposta include la definizione completa del nuovo oggetto. Per ulteriori informazioni sulle nuove proprietà disponibili per questo tipo di origine della conoscenza, che ora è possibile aggiornare, vedere Come creare un'origine della conoscenza dell'indice di ricerca.

Aggiornare una fonte di conoscenza azureBlob

Questa procedura crea una nuova 2025-11-01-previewazureBlob fonte delle informazioni allo stesso livello funzionale della precedente versione 2025-08-01. Crea un nuovo set di oggetti generati: origine dati, set di competenze, indicizzatore, indice.

  1. Elenca tutte le fonti di conoscenza per nome per trovare la tua fonte di conoscenza.

    ### 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. Ottenere la definizione corrente per esaminare le proprietà esistenti.

    ### 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

    Se il flusso di lavoro include un modello, la risposta dovrebbe essere simile all'esempio seguente. Si noti che una risposta include i nomi degli oggetti generati. Questi oggetti sono completamente indipendenti dall'origine delle informazioni e rimangono operativi anche se si aggiorna o si elimina la relativa origine delle informazioni.

     {
   "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. Formulare una richiesta Create Knowledge Source come base per la migrazione.

    Iniziare con il codice JSON 08-01-preview.

    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
  }
}

    Eseguire gli aggiornamenti seguenti per una 2025-11-01-preview migrazione:

    • Dare un nuovo nome alla fonte di conoscenza.

    • Modificare la versione dell'API in 2025-11-01-preview.

    • Aggiungere ingestionParameters come contenitore per le proprietà figlio seguenti: "embeddingModel", "chatCompletionModel", "ingestionSchedule", "contentExtractionMode".

  4. Esaminare gli aggiornamenti e quindi inviare la richiesta per creare l'oggetto. Vengono creati nuovi oggetti generati per la pipeline dell'indicizzatore.

    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"
        }
    }
}

Ora disponi di una fonte di conoscenza migrata azureBlob retrocompatibile con la versione precedente, che utilizza le specifiche di proprietà corrette per 2025-11-01-preview.

La risposta include la definizione completa del nuovo oggetto. Per ulteriori informazioni sulle nuove proprietà disponibili per questo tipo di fonte di conoscenza, che ora è possibile configurare tramite gli aggiornamenti, consultare Creare una fonte di conoscenza di tipo blob.

Sostituire agente di conoscenza con base di conoscenza

  1. Le Knowledge Base richiedono un'origine delle informazioni. Assicurarsi di disporre di una fonte delle informazioni che fa riferimento a 2025-11-01-preview prima di iniziare.

  2. Ottenere la definizione corrente per esaminare le proprietà esistenti.

    ### 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

    La risposta dovrebbe essere simile all'esempio seguente.

    {
  "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. Formulare una richiesta create knowledge base come base per la migrazione.

    Iniziare con il codice JSON 08-01-preview.

    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"
    }
}

    Eseguire gli aggiornamenti seguenti per una 2025-11-01-preview migrazione:

    • Sostituire l'endpoint: /knowledgebases/{{knowledge-base-name}}. Assegnare alla Knowledge Base un nome univoco.

    • Modificare la versione dell'API in 2025-11-01-preview.

    • Eliminare requestLimits. Le maxRuntimeInSeconds proprietà e maxOutputSize vengono ora specificate direttamente nella richiesta di recupero.

    • Aggiornamento knowledgeSources:

    • Spostare alwaysQuerySource, includeReferenceSourceDataincludeReferences e rerankerThreshold nella sezione knowledgeSourceParams di un'azione di recupero.

    • Nessuna modifica per models.

    • Aggiornamento outputConfiguration:

      • Sostituire outputConfiguration con outputMode.

      • Eliminare attemptFastPath. Non esiste più. Il comportamento equivalente si ottiene impostando retrievalReasoningEffort al minimo (vedere Impostare il livello di impegno del ragionamento per il recupero (anteprima)).

      • Se la modalità è impostata su answerSynthesis, assicurarsi di impostare lo sforzo di ragionamento del recupero su basso (impostazione predefinita) o medio.

    • Aggiungere ingestionParameters come requisito per creare un'origine conoscitiva 2025-11-01-preview azureBlob.

  4. Esaminare gli aggiornamenti e quindi inviare la richiesta per creare l'oggetto. Vengono creati nuovi oggetti generati per la pipeline dell'indicizzatore.

     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."
 }

Ora hai una base di conoscenza invece di un agente di conoscenza e l'oggetto è retrocompatibile con la versione precedente.

La risposta include la definizione completa del nuovo oggetto. Per altre informazioni sulle nuove proprietà disponibili per una Knowledge Base, che è ora possibile eseguire tramite gli aggiornamenti, vedere Come creare una knowledge base.

Aggiornamento e test del recupero per gli aggiornamenti di anteprima del 2025-11-01

La richiesta di recupero viene modificata per consentire a 2025-11-01-preview di supportare più formati, inclusa una richiesta più semplice che riduce al minimo l'elaborazione da parte dell'LLM. Per altre informazioni sul recupero in questa anteprima, vedere Recuperare dati usando una Knowledge Base. Questa sezione illustra come aggiornare il codice.

  1. Modificare l'endpoint /agents/retrieve in /knowledgebases/retrieve.

  2. Modificare la versione dell'API in 2025-11-01-preview.

  3. Non sono necessarie modifiche a messages se si usa un'attività di ragionamento per il recupero low o medium. Sostituire messages con intents se si utilizza il ragionamento minimal (vedere Impostare il livello di impegno del ragionamento per il recupero (anteprima)).

  4. Modificare knowledgeSourceParams per includere tutte le proprietà rimosse dall'agente: rerankerThreshold, alwaysQuerySource, includeReferenceSourceData, includeReferences.

  5. Aggiungere retrievalReasoningEffort impostato su minimum se si usa attemptFastPath. Se stavi usando maxSubQueries, non è più disponibile. Usare l'impostazione retrievalReasoningEffort per specificare l'elaborazione delle subquery (vedere Impostare il livello di impegno del ragionamento per il recupero (anteprima)).

Per verificare l'output della knowledge base con una query, usare 2025-11-01-preview di Recupero di informazioni - Recupera (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
}

Se la risposta ha un codice HTTP 200 OK, la base di conoscenza ha recuperato correttamente il contenuto dalla fonte di conoscenza.

Aggiornare il codice e i client per 2025-11-01-preview

Per completare la migrazione, seguire questa procedura di pulizia:

  1. Solo per le fonti di conoscenza BLOB, aggiornare i client affinché utilizzino il nuovo indice. Se si dispone di codice o script che esegue un indicizzatore o fa riferimento a un'origine dati, un indice o un set di competenze, assicurarsi di aggiornare i riferimenti ai nuovi oggetti.

  2. Sostituire tutti i riferimenti all'agente con knowledgeBases nei file di configurazione, nel codice, negli script e nei test.

  3. Aggiornare le chiamate client per usare 2025-11-01-preview.

  4. Cancellare o rigenerare le definizioni memorizzate nella cache create usando le forme precedenti.

2025-08-01-preview

Se è stato creato un agente di knowledge base usando 2025-05-01-preview, la definizione dell'agente include una matrice inline targetIndexes e una proprietà facoltativa defaultMaxDocsForReranker .

A partire dalla versione dell'API 2025-08-01-preview, le origini dati di conoscenza riutilizzabili sostituiscono targetIndexes, e defaultMaxDocsForReranker non è più supportato. Queste modifiche decisive richiedono di:

  1. Ottenere la configurazione corrente targetIndexes
  2. Creare un'origine conoscenze equivalente
  3. Aggiornare l'agente da usare knowledgeSources invece di targetIndexes
  4. Inviare una query per testare il recupero
  5. Rimuovere il codice che usa targetIndexes e aggiorna i client

Ottenere la configurazione corrente

Per recuperare la definizione dell'agente, usare 2025-05-01-preview di Agenti di informazioni - Ottieni (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}}

La risposta dovrebbe essere simile all'esempio seguente. Copiare i indexNamevalori , defaultRerankerThresholde defaultIncludeReferenceSourceData da usare nei passaggi successivi. defaultMaxDocsForReranker è deprecato, quindi è possibile ignorarne il valore.

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

Creare una fonte di conoscenza

Per creare una fonte delle informazioni searchIndex, usare 2025-08-01-preview di Fonti delle informazioni - Crea (REST API). Impostare searchIndexName sul valore copiato in precedenza.

@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"
        }
    }

L'esempio precedente crea un'origine dati che rappresenta un indice, ma è possibile specificare più indici o un archivio BLOB di Azure. Per altre informazioni, vedere Creare una fonte di conoscenza.

Aggiornare l'agente

Per sostituire targetIndexes con knowledgeSources nella definizione dell'agente, usare di 2025-08-01-previewKnowledge Agents - Create or Update (API REST). Impostare rerankerThreshold e includeReferenceSourceData sui valori copiati in precedenza.

### 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
            }
        ]
    }

Nell'esempio precedente la definizione viene aggiornata per fare riferimento a un'unica origine conoscenze, ma è possibile specificare più origini di informazioni. È anche possibile usare altre proprietà per controllare il comportamento di recupero, ad esempio alwaysQuerySource. Per altre informazioni, vedere Creare un agente di informazioni.

Testare il recupero degli aggiornamenti di 2025-08-01-preview

Per testare l'output dell'agente con una query, utilizza il di 2025-08-01-preview.

### 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"
                    }
                ]
            }
        ]
    }

Se la risposta ha un 200 OK codice HTTP, l'agente ha recuperato correttamente il contenuto dall'origine della knowledge base.

Aggiornare il codice e i client per 2025-08-01-preview

Per completare la migrazione, seguire questa procedura di pulizia:

  • Sostituire tutti i targetIndexes riferimenti con knowledgeSources nei file di configurazione, nel codice, negli script e nei test.
  • Aggiornare le chiamate client per usare 2025-08-01-preview.
  • Cancellare o rigenerare le definizioni dell'agente memorizzate nella cache create usando la forma precedente.

Modifiche specifiche della versione

Questa sezione descrive le modifiche incompatibili e compatibili per le seguenti versioni dell'API:

2026-08-01-preview

La 2026-08-01-preview versione si basa sulla versione 2026-05-01-preview e include modifiche di rilievo per le applicazioni che usano le origini delle informazioni di IQ di lavoro, il paging degli elenchi basato su offset, i record di attività supportati dal modello, l'elaborazione dei risultati del server MCP o le chiamate client generate dal client posizionale.

Per esaminare la documentazione di riferimento dell'API REST per questa versione, selezionare il filtro della versione dell'API 2026-08-01-preview nella parte superiore della pagina.

  • workIQParameters è obbligatorio per un'origine conoscitiva di Work IQ e deve contenere entraAppAuthentication. Aggiornate la sorgente direttamente oppure createne una sostitutiva per una migrazione affiancata. Trasmettere l'asserzione dell'utente nell'intestazione x-ms-query-work-iq-source-authorization nelle richieste di recupero.

  • I riferimenti di Work IQ eliminano attributions, la forma WorkIQAttribution e seeMoreWebUrl. Il riferimento rimodellato espone searchSensitivityLabelInfo. Rimuovere le dipendenze dai campi eliminati e aggiornare l'elaborazione dei riferimenti per la nuova struttura dell'etichetta di riservatezza.

  • I parametri $skip, $count e $top, disponibili solo in anteprima, vengono rimossi. Le operazioni della lista di raccolte utilizzano search, pageSize e searchType. Le risposte utilizzano @odata.nextLink per la continuazione della paginazione. Aggiornare le richieste dell'elenco e seguire ciascuna di esse @odata.nextLink esattamente come restituita.

  • I record di attività di pianificazione delle query, di sintesi di risposte e di riepilogo Web rimuovono i record scalari modelName. L'oggetto sostitutivo model contiene modelName e deploymentId. Deserializzare l'oggetto annidato model per i record di attività basati su modello.

  • McpServerTool.inclusionMode viene rimosso. Per ogni elemento tools del server MCP, mappare reranked a always e resultsProcessing: "rerank" a resultsProcessing: "none". Se omesso, resultsProcessing viene impostato su rerank; none esclude il riordinamento e preserva l'ordine originale dei risultati.

  • I nuovi parametri dell'elenco modificano l'ordine dei parametri del metodo generato, ma non influiscono sull'associazione dei parametri REST. Esamina le chiamate posizionali dopo aver installato un pacchetto SDK che supporta 2026-08-01-preview. Preferisci argomenti con nome o opzioni se disponibili.

2026-05-01-anteprima

2026-05-01-preview aggiunge funzionalità di base di conoscenza, fonte di conoscenza e recupero in aggiunta a 2025-11-01-preview senza rimuovere le proprietà precedentemente salvate. Le basi di conoscenza esistenti e le fonti di conoscenza che hai creato nelle versioni di anteprima precedenti continuano a funzionare. Questa versione espone principalmente nuove funzionalità e ripristina alcuni limiti di sola anteprima.

Per esaminare la documentazione di riferimento dell'API REST per questa versione, selezionare il filtro della versione dell'API 2026-05-01-preview nella parte superiore della pagina.

Non sono presenti modifiche di rilievo tra 2025-11-01-preview e 2026-05-01-preview. Le richieste esistenti di destinazione 2025-11-01-preview continuano a funzionare quando si modifica la versione dell'API in 2026-05-01-preview.

Gli SDK linguistici forniti con la versione 2026-05-01-preview introducono modifiche alla struttura del codice che causano problemi a livello di SDK. Per la mappatura completa della struttura dell'SDK, vedi Aggiornare il codice e i client per 2026-05-01-preview.

01-04-2026

2026-04-01 è la prima versione dell'API stabile per il recupero agentico. Definisce un contratto di recupero estrativo minimo e rimuove le funzionalità di pianificazione e sintesi delle risposte basate su messaggi di anteprima.

Per esaminare la documentazione di riferimento dell'API REST per questa versione, selezionare il filtro della versione dell'API 2026-04-01 nella parte superiore della pagina.

Le modifiche seguenti influiscono sia sullo schema della Knowledge Base che sulla richiesta di recupero:

  • retrievalReasoningEffort viene rimosso. Le basi di conoscenza precedentemente configurate con il livello di ragionamento low o medium non sono compatibili con 2026-04-01 e devono essere ricreate.

  • outputMode viene rimosso. Il recupero restituisce contenuto con grounding estrattivo per impostazione predefinita. La sintesi delle risposte non è supportata.

Le modifiche seguenti influiscono solo sulla richiesta di recupero:

  • intents sostituisce messages.

  • alwaysQuerySource viene rimosso da knowledgeSourceParams.

  • maxOutputSize viene rinominato in maxOutputSizeInTokens.

  • Lo stato della conversazione non viene mantenuto tra le diverse richieste. Il modello a più turni basato su messages non è supportato.

La modifica seguente influisce su azureBlob e indexedOneLake fonti di conoscenza:

  • ingestionPermissionOptions viene rimosso da ingestionParameters. azureBlob e indexedOneLake le origini di conoscenza che includono questa proprietà devono essere ricreate senza di essa.

Nota

L'invio di campi rimossi restituisce un 400 Bad Request codice HTTP. La richiesta di recupero non elimina né ignora campi non più esistenti in questa versione.

2025-11-01-preview

Per esaminare la documentazione di riferimento dell'API REST per questa versione, selezionare il filtro della versione dell'API 2025-11-01-preview nella parte superiore della pagina.

  • L'agente dei contenuti viene rinominato knowledge base.

    Route precedente Nuova route
    /agents /knowledgebases
    /agents/agent-name /knowledgebases/knowledge-base-name
    /agents/agent-name/retrieve /knowledgebases/knowledge-base-name/retrieve

  • L'agente di knowledge base outputConfiguration viene rinominato in outputMode e modificato da un oggetto a un enumeratore di stringhe. Sono interessate diverse proprietà:

    • includeActivity viene spostato da outputConfiguration direttamente nella richiesta di recupero.
    • attemptFastPath in outputConfiguration viene rimosso completamente. La sostituzione è rappresentata dal nuovo minimal sforzo di ragionamento.

  • L'agente knowledge base (base) requestLimits viene rimosso. Le proprietà figlio di maxRuntimeInSeconds e maxOutputSize vengono spostate direttamente nella richiesta di recupero.

  • I parametri dell'agente di conoscenza di base knowledgeSources ora elencano solo i nomi delle fonti di conoscenza utilizzate da una base di conoscenza. Altre proprietà figlio che in precedenza erano incluse in knowledgeSources vengono spostate nelle proprietà knowledgeSourceParams della richiesta di recupero:

    • rerankerThreshold
    • alwaysQuerySource
    • includeReferenceSourceData
    • includeReferences

    La proprietà maxSubQueries non è più disponibile. La sua sostituzione è la nuova proprietà dello sforzo di ragionamento di recupero.

  • Richiesta di recupero dell'agente di informazioni: il record di attività semanticReranker viene sostituito con il tipo di record di attività agenticReasoning.

  • Fonti di conoscenza per entrambe azureBlob e searchIndex: le proprietà di primo livello per identity, embeddingModel, chatCompletionModel, disableImageVerbalization e ingestionSchedule ora fanno parte di un oggetto ingestionParameters nella fonte di conoscenza. Tutte le fonti di conoscenza che estraggono da un indice di ricerca hanno un oggetto ingestionParameters.

  • Solo per searchIndex le origini delle informazioni: sourceDataSelect viene rinominato in sourceDataFields e è una matrice che accetta fieldName e fieldToSearch.

2025-08-01-preview

Per esaminare la documentazione di riferimento dell'API REST per questa versione, selezionare il filtro della versione dell'API 2025-08-01-preview nella parte superiore della pagina.

  • Introduce le fonti delle informazioni come nuovo modo per definire le origini dati, supportando entrambi i tipi searchIndex (uno o più indici) e azureBlob. Per ulteriori informazioni, consulta Creare una fonte di conoscenza per l'indice di ricerca e Creare una fonte di conoscenza BLOB.

  • Richiede knowledgeSources anziché nelle definizioni dell'agente targetIndexes . Per la procedura di migrazione, vedere Come eseguire la migrazione.

  • Rimuove il supporto defaultMaxDocsForReranker. Questa proprietà esisteva in precedenza in targetIndexes, ma non esiste alcuna sostituzione in knowledgeSources.

Anteprima 2025-05-01

Questa versione dell'API introduce il recupero agentico e gli agenti della conoscenza. Ogni definizione dell'agente richiede una targetIndexes matrice che specifica un singolo indice e proprietà facoltative, ad esempio defaultRerankerThreshold e defaultIncludeReferenceSourceData.

Per esaminare la documentazione di riferimento dell'API REST per questa versione, selezionare il filtro della versione dell'API 2025-05-01-preview nella parte superiore della pagina.

Contenuto correlato

  • Ultimo aggiornamento: