View a markdown version of this page

Daftar produk agen AI berbasis kontainer - AWS Marketplace
Mengelola agen dan alat AI berbasis kontainerMulai wizard daftarLangkah 1: Berikan Informasi ProdukLangkah 2: Konfigurasikan harga Kontainer Agen AILangkah 3: Tentukan kebijakan pengembalian danaLangkah 4: Konfigurasikan EULALangkah 5: Tambahkan repositoriLangkah 6: Konfigurasikan ketersediaan penawaran/Izinkan daftarLangkah 7: Unggah gambar Container dan artefak ke repositoriLangkah 8: Tambahkan Versi Produk Baru dengan AsetLangkah 9: Tinjau Daftar Produk dan Publikasikan ke PublikDetail penyebaran kontainerPengujian dan validasiPraktik dan Rekomendasi Terbaik

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

Daftar produk agen AI berbasis kontainer

Mengelola agen dan alat AI berbasis kontainer

Agen dan alat AI berbasis kontainer 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 Portal AWS Marketplace Manajemen dengan akun penjual AWS Anda.

  2. Pilih Produk dan kemudian pilih Agen dan Alat AI di bilah navigasi.

  3. Pilih menu produk Create AI Agents and Tools, lalu pilih Container-based AI agents & tools.

  4. Pilih Hasilkan ID produk dan kode produk.

  5. (Opsional) Tambahkan tag untuk mendukung otorisasi berbasis tag.

  6. 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)

  2. Masukkan detail dukungan dan tambahkan sumber belajar opsional dengan memilih Tambah sumber daya.

  3. Di menu Kategori produk, pilih 1-3 kategori. Kami menyarankan Anda memilih setidaknya satu kategori dari kategori bisnis Agen & Alat AI.

  4. Masukkan kata kunci untuk meningkatkan kemampuan pencarian.

  5. (Opsional) Tambahkan aset video dan gambar sesuai dengan pedoman.

  6. Pilih Berikutnya.

Langkah 2: Konfigurasikan harga Kontainer Agen AI

  1. Pilih model harga.

    AgentCore keterbatasan 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, lihatHarga kontrak untuk produk kontainer dengan AWS License Manager. Untuk mempelajari lebih lanjut tentang pengukuran kustom untuk harga berbasis penggunaan, lihat. Mengkonfigurasi pengukuran khusus untuk produk kontainer dengan AWS Marketplace Metering Service

  2. Pilih Selanjutnya.

  3. Dalam harga yang ditetapkan.

  4. Pilih Selanjutnya.

Langkah 3: Tentukan kebijakan pengembalian dana

  1. Masukkan kebijakan pengembalian dana.

  2. 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.

  2. 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.

  2. Pilih Selanjutnya.

Langkah 6: Konfigurasikan ketersediaan penawaran/Izinkan daftar

  1. Di Konfigurasikan ketersediaan penawaran, pilih setelan ketersediaan geografis Anda.

  2. Pilih Selanjutnya.

  3. Di Configure allowlist, cantumkan akun AWS apa pun yang seharusnya memiliki akses ke daftar saat dalam status terbatas.

  4. Pilih Kirim untuk membuat permintaan perubahan baru untuk pengujian visibilitas terbatas.

    Tunggu 10-15 menit hingga status permintaan Anda dalam status Succeeded.

Langkah 7: Unggah gambar Container dan artefak ke repositori

catatan

Lihat AgentCore Runtime Amazon Bedrock untuk AWS Marketplace cara mengintegrasikan AgentCore dengan Container Image Anda.

  1. Temukan URL untuk repositori ECR:

    • Buka halaman produk Server di Portal AWS Marketplace Manajemen.

    • Pilih produk kontainer Anda untuk melihat detailnya.

    • Pilih tab Repositori untuk menyalin URL repositori.

  2. 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 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.

  3. 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.

  4. 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.

  5. 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. Untuk informasi selengkapnya, lihat Pemindaian produk kontainer untuk masalah keamanan.

Langkah 8: Tambahkan Versi Produk Baru dengan Aset

  1. Buka halaman produk Agen dan Alat AI di Portal AWS Marketplace Manajemen.

    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 Marketplace Management Portal. Setelah Anda membuat versi untuk Amazon Bedrock AgentCore Runtime, Anda akan menemukan produk kontainer Anda di halaman produk Agen dan Alat AI.

  2. Pilih produk kontainer Anda dan klik menu tarik-turun Minta perubahan, pilih Perbarui versi, dan pilih Tambahkan versi baru.

  3. Dalam opsi Pengiriman, masukkan:

    • Judul versi

    • Catatan rilis

  4. Pilih Tambahkan opsi pengiriman.

  5. 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 kontainer 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.

  6. Jika Anda memilih agen AI atau jenis alat Server A2A, konfirmasikan bahwa agen Anda menggunakan penalaran LLMs 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.

  7. 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 Portal AWS Marketplace Manajemen.

  2. Pilih produk kontainer Anda dalam daftar.

  3. Pilih Lihat di AWS Marketplace.

  4. Tinjau halaman detail produk Anda untuk akurasi. Pastikan petunjuk penggunaan cukup memandu pembeli melalui langkah-langkah yang diperlukan untuk meluncurkan produk Anda.

  5. 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 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 'tools/list' and 'tools/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 ARM64 kontainer

  • Port: Kontainer harus mengekspos port 8080 untuk komunikasi agen berbasis HTTP

  • Tidak ada kredensi hardcode

  • Bebas dari Kerentanan dan Eksposur Umum () CVEs

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: Menggunakan JSON-RPC untuk komunikasi agent-to-agent

  • Otentikasi: Mendukung skema otentikasi SiGv4 dan 2.0 OAuth

Instruksi penggunaan

Pastikan instruksi memandu pelanggan secara menyeluruh melalui peluncuran dan konfigurasi produk. Lihat Membuat AMI dan petunjuk penggunaan produk kontainer untuk AWS Marketplace.

Pengujian dan validasi

Sebelum menerbitkan agen atau alat yang kompatibel dengan MCP 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

Praktik dan Rekomendasi Terbaik

Persyaratan Dokumentasi

Saat mencantumkan agen atau alat yang kompatibel dengan Protokol 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: