View a markdown version of this page

Versi konektor - Batu Dasar Amazon AgentCore
Perilaku pembuatan versiAlat Pencarian Web (pencarian web)Basis Pengetahuan Terkelola Amazon Bedrock (basis pengetahuan dasar)Contoh: pin versiSiklus hidup versiKompatibilitas mundur

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Versi konektor

Built-in konektor di Amazon Bedrock AgentCore Gateway menggunakan versi semantik (MAJOR.MINOR.PATCH). Anda dapat menyematkan target ke versi konektor tertentu atau membiarkannya menggunakan versi default konektor saat ini.

Perilaku pembuatan versi

Tabel berikut menjelaskan bagaimana Gateway menyelesaikan versi konektor saat Anda membuat atau memperbarui target.

Skenario Perilaku

Buat dengan source.version

Target disematkan ke versi itu.

Buat tanpa source.version

Target mendapatkan versi default konektor saat ini.

Perbarui dengan source.version

Target bergerak ke versi yang ditentukan.

Perbarui tanpa source.version

Target mempertahankan versi saat ini (lengket).

GetGatewayTarget

Jawaban termasuk yang diselesaikansource.version.

Versi default: 1.1.0

Versi Dirilis Perubahan

1.2.0

2026-07-20

Agent-side filter tingkat permintaan: domain menyertakan dan mengecualikan daftar (hingga 100 domain per daftar) dan pemfilteran rentang tanggal publikasi (UTC). ISO-8601

1.1.0

2026-06-15

Ditambahkan structuredContent dalam hasil alat; publishedDate bidang ditambahkan; ekstraksi cuplikan yang ditingkatkan.

Basis Pengetahuan Terkelola Amazon Bedrock (basis pengetahuan dasar)

Versi default: 1.0.0

Versi Dirilis Perubahan

1.0.0

2026-04-01

Rilis awal — Retrieve dan AgenticRetrieveStream operasi.

Contoh: pin versi

Untuk menyematkan target ke versi konektor tertentu, sertakan source.version dalam konfigurasi target:

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

Jika Anda menentukan versi yang tidak ada, API mengembalikan ValidationException yang mencantumkan versi yang tersedia.

Siklus hidup versi

Setiap versi konektor bergerak melalui tahapan berikut:

Stage Deskripsi

Available

Anda dapat memilih versi ini untuk target baru atau yang diperbarui.

Default

Ditugaskan saat Anda menghilangkansource.version.

Usang

Bekerja untuk target yang ada tetapi tidak direkomendasikan untuk yang baru.

Dipensiunkan

Tidak lagi tersedia untuk target baru. Target yang ada harus ditingkatkan.

Kompatibilitas mundur

Versi minor dan patch kompatibel ke belakang. Bidang baru pada skema input alat dan konfigurasi admin bersifat aditif.

Target yang ada menyimpan versi yang disematkan saat versi default konektor berubah. Untuk mengadopsi versi minor baru, perbarui target dengan yang barusource.version.

tools/listdapat mengekspos properti tambahan pada versi minor baru. Klien yang mengurai skema secara ketat harus mentolerir properti yang tidak diketahui.

Admin-side kunci konfigurasi divalidasi terhadap versi konektor target. Meneruskan kunci yang tidak dikenali versi yang disematkan mengembalikan ValidationException saat pembuatan atau pembaruan target.

Benjolan versi utama menunjukkan perubahan yang merusak dan menyertakan panduan migrasi.