Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Daftar produk agen Container-based AI
## Mengelola agen dan alat AI berbasis kontainer
Container-based Agen dan alat AI yang berjalan di Amazon Bedrock AgentCore Runtime dapat dikelola melalui halaman produk **agen dan alat AI** terpadu atau halaman produk **Server** di AWS Marketplace Management Console. Hanya produk dengan versi yang mendukung Amazon Bedrock AgentCore Runtime yang akan terlihat di halaman produk **agen dan alat AI**.
## Mulai wizard daftar
1. Masuk ke [AWS Partner Central](https://aws.amazon.com/marketplace/management/homepage/) dengan akun penjual AWS Anda.
1. Pilih **Build** dan kemudian pilih **AI Agents and Tools** di bilah navigasi.
1. Pilih menu **produk Create AI Agents and Tools**, lalu pilih **Container-based AI agent & tools**.
1. Pilih **Hasilkan ID produk dan kode produk**.
1. (Opsional) Tambahkan tag untuk mendukung otorisasi berbasis tag.
1. Pilih **Lanjutkan**.
## Langkah 1: Berikan Informasi Produk
1. Dalam **informasi Produk**, masukkan:
+ **Judul produk**
+ **Logo produk S3 URL**
+ **Deskripsi singkat**
+ **Deskripsi panjang**
+ **Sorot (1-3)**
1. Masukkan detail dukungan dan tambahkan sumber belajar opsional dengan memilih Tambah sumber daya.
1. Di menu **Kategori produk**, pilih 1-3 kategori. Kami menyarankan Anda memilih setidaknya satu kategori dari kategori bisnis **Agen & Alat AI**.
1. Masukkan kata kunci untuk meningkatkan kemampuan pencarian.
1. (Opsional) Tambahkan aset video dan gambar sesuai dengan pedoman.
1. Pilih **Berikutnya**.
## Langkah 2: Konfigurasikan harga Kontainer Agen AI
1. Pilih model harga.
**AgentCore batasan harga**
Jika gambar kontainer digunakan AgentCore, Per **Jam** dan **Penggunaan dengan model harga kontrak jangka panjang** tidak didukung. Untuk mempelajari lebih lanjut tentang harga kontrak, lihat[Harga kontrak untuk produk kontainer dengan AWS License Manager](container-license-manager-integration.md). Untuk mempelajari lebih lanjut tentang pengukuran kustom untuk harga berbasis penggunaan, lihat. [Mengkonfigurasi pengukuran khusus untuk produk kontainer dengan AWS Marketplace Metering Service](container-metering-meterusage.md)
1. Pilih **Selanjutnya**.
1. Dalam **harga yang ditetapkan**.
1. Pilih **Selanjutnya**.
## Langkah 3: Tentukan kebijakan pengembalian dana
1. Masukkan kebijakan pengembalian dana.
1. Pilih **Selanjutnya**.
**catatan**
Jika Anda memilih model harga produk gratis, Anda tidak perlu memasukkan kebijakan pengembalian dana.
## Langkah 4: Konfigurasikan EULA
1. Pilih **Kontrak Standar untuk AWS Marketplace** atau **EULA Kustom**.
**catatan**
Jika Anda memilih Custom EULA, masukkan URL untuk perjanjian lisensi pengguna akhir.
1. Pilih **Selanjutnya**.
## Langkah 5: Tambahkan repositori
1. Tambahkan repositori awal untuk produk kontainer Anda.
**catatan**
Nama repositori harus unik di semua produk di akun penjual Anda. Anda dapat membuat hingga 50 repositori per produk.
1. Pilih **Selanjutnya**.
## Langkah 6: Konfigurasikan ketersediaan penawaran/Izinkan daftar
1. Di **Konfigurasikan ketersediaan penawaran**, pilih setelan ketersediaan geografis Anda.
1. Pilih **Selanjutnya**.
1. Di **Configure allowlist**, cantumkan akun AWS apa pun yang seharusnya memiliki akses ke daftar saat dalam status terbatas.
1. Pilih **Kirim** untuk membuat permintaan perubahan baru untuk pengujian visibilitas terbatas.
Tunggu 10-15 menit hingga status permintaan Anda dalam status *Berhasil*.
## Langkah 7: Unggah gambar Container dan artefak ke repositori
**catatan**
Lihat [AgentCore Runtime Amazon Bedrock untuk AWS Marketplace](bedrock-agentcore-runtime.md) cara mengintegrasikan AgentCore dengan Container Image Anda.
1. Temukan URL untuk repositori ECR:
+ Buka halaman produk Server di AWS Partner Central.
+ Pilih produk kontainer Anda untuk melihat detailnya.
+ Pilih tab Repositori untuk menyalin URL repositori.
1. Pilih **Lihat perintah push** untuk membuka daftar instruksi, termasuk perintah yang dapat Anda gunakan untuk mendorong gambar kontainer Docker dan bagan Helm ke repositori itu. Untuk informasi umum tentang cara mendorong gambar kontainer dan artefak lainnya ke repositori, lihat [Mendorong gambar di Panduan Pengguna](https://docs.aws.amazon.com/AmazonECR/latest/userguide/docker-push-ecr-image.html) Amazon Elastic Container Registry.
**catatan**
Anda dapat menggunakan operasi API Amazon Elastic Container Registry (Amazon ECR) Registry (Amazon ECR) berikut saat memanggil docker pull atau docker push:
DescribeImages - Gunakan ini untuk meninjau metadata tentang gambar dalam repositori.
GetAuthorizationToken - Gunakan untuk mengautentikasi sebelum mengunggah artefak ke repositori, lalu gunakan perintah docker pull atau docker push.
ListImages - Gunakan untuk melihat daftar gambar yang Anda dorong.
1. Gunakan perintah yang terdaftar untuk mendorong artefak yang diperlukan dari repositori lokal Anda ke repositori untuk produk AWS Marketplace Anda.
**catatan**
Tag yang Anda berikan dalam perintah push digunakan untuk membedakan versi artefak yang Anda unggah ke repositori. Gunakan tag yang masuk akal untuk versi artefak adalah bagian dari.
1. Ulangi untuk setiap citra kontainer atau artefak yang Anda butuhkan dalam versi Anda.
**catatan**
Versi Anda dapat menyertakan hingga 50 gambar kontainer atau artefak di setiap opsi pengiriman. Lihat prosedur berikut untuk informasi lebih lanjut tentang opsi pengiriman.
1. Setelah Anda mengunggah artefak Anda, Anda siap untuk membuat versi produk Anda.
**catatan**
Citra kontainer Anda dipindai secara otomatis untuk melihat apakah citra tersebut memenuhi [Persyaratan produk berbasis kontainer untuk AWS Marketplace](container-product-policies.md). Untuk informasi selengkapnya, lihat [Pemindaian produk kontainer untuk masalah keamanan](container-product-getting-started.md#container-security).
## Langkah 8: Tambahkan Versi Produk Baru dengan Aset
1. Buka halaman produk **Agen dan Alat AI** di AWS Partner Central.
**catatan**
Hanya produk kontainer dengan versi yang mendukung Amazon Bedrock AgentCore Runtime yang terlihat di halaman produk **Agen dan Alat AI**. Sebelum menambahkan versi pertama, Anda hanya akan menemukan produk Anda di halaman produk **Server** di AWS Partner Central. Setelah Anda membuat versi untuk Amazon Bedrock AgentCore Runtime, Anda akan menemukan produk kontainer Anda di halaman produk **Agen dan Alat AI**.
1. Pilih produk kontainer Anda dan klik menu tarik-turun **Minta perubahan**, pilih **Perbarui versi**, dan pilih **Tambahkan versi baru**.
1. Dalam **opsi Pengiriman**, masukkan:
+ **Judul versi**
+ **Catatan rilis**
1. Pilih **Tambahkan opsi pengiriman**.
1. Untuk **metode Pengiriman**, pilih **Gambar kontainer** dan isi:
+ **Layanan yang didukung**: pilih lingkungan tempat pembeli dapat meluncurkan perangkat lunak.
+ **Untuk AgentCore layanan **Bedrock**, pilih **Agen AI, Server MCP, atau Server A2A di bidang Jenis**.**
+ **Gambar kontainer**: *URL repositori* dan *tag versi* yang Anda tentukan sebelumnya.
+ **Judul opsi pengiriman** dan **deskripsi opsi Deployment**: Masukkan judul dan deskripsi untuk opsi pengiriman ini.
+ **Petunjuk penggunaan**: Masukkan informasi terperinci untuk membantu pembeli Anda menggunakan perangkat lunak Anda setelah meluncurkannya.
+ **Variabel Lingkungan**: Tentukan variabel lingkungan yang harus disediakan pembeli untuk mengonfigurasi perilaku runtime agen. Variabel ini dapat digunakan untuk meneruskan pengaturan, kredensil, atau flag kustom ke wadah saat startup. Untuk setiap variabel, berikan nama seperti yang diharapkan oleh container Anda, deskripsi, dan nilai default opsional. Untuk variabel seperti kredensil atau kunci API yang unik, jangan berikan nilai default. Anda dapat menggunakan deskripsi untuk menentukan rincian tentang variabel serta nilai yang mungkin. Semua variabel yang disediakan dengan nilai defaultnya akan diisi sebelumnya saat pembeli meluncurkan produk Anda.
1. Jika Anda memilih **agen AI** atau jenis alat **Server A2A**, konfirmasikan bahwa agen Anda menggunakan LLM penalaran dan menunjukkan kemampuan otonom. Persyaratan ini membantu memastikan bahwa agen yang ditawarkan di AWS Marketplace memenuhi standar berkualitas tinggi. Jika agen Anda tidak memenuhi kedua persyaratan, pilih jenis alat yang berbeda.
1. Pilih **Tambahkan versi**.
Tunggu dan segarkan halaman hingga status permintaan ditampilkan *Berhasil.*
Menambahkan versi baru secara otomatis memindai gambar kontainer untuk mencari kerentanan.
## Langkah 9: Tinjau Daftar Produk dan Publikasikan ke Publik
1. Buka halaman produk **Agen dan Alat AI** di AWS Partner Central.
1. Pilih produk kontainer Anda dalam daftar.
1. Pilih **Lihat di AWS Marketplace**.
1. Tinjau halaman detail produk Anda untuk akurasi. Pastikan petunjuk penggunaan cukup memandu pembeli melalui langkah-langkah yang diperlukan untuk meluncurkan produk Anda.
1. Kirim permintaan visibilitas Pembaruan ke publik:
+ Dari halaman **Produk Server**, pada tab **Produk server saat ini**, pilih produk berbasis kontainer yang ingin Anda modifikasi. Dari menu tarik-turun **Permintaan perubahan**, pilih **Perbarui** visibilitas.
## Detail penyebaran kontainer
Penyebaran kontainer mengemas agen atau alat AI Anda sebagai aplikasi kontainer yang dapat dijalankan pelanggan di lingkungan AWS mereka sendiri. Pendekatan ini memberikan manfaat sebagai berikut:
+ Data tetap berada dalam lingkungan pelanggan
+ Konfigurasi penerapan yang dapat disesuaikan
+ Integrasi yang didukung dengan Bedrock AgentCore Runtime dan infrastruktur pelanggan yang ada
Saat mencantumkan agen kontainer, berikan instruksi penerapan yang jelas, persyaratan sumber daya, dan opsi konfigurasi untuk memastikan implementasi pelanggan berhasil.
### Persyaratan teknis untuk Bedrock AgentCore Runtime Containers
**catatan**
Lihat [AgentCore Runtime Amazon Bedrock untuk AWS Marketplace](bedrock-agentcore-runtime.md) untuk detail selengkapnya.
Saat membuat produk agen AI berbasis kontainer untuk AWS Marketplace, ikuti persyaratan ini:
Persyaratan Server MCP
+ **Transportasi**: Stateless streamable-http saja
+ **Manajemen Sesi**: Platform secara otomatis menambahkan `Mcp-Session-Id` header untuk isolasi sesi
+ **Host**: Kontainer harus mendengarkan `0.0.0.0`
+ **Port**: Kontainer harus mengekspos port `8000` untuk komunikasi server MCP
+ **Path**: `/mcp` - Titik akhir POST untuk menerima pesan MCP RPC. InvokeAgentRuntime untuk server MCP akan melewati permintaan ke jalur ini.
+ **Protokol**: Server MCP harus mendukung protokol MCP termasuk pesan protokol '' dan 'tools/listtools/call' (didukung oleh kerangka umum seperti FastMCP).
Persyaratan Agen
+ **/ping** Endpoint: DAPATKAN titik akhir untuk pemeriksaan kesehatan
+ **/invocations** Endpoint: Titik akhir POST untuk interaksi agen
+ **Docker Container: Paket penerapan kontainer** ARM64
+ **Port**: Kontainer harus mengekspos port `8080` untuk komunikasi HTTP-based agen
+ Tidak ada kredensi hardcode
+ Bebas dari Kerentanan dan Eksposur Umum (CVE)
Persyaratan Server A2A
+ **Port**: Server A2A berjalan pada port 9000 (vs 8080 untuk HTTP, 8000 untuk MCP)
+ **Host**: Kontainer harus mendengarkan `0.0.0.0`
+ **Jalur**: Server A2A dipasang di `/` (vs `/invocations` untuk HTTP, `/mcp` untuk MCP)
+ **Kartu Agen**: A2A menyediakan penemuan agen bawaan melalui Kartu Agen di `/.well-known/agent-card.json`
+ **Protokol**: Penggunaan JSON-RPC untuk komunikasi agen-ke-agen
+ **Otentikasi**: Mendukung skema otentikasi SiGv4 dan OAuth 2.0
Instruksi penggunaan
Pastikan instruksi memandu pelanggan secara menyeluruh melalui peluncuran dan konfigurasi produk. Lihat [Membuat AMI dan petunjuk penggunaan produk kontainer untuk AWS Marketplace](ami-container-product-usage-instructions.md).
## Pengujian dan validasi
Sebelum mempublikasikan MCP-compatible agen atau alat Anda ke publik, uji implementasi Anda secara menyeluruh:
+ Verifikasi petunjuk penggunaan memberikan informasi yang diperlukan untuk meluncurkan dan mengkonfigurasi produk.
+ Uji alur otentikasi dan penanganan kesalahan
+ Validasi kinerja dalam berbagai kondisi beban
+ Pastikan kompatibilitas dengan klien MCP populer
+ Dokumentasikan persyaratan konfigurasi khusus klien apa pun
## Praktik dan Rekomendasi Terbaik
### Persyaratan Dokumentasi
Saat mencantumkan Protocol-compatible agen atau alat Konteks Model AWS Marketplace, sertakan dokumentasi komprehensif:
+ Deskripsi dan contoh kemampuan terperinci
+ Instruksi otentikasi dan konfigurasi
+ Contoh kode untuk skenario integrasi umum
+ Panduan pemecahan masalah dan referensi kesalahan
+ Pertimbangan kinerja dan praktik terbaik
### Sumber daya tambahan
Untuk informasi selengkapnya tentang penerapan Protokol Konteks Model di agen atau alat AI Anda, lihat sumber daya berikut:
+ [Dokumentasi Amazon Bedrock AgentCore ](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/what-is-bedrock-agentcore.html)
+ [AgentCore Runtime Amazon Bedrock untuk AWS Marketplace](bedrock-agentcore-runtime.md)
+ [Persyaratan Teknis Kontainer](https://docs.aws.amazon.com/marketplace/latest/userguide/container-product-getting-started.html)