翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

の Amazon Bedrock AgentCore ランタイム AWS Marketplace

このドキュメントでは、Amazon Bedrock AgentCore ランタイムにデプロイできる AI エージェントまたはツールを一覧表示したい AWS Marketplace 販売者向けの情報を提供します。ここでは、 AWS Marketplaceで Bedrock AgentCore Runtime がサポートするコンテナを準備するための技術要件、設定ガイドライン、ベストプラクティスの概要を説明します。

概要:

Amazon Bedrock AgentCore Runtime は、AI エージェントまたはツールをデプロイして実行するための、安全でサーバーレスな専用のホスティング環境を提供します。Bedrock AgentCore ランタイムコンテナを に一覧表示するときは AWS Marketplace、Bedrock AgentCore 環境内で適切に機能するための特定の要件を満たしていることを確認する必要があります。

Bedrock AgentCore コンテナの技術要件

Amazon Bedrock AgentCore ランタイムには、AI エージェント、MCP サーバー、A2A サーバーを一覧表示するためのさまざまな技術要件があります。

エージェントの要件

コンテナ化されたエージェントは、次のコア要件を満たしている必要があります。

/ping - GET

このエンドポイントは、エージェントが動作しており、リクエストを処理する準備ができていることを確認します。

レスポンスの例:

{
  "status": "Healthy"
}
                

/invocations - POST

これは、顧客が JSON 形式のペイロードを使用して InvokeAgentRuntime アクションでエージェントを呼び出すときの、主要なエージェントインタラクションエンドポイントです。InvokeAgentRuntime はストリーミングレスポンスをサポートしているため、お客様は利用可能になったときに部分的なレスポンスを受け取ることができます。

リクエストの例:

Content-Type: application/json
{
  "prompt": "What's the weather today?"
}
                

レスポンスの例:

MCP サーバーの要件

Amazon Bedrock AgentCore Runtime を使用すると、モデルコンテキストプロトコル (MCP) サーバーをデプロイして実行できます。MCP プロトコルを使用して Amazon Bedrock AgentCore Runtime を設定すると、サービスはパス 0.0.0.0:8000/mcp で MCP サーバーコンテナを想定します。これは、最も公式な MCP サーバー SDK がサポートするデフォルトのパスです。

Amazon Bedrock AgentCore Runtime はデフォルトでセッション分離を提供するため、ステートレスストリーミング可能 HTTP サーバーが必要です。ランタイムは、リクエストを含まないリクエストの Mcp-Session-Id ヘッダーを自動的に追加します。これにより、MCP クライアントは同じ Amazon Bedrock AgentCore Runtime セッションへの接続継続性を維持できます。

InvokeAgentRuntime API はペイロードデータを直接渡すため、MCP などのプロトコルの RPC メッセージを簡単にプロキシできます。

要件:

MCP サーバーの要件の詳細については、「AgentCore Runtime で MCP サーバーをデプロイする」を参照してください。

/mcp - POST

これは、顧客が InvokeAgentRuntime を使用して MCP サーバーを呼び出すときの、プライマリエージェントインタラクションエンドポイントです。

一覧表示リクエストの例:

Content-Type: application/json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list",
}
                

一覧表示レスポンスの例:

JSON レスポンス (非ストリーミング):

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"
  }
}
                

ツール呼び出しリクエストの例:

Content-Type: application/json
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "get_weather",
    "arguments": {
      "location": "New York"
    }
  }
}
                

ツール呼び出しレスポンスの例:

JSON レスポンス (非ストリーミング):

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
  }
}
                

A2A サーバーの要件

Amazon Bedrock AgentCore Runtime では、AgentCore Runtime で Agent-to-Agent (A2A) AgentCore サーバーをデプロイして実行できます。Amazon Bedrock AgentCore の A2A プロトコルサポートにより、透過的なプロキシレイヤーとして機能し、A2A サーバーとのシームレスな統合が可能になります。A2A 用に設定されている場合、Amazon Bedrock AgentCore は、デフォルトの A2A サーバー設定と一致するルートパス (0.0.0.0:9000/) のポート9000でコンテナがステートレスでストリーミング可能な HTTP サーバーを実行することを期待します。 A2A

このサービスは、プロトコルの透明性を維持しながらエンタープライズグレードのセッション分離を提供します。InvokeAgentRuntime API からの JSON-RPC ペイロードは、変更なしで A2A コンテナに直接渡されます。このアーキテクチャは、 のエージェントカードによる組み込みエージェント検出/.well-known/agent-card.jsonや JSON-RPC 通信などの標準の A2A プロトコル機能を保持し、エンタープライズ認証 (SigV4/OAuth 2.0) とスケーラビリティを追加します。

他のプロトコルとの主な違いは、ポート (HTTP の場合は 9000 対 8080)、マウントパス (/ 対 /invocations)、標準化されたエージェント検出メカニズムです。Amazon Bedrock AgentCore は、本番環境の A2A エージェントに最適なデプロイプラットフォームです。

要件:

A2A サーバーの要件の詳細については、AgentCore ランタイムで A2A サーバーをデプロイする」を参照してください。

/ - POST

これは、顧客が InvokeAgentRuntime を使用して A2A サーバーを呼び出すときの、主要なエージェントインタラクションエンドポイントです。

エージェント呼び出しリクエストの例:

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"  
    }  
  } 
}
                

エージェント呼び出しレスポンスの例:

JSON レスポンス (非ストリーミング):

Content-Type: application/json
{
  "jsonrpc": "2.0",
  "id": "req-001",
  "result": {
    "artifacts": [
      {
        "parts": [
          {
            "kind": "text",
            "text": "101 * 11 is 1111"
          }
        ]
      }
    ]
  }
}
                

エージェントカードの取得例:

curl https://bedrock-agentcore.<REGION>.amazonaws.com/runtimes/{escaped_agent_arn}/invocations/.well-known/agent-card.json
                

/ping - GET

これは、ヘルスチェックを実行するためのエンドポイントです。

Bedrock AgentCore Runtime コンテナのテスト

コンテナを に送信する前に AWS Marketplace、徹底的にテストします。

ローカルエージェントのテスト

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!"}'
            

ローカル MCP サーバーテスト

Docker を使用して MCP サーバーをローカルでテストする

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"}}}'
            

ローカル A2A サーバーテスト

Docker を使用して A2A サーバーをローカルでテストする

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" }}}'
            

Bedrock AgentCore Runtime でのテスト

コンテナをローカルでテストした後、Amazon Elastic Container Registry (Amazon ECR) にアップロードし、Amazon Bedrock AgentCore Runtime にデプロイします。Amazon Bedrock AgentCore ランタイムコンソールまたは AWS Command Line Interface () を使用してデプロイできますAWS CLI。

コンテナ設定のベストプラクティス

セキュリティに関する考慮事項

パフォーマンスの最適化

エラー処理

AWS Marketplace 送信の要件

AgentCore ランタイムコンテナを に送信するときは AWS Marketplace、以下を含めます。

その他のリソース

詳細については次を参照してください:

での AgentCore ランタイムのサポート AWS Marketplace

AgentCore Runtime コンテナの への一覧表示に関する質問については AWS Marketplace、「サポートの取得 AWS Marketplace」を参照してください。

AgentCore ランタイムに関する技術的な質問については、AWS サポート 「」および「カスタマーサービス」を参照してください。