View a markdown version of this page

Versiones del conector - Base amazónica AgentCore
Comportamiento de control de versionesHerramienta de búsqueda en la web (búsqueda en la web)Bases de conocimiento administradas de Amazon Bedrock (bases de conocimiento fundamentales) Ejemplo: anclar una versiónCiclo de vida de la versiónCompatibilidad con versiones anteriores

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Versiones del conector

Built-in los conectores de Amazon Bedrock AgentCore Gateway utilizan el control de versiones semántico (). MAJOR.MINOR.PATCH Puede anclar un destino a una versión de conector específica o dejar que utilice la versión predeterminada actual del conector.

Comportamiento de control de versiones

En la tabla siguiente se describe cómo la puerta de enlace resuelve las versiones de los conectores al crear o actualizar un destino.

Escenario Comportamiento

Crear con source.version

Target está anclado a esa versión.

Crea sin source.version

Target obtiene la versión predeterminada actual del conector.

Actualice con source.version

Target pasa a la versión especificada.

Actualice sin source.version

Target conserva su versión actual (fija).

GetGatewayTarget

La respuesta incluye lo resueltosource.version.

Versión predeterminada: 1.1.0

Versión Released Cambios

1.2.0

2026-07-20

Agent-side filtros a nivel de solicitud: listas de inclusión y exclusión de dominios (hasta 100 dominios por lista) y filtrado por intervalo de fechas de publicación (UTC). ISO-8601

1.1.0

15 de junio de 2026

Se agregó a los resultados structuredContent de la herramienta; se agregó un publishedDate campo; se mejoró la extracción de fragmentos.

Bases de conocimiento administradas de Amazon Bedrock (bases de conocimiento fundamentales)

Versión predeterminada: 1.0.0

Versión Released Cambios

1.0.0

2026-04-01

Versión inicial y operaciones. Retrieve AgenticRetrieveStream

Ejemplo: anclar una versión

Para anclar un destino a una versión de conector específica, incluya source.version en la configuración del destino:

{
  "targetConfiguration": {
    "mcp": {
      "connector": {
        "source": {
          "connectorId": "web-search",
          "version": "1.1.0"
        }
      }
    }
  }
}

Si especificas una versión que no existe, la API devuelve una ValidationException que muestra las versiones disponibles.

Ciclo de vida de la versión

Cada versión del conector pasa por las siguientes etapas:

Etapa Description (Descripción)

Disponible

Puede seleccionar esta versión para destinos nuevos o actualizados.

Predeterminado

Se asigna cuando se omite. source.version

Obsoleto

Funciona para los objetivos existentes, pero no se recomienda para los nuevos.

Retired

Ya no está disponible para objetivos nuevos. Los objetivos existentes deben actualizarse.

Compatibilidad con versiones anteriores

Las versiones secundarias y de parche son compatibles con versiones anteriores. Los nuevos campos en el esquema de entrada de la herramienta y en la configuración administrativa son aditivos.

Los objetivos existentes mantienen su versión anclada cuando cambia la versión predeterminada del conector. Para adoptar una nueva versión secundaria, actualice el objetivo con la nuevasource.version.

tools/listpuede exponer propiedades adicionales en las nuevas versiones secundarias. Los clientes que analicen estrictamente el esquema deben tolerar las propiedades desconocidas.

Admin-side las claves de configuración se validan comparándolas con la versión del conector de destino. Si se pasa una clave que la versión anclada no reconoce, se obtiene una ValidationException al crearla o actualizarla.

Un cambio importante en la versión indica un cambio importante e incluye una guía de migración.