View a markdown version of this page

Versioni del connettore - Fondamento Amazon AgentCore
Comportamento del controllo delle versioniStrumento di ricerca sul Web (ricerca sul Web)Knowledge Base gestite da Amazon Bedrock (basi di conoscenza di base) Esempio: aggiungi una versioneCiclo di vita delle versioniCompatibilità con le versioni precedenti

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Versioni del connettore

Built-in i connettori su Amazon Bedrock AgentCore Gateway utilizzano il versionamento semantico (). MAJOR.MINOR.PATCH Puoi collegare un target a una versione specifica del connettore o lasciare che utilizzi la versione predefinita corrente del connettore.

Comportamento del controllo delle versioni

La tabella seguente descrive come il Gateway risolve le versioni dei connettori quando si crea o si aggiorna una destinazione.

Scenario Comportamento

Crea con source.version

Target è associato a quella versione.

Crea senza source.version

Target ottiene la versione predefinita corrente del connettore.

Aggiorna con source.version

Target passa alla versione specificata.

Aggiornamento senza source.version

Target mantiene la sua versione attuale (permanente).

GetGatewayTarget

La risposta include i risoltisource.version.

Versione predefinita: 1.1.0

Versione Released Modifiche

1.2.0

2026-07-20

Agent-side filtri a livello di richiesta: elenchi di inclusione ed esclusione dei domini (fino a 100 domini per elenco) e filtro per intervalli di date di pubblicazione (UTC). ISO-8601

1.1.0

15/06/2020

Aggiunto structuredContent nei risultati dello strumento; aggiunto publishedDate campo; migliore estrazione degli snippet.

Knowledge Base gestite da Amazon Bedrock (basi di conoscenza di base)

Versione predefinita: 1.0.0

Versione Released Modifiche

1.0.0

2026-04-01

Versione iniziale e operazioni. Retrieve AgenticRetrieveStream

Esempio: aggiungi una versione

Per aggiungere una destinazione a una versione specifica del connettore, includi source.version nella configurazione della destinazione:

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

Se specifichi una versione che non esiste, l'API restituisce una ValidationException lista delle versioni disponibili.

Ciclo di vita delle versioni

Ogni versione del connettore passa attraverso le seguenti fasi:

Fase Description

Disponibilità

È possibile selezionare questa versione per destinazioni nuove o aggiornate.

Predefinita

Assegnato quando si omette. source.version

Deprecated

Funziona per obiettivi esistenti ma non è consigliato per obiettivi nuovi.

Ritirata

Non più disponibile per nuovi obiettivi. Gli obiettivi esistenti devono essere aggiornati.

Compatibilità con le versioni precedenti

Le versioni secondarie e le patch sono compatibili con le versioni precedenti. I nuovi campi nello schema di input dello strumento e nella configurazione dell'amministratore sono aggiuntivi.

Le destinazioni esistenti mantengono la loro versione bloccata quando viene modificata la versione predefinita del connettore. Per adottare una nuova versione secondaria, aggiorna il target con la nuovasource.version.

tools/listpuò esporre proprietà aggiuntive su nuove versioni secondarie. I client che analizzano rigorosamente lo schema devono tollerare proprietà sconosciute.

Admin-side le chiavi di configurazione vengono convalidate rispetto alla versione del connettore di destinazione. Il passaggio di una chiave che la versione bloccata non riconosce restituisce un valore ValidationException al momento della creazione o dell'aggiornamento della destinazione.

Un aumento importante della versione indica una modifica sostanziale e include una guida alla migrazione.