Migración del código de recuperación de agentes a la versión más reciente

Nota

Búsqueda de Azure AI está disponible a través del portal de Azure, las API REST y los SDK de Azure. También respalda Foundry IQ, la capa de conocimiento administrada que transforma el contenido empresarial en bases de conocimiento reutilizables y compatibles con permisos para agentes en el portal de Microsoft Foundry.

Importante

Las características, funcionalidades o propiedades marcadas (versión preliminar) no están cubiertas por un contrato de nivel de servicio, no se recomiendan para cargas de trabajo de producción y pueden cambiar o restringirse antes de que estén disponibles con carácter general. Los términos de la versión preliminar Búsqueda de Azure AI se aplican a todas las funciones de vista previa, ya sea independiente o parte de una característica disponible con carácter general.

Si el código de recuperación agente tiene como destino una versión anterior de la API, en este artículo se explica cuándo y cómo migrar a una versión más reciente. También se describen los cambios importantes y no separados para todas las versiones de la API que admiten la recuperación de agentes.

Las instrucciones de migración están diseñadas para ayudarle a ejecutar una solución existente en una versión de API más reciente. Las instrucciones de este artículo le ayudarán a solucionar los cambios importantes en el nivel de API para que la aplicación se ejecute como antes. Para obtener ayuda con la adición de nuevas funcionalidades, comience con Novedades de Búsqueda de Azure AI.

Sugerencia

¿Usar un SDK de Azure en lugar de REST? Antes de actualizar el paquete y aplicar los cambios de migración pertinentes, compruebe el registro de cambios del lenguaje del SDK para confirmar la compatibilidad con la versión de la API de destino.

Cuándo migrar

La mayoría de las versiones que admiten la recuperación agente introdujeron cambios importantes. Puede seguir ejecutando código anterior sin cambios conservando el valor de la versión de la API, pero para beneficiarse de correcciones de errores, mejoras y funcionalidad más reciente, debe actualizar el código.

Si el código tiene como destino una versión preliminar, se recomienda migrar a la versión estable más reciente solo si el caso de uso es totalmente compatible con 2026-04-01. Si depende de la síntesis de respuestas, de un esfuerzo de razonamiento no mínimo o de mensajes de varios turnos, revise los cambios disruptivos y los que no lo son antes de decidir migrar. Esas funcionalidades permanecen en versión preliminar.

Antes de migrar

  • Para comprender el ámbito de los cambios, revise los cambios importantes y no disruptivos para cada versión.

  • La ruta de migración admitida es incremental. Si el código tiene como destino 2025-05-01-preview, primero migre a 2025-08-01-preview, continúe con cada versión posterior hasta que llegue a la versión de destino.

  • Para una migración en paralelo, cree objetos con nombre único que implementen los comportamientos de la versión anterior. Este enfoque conserva los objetos existentes mientras desarrolla y prueba los reemplazos. Si un objeto admite la actualización local, los pasos específicos de la versión indican esa opción.

  • Para cada objeto que migre, empiece por obtener la definición actual del servicio de búsqueda para que pueda revisar las propiedades existentes antes de especificar la nueva.

  • Elimine las versiones anteriores solo después de que la migración esté completamente probada e implementada.

Cómo migrar

En esta sección se describen los pasos de migración para las siguientes versiones de API:

2026-08-01-preview

Si va a migrar desde 2026-05-01-preview, puede migrar directamente a 2026-08-01-preview. Esta migración requiere actualizaciones en los orígenes de conocimiento de Work IQ, la paginación en listas, el procesamiento de respuestas, las herramientas del servidor MCP y las llamadas afectadas del cliente generado.

  1. Migrar fuentes de conocimiento de Work IQ
  2. Actualizar paginación de lista
  3. Actualización del procesamiento de la respuesta de recuperación
  4. Actualizar código y clientes

Migrar fuentes de conocimiento de Work IQ

Para migrar un origen de conocimiento de Work IQ a la nueva configuración de autenticación:

  1. Exporte su definición actual.

  2. Actualice el origen de conocimiento existente mediante orígenes de conocimiento: crear o actualizar o crear un reemplazo con un nombre único para una migración en paralelo.

  3. Use la versión de la 2026-08-01-preview API y configure workIQParameters.entraAppAuthentication. Las applicationId propiedades y federatedCredentialId son necesarias. La propiedad tenantId es opcional y, por defecto, corresponde al inquilino del servicio de búsqueda.

  4. Si ha creado un reemplazo, actualice cada base de conocimiento que haga referencia al origen de conocimiento anterior para usar el nombre de reemplazo.

  5. Actualice las solicitudes de recuperación para incluir la aserción del usuario en el encabezado x-ms-query-work-iq-source-authorization.

Para obtener información y ejemplos, consulte Creación de un origen de conocimiento de Work IQ (versión preliminar).

Actualizar paginación de lista

Para reemplazar la paginación basada en desplazamiento por paginación basada en cursores:

  1. Elimina $top, $skip y $count de las solicitudes de la lista de fuentes de conocimiento. Establezca pageSize de 1 a 3000 para controlar el tamaño de página. Si lo omite, el servicio elige el tamaño de página.

  2. Para filtrar por nombre, establezca search y searchType. El único valor admitido searchType es prefix, que también es el valor predeterminado. La siguiente solicitud devuelve hasta 100 orígenes de conocimiento cuyos nombres comienzan por 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. Si la respuesta contiene @odata.nextLink, envíe esa dirección URL exactamente como se devuelve. No analice ni modifique su estado de continuación.

Actualiza el procesamiento de la respuesta de recuperación

Para procesar las nuevas formas de referencia de Work IQ y actividades respaldadas por modelos:

  1. Quite las dependencias de attributions, WorkIQAttributiony seeMoreWebUrl. Lee los metadatos de la etiqueta de confidencialidad de searchSensitivityLabelInfo en la referencia de Work IQ.

  2. En los registros de actividad de planificación de consultas, generación de respuestas y resumen web, lea modelName y deploymentId del objeto anidado model. El objeto anidado y ambas propiedades son opcionales.

Los fragmentos siguientes muestran los cambios en la forma de respuesta.

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

En 2026-08-01-preview, los mismos fragmentos usan la siguiente forma:

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

Actualización de código y clientes para 2026-08-01-preview

Para completar la migración:

  1. En cada elemento del servidor MCP tools, reemplace inclusionMode por resultsProcessing. Asigne reranked a rerank y always a none. El valor predeterminado es rerank. El none valor omite el reranking y conserva el orden de resultados subyacente de la herramienta. Para la configuración, consulte Configurar herramientas para una fuente de conocimiento de servidor MCP.

  2. Si usa un SDK de Azure, instale un paquete que admita 2026-08-01-previewy revise las llamadas de lista posicional para los cambios en el orden de los parámetros. Quienes realizan llamadas REST no se ven afectados porque los parámetros HTTP se identifican por nombre. En C#, prefiera argumentos con nombre, como GetKnowledgeSourcesAsync(search: ..., pageSize: ...). En Python, pase las opciones de lista como argumentos de palabra clave.

  3. Pruebe la autenticación y las referencias de Work IQ, la paginación de cursores, la deserialización de registros de actividad, el orden de resultados del servidor MCP y las llamadas de cliente generadas antes de actualizar la producción.

  4. Si ha creado orígenes de conocimiento de Work IQ sustitutivos, elimine los orígenes anteriores solo después de que la migración supere todas las pruebas, haya implementado la aplicación actualizada y ninguna base de conocimiento haga referencia a los nombres anteriores.

versión preliminar del 2026-05-01

Si va a migrar de 2026-04-01 o 2025-11-01-preview, puede pasar directamente a 2026-05-01-preview. Las solicitudes, las respuestas y los objetos persistentes de esas versiones siguen siendo compatibles. Las diferencias son las características aditivas y el cambio de nombre del SDK de lenguaje.

  1. Actualice la versión de la API a 2026-05-01-preview en las solicitudes REST. Los clientes del SDK usan la versión de API predeterminada del paquete, por lo que no es necesario pasar un argumento explícito serviceVersion . En su lugar, actualice al paquete del 2026-05-01-preview SDK.

  2. Si usa la Python o el SDK de JavaScript, actualice el cliente de recuperación para KnowledgeBaseRetrievalClient y llame a retrieve(...) en lugar del retrieveKnowledge(...) heredado. Para obtener la asignación completa de formas del SDK, consulte Actualización de código y clientes para 2026-05-01-preview.

  3. (Opcional) Adopta las nuevas 2026-05-01-preview funciones, como la búsqueda basada en la actualidad, los límites de documentos por fuente y en el resultado final, los valores predeterminados de búsqueda guardados, CORS para la base de conocimiento y los metadatos de etiquetas de confidencialidad de Purview en las respuestas de búsqueda. Ninguna de estas características es necesaria para mantener una solución existente en funcionamiento.

Actualizar código y clientes para 2026-05-01-preview

Los 2026-05-01-preview SDK presentan cambios de forma de código en los idiomas admitidos:

Language Actualizaciones de migración
Python Cree el cliente de recuperación como KnowledgeBaseRetrievalClient(endpoint=..., credential=..., knowledge_base_name=...). Cree instancias de esfuerzo de razonamiento como KnowledgeRetrievalLowReasoningEffort() y pase la cadena output_mode="answerSynthesis" en la base de conocimiento o recupere la solicitud. Pase AzureOpenAIVectorizerParameters(resource_url=...) (cuyo nombre anterior era resource_uri), usando el punto de conexión raíz del recurso en lugar de un punto de conexión /openai/v1.
.NET Cree el cliente de recuperación como new KnowledgeBaseRetrievalClient(endpoint, knowledgeBaseName, credential) y pase una AzureKeyCredential o una credencial de token. Para adjuntar un modelo de OpenAI basado en claves Azure a una base de conocimiento, establezca la clave de API del modelo en AzureOpenAIVectorizerParameters.ApiKey.
Java Use KnowledgeBaseRetrievalClientBuilder para crear el cliente de recuperación y leer los resultados como KnowledgeBaseRetrievalResult. KnowledgeBaseRetrievalOptions ahora expone setMessages(...) junto con setIntents(...), además de setRetrievalReasoningEffort, setOutputMode, setMaxOutputSize y setMaxOutputDocuments, por lo que la recuperación basada en mensajes y la síntesis de respuestas funcionan sin una solución alternativa basada en la intención semántica. KnowledgeBase agrega setOutputMode, setRetrievalReasoningEffort, setRetrievalInstructions, setAnswerInstructionsy setCorsOptions. SearchIndexKnowledgeSourceParams agrega setAlwaysQuerySource, setFailOnError, setMaxOutputDocumentsy setEnableImageServing.
JavaScript y TypeScript Utilice KnowledgeRetrievalClient.retrieve({ intents: [{ type: "semantic", search: query }] }). El método anterior retrieveKnowledge(...) se quita en favor de retrieve(...).

Después de actualizar las formas de cliente, ejecute el flujo completo que crea el índice, carga documentos, crea un origen de conocimiento, crea una base de conocimiento, emite una solicitud de recuperación y limpia los recursos para confirmar la migración de un extremo a otro.

01-04-2026

Si está migrando desde 2025-11-01-preview, puede hacerlo directamente a 2026-04-01. El índice y el contenido permanecen sin cambios. Solo tiene que actualizar el esquema de la base de conocimiento y la forma de solicitud de recuperación.

  1. Migración de orígenes de conocimiento
  2. Migración de la base de conocimiento
  3. Actualización de la solicitud de recuperación
  4. Actualización del consentimiento de facturación
  5. Actualizar código y clientes

Migración de orígenes de conocimiento

En 2026-04-01, los tipos de origen de conocimiento searchIndex, azureBlob, indexedOneLake y web están disponibles con carácter general. Otros tipos de origen de conocimiento permanecen en versión preliminar.

  1. Usar Orígenes de Conocimiento - Obtener (API REST) para obtener la definición actual.

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

  2. En la respuesta, identifique qué llevar a cabo y qué quitar:

    • Para searchIndex y web, transfiera todos los valores de propiedad.

    • Para azureBlob y indexedOneLake, traslade todos los valores de las propiedades, pero omita ingestionPermissionOptions de ingestionParameters. Esta propiedad no se admite en 2026-04-01.

  3. Usar orígenes de conocimiento: crear o actualizar (API REST) para crear un nuevo origen de conocimiento con un nombre único, la versión de la 2026-04-01 API y los valores de propiedad del paso anterior.

    En el ejemplo siguiente se muestra un searchIndex origen de conocimiento. Utilice un patrón similar para azureBlob, indexedOneLake y web los orígenes de conocimiento.

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

Migración de la base de conocimiento

La 2026-04-01 base de conocimiento tiene un esquema más sencillo que la 2025-11-01-preview versión: mantiene knowledgeSources y quita la configuración de generación de respuestas. Revise la definición actual antes de crear un nuevo objeto.

  1. Use Knowledge Base - Get (API REST) para obtener la definición actual.

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

  2. En la respuesta, identifique qué llevar a cabo y qué quitar:

    • Anote las knowledgeSources referencias. Lleve estos elementos a la nueva base de conocimiento.

    • Si está presente, quite outputMode, answerInstructions y retrievalInstructions. Estas propiedades no se admiten en 2026-04-01.

    • Si la base de conocimiento usa un web origen de conocimiento, mantenga models. La recuperación web requiere resumen respaldado por modelos. Para todos los demás tipos de fuente de conocimiento, elimine models.

  3. Use Knowledge Base- Create Or Update (API REST) para crear una nueva base de conocimiento con un nombre único, la versión de la 2026-04-01 API y solo las propiedades admitidas.

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

Actualización de la solicitud de recuperación

La 2026-04-01 solicitud de recuperación tiene una forma diferente a la versión preliminar:

  • Use intents en lugar de messages.

  • Use maxOutputSizeInTokens en lugar de maxOutputSize.

  • Si está presente, quite retrievalReasoningEffort y alwaysQuerySource. Estos parámetros no se admiten en 2026-04-01.

  • Para preguntas de seguimiento, envíe una nueva solicitud de recuperación con una nueva intención semántica. 2026-04-01 no mantiene una transcripción de mensajes en ejecución.

Para probar el resultado de la base de conocimiento con una consulta, utilice la versión 2026-04-01 de Knowledge Retrieval - Retrieve (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
}

Si la respuesta tiene un 200 OK código HTTP, la base de conocimiento recuperó correctamente el contenido del origen de conocimiento.

A partir de la versión de la 2026-04-01 API, el consentimiento de facturación de recuperación agente se controla mediante una propiedad dedicada knowledgeRetrieval independiente de semanticSearch, que ahora solo se aplica a la facturación del clasificador semántico. knowledgeRetrieval es una propiedad del plano de administración, por lo que la establece mediante la API REST de administración de búsqueda, no la API REST del servicio de búsqueda.

Use la versión preliminar más reciente de Services - Create Or Update (API REST) para establecer knowledgeRetrieval en el servicio de búsqueda.

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

Para obtener los valores válidos y los detalles de facturación, consulte Habilitación o deshabilitación de la facturación de recuperación mediante agente.

Actualizaciones de código y clientes para 2026-04-01

Para completar la migración:

  1. Actualice las llamadas de cliente para usar la versión de la 2026-04-01 API.

  2. Actualice los nombres de origen de conocimiento o base de conocimiento codificados de forma rígida en el código para hacer referencia a los nuevos objetos creados durante la migración.

  3. Si ha migrado orígenes de conocimientos azureBlobindexedOneLake, actualice cualquier código o script que haga referencia al índice, indexador, origen de datos o conjunto de aptitudes asociado por nombre para que apunten a los nuevos objetos.

  4. Actualice el código que procesa las respuestas de recuperación. Las respuestas devuelven contenido de base extractivo con activity y references, no respuestas sintetizadas.

  5. Elimine los objetos de vista previa solo después de que los nuevos objetos estén totalmente validados e implementados.

2025-11-01-vista previa

Si va a migrar de 2025-08-01-preview, se cambia el nombre de "knowledge agent" a "knowledge base" y se reubican varias propiedades en distintos objetos y niveles dentro de una definición de objeto.

  1. Actualizar orígenes de conocimiento de searchIndex
  2. Actualización de orígenes de conocimiento de azureBlob
  3. Reemplazo del agente de conocimiento por knowledge base
  4. Actualizar la solicitud de recuperación y enviar una consulta para probar las actualizaciones
  5. Actualización del código de cliente

Actualización de un origen de conocimiento searchIndex

Este procedimiento crea un nuevo 2025-11-01-previewsearchIndex origen de conocimiento en el mismo nivel funcional que la versión anterior 2025-08-01 . El propio índice subyacente no requiere actualizaciones.

  1. Enumere todas las fuentes de conocimiento por nombre para encontrar su fuente de conocimiento.

    ### 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. Obtenga la definición actual para revisar las propiedades existentes.

    ### 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 respuesta debe ser similar al ejemplo siguiente.

    {
     "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. Formule una solicitud Crear origen de conocimiento como base para la migración.

    Comience con el 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"
  }
}

    Realice las siguientes actualizaciones para una 2025-11-01-preview migración:

    • Asigne un nuevo nombre al origen de conocimiento.

    • Cambie la versión de la API a 2025-11-01-preview.

    • Cambie el nombre sourceDataSelect a sourceDataFields y cambie la cadena a una matriz con pares nombre-valor para cada campo recuperable que desee consultar. Estos son los campos que se van a devolver en los resultados de búsqueda, similares a una select cláusula de una consulta clásica.

  4. Revise las actualizaciones y envíe la solicitud para crear el objeto.

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

Ahora dispone de una fuente de conocimiento migrada searchIndex retrocompatible con la versión anterior, utilizando las especificaciones de propiedad correctas para 2025-11-01-preview.

La respuesta incluye la definición completa del nuevo objeto. Para obtener más información sobre las nuevas propiedades disponibles para este tipo de origen de conocimiento, que ahora puede hacer a través de las actualizaciones, consulte Creación de un origen de conocimiento de índice de búsqueda.

Actualización de un origen de conocimiento de AzureBlob

Este procedimiento crea un nuevo 2025-11-01-previewazureBlob origen de conocimiento en el mismo nivel funcional que la versión anterior 2025-08-01 . Crea un nuevo conjunto de objetos generados: origen de datos, conjunto de aptitudes, indexador, índice.

  1. Enumere todas las fuentes de conocimiento por nombre para encontrar su fuente de conocimiento.

    ### 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. Obtenga la definición actual para revisar las propiedades existentes.

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

    Si el flujo de trabajo incluye un modelo, la respuesta debe ser similar al ejemplo siguiente. Observe que una respuesta incluye los nombres de los objetos generados. Estos objetos son totalmente independientes del origen de conocimiento y permanecen operativos incluso si actualiza o elimina su origen de conocimiento.

     {
   "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. Formule una solicitud Crear origen de conocimiento como base para la migración.

    Comience con el 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
  }
}

    Realice las siguientes actualizaciones para una 2025-11-01-preview migración:

    • Asigne un nuevo nombre al origen de conocimiento.

    • Cambie la versión de la API a 2025-11-01-preview.

    • Agregue ingestionParameters como contenedor para las siguientes propiedades secundarias: "embeddingModel", "chatCompletionModel", "ingestionSchedule", "contentExtractionMode".

  4. Revise las actualizaciones y envíe la solicitud para crear el objeto. Los nuevos objetos generados se crean para la canalización del indexador.

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

Ahora dispone de una fuente de conocimiento migrada azureBlob retrocompatible con la versión anterior, utilizando las especificaciones de propiedad correctas para 2025-11-01-preview.

La respuesta incluye la definición completa del nuevo objeto. Para más información sobre las nuevas propiedades disponibles para este tipo de origen de conocimiento, que ahora puede realizar a través de las actualizaciones, consulte Creación de un origen de conocimiento de blobs.

Reemplazo del agente de conocimiento por knowledge base

  1. Las bases de conocimiento requieren un origen de conocimiento. Asegúrese de tener una fuente de conocimiento que apunte a 2025-11-01-preview antes de empezar.

  2. Obtenga la definición actual para revisar las propiedades existentes.

    ### 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 respuesta debe ser similar al ejemplo siguiente.

    {
  "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. Formule una solicitud Crear base de conocimiento como base para la migración.

    Comience con el 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"
    }
}

    Realice las siguientes actualizaciones para una 2025-11-01-preview migración:

    • Reemplace el endpoint: /knowledgebases/{{knowledge-base-name}}. Asigne un nombre único a la base de conocimiento.

    • Cambie la versión de la API a 2025-11-01-preview.

    • Elimine requestLimits. Las propiedades maxRuntimeInSeconds y maxOutputSize ahora se especifican directamente en la solicitud de recuperación.

    • Actualizar knowledgeSources:

    • Mueva alwaysQuerySource, includeReferenceSourceData, includeReferencesy rerankerThreshold a la knowledgeSourceParams sección de una acción de recuperación.

    • No hay cambios para models.

    • Actualizar outputConfiguration:

      • Reemplace outputConfiguration con outputMode.

      • Elimine attemptFastPath. Ya no existe. El comportamiento equivalente se implementa mediante retrievalReasoningEffort configurado al mínimo (consulte Configurar el esfuerzo de razonamiento de recuperación (versión preliminar)).

      • Si la modalidad está establecida en answerSynthesis, asegúrese de establecer el esfuerzo de razonamiento para la recuperación en bajo (valor predeterminado) o medio.

    • Agregue ingestionParameters como requisito para crear un 2025-11-01-preview origen de conocimiento de azureBlob.

  4. Revise las actualizaciones y envíe la solicitud para crear el objeto. Los nuevos objetos generados se crean para la canalización del indexador.

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

Ahora tienes una base de conocimientos en lugar de un agente de conocimientos, y el objeto es retrocompatible con la versión anterior.

La respuesta incluye la definición completa del nuevo objeto. Para obtener más información sobre las nuevas propiedades disponibles para una base de conocimiento, que ahora puede realizar a través de las actualizaciones, consulte Creación de una base de conocimiento.

Actualizar y probar la recuperación de actualizaciones de 2025-11-01-preview

La solicitud de recuperación se modifica para 2025-11-01-preview a fin de admitir más formatos, incluida una solicitud más sencilla que minimiza el procesamiento por parte del LLM. Para obtener más información sobre la recuperación en esta versión preliminar, consulte Recuperación de datos mediante una base de conocimiento. En esta sección se explica cómo actualizar el código.

  1. Cambie el endpoint de /agents/retrieve a /knowledgebases/retrieve.

  2. Cambie la versión de la API a 2025-11-01-preview.

  3. No es necesario realizar cambios en messages si utilizas el método de razonamiento de búsqueda low o medium. Sustituya messages por intents si utiliza el razonamiento de minimal (consulte Establecer el esfuerzo de razonamiento de recuperación (versión preliminar)).

  4. Modifique knowledgeSourceParams para incluir las propiedades que se quitaron del agente: rerankerThreshold, alwaysQuerySource, includeReferenceSourceData, . includeReferences

  5. Agregue retrievalReasoningEffort a minimum si estabas usando attemptFastPath. Si estaba usando maxSubQueries, ya no existe. Use la configuración retrievalReasoningEffort para especificar el procesamiento de subconsultas (consulte Configurar el esfuerzo de razonamiento de recuperación (versión preliminar)).

Para probar el resultado de su base de conocimiento con una consulta, utilice el 2025-11-01-preview de Recuperación de conocimiento - Recuperar (API REST).

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

Si la respuesta tiene un 200 OK código HTTP, la base de conocimiento recuperó correctamente el contenido del origen de conocimiento.

Actualización de código y clientes para 2025-11-01-preview

Para completar la migración, siga estos pasos de limpieza:

  1. Solo para fuentes de conocimientos de blobs, actualice los clientes para usar el nuevo índice. Si tiene código o script que ejecuta un indexador o hace referencia a un origen de datos, índice o conjunto de aptitudes, asegúrese de actualizar las referencias a los nuevos objetos.

  2. Reemplace todas las referencias de agente por knowledgeBases en archivos de configuración, código, scripts y pruebas.

  3. Actualice las llamadas del cliente para usar 2025-11-01-preview.

  4. Borre o regenere las definiciones almacenadas en caché que se crearon con las formas antiguas.

2025-08-01-preview

Si ha creado un agente de conocimiento utilizando 2025-05-01-preview, la definición de su agente incluye una matriz en línea targetIndexes y una propiedad opcional defaultMaxDocsForReranker.

A partir de la versión de API 2025-08-01-preview, las fuentes de conocimiento reutilizables sustituyen a targetIndexes y defaultMaxDocsForReranker ya no es compatible. Estos cambios importantes requieren que:

  1. Obtención de la configuración actual targetIndexes
  2. Creación de un origen de conocimiento equivalente
  3. Actualizar el agente para usar knowledgeSources en lugar de targetIndexes
  4. Envío de una consulta para probar la recuperación
  5. Eliminación de código que usa targetIndexes y actualiza clientes

Obtención de la configuración actual

Para recuperar la definición de su agente, utilice el 2025-05-01-preview de Agentes de conocimiento - Obtener (API REST).

@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 respuesta debe ser similar al ejemplo siguiente. Copie los indexNamevalores , defaultRerankerThresholdy defaultIncludeReferenceSourceData para usarlos en los próximos pasos. defaultMaxDocsForReranker está en desuso, por lo que puede omitir su valor.

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

Creación de un origen de conocimiento

Para crear un searchIndex origen de conocimiento, use el 2025-08-01-preview de Orígenes de conocimiento : creación (API REST). Establezca searchIndexName en el valor que copió anteriormente.

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

En el ejemplo anterior se crea un origen de conocimiento que representa un índice, pero puede tener como destino varios índices o un blob de Azure. Para obtener más información, consulte Creación de un origen de conocimiento.

Actualización del agente

Para reemplazar targetIndexes por knowledgeSources en la definición de su agente, use el valor 2025-08-01-preview de Agentes de conocimiento: crear o actualizar (API REST). Establezca rerankerThreshold y includeReferenceSourceData en los valores que copió anteriormente.

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

En el ejemplo anterior se actualiza la definición para hacer referencia a un origen de conocimiento, pero puede tener como destino varios orígenes de conocimiento. También puede usar otras propiedades para controlar el comportamiento de recuperación, como alwaysQuerySource. Para obtener más información, consulte Creación de un agente de conocimiento.

Probar las actualizaciones para 2025-08-01-preview

Para probar la salida de su agente con una consulta, utilice el 2025-08-01-preview de Recuperación de conocimiento - Recuperar (API REST).

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

Si la respuesta tiene un 200 OK código HTTP, el agente recuperó correctamente el contenido del origen de conocimiento.

Actualización de código y clientes para 2025-08-01-preview

Para completar la migración, siga estos pasos de limpieza:

  • Reemplace todas las targetIndexes referencias por knowledgeSources en archivos de configuración, código, scripts y pruebas.
  • Actualice las llamadas del cliente para usar 2025-08-01-preview.
  • Borre o regenere las definiciones de agente almacenadas en caché que se crearon con la forma antigua.

Cambios específicos de la versión

Esta sección aborda los cambios que rompen la compatibilidad y los que no para las siguientes versiones de la API:

2026-08-01-preview

La 2026-08-01-preview versión se basa en 2026-05-01-preview e incluye cambios importantes en las aplicaciones que usan orígenes de conocimiento de Work IQ, paginación de listas basadas en desplazamiento, registros de actividad respaldados por modelos, procesamiento de resultados del servidor MCP o llamadas de cliente generadas posicionales.

Para revisar la documentación de referencia de la API REST para esta versión, seleccione el 2026-08-01-preview filtro de versión de API en la parte superior de la página.

  • workIQParameters es necesario en un origen de conocimiento de Work IQ y debe contener entraAppAuthentication. Actualice el código fuente in situ o cree un sustituto para una migración en paralelo. Pase la aserción de usuario en el x-ms-query-work-iq-source-authorization encabezado en las solicitudes de recuperación.

  • Las referencias de Work IQ eliminan attributions, la forma WorkIQAttribution y seeMoreWebUrl. La referencia rediseñada expone searchSensitivityLabelInfo. Quite las dependencias de los campos eliminados y actualice el procesamiento de referencia para la nueva forma de etiqueta de confidencialidad.

  • Se han eliminado los parámetros $top, $skip y $count, que eran solo de vista previa. Las operaciones de lista de recopilación usan search, pageSizey searchType. Las respuestas utilizan @odata.nextLink para la paginación continua. Actualice las solicitudes de lista y siga cada @odata.nextLink exactamente tal y como se devuelve.

  • Los registros de actividad de planificación de consultas, de síntesis de respuestas y de resumen de la web eliminan el escalar modelName. El objeto de reemplazo model contiene modelName y deploymentId. Deserialice el objeto anidado model para los registros de actividad basados en modelos.

  • McpServerTool.inclusionMode se quita. En cada elemento de servidor tools MCP, asigne reranked a resultsProcessing: "rerank" y always a resultsProcessing: "none". Si se omite, resultsProcessing toma como valor predeterminado rerank; none omite la reclasificación y conserva el orden subyacente de los resultados.

  • Los nuevos parámetros de lista cambian el orden de los parámetros del método generado, pero no afectan al enlace de parámetros REST. Revise las llamadas posicionales después de instalar un paquete de SDK que admita 2026-08-01-preview. Se prefieren argumentos o opciones con nombre cuando estén disponibles.

versión preliminar del 2026-05-01

2026-05-01-preview agrega funciones de base de conocimiento, origen de conocimiento y recuperación a 2025-11-01-preview sin eliminar las propiedades conservadas previamente. Las bases de conocimiento y los orígenes de conocimiento existentes que creó en versiones preliminares anteriores siguen funcionando. Esta versión expone principalmente nuevas funcionalidades y revierte algunos límites de solo versión preliminar.

Para revisar la documentación de referencia de la API REST para esta versión, seleccione el 2026-05-01-preview filtro de versión de API en la parte superior de la página.

No hay cambios importantes entre 2025-11-01-preview y 2026-05-01-preview. Las solicitudes existentes que tienen como destino 2025-11-01-preview siguen funcionando al cambiar la versión de la API a 2026-05-01-preview.

Los SDK de lenguaje que incluyen 2026-05-01-preview introducen cambios en la estructura del código que provocan incompatibilidades en la capa del SDK. Consulte Actualizar código y clientes para 2026-05-01-preview para la asignación completa de formas del SDK.

01-04-2026

2026-04-01 es la primera versión estable de la API para la recuperación agéntica. Establece un contrato de recuperación mínimo y extractivo, y elimina las capacidades de planificación de consultas basadas en mensajes y de síntesis de respuestas propias de la etapa de la versión preliminar.

Para revisar la documentación de referencia de la API REST para esta versión, seleccione el 2026-04-01 filtro de versión de API en la parte superior de la página.

Los cambios siguientes afectan tanto al esquema de la base de conocimiento como a la solicitud de recuperación:

  • retrievalReasoningEffort se quita. Las bases de conocimiento configuradas anteriormente con un esfuerzo de razonamiento low o medium no son compatibles con 2026-04-01 y deben recrearse.

  • outputMode se quita. Por defecto, la recuperación devuelve contenido fundamentado extractivo. No se admite la síntesis de respuestas.

Los cambios siguientes afectan solo a la solicitud de recuperación:

  • intentsreemplaza a messages.

  • alwaysQuerySource se quita de knowledgeSourceParams.

  • maxOutputSize se cambia el nombre a maxOutputSizeInTokens.

  • El estado conversacional no se mantiene entre las solicitudes. El patrón multiturno basado en messages no se admite.

El siguiente cambio afecta a las fuentes de conocimiento azureBlob y indexedOneLake.

  • ingestionPermissionOptions se quita de ingestionParameters. Los orígenes de conocimientos azureBlob y indexedOneLake que incluyen esta propiedad deben volver a crearse sin ella.

Nota

El envío de campos eliminados devuelve un 400 Bad Request código HTTP. La solicitud de recuperación no quita ni tolera campos que ya no existen en esta versión.

2025-11-01-vista previa

Para revisar la documentación de referencia de la API REST para esta versión, seleccione el 2025-11-01-preview filtro de versión de API en la parte superior de la página.

  • Se cambia el nombre del agente de conocimiento a la base de conocimiento.

    Ruta anterior Nueva ruta
    /agents /knowledgebases
    /agents/agent-name /knowledgebases/knowledge-base-name
    /agents/agent-name/retrieve /knowledgebases/knowledge-base-name/retrieve

  • Se cambia el nombre del agente de conocimiento (base) outputConfiguration a outputMode y se cambia de un objeto a un enumerador de cadenas. Varias propiedades se ven afectadas:

    • includeActivity se mueve desde outputConfiguration directamente a la solicitud de recuperación.
    • attemptFastPath en outputConfiguration se elimina completamente. El nuevo esfuerzo de razonamiento de minimal es el reemplazo.

  • Se ha eliminado el agente de conocimiento (base) requestLimits. Las propiedades secundarias de maxRuntimeInSeconds y maxOutputSize se trasladan directamente a la solicitud de recuperación.

  • Los parámetros del agente de conocimiento (base) knowledgeSources ahora solo muestran los nombres del origen de conocimiento que usa una base de conocimiento. Otras propiedades secundarias que antes estaban en knowledgeSources se trasladan a las propiedades knowledgeSourceParams de la solicitud de recuperación:

    • rerankerThreshold
    • alwaysQuerySource
    • includeReferenceSourceData
    • includeReferences

    La propiedad maxSubQueries se ha eliminado. Su sustitución es la nueva propiedad de esfuerzo en razonamiento para recuperación de datos.

  • Solicitud de recuperación del agente de conocimiento (base): el registro de actividad semanticReranker se sustituye por el tipo de registro de actividad agenticReasoning.

  • Orígenes de conocimiento para azureBlob y searchIndex: propiedades de nivel superior para identity, embeddingModel, chatCompletionModel, disableImageVerbalization y ingestionSchedule son ahora parte de un objeto ingestionParameters en la fuente de conocimiento. Todas las fuentes de conocimiento que extraen de un índice de búsqueda tienen un objeto ingestionParameters.

  • Solo para fuentes de conocimiento searchIndex: sourceDataSelect se renombra a sourceDataFields y es una matriz que acepta fieldName y fieldToSearch.

2025-08-01-preview

Para revisar la documentación de referencia de la API REST para esta versión, seleccione el 2025-08-01-preview filtro de versión de API en la parte superior de la página.

  • Presenta las fuentes de conocimiento como la nueva forma de definir fuentes de datos, que admiten tanto searchIndex (uno o varios índices) como azureBlob tipos. Para obtener más información, consulte Creación de un origen de conocimiento de índice de búsqueda y Creación de un origen de conocimiento de blobs.

  • Requiere knowledgeSources en lugar de targetIndexes en definiciones de agente. Para conocer los pasos de migración, consulte Migración.

  • Quita la compatibilidad defaultMaxDocsForReranker. Esta propiedad existía anteriormente en targetIndexes, pero no hay ningún reemplazo en knowledgeSources.

2025-05-01-preview

Esta versión de la API incorpora recuperación agéntica y agentes de conocimiento. Cada definición de agente requiere una targetIndexes matriz que especifique un único índice y propiedades opcionales, como defaultRerankerThreshold y defaultIncludeReferenceSourceData.

Para revisar la documentación de referencia de la API REST para esta versión, seleccione el 2025-05-01-preview filtro de versión de API en la parte superior de la página.

Contenido relacionado

  • Last updated on