As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Versões do conector
<a name="gateway-target-connector-versions"></a>

Built-in os conectores no Amazon Bedrock AgentCore Gateway usam versionamento semântico (). `MAJOR.MINOR.PATCH` Você pode fixar um alvo em uma versão específica do conector ou permitir que ele use a versão padrão atual do conector.

## Comportamento de versionamento
<a name="gateway-target-connector-versions-behavior"></a>

A tabela a seguir descreve como o Gateway resolve as versões do conector quando você cria ou atualiza um alvo.


| Cenário | Comportamento | 
| --- | --- | 
| Criar com o `source.version`  | O alvo está fixado nessa versão. | 
| Crie sem `source.version`  | O Target obtém a versão padrão atual do conector. | 
| Atualizar com `source.version`  | O Target é movido para a versão especificada. | 
| Atualizar sem `source.version`  | O Target mantém sua versão atual (fixa). | 
|  `GetGatewayTarget`  | A resposta inclui o resolvido`source.version`. | 

## Ferramenta de pesquisa na Web (pesquisa `na web`)
<a name="gateway-target-connector-versions-web-search"></a>

 **Versão padrão: ** `1.1.0` 


| Versão | Liberado | Alterações | 
| --- | --- | --- | 
|  `1.2.0`  | 2026-07-20 | Agent-side filtros em nível de solicitação: listas de inclusão e exclusão de domínios (até 100 domínios por lista) e filtragem por intervalo de datas de publicação (UTC). ISO-8601  | 
|  `1.1.0`  | 2026-06-15 | Adicionado `structuredContent` nos resultados da ferramenta; `publishedDate` campo adicionado; extração aprimorada de trechos. | 

## Bases de conhecimento gerenciadas da Amazon `Bedrock` (bases de conhecimento básicas)
<a name="gateway-target-connector-versions-managed-kb"></a>

 **Versão padrão: ** `1.0.0` 


| Versão | Liberado | Alterações | 
| --- | --- | --- | 
|  `1.0.0`  | 2026-04-01 | Versão inicial — `Retrieve` e `AgenticRetrieveStream` operações. | 

## Exemplo: fixar uma versão
<a name="gateway-target-connector-versions-pin-example"></a>

Para fixar um alvo em uma versão específica do conector, inclua `source.version` na configuração de destino:

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

Se você especificar uma versão que não existe, a API retornará uma `ValidationException` lista das versões disponíveis.

## Ciclo de vida da versão
<a name="gateway-target-connector-versions-lifecycle"></a>

Cada versão do conector passa pelos seguintes estágios:


| Estágio | Description | 
| --- | --- | 
| Available (Disponível) | Você pode selecionar essa versão para destinos novos ou atualizados. | 
| Padrão | Atribuído quando você omite. `source.version` | 
| Preterido | Funciona para alvos existentes, mas não é recomendado para novos. | 
| Descontinuado | Não está mais disponível para novos alvos. Os alvos existentes devem ser atualizados. | 

## Compatibilidade retroativa
<a name="gateway-target-connector-versions-backward-compatibility"></a>

As versões secundárias e de patch são compatíveis com versões anteriores. Novos campos no esquema de entrada da ferramenta e na configuração administrativa são aditivos.

Os destinos existentes mantêm sua versão fixa quando a versão padrão do conector é alterada. Para adotar uma nova versão secundária, atualize o alvo com a nova`source.version`.

 `tools/list`pode expor propriedades adicionais em novas versões secundárias. Clientes que analisam estritamente o esquema devem tolerar propriedades desconhecidas.

Admin-side as chaves de configuração são validadas em relação à versão do conector de destino. Passar uma chave que a versão fixada não reconhece retorna uma criação ou atualização `ValidationException` no destino.

Um grande aumento na versão indica uma alteração significativa e inclui um guia de migração.