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

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 .

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

Agen kontainer Anda harus memenuhi persyaratan inti berikut:

/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:

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.

InvokeAgentRuntimeAPI melewati data payload secara langsung, yang memungkinkan proxy pesan RPC dengan mudah untuk protokol seperti MCP.

Persyaratan:

Untuk mempelajari lebih lanjut tentang persyaratan server MCP, lihat Menerapkan server MCP 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:

Untuk mempelajari lebih lanjut tentang persyaratan server A2A, lihat Menerapkan server A2A 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.<REGION>.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 <your-container-image>

# 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 <your-container-image>

# 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 <your-container-image>

# 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

Optimalisasi kinerja

Penanganan kesalahan

Persyaratan untuk AWS Marketplace pengiriman

Saat Anda mengirimkan container AgentCore Runtime Anda ke AWS Marketplace, sertakan:

Sumber Daya Tambahan

Untuk informasi selengkapnya, lihat berikut ini:

Support untuk AgentCore Runtime di AWS Marketplace

Untuk pertanyaan terkait dengan daftar container AgentCore Runtime Anda AWS Marketplace, lihat Mendapatkan dukungan untuk AWS Marketplace.

Untuk pertanyaan teknis tentang AgentCore Runtime, lihat AWS Dukungan dan Layanan Pelanggan.