View a markdown version of this page

Mode pemeliharaan Amazon Bedrock Agents Classic - Amazon Bedrock
Rencana migrasiMembandingkan kemampuanProsedur migrasiPertanyaan umumSumber daya tambahan

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

Mode pemeliharaan Amazon Bedrock Agents Classic

Amazon Bedrock Agents (diluncurkan November 2023) sekarang menjadi Amazon Bedrock Agents Classic dan tidak akan lagi terbuka untuk pelanggan baru mulai 30 Juli 2026. Untuk kemampuan yang mirip dengan Amazon Bedrock Agents Classic, jelajahi Amazon Bedrock AgentCore. Amazon Bedrock terus tersedia, tetapi layanan Agen Klasik akan berada dalam mode pemeliharaan.

Panduan ini memberikan informasi tentang opsi migrasi mode pemeliharaan untuk pelanggan Amazon Bedrock Agents Classic.

catatan

Amazon Bedrock terus didukung penuh. Hanya layanan Amazon Bedrock Agents Classic yang tidak lagi terbuka untuk pelanggan baru per 30 Juli 2026. Model, Pangkalan Pengetahuan, dan Pagar Pembatas Amazon Anda yang ada tidak terpengaruh.

Rencana migrasi

Kami menyarankan Anda memigrasikan beban kerja Amazon Bedrock Agents Classic Anda ke Amazon Bedrock. AgentCore AgentCore adalah platform untuk membangun, menghubungkan, dan mengoptimalkan agen AI. Harness terkelola di AgentCore menyediakan titik awal berbasis konfigurasi di mana pengembang dapat mendeklarasikan model, alat, dan instruksi agen. AgentCore menangani lingkungan, komputasi, memori, identitas, dan observabilitas.

Agen terkelola memanfaatkan AgentCore (disarankan)

Harness terkelola di AgentCore menyediakan titik awal berbasis konfigurasi di mana pembangun dapat mendeklarasikan model, alat, dan instruksi agen. AgentCore menangani komputasi, lingkungan, memori, identitas, dan observabilitas. Harness mendukung:

  • Loop orkestrasi terkelola dengan konektivitas alat bawaan

  • Grup aksi diekspos sebagai alat MCP melalui AgentCore gateway (REST API, fungsi Lambda, atau tingkat kode @tools)

  • Gateway-fronted Integrasi Basis Pengetahuan

  • Alat fungsi sebaris untuk pola pengembalian kontrol dan manusia-dalam-loop

  • Penerjemah kode untuk eksekusi kode kotak pasir

  • Short-term dan memori jangka panjang dengan strategi yang dapat dikonfigurasi

  • Penegakan pagar pembatas melalui gateway AgentCore

  • Penelusuran terus-menerus dari ujung ke ujung dari semua tindakan agen

  • Konfigurasi prompt sistem untuk perilaku agen secara keseluruhan

Code-defined agen pada AgentCore

Untuk beban kerja yang membutuhkan kemampuan di luar model deklaratif harness, pelanggan dapat menggunakan agen yang ditentukan kode secara langsung. AgentCore Jalur ini mendukung:

  • Penggantian cepat pada tahap orkestrasi tertentu

  • Multi-agent pola kolaborasi dan supervisor

  • Logika orkestrasi khusus

  • Titik akhir yang lebih luas OpenAI-compatible

  • Kerangka kerja apa pun (Strands, LangChain, OpenAI Agents SDK, Claude Agent SDK, atau kustom)

Code-defined agen masih mendapat manfaat dari AgentCore infrastruktur terkelola sambil memberikan pengembang kendali penuh atas loop agen.

Gunakan harness kecuali Anda memiliki alasan khusus untuk memiliki loop sendiri (misalnya, basis kode agen yang ada untuk bermigrasi, atau orkestrasi lanjutan yang belum diungkapkan oleh harness). Pelanggan juga dapat menggunakan AgentCore CLI untuk mengimpor konfigurasi Bedrock Agents Classic yang ada sebagai titik awal untuk kedua jalur.

Membandingkan kemampuan

Agen Batuan Dasar Klasik AgentCore Setara
Loop orkestrasi terkelola Didukung out-of-the-box dengan harness AgentCore
Grup aksi didefinisikan melalui OpenAPI/skema fungsi+eksekutor Lambda opsional, dipanggil dari agen terkelola Alat yang diekspos melalui AgentCore gateway sebagai alat MCP yang membungkus REST API dan fungsi Lambda atau tingkat kode @tools.
Asosiasi Pangkalan Pengetahuan Batuan Dasar langsung pada konfigurasi agen untuk RAG Gateway-fronted Integrasi basis pengetahuan di AgentCore. Basis pengetahuan dapat diakses melalui alat pengambilan tingkat kode.
Lacak UI dan API yang menampilkan pra-pemrosesan, orkestrasi, panggilan grup tindakan, kueri KB, dan pengamatan dari ujung ke ujung AgentCore menyediakan penelusuran ujung ke ujung yang terus-menerus dari semua tindakan agen.
Konfigurasi penggantian cepat pada tahap tertentu (pra-pemrosesan, orkestrasi, pembuatan respons KB, pasca-pemrosesan) Prompt sistem pada harness (--system-prompt) mencakup perilaku agen secara keseluruhan. Stage-specific penggantian prompt (pra-pemrosesan, pembuatan respons KB, pasca-pemrosesan) tidak direplikasi secara langsung. Mencapai perilaku yang setara membutuhkan penggabungan prompt sistem dengan eksekusi perintah dan skrip yang dikelola sendiri.
Built-in AMAZON.UserInput alat untuk reprompting pengguna otomatis dan elisitasi parameter selama orkestrasi Alat fungsi inline di harness. Agen memanggil alat, harness menjeda dan mengembalikan tool_use ke kode klien, yang menangani interaksi pengguna dan mengirimkan hasilnya kembali. Setara dengan return-of-control. Membutuhkan definisi alat eksplisit daripada elisitasi otomatis.
Built-in AMAZON.CodeInterpreter grup aksi untuk eksekusi kode kotak pasir AgentCore penerjemah kode
Konfigurasi sesi dan memori pada agen (TTL idle, tipe memori, memori lintas sesi) AgentCore memori untuk jangka pendek dan panjang (dengan strategi memori yang berbeda)
Pagar pembatas dan kebijakan agen dilampirkan secara deklaratif pada agen dan ditegakkan selama orkestrasi Konfigurasi pagar pembatas di Bedrock, dengan penegakan kebijakan di gateway AgentCore
Multi-agent peran kolaborasi dan perutean (misalnya, agen pengawas dan peran orkestrasi) Terbatas. Pola supervisor dimungkinkan dengan mengekspos agen sebagai alat MCP (agent-as-tool). Mode perutean multi-agen tidak mudah hari ini. Kolaborasi multi-agen penuh membutuhkan kode kerangka kerja khusus.
Orkestrator kustom Didukung melalui AgentCore runtime (menyebarkan kode orkestrasi khusus secara langsung). Tidak tersedia melalui harness.
Pengembalian kontrol (agen berhenti untuk input eksternal) Alat fungsi inline di harness. Agen berhenti, mengembalikan tool_use ke klien.

Prosedur migrasi

Prasyarat untuk bermigrasi ke harness AgentCore

  • Node.js 20+ dan AgentCore CLI, atau Python 3.10+ dengan boto3

  • AWS kredensil di wilayah di mana AgentCore harness tersedia. Untuk informasi selengkapnya, lihat AWS Wilayah yang Didukung untuk AgentCore.

  • Peran eksekusi IAM dengan izin yang diperlukan

  • (Opsional) Toolkit agen untuk AWS di GitHub situs web memberikan keterampilan khusus untuk memandu agen AI Anda melalui migrasi.

Migrasi dengan toolkit agen untuk AWS (Direkomendasikan)

Toolkit agen untuk AWS di GitHub situs web mencakup amazon-bedrock keterampilan yang memandu agen AI Anda (atau asisten pengkodean) melalui migrasi ujung ke ujung. Ini memeriksa Agen Bedrock Anda yang ada, memeriksa kelayakan migrasi, dan memetakan setiap komponen ke harness yang setara. AgentCore Keterampilan kemudian mendorong AgentCore CLI ke perancah dan menggunakan harness. Itu tidak pernah memodifikasi agen sumber Anda.

Untuk menggunakan keterampilan:

  1. Instal toolkit agen untuk AWS. Untuk petunjuk tentang menginstal toolkit agen dan mengaktifkan keterampilan, lihat toolkit agen untuk AWS README di situs web. GitHub

  2. Aktifkan amazon-bedrock keterampilan untuk agen Anda.

  3. (Opsional) Untuk akses AWS yang efisien, konfigurasikan server AWS MCP. Keterampilan ini juga bekerja dengan AWS CLI dan boto3.

  4. Instal AgentCore CLI versi terbaru. Keterampilan menggunakan AgentCore CLI untuk perancah dan menyebarkan harness.

  5. Minta agen Anda dengan “Bantu saya memigrasikan Agen Batuan Dasar saya untuk AgentCore memanfaatkan”. Berikan ID agen, nama, atau ARN, bersama dengan AWS wilayah dan profil saat keterampilan bertanya.

  6. Konfirmasikan akun, wilayah, dan agen sumber di setiap pos pemeriksaan. Keterampilan menyajikan inventaris komponen, penilaian kelayakan, dan rencana migrasi tertulis. Ini berhenti untuk persetujuan Anda sebelum menerapkan.

Anda juga dapat menggunakan keterampilan untuk menjawab pertanyaan migrasi tanpa melakukan migrasi. Jika agen Anda menggunakan fitur tanpa jalur harness yang divalidasi, keterampilan berhenti dan menyarankan alternatif.

Migrasi secara manual

Jika Anda lebih suka bermigrasi tanpa keahlian, atau agen Anda tidak memenuhi syarat untuk jalur berbasis keterampilan, ikuti langkah-langkah ini untuk membangun harness dengan CLI. AgentCore Gunakan AgentCore CLI versi terbaru.

Langkah 1: Buat dan konfigurasikan

agentcore create --name my-research-agent

Jika Anda memiliki Agen Batuan Dasar yang ingin Anda tiru, tinjau konfigurasinya (model, grup tindakan, KB, penggantian prompt) dan petakan masing-masing ke parameter harness yang sesuai:

  • model — --model-id

  • action groups— Alat gerbang

  • KBs— Gateway atau alat pengambilan

  • prompt — --system-prompt

Tambahkan alat:

agentcore add tool --harness my-research-agent \
  --type agentcore_browser --name browser
agentcore add tool --harness my-research-agent \
  --type agentcore_code_interpreter --name code-interpreter

Untuk menghubungkan grup tindakan yang ada melalui gateway:

agentcore add tool --harness my-research-agent \
  --type agentcore_gateway --name my-gateway \
  --gateway-arn arn:aws:bedrock-agentcore:us-west-2:123456789012:gateway/my-gw

Langkah 2: Konfigurasikan model dan prompt sistem

agentcore add harness \
  --name my-research-agent \
  --model-id us.anthropic.claude-sonnet-4-6-20250514-v1:0 \
  --system-prompt "You are a research assistant." \
  --tools agentcore-browser,code-interpreter

Langkah 3: Menyebarkan dan memanggil

agentcore deploy
agentcore invoke --harness my-research-agent \
  --session-id "$(uuidgen)" \
  "Research tropical vacation options under $3k"

Ganti model pada pemanggilan apa pun tanpa menerapkan ulang:

agentcore invoke --harness my-research-agent \
  --model-id us.anthropic.claude-opus-4-5-20251101-v1:0 \
  "Summarize this research paper"
Memori

Diaktifkan secara default. Untuk cakupan memori ke pengguna individu, berikan--actor-id:

agentcore invoke --harness my-research-agent \
  --session-id "$(uuidgen)" --actor-id alice \
  "What did we discuss about the Portugal trip?"

Setiap aktor mendapatkan memori yang terisolasi. Long-term cakupan strategi yang diekstraksi pengetahuan oleh ID aktor.

Pertanyaan umum

Dampak

Apakah agen saya yang ada akan berhenti bekerja?

Tidak. Agen yang ada terus berfungsi secara normal. Semua API (UpdateAgent, GetAgent, ListAgents, DeleteAgent, PrepareAgent InvokeAgent, API grup tindakan, API basis pengetahuan, API alias, dll.) tetap tersedia untuk semua pelanggan. Hanya CreateAgent dan InvokeInlineAgent dibatasi untuk akun tanpa penggunaan sebelumnya.

Bagaimana saya tahu jika akun saya terpengaruh?

Jika akun Anda memiliki aktivitas Agen Bedrock dalam 12 bulan terakhir, Anda diizinkan terdaftar dan tidak terpengaruh. Ini berlaku per akun. Jika Anda memiliki beberapa AWS akun, hanya akun yang menggunakan Agen Batuan Dasar sebelumnya yang diizinkan terdaftar. Akun tanpa penggunaan sebelumnya akan menerima AccessDeniedException (HTTP 403) saat menelepon CreateAgent atau InvokeInlineAgent.

Kesalahan apa yang akan saya lihat jika akun saya tidak diizinkan terdaftar?

Kode Kesalahan: AccessDeniedException (HTTP 403)

Pesan: “Agen Bedrock dalam Mode Pemeliharaan. Pembuatan agen baru tidak tersedia untuk akun tanpa penggunaan layanan sebelumnya. Untuk mempelajari lebih lanjut, lihat mode pemeliharaan Amazon Bedrock Agents Classic.”

Apakah saya perlu mengambil tindakan?

Tidak segera. Beban kerja Anda yang ada tidak terpengaruh. Namun, kami merekomendasikan AgentCore untuk mengevaluasi pengembangan agen baru dan migrasi masa depan, karena tidak ada fitur baru yang akan ditambahkan ke Bedrock Agents Classic.

Dapatkah saya meminta pengecualian kepada Agen Bedrock di akun baru setelah 30 Juli?

Tidak. Tidak ada proses pengecualian. AWS Secara otomatis menentukan daftar yang diizinkan berdasarkan apakah akun Anda telah memiliki aktivitas Agen Batuan Dasar dalam 12 bulan terakhir. Jika Anda memerlukan kemampuan agen di akun baru, gunakan Amazon Bedrock AgentCore, yang menawarkan fungsionalitas yang setara dan diperluas.

Bagaimana dengan perubahan nama menjadi “Bedrock Agents Classic”?

Ini hanya pembaruan penamaan. Tidak ada tindakan yang diperlukan di pihak Anda. Ruang nama API yang ada (agen dasar), klien SDK, tipe CloudFormation sumber daya, dan awalan tindakan IAM tetap tidak berubah.

Apakah templat saya CloudFormation, CDK, atau Terraform masih berfungsi?

Ya. Template IAC yang ada yang membuat atau mengelola Agen Batuan Dasar akan terus berfungsi untuk akun yang diizinkan. Jika Anda menyediakan lingkungan baru di akun tanpa penggunaan Agen Batuan Dasar sebelumnya, gunakan AgentCore sumber daya Amazon Bedrock di templat Anda.

Apakah versi model baru akan tersedia di Bedrock Agents Classic?

Tidak. Katalog model yang tersedia di Bedrock Agents Classic dibekukan pada tanggal efektif mode pemeliharaan (30 Juli 2026). Model-model baru yang dirilis setelah tanggal tersebut akan tersedia melalui AgentCore. Amazon Bedrock sendiri (inferensi model, Pangkalan Pengetahuan, Pagar Pembatas) terus menerima model baru. Pembatasan ini hanya berlaku untuk lapisan orkestrasi Bedrock Agents Classic.

Apakah harga akan berubah untuk Bedrock Agents Classic?

Tidak ada biaya untuk Bedrock Agents Classic itu sendiri. Anda terus membayar hanya untuk inferensi model yang mendasari dan sumber daya terkait apa pun (Pangkalan Pengetahuan, pemanggilan Lambda, dll.) Seperti sebelumnya.

Migrasi

Apa jalur migrasi yang direkomendasikan?

AgentCore adalah platform yang direkomendasikan. Dua jalur tersedia:

  • AgentCore harness — Pengalaman berbasis konfigurasi yang mirip dengan Bedrock Agents Classic. Deklarasikan model, alat, dan instruksi Anda; AgentCore menangani komputasi, memori, identitas, dan observabilitas. Ini adalah analog terdekat dengan pengalaman yang dikelola Agen Bedrock.

  • Code-defined agen aktif AgentCore — Untuk beban kerja yang membutuhkan orkestrasi tingkat lanjut, kolaborasi multi-agen, atau logika khusus. Terapkan kerangka kerja apa pun (Strands, LangChain, OpenAI Agents SDK, Claude Agent SDK, atau kustom) pada infrastruktur terkelola. AgentCore

Apakah ada alat migrasi otomatis?

Ya. Keterampilan agen untuk memandu Anda melalui migrasi Bedrock Agents Classic langsung ke AgentCore harness tersedia di toolkit agen untuk AWS di situs web. GitHub Keterampilan ini juga tersedia melalui server AWS MCP. Untuk petunjuk tentang menginstal dan menggunakan keterampilan, lihat toolkit agen untuk AWS README di situs web. GitHub Mulailah dengan prompt “Bantu saya memigrasikan Agen Batuan Dasar saya untuk AgentCore memanfaatkan.”

Berapa lama migrasi berlangsung?

Untuk agen langsung (model+kelompok tindakan+basis pengetahuan), impor CLI atau pengaturan harness membutuhkan waktu berjam-jam. Upaya utama melibatkan meninjau kode yang dihasilkan atau menyebarkan kembali kelompok tindakan di belakang gateway. AgentCore Agen kompleks dengan orkestra khusus atau kolaborasi multi-agen akan membutuhkan kerja kode yang lebih signifikan.

Apakah ada tenggat waktu untuk bermigrasi?

Tidak ada tenggat waktu migrasi. Bedrock Agents Classic tetap tersedia untuk pelanggan yang sudah ada dalam mode pemeliharaan tanpa tanggal akhir masa pakai yang direncanakan. Namun, karena tidak ada fitur baru yang direncanakan, kami sarankan untuk bermigrasi AgentCore untuk mendapatkan manfaat dari inovasi yang sedang berlangsung.

Bagaimana dengan Basis Pengetahuan Batuan Dasar saya?

Basis Pengetahuan terus bekerja dan tidak terpengaruh oleh mode pemeliharaan. Saat bermigrasi ke AgentCore, hubungkan mereka melalui AgentCore gateway. Sumber daya Basis Pengetahuan yang mendasarinya tidak berubah.

Bagaimana dengan pagar pembatas batuan dasar saya?

Pagar pembatas yang dikonfigurasi pada model Bedrock masih berlaku saat model dipanggil. AgentCore Agent-level Penegakan pagar pembatas tersedia melalui kebijakan AgentCore gateway.

Apakah saya masih bisa menggunakan model yang sama?

Ya. AgentCore mendukung katalog model Bedrock lengkap ditambah penyedia tambahan (OpenAI, Gemini, dan OpenAI-compatible titik akhir apa pun). Anda dapat beralih di antara penyedia model di tengah sesi tanpa menerapkan ulang.

Bagaimana dengan kolaborasi multi-agen?

Anda dapat membangun pola multi-agen AgentCore saat runtime menggunakan kerangka kerja apa pun yang didukung. Harness terkelola mendukung pola agen-sebagai-alat untuk kasus penggunaan multi-agen yang lebih sederhana.

Bagaimana dengan agen inline?

Akun dengan InvokeInlineAgent penggunaan dalam 12 bulan terakhir dapat terus menggunakan agen inline. Untuk pengembangan baru, harness AgentCore terkelola menyediakan kemampuan agen fana yang setara dengan fitur tambahan (memori, sesi stateful, konektivitas alat melalui gateway). Panduan migrasi untuk agen inline akan datang.

Di wilayah mana yang AgentCore tersedia?

AgentCore tersedia di wilayah ini. Jika beban kerja Bedrock Agents Classic Anda berjalan di wilayah yang belum AgentCore tersedia, Anda dapat terus menggunakan Bedrock Agents Classic di wilayah tersebut sambil memigrasikan pengembangan baru ke AgentCore wilayah yang didukung.

Harga dan dukungan

Berapa AgentCore biayanya?

AgentCore menggunakan harga berbasis konsumsi di seluruh kemampuannya (runtime, memori, gateway). Tidak ada biaya orkestrasi harness terpisah. AgentCoreHarness lebih hemat token daripada permintaan internal Bedrock Agents Classic, sehingga pelanggan dapat melihat biaya inferensi model yang sebanding atau lebih rendah. Lihat AgentCoreharga untuk detailnya.

Sumber daya tambahan