Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# AgentCore Runtime Amazon Bedrock untuk AWS Marketplace
Dokumen ini memberikan informasi bagi AWS Marketplace penjual yang ingin mencantumkan agen AI atau alat yang dapat digunakan di Amazon Bedrock AgentCore Runtime. Ini menguraikan persyaratan teknis, pedoman konfigurasi, dan praktik terbaik untuk menyiapkan container yang didukung Bedrock AgentCore Runtime Anda. AWS Marketplace
**Topics**
+ [Gambaran umum](#agentcore-runtime-overview)
+ [Persyaratan teknis AgentCore wadah batuan dasar](#agentcore-container-requirements)
+ [Menguji container Bedrock AgentCore Runtime Anda](#testing-agentcore-container)
+ [Praktik terbaik untuk konfigurasi kontainer](#container-best-practices)
+ [Persyaratan untuk AWS Marketplace pengiriman](#marketplace-submission-requirements)
+ [Sumber Daya Tambahan](#agentcore-additional-resources)
+ [Support untuk AgentCore Runtime di AWS Marketplace](#agentcore-support)
## Gambaran umum
Amazon Bedrock AgentCore Runtime menyediakan lingkungan hosting yang aman, tanpa server, dan dibuat khusus untuk menerapkan dan menjalankan agen atau alat AI. Saat mencantumkan container Bedrock AgentCore Runtime Anda AWS Marketplace, Anda perlu memastikannya memenuhi persyaratan khusus agar berfungsi dengan baik dalam lingkungan Bedrock AgentCore .
**catatan**
Untuk mempelajari lebih lanjut, lihat [Memulai dengan Amazon Bedrock AgentCore Runtime](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/runtime-getting-started.html).
## Persyaratan teknis AgentCore wadah batuan dasar
Amazon Bedrock AgentCore Runtime memiliki persyaratan teknis yang berbeda untuk mencantumkan agen AI, server MCP, dan server A2A.
+ **Persyaratan agen**
+ **Persyaratan server MCP**
+ **Persyaratan server A2A**
### Persyaratan agen
Agen kontainer Anda harus memenuhi persyaratan inti berikut:
+ **/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
#### `/ping`- DAPATKAN
Titik akhir ini memverifikasi bahwa agen Anda beroperasi dan siap menangani permintaan.
**Contoh Respon:**
```
{
"status": "Healthy"
}
```
#### `/invocations`- POSTING
Ini adalah titik akhir interaksi agen utama ketika pelanggan memanggil agen dengan InvokeAgentRuntime tindakan dengan muatan dalam format JSON. InvokeAgentRuntime mendukung respons streaming, memungkinkan pelanggan untuk menerima tanggapan sebagian saat tersedia.
**Contoh Permintaan:**
```
Content-Type: application/json
{
"prompt": "What's the weather today?"
}
```
**Contoh Tanggapan:**
+ Tanggapan JSON (non-streaming):
```
Content-Type: application/json
{
"response": "Your agent's response here",
"status": "success"
}
```
+ Respons SSE (streaming):
```
Content-Type: text/event-stream
data: {"event": "partial response 1"}
data: {"event": "partial response 2"}
data: {"event": "final response"}
```
### Persyaratan server MCP
Amazon Bedrock AgentCore Runtime memungkinkan Anda menerapkan dan menjalankan server Model Context Protocol (MCP). Saat Anda mengonfigurasi Amazon Bedrock AgentCore Runtime dengan protokol MCP, layanan mengharapkan kontainer server MCP di jalur. `0.0.0.0:8000/mcp` Ini adalah jalur default yang SDKs didukung sebagian besar server MCP resmi.
Karena Amazon Bedrock AgentCore Runtime menyediakan isolasi sesi secara default, ini memerlukan server HTTP Streamable-stateless. Runtime secara otomatis menambahkan `Mcp-Session-Id` header untuk permintaan apa pun yang tidak menyertakannya. Hal ini memungkinkan klien MCP untuk mempertahankan kontinuitas koneksi ke sesi Amazon Bedrock AgentCore Runtime yang sama.
`InvokeAgentRuntime`API melewati data payload secara langsung, yang memungkinkan proxy pesan RPC dengan mudah untuk protokol seperti MCP.
Persyaratan:
+ **Transport** - Harus menggunakan stateless streamable-http saja
+ **Manajemen Sesi** - Platform secara otomatis menambahkan `Mcp-Session-Id` header untuk isolasi sesi
+ **Host** - Container harus mendengarkan `0.0.0.0`
+ **Port** - Container harus mengekspos port `8000` untuk komunikasi server MCP
+ **Path** - Harus mengekspos `/mcp` sebagai titik akhir POST untuk menerima pesan MCP RPC. `InvokeAgentRuntime`API melewati permintaan ke jalur ini untuk server MCP.
+ **Protokol** - server MCP harus mendukung protokol MCP, termasuk pesan protokol berikut:
+ `tools/list`
+ `tools/call`(didukung oleh kerangka kerja umum seperti FastMCP)
Untuk mempelajari lebih lanjut tentang persyaratan server MCP, lihat [Menerapkan server MCP](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/runtime-mcp.html) di Runtime. AgentCore
#### `/mcp`- POSTING
Ini adalah titik akhir interaksi agen utama ketika pelanggan memanggil server MCP. InvokeAgentRuntime
**Contoh daftar permintaan:**
```
Content-Type: application/json
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list",
}
```
**Contoh respon daftar:**
Tanggapan JSON (non-streaming):
```
Content-Type: application/json
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"tools": [
{
"name": "get_weather",
"title": "Weather Information Provider",
"description": "Get current weather information for a location",
"inputSchema": {
"type": "object",
"properties": {
"location": {
"type": "string",
"description": "City name or zip code"
}
},
"required": ["location"]
}
}
],
"nextCursor": "next-page-cursor"
}
}
```
**Contoh permintaan panggilan alat:**
```
Content-Type: application/json
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "get_weather",
"arguments": {
"location": "New York"
}
}
}
```
**Contoh respons panggilan alat:**
Tanggapan JSON (non-streaming):
```
Content-Type: application/json
{
"jsonrpc": "2.0",
"id": 2,
"result": {
"content": [
{
"type": "text",
"text": "Current weather in New York:\nTemperature: 72°F\nConditions: Partly cloudy"
}
],
"isError": false
}
}
```
### Persyaratan Server A2A
Amazon Bedrock AgentCore Runtime memungkinkan Anda menerapkan dan menjalankan server Agent-to-Agent (A2A) di Runtime. AgentCore Dukungan protokol AgentCore A2A Amazon Bedrock memungkinkan integrasi tanpa batas dengan server A2A dengan bertindak sebagai lapisan proxy transparan. Saat dikonfigurasi untuk A2A, Amazon Bedrock AgentCore mengharapkan container untuk menjalankan server HTTP stateless dan streamable pada port `9000` di root path (`0.0.0.0:9000/`), yang sejajar dengan konfigurasi server A2A default.
Layanan ini menyediakan isolasi sesi tingkat perusahaan sambil mempertahankan transparansi protokol - muatan JSON-RPC dari InvokeAgentRuntime API diteruskan langsung ke wadah A2A tanpa modifikasi. Arsitektur ini mempertahankan fitur protokol A2A standar seperti penemuan agen bawaan melalui Kartu Agen di `/.well-known/agent-card.json` dan komunikasi JSON-RPC, sambil menambahkan otentikasi perusahaan (SigV4/2.0) dan skalabilitas. OAuth
Pembeda utama dari protokol lain adalah port (9000 vs 8080 untuk HTTP), jalur pemasangan (`/`vs`/invocations`), dan mekanisme penemuan agen standar, menjadikan Amazon Bedrock platform penyebaran yang AgentCore ideal untuk agen A2A di lingkungan produksi.
Persyaratan:
+ **Port** - Server A2A berjalan pada port 9000 (vs 8080 untuk HTTP, 8000 untuk MCP)
+ **Host** - Container harus mendengarkan `0.0.0.0`
+ **Jalan**
+ Server A2A dipasang di `/` (vs `/invocations` untuk HTTP, `/mcp` untuk MCP)
+ Pemeriksaan Kesehatan saat `/ping` menggunakan GET
+ **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
Untuk mempelajari lebih lanjut tentang persyaratan server A2A, lihat [Menerapkan server A2A](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/runtime-a2a.html) di Runtime. AgentCore
#### `/`- POSTING
Ini adalah titik akhir interaksi agen utama ketika pelanggan memanggil server A2A. InvokeAgentRuntime
**Contoh permintaan permintaan agen:**
```
Content-Type: application/json
{
"jsonrpc": "2.0",
"id": "req-001",
"method": "message/send",
"params": {
"message": {
"role": "user",
"parts": [
{
"kind": "text",
"text": "what is 101 * 11?"
}
],
"messageId": "12345678-1234-1234-1234-123456789012"
}
}
}
```
**Contoh respons pemanggilan agen:**
Tanggapan JSON (non-streaming):
```
Content-Type: application/json
{
"jsonrpc": "2.0",
"id": "req-001",
"result": {
"artifacts": [
{
"parts": [
{
"kind": "text",
"text": "101 * 11 is 1111"
}
]
}
]
}
}
```
**Contoh pengambilan kartu agen:**
```
curl https://bedrock-agentcore..amazonaws.com/runtimes/{escaped_agent_arn}/invocations/.well-known/agent-card.json
```
#### `/ping`- DAPATKAN
Ini adalah titik akhir untuk melakukan pemeriksaan kesehatan.
## Menguji container Bedrock AgentCore Runtime Anda
Sebelum mengirimkan wadah Anda AWS Marketplace, ujilah dengan seksama:
### Pengujian Agen Lokal
Uji agen Anda secara lokal menggunakan Docker
```
docker run -p 8080:8080
# Test ping endpoint
curl http://localhost:8080/ping
# Test agent invocation endpoint
curl -X POST http://localhost:8080/invocations \
-H "Content-Type: application/json" \
-d '{"prompt": "Hello world!"}'
```
### Pengujian Server MCP Lokal
Uji server MCP Anda secara lokal menggunakan Docker
```
docker run -p 8000:8000
# Test ping endpoint
curl http://localhost:8000/ping
# Test MCP endpoint with tools/list
curl -X POST http://localhost:8000/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc": "2.0","id": 1,"method": "tools/list"}'
# Test MCP endpoint with tools/call
curl -X POST http://localhost:8000/mcp \
-H "Content-Type: application/json" \
-d '{ "jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": {"name": "get_weather", "arguments": {"location": "New York"}}}'
```
### Pengujian Server A2A Lokal
Uji server A2A Anda secara lokal menggunakan Docker
```
docker run -p 9000:9000
# Test ping endpoint
curl http://localhost:9000/ping
# Retrieve agent card
curl http://localhost:9000/.well-known/agent-card.json
# Test A2A endpoint with message/send
curl -X POST http://localhost:9000/ \
-H "Content-Type: application/json" \
-d '{ "jsonrpc": "2.0", "id": "req-001", "method": "message/send", "params": { "message": { "role": "user", "parts": [ { "kind": "text", "text": "what is 101 * 11?"}],"messageId": "12345678-1234-1234-1234-123456789012" }}}'
```
### Pengujian pada Runtime Bedrock AgentCore
Setelah menguji kontainer secara lokal, unggah ke Amazon Elastic Container Registry (Amazon ECR) dan terapkan ke Amazon Bedrock Runtime. AgentCore Anda dapat menerapkan menggunakan konsol Amazon Bedrock AgentCore Runtime atau (). AWS Command Line Interface AWS CLI
## Praktik terbaik untuk konfigurasi kontainer
### Pertimbangan keamanan
+ **Isolasi** - Jangan menyimpan data sensitif di antara pemanggilan
+ **Otentikasi** - Validasi semua permintaan yang masuk
+ **Logging** - Log informasi yang sesuai tetapi hindari memasukkan data sensitif
+ **Dependensi** - Jaga agar semua dependensi tetap terkini untuk mencegah kerentanan keamanan
### Optimalisasi kinerja
+ **Mulai dingin** - Optimalkan wadah Anda untuk memulai dingin yang cepat
+ **Penggunaan Memori** - Minimalkan jejak memori untuk meningkatkan kinerja
+ **Concurrency** - Rancang agen Anda untuk menangani permintaan bersamaan secara efisien
+ **Timeout** - Menerapkan penanganan batas waktu yang tepat
### Penanganan kesalahan
+ **Degradasi anggun** - Menerapkan mekanisme fallback ketika layanan tidak tersedia
+ **Kesalahan terstruktur** - Kembalikan respons kesalahan yang terstruktur dengan baik dengan kode status HTTP yang sesuai
+ **Coba lagi logika** - Menerapkan logika coba lagi yang sesuai untuk kegagalan sementara
## Persyaratan untuk AWS Marketplace pengiriman
Saat Anda mengirimkan container AgentCore Runtime Anda ke AWS Marketplace, sertakan:
+ **Gambar kontainer** - Gambar kontainer Anda didorong ke Amazon ECR
+ **Dokumentasi** - Dokumentasi komprehensif tentang cara menggunakan agen Anda atau server MCP
+ **Contoh penggunaan** - Contoh yang jelas tentang cara memanggil agen atau server MCP Anda
+ **Informasi Support** - Informasi kontak untuk dukungan
+ **Informasi harga** - Struktur harga yang jelas untuk agen atau server MCP Anda
## Sumber Daya Tambahan
Untuk informasi selengkapnya, lihat berikut ini:
+ [Apa itu Amazon Bedrock? AgentCore](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/what-is-bedrock-agentcore.html)
+ [Apa itu AWS Marketplace?](https://docs.aws.amazon.com/marketplace/latest/userguide/what-is-marketplace.html)
+ [Memulai dengan Produk Kontainer](container-product-getting-started.md)
## Support untuk AgentCore Runtime di AWS Marketplace
Untuk pertanyaan terkait dengan daftar container AgentCore Runtime Anda AWS Marketplace, lihat [Mendapatkan dukungan untuk AWS Marketplace](https://docs.aws.amazon.com/marketplace/latest/buyerguide/buyer-support.html).
Untuk pertanyaan teknis tentang AgentCore Runtime, lihat [AWS Dukungan dan Layanan Pelanggan](https://console.aws.amazon.com/support/home#/case/create?issueType=technical).