Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Tambahkan API REST API Gateway sebagai target untuk Amazon Bedrock AgentCore Gateway
Amazon Bedrock AgentCore Gateway memberi pengembang agen AI cara aman untuk mengekspos REST API Gateway Anda APIs sebagai alat yang kompatibel dengan Model Context Protocol (MCP). AgentCore Gateway menggunakan target untuk menentukan alat. Saat Anda menambahkan tahap sebagai target, Gateway Anda menjadi URL MCP tunggal yang memungkinkan akses ke alat untuk agen. Untuk informasi selengkapnya, lihat Tahapan API Gateway REST API sebagai target di Panduan Pengembang Amazon Bedrock AgentCore Gateway.
Target API Gateway menghubungkan AgentCore Gateway Anda ke tahapan REST Anda APIs. Anda dapat memasukkan seluruh tahap sebagai target, atau memilih sumber daya. Setelah Anda membuat target API Gateway, AgentCore Gateway menerjemahkan permintaan MCP yang masuk ke dalam permintaan HTTP dan menangani pemformatan respons. Klien MCP dapat mengambil dokumentasi API menggunakan tools/list metode dan memanggil APIs menggunakan metode. tools/call
Pertimbangan-pertimbangan
Pertimbangan berikut mungkin memengaruhi penggunaan Anda menambahkan tahap sebagai target ke AgentCore Gateway:
-
Anda harus sudah memiliki AgentCore Gateway.
-
Hanya REST publik APIs yang didukung.
-
Titik akhir default API Anda tidak dapat dinonaktifkan.
-
Setiap metode API Anda harus memiliki nama operasi yang ditentukan untuknya, atau kebutuhan Anda untuk membuat penggantian nama saat Anda menambahkan tahap sebagai target. Nama ini digunakan sebagai nama alat yang digunakan agen untuk berinteraksi dengan metode Anda.
-
Anda dapat menggunakan
API_KEY,NO_AUTH, atau jenis penyediaGATEWAY_IAM_ROLEkredensi untuk Outbound Auth agar Gateway Anda dapat mengakses API Anda. PenyediaAPI_KEYkredensi ditentukan oleh AgentCore Gateway. Anda dapat menggunakan kunci API Gateway API yang ada. Untuk informasi selengkapnya, lihat Menyiapkan Autentikasi Keluar. -
Jika Anda menggunakan kumpulan pengguna Amazon Cognito atau otorisasi Lambda untuk mengontrol akses ke API Anda, klien MCP tidak dapat mengaksesnya.
-
API Anda harus berada di akun dan Wilayah yang sama dengan AgentCore Gateway Anda.
Menambahkan tahap API sebagai target untuk AgentCore Gateway
Prosedur berikut menunjukkan cara menambahkan tahap API sebagai target untuk AgentCore Gateway.
Untuk menambahkan tahap API sebagai target untuk AgentCore Gateway
Masuk ke konsol API Gateway di https://console.aws.amazon.com/apigateway
. Pilih REST API yang diterapkan ke panggung.
Di panel navigasi utama, pilih Tahapan.
-
Pilih Tindakan tahap, lalu pilih Buat target MCP.
Untuk AgentCore Gateway, pilih AgentCore Gateway.
Untuk nama Target, masukkan nama target.
Untuk deskripsi Target, masukkan deskripsi.
Simpan API dan panggung yang disediakan.
-
Untuk sumber daya API Pilih, pilih sumber daya API Anda yang dapat diakses oleh agen yang menggunakan AgentCore Gateway Anda.
Jika Anda tidak memilih sumber daya, agen tidak dapat melihat dokumentasi atau memanggil titik akhir.
-
Kombinasi sumber daya dan metode adalah operasi untuk alat. Jika operasi Anda tidak memiliki nama, buat penggantian nama.
Anda juga dapat menentukan nama operasi untuk metode saat Anda membuatnya.
Untuk konfigurasi Outbound Auth, pilih Peran IAM, Tanpa otorisasi, atau kunci API.
Pilih Buat target.
Untuk melihat semua AgentCore Gateway yang memiliki akses ke Anda APIs, pilih bagian target MCP di panel navigasi utama. Di bagian ini, Anda dapat membuat target MCP untuk API apa pun di Wilayah yang diterapkan ke sebuah panggung. Pilih Buat target MCP dan ikuti langkah-langkah sebelumnya.
Anda juga dapat melihat alat yang tersedia untuk target Anda dan mengedit target Anda di konsol AgentCore Gateway. Untuk informasi selengkapnya, lihat Menambahkan target ke AgentCore Gateway yang ada.
