View a markdown version of this page

Versões do conector - Base da Amazônia AgentCore
Comportamento de versionamentoFerramenta de pesquisa na Web (pesquisa na web)Bases de conhecimento gerenciadas da Amazon Bedrock (bases de conhecimento básicas)Exemplo: fixar uma versãoCiclo de vida da versãoCompatibilidade retroativa

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

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 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 resolvidosource.version.

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)

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

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

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

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 novasource.version.

tools/listpode 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.