Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Amazon Bedrock AgentCore Runtime für AWS Marketplace

Dieses Dokument enthält Informationen für AWS Marketplace Verkäufer, die KI-Agenten oder Tools auflisten möchten, die auf Amazon Bedrock AgentCore Runtime eingesetzt werden können. Es beschreibt die technischen Anforderungen, Konfigurationsrichtlinien und Best Practices für die Vorbereitung Ihres von Bedrock AgentCore Runtime unterstützten Containers für. AWS Marketplace

Übersicht

Amazon Bedrock AgentCore Runtime bietet eine sichere, serverlose und speziell entwickelte Hosting-Umgebung für die Bereitstellung und Ausführung von KI-Agenten oder -Tools. Wenn Sie Ihren Bedrock AgentCore Runtime-Container anbieten, müssen Sie sicherstellen AWS Marketplace, dass er bestimmte Anforderungen erfüllt, damit er in der Bedrock-Umgebung ordnungsgemäß funktioniert. AgentCore

Technische Anforderungen für AgentCore Bedrock-Container

Amazon Bedrock AgentCore Runtime hat unterschiedliche technische Anforderungen für die Auflistung von AI-Agenten, MCP-Servern und A2A-Servern.

Anforderungen an den Agenten

Ihr Agent in Containern muss die folgenden Kernanforderungen erfüllen:

/ping- HOLEN

Dieser Endpunkt überprüft, ob Ihr Agent betriebsbereit und bereit ist, Anfragen zu bearbeiten.

Beispiel für eine Antwort:

{
  "status": "Healthy"
}
                

/invocations- BEITRAG

Dies ist der primäre Endpunkt der Agenteninteraktion, wenn Kunden den Agenten mit der Payload im JSON-Format anrufen, um eine InvokeAgentRuntime Aktion auszuführen. InvokeAgentRuntime unterstützt Streaming-Antworten, sodass Kunden Teilantworten erhalten können, sobald diese verfügbar sind.

Beispiel für eine Anfrage:

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

Beispielantworten:

MCP-Serveranforderungen

Mit Amazon Bedrock AgentCore Runtime können Sie Model Context Protocol (MCP) -Server bereitstellen und ausführen. Wenn Sie Amazon Bedrock AgentCore Runtime mit dem MCP-Protokoll konfigurieren, erwartet der Service MCP-Servercontainer im Pfad. 0.0.0.0:8000/mcp Dies ist der Standardpfad, den die meisten offiziellen MCP-Server unterstützen. SDKs

Da Amazon Bedrock AgentCore Runtime standardmäßig Sitzungsisolierung bietet, sind statuslose Streamable-HTTP-Server erforderlich. Die Runtime fügt automatisch einen Mcp-Session-Id Header für jede Anfrage hinzu, die keinen enthält. Auf diese Weise können MCP-Clients die Verbindungskontinuität zu derselben Amazon Bedrock AgentCore Runtime-Sitzung aufrechterhalten.

Die InvokeAgentRuntime API leitet Nutzdaten direkt weiter, was die einfache Weiterleitung von RPC-Nachrichten für Protokolle wie MCP ermöglicht.

Voraussetzungen:

Weitere Informationen zu den MCP-Serveranforderungen finden Sie unter Bereitstellen von MCP-Servern in Runtime. AgentCore

/mcp- BEITRAG

Dies ist der primäre Endpunkt für Agenteninteraktionen, mit InvokeAgentRuntime dem Kunden den MCP-Server anrufen.

Beispiel für eine Listenanfrage:

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

Beispiel für eine Listenantwort:

JSON-Antwort (kein 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"
  }
}
                

Beispiel für eine Anfrage zum Tool-Aufruf:

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

Beispiel für eine Antwort auf einen Tool-Aufruf:

JSON-Antwort (kein 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
  }
}
                

A2A-Serveranforderungen

Mit Amazon Bedrock AgentCore Runtime können Sie Agent-to-Agent (A2A) -Server in der AgentCore Runtime bereitstellen und ausführen. AgentCoreDie A2A-Protokollunterstützung von Amazon Bedrock ermöglicht eine nahtlose Integration mit A2A-Servern, indem sie als transparente Proxyschicht fungiert. Bei der Konfiguration für A2A AgentCore erwartet Amazon Bedrock, dass Container statuslose, streambare HTTP-Server auf dem Port 9000 im Root-Pfad (0.0.0.0:9000/) ausführen, was der standardmäßigen A2A-Serverkonfiguration entspricht.

Der Service bietet Sitzungsisolierung auf Unternehmensebene bei gleichzeitiger Wahrung der Protokolltransparenz — JSON-RPC-Nutzlasten von der API werden ohne Änderung direkt an den InvokeAgentRuntime A2A-Container weitergeleitet. Diese Architektur behält die standardmäßigen A2A-Protokollfunktionen wie die integrierte Agentenerkennung über Agentenkarten bei /.well-known/agent-card.json und die JSON-RPC-Kommunikation bei und bietet gleichzeitig Unternehmensauthentifizierung (SigV4/2.0) und Skalierbarkeit. OAuth

Die wichtigsten Unterscheidungsmerkmale zu anderen Protokollen sind der Port (9000 gegenüber 8080 für HTTP), der Bereitstellungspfad (/vs/invocations) und der standardisierte Agentenerkennungsmechanismus, was Amazon Bedrock zu AgentCore einer idealen Bereitstellungsplattform für A2A-Agenten in Produktionsumgebungen macht.

Voraussetzungen:

Weitere Informationen zu den A2A-Serveranforderungen finden Sie unter Bereitstellen von A2A-Servern in Runtime. AgentCore

/- BEITRAG

Dies ist der primäre Endpunkt für Agenteninteraktionen, mit InvokeAgentRuntime dem Kunden den A2A-Server anrufen.

Beispiel für eine Anfrage zum Aufrufen eines Agenten:

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

Beispiel für eine Antwort auf einen Agentenaufruf:

JSON-Antwort (kein Streaming):

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

Beispiel für den Abruf einer Agentenkarte:

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

/ping- HOLEN

Dies ist der Endpunkt für die Durchführung von Gesundheitschecks.

Testen Sie Ihren Bedrock AgentCore Runtime-Container

Bevor Sie Ihren Container einreichen AWS Marketplace, testen Sie ihn gründlich:

Testen mit lokalen Agenten

Testen Sie Ihren Agenten lokal mit 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!"}'
            

Testen lokaler MCP-Server

Testen Sie Ihren MCP-Server lokal mit 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"}}}'
            

Testen lokaler A2A-Server

Testen Sie Ihren A2A-Server lokal mit 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" }}}'
            

Testen auf Bedrock Runtime AgentCore

Nachdem Sie Ihren Container lokal getestet haben, laden Sie ihn in Amazon Elastic Container Registry (Amazon ECR) hoch und stellen Sie ihn in Amazon Bedrock AgentCore Runtime bereit. Sie können die Bereitstellung entweder mit der Amazon Bedrock AgentCore Runtime-Konsole oder mit AWS Command Line Interface (AWS CLI) durchführen.

Bewährte Methoden für die Container-Konfiguration

Sicherheitsüberlegungen

Leistungsoptimierung

Fehlerbehandlung

Voraussetzungen für die Einreichung AWS Marketplace

Wenn Sie Ihren AgentCore Runtime-Container an einreichen AWS Marketplace, müssen Sie Folgendes angeben:

Weitere Ressourcen

Weitere Informationen finden Sie hier:

Support für AgentCore Runtime on AWS Marketplace

Fragen zur Listung Ihres AgentCore Runtime-Containers auf AWS Marketplace finden Sie unter Support erhalten für AWS Marketplace.

Technische Fragen zu AgentCore Runtime finden Sie unter AWS Support Kundenservice.