View a markdown version of this page

Gerbang Dasar Dasar Amazon AgentCore - AWS Marketplace
IkhtisarIntegrasi dengan Bedrock AgentCore Gateway

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

Gerbang Dasar Dasar Amazon AgentCore

Dokumen ini memberikan informasi bagi AWS Marketplace penjual yang ingin membuat daftar produk atau alat agen AI berbasis API yang dapat diintegrasikan dengan Amazon Bedrock AgentCore Gateway.

Ikhtisar

Amazon Bedrock AgentCore Gateway membantu pengembang membangun, menerapkan, menemukan, dan terhubung ke alat dalam skala besar. Layanan ini memungkinkan Anda untuk:

  • Konversi APIs, fungsi Lambda, dan layanan yang ada menjadi alat yang kompatibel dengan Model Context Protocol (MCP)

  • Buat alat tersedia untuk agen melalui titik akhir Gateway

  • Gunakan otentikasi ingress dan egress yang komprehensif dalam layanan yang dikelola sepenuhnya

Agen AI menggunakan alat ini untuk melakukan tugas-tugas seperti:

  • Meminta basis data

  • Mengirim pesan

  • Menganalisis dokumen

Untuk informasi selengkapnya, lihat Panduan AgentCore Pengembang Amazon Bedrock.

Integrasi dengan Bedrock AgentCore Gateway

Anda dapat mengaktifkan integrasi Amazon Bedrock AgentCore Gateway untuk produk agen AI berbasis SaaS API Anda dengan salah satu cara berikut, tergantung pada produk Anda:

  • Jika Anda mencantumkan server MCP yang mendukung OAuth otentikasi berkaki dua, Anda dapat memilih untuk menawarkan integrasi kepada pembeli Anda tanpa persyaratan tambahan. Titik akhir server MCP yang Anda berikan sebagai bagian dari proses listing Anda akan digunakan untuk integrasi. Namun, Anda harus memastikan server MCP Anda memenuhi persyaratan yang tercantum di bawah ini. Untuk informasi selengkapnya, lihat target server MCP.

  • Untuk semua agen atau alat lainnya, Anda dapat memberikan spesifikasi OpenAPI untuk mengaktifkan integrasi.

Persyaratan server MCP

Server MCP Anda harus memenuhi persyaratan berikut:

  • OAuth Otentikasi berkaki dua dengan salah satu konfigurasi berikut:

    • id klien, rahasia klien, dan URL penemuan

    • id klien, rahasia klien, penerbit, titik akhir otorisasi, dan titik akhir token.

  • Server MCP harus memiliki kemampuan alat.

  • Versi protokol MCP yang didukung: 2025-06-18 dan 2025-03-26.

  • Untuk URL atau titik akhir server yang disediakan, URL harus dikodekan. Gateway menggunakan URL yang sama untuk memanggil server.

Persyaratan spesifikasi OpenAPI

Spesifikasi OpenAPI Anda harus:

  • Sertakan operationId bidang untuk semua operasi

  • Bebas dari kesalahan semantik

  • Sertakan URL endpoint aman (https) yang valid di atribut server

Tabel berikut menunjukkan fitur OpenAPI yang didukung dan tidak didukung:

Kategori Didukung Tidak Didukung
Versi 3.0 dan 3.1 2
Definisi skema Tipe data dasar (string, angka, boolean, dll.) Spesifikasi OneOf
Validasi bidang yang diperlukan Spesifikasi AnyOf
Benda bersarang
Array dengan spesifikasi item
Metode HTTP standar
Jenis media aplikasi/json Jenis media khusus
aplikasi/xml. Jenis media biner
multipart/bentuk-data
x-www-form-urlencoded
Parameter Parameter jalur sederhana dan parameter kueri dasar seperti string/number/boolean tipe Serialisasi parameter jalur kompleks
Array parameter kueri yang kompleks
Serialisasi parameter header
Serialisasi parameter cookie
Permintaan dan tanggapan Badan JSON
Badan XHTML
Kode status HTTP standar
Validasi Validasi bidang dasar Validasi pola Regex
Validasi nilai min/max
Keamanan N/A Skema keamanan pada tingkat spesifikasi
Beberapa skema keamanan
OAuth 2.0 pada tingkat spesifikasi
Kunci API pada tingkat spesifikasi
HTTP Autentikasi dasar pada tingkat spesifikasi
Konfigurasi server URL dasar
URL dengan placeholder

Mengaktifkan Bedrock Gateway AgentCore

Sebelum Anda mengaktifkan integrasi Gateway, uji spesifikasi OpenAPI atau server MCP Anda dengan Amazon Bedrock AgentCore Gateway dengan menyelesaikan tugas-tugas berikut:

Untuk mengaktifkan integrasi Gateway

  1. Masuklah keAWS Marketplace Portal manajemen.

  2. Buka halaman agen dan alat AI.

  3. Pada tab agen AI dan produk alat, pilih produk yang akan dimodifikasi.

  4. Dari daftar tarik-turun Permintaan perubahan, pilih opsi Perbarui pemenuhan.

  5. Pilih Aktifkan alat untuk AgentCore integrasi Amazon Bedrock.

  6. Unggah spesifikasi OpenAPI Anda. Untuk produk MCP Server OAuth berkaki dua, ini tidak diperlukan dan hanya titik akhir MCP yang diperlukan.

  7. Pilih Kirim.

Setelah Anda mengirimkan, status permintaan akan muncul sebagai Sedang ditinjau di tab Permintaan. Saat pemrosesan selesai, status berubah menjadi Berhasil.