View a markdown version of this page

Versions du connecteur - Base rocheuse de l'Amazonie AgentCore
Comportement de gestion des versionsOutil de recherche sur le Web (recherche sur le Web)Bases de connaissances gérées Amazon Bedrock (bases de connaissances fondamentales)Exemple : épingler une versionCycle de vie des versionsRétrocompatibilité

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Versions du connecteur

Built-in les connecteurs d'Amazon Bedrock AgentCore Gateway utilisent le versionnement sémantique (). MAJOR.MINOR.PATCH Vous pouvez épingler une cible à une version de connecteur spécifique ou la laisser utiliser la version par défaut actuelle du connecteur.

Comportement de gestion des versions

Le tableau suivant décrit comment la passerelle résout les versions de connecteurs lorsque vous créez ou mettez à jour une cible.

Scénario Comportement

Création avec source.version

La cible est épinglée à cette version.

Créez sans source.version

Target obtient la version par défaut actuelle du connecteur.

Mettre à jour avec source.version

La cible passe à la version spécifiée.

Mettre à jour sans source.version

Target conserve sa version actuelle (sticky).

GetGatewayTarget

La réponse inclut la réponse résoluesource.version.

Version par défaut : 1.1.0

Version Libéré Modifications

1.2.0

20/07/2026

Agent-side filtres au niveau de la demande : listes d'inclusion et d'exclusion de domaines (jusqu'à 100 domaines par liste) et filtrage par plage de dates de publication (UTC). ISO-8601

1.1.0

15 juin 2026

Ajouté structuredContent dans les résultats de l'outil ; publishedDate champ ajouté ; extraction des extraits améliorée.

Bases de connaissances gérées Amazon Bedrock (bases de connaissances fondamentales)

Version par défaut : 1.0.0

Version Libéré Modifications

1.0.0

01/04/2026

Version initiale — Retrieve et AgenticRetrieveStream opérations.

Exemple : épingler une version

Pour associer une cible à une version de connecteur spécifique, incluez source.version dans la configuration de la cible :

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

Si vous spécifiez une version qui n'existe pas, l'API renvoie une ValidationException liste des versions disponibles.

Cycle de vie des versions

Chaque version de connecteur passe par les étapes suivantes :

Étape Description

Available

Vous pouvez sélectionner cette version pour les cibles nouvelles ou mises à jour.

Par défaut

Attribué lorsque vous omettezsource.version.

Obsolète

Fonctionne pour les cibles existantes mais n'est pas recommandé pour les nouvelles.

Hors service

N'est plus disponible pour les nouvelles cibles. Les cibles existantes doivent être améliorées.

Rétrocompatibilité

Les versions mineures et les patchs sont rétrocompatibles. Les nouveaux champs du schéma de saisie de l'outil et de la configuration administrative s'additionnent.

Les cibles existantes conservent leur version épinglée lorsque la version par défaut du connecteur change. Pour adopter une nouvelle version mineure, mettez à jour la cible avec la nouvellesource.version.

tools/listpeut exposer des propriétés supplémentaires sur les nouvelles versions mineures. Les clients qui analysent strictement le schéma doivent tolérer des propriétés inconnues.

Admin-side les clés de configuration sont validées par rapport à la version du connecteur de la cible. La transmission d'une clé que la version épinglée ne reconnaît pas renvoie une valeur lors de la création ou de la mise ValidationException à jour de la cible.

Un changement de version majeur indique une modification majeure et inclut un guide de migration.