Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Amazon Bedrock AgentCore Runtime pour AWS Marketplace

Ce document fournit des informations aux AWS Marketplace vendeurs qui souhaitent répertorier des agents ou des outils d'IA pouvant être déployés sur Amazon Bedrock AgentCore Runtime. Il décrit les exigences techniques, les directives de configuration et les meilleures pratiques pour préparer votre conteneur compatible avec Bedrock AgentCore Runtime pour AWS Marketplace.

Aperçu

Amazon Bedrock AgentCore Runtime fournit un environnement d'hébergement sécurisé, sans serveur et spécialement conçu pour le déploiement et l'exécution d'agents ou d'outils d'IA. Lorsque vous inscrivez votre conteneur Bedrock AgentCore Runtime sur Bedrock AWS Marketplace, vous devez vous assurer qu'il répond à des exigences spécifiques pour fonctionner correctement dans l'environnement Bedrock AgentCore .

Exigences techniques relatives aux AgentCore conteneurs Bedrock

Amazon Bedrock AgentCore Runtime a des exigences techniques différentes pour répertorier les agents AI, les serveurs MCP et les serveurs A2A.

Exigences relatives aux agents

Votre agent conteneurisé doit répondre aux exigences fondamentales suivantes :

/ping- OBTENEZ

Ce point de terminaison vérifie que votre agent est opérationnel et prêt à traiter les demandes.

Exemple de réponse :

{
  "status": "Healthy"
}
                

/invocations- PUBLIER

Il s'agit du point de terminaison principal de l'interaction avec l'agent lorsque les clients appellent l'agent avec une InvokeAgentRuntime action avec la charge utile au format JSON. InvokeAgentRuntime prend en charge les réponses en streaming, permettant aux clients de recevoir des réponses partielles dès qu'elles sont disponibles.

Exemple de demande :

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

Exemples de réponses :

Configuration requise pour le serveur MCP

Amazon Bedrock AgentCore Runtime vous permet de déployer et d'exécuter des serveurs MCP (Model Context Protocol). Lorsque vous configurez Amazon Bedrock AgentCore Runtime avec le protocole MCP, le service attend des conteneurs de serveur MCP sur le chemin. 0.0.0.0:8000/mcp Il s'agit du chemin par défaut pris en SDKs charge par la plupart des serveurs MCP officiels.

Dans la mesure où Amazon Bedrock AgentCore Runtime assure l'isolation des sessions par défaut, il nécessite des serveurs HTTP streamables sans état. Le moteur d'exécution ajoute automatiquement un Mcp-Session-Id en-tête pour toute demande qui n'en inclut pas un. Cela permet aux clients MCP de maintenir la continuité de la connexion à la même session Amazon Bedrock AgentCore Runtime.

L'InvokeAgentRuntimeAPI transmet directement les données de charge utile, ce qui permet de transmettre facilement des messages RPC par proxy pour des protocoles tels que MCP.

Prérequis:

Pour en savoir plus sur les exigences des serveurs MCP, voir Déployer des serveurs MCP dans AgentCore Runtime.

/mcp- PUBLIER

Il s'agit du principal point de terminaison d'interaction avec l'agent lorsque les clients appellent le serveur MCP avec InvokeAgentRuntime.

Exemple de demande de liste :

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

Exemple de réponse de liste :

Réponse JSON (sans diffusion en continu) :

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

Exemple de demande d'appel d'outil :

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

Exemple de réponse à un appel d'outil :

Réponse JSON (sans diffusion en continu) :

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

Configuration requise pour le serveur A2A

Amazon Bedrock AgentCore Runtime vous permet de déployer et d'exécuter des serveurs Agent-to-Agent (A2A) dans le AgentCore Runtime. La prise en charge AgentCore du protocole A2A d'Amazon Bedrock permet une intégration parfaite avec les serveurs A2A en agissant comme une couche proxy transparente. Lorsqu'ils sont configurés pour A2A, Amazon Bedrock AgentCore s'attend à ce que les conteneurs exécutent des serveurs HTTP apatrides et streamables sur le port situé sur le chemin racine (0.0.0.0:9000/), ce qui correspond 9000 à la configuration du serveur A2A par défaut.

Le service permet d'isoler les sessions de niveau professionnel tout en préservant la transparence du protocole : les charges utiles JSON-RPC provenant de l' InvokeAgentRuntime API sont transmises directement au conteneur A2A sans modification. Cette architecture préserve les fonctionnalités standard du protocole A2A, telles que la découverte intégrée des agents via des cartes d'agent /.well-known/agent-card.json et la communication JSON-RPC, tout en ajoutant l'authentification d'entreprise (OAuth SigV4/ 2.0) et l'évolutivité.

Les principaux facteurs de différenciation par rapport aux autres protocoles sont le port (9000 contre 8080 pour HTTP), le chemin de montage (/vs/invocations) et le mécanisme standardisé de découverte des agents, faisant d'Amazon Bedrock AgentCore une plate-forme de déploiement idéale pour les agents A2A dans les environnements de production.

Prérequis:

Pour en savoir plus sur les exigences du serveur A2A, voir Déployer des serveurs A2A dans AgentCore Runtime.

/- PUBLIER

Il s'agit du principal point de terminaison d'interaction avec l'agent lorsque les clients appellent le serveur A2A avec InvokeAgentRuntime.

Exemple de demande d'invocation d'agent :

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

Exemple de réponse à un appel d'agent :

Réponse JSON (sans diffusion en continu) :

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

Exemple de récupération d'une carte d'agent :

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

/ping- OBTENEZ

Il s'agit du point de terminaison pour effectuer les bilans de santé.

Test de votre conteneur Bedrock AgentCore Runtime

Avant de soumettre votre contenant à AWS Marketplace, testez-le minutieusement :

Tests d'agents locaux

Testez votre agent localement à l'aide de 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!"}'
            

Test du serveur MCP local

Testez votre serveur MCP localement à l'aide de 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"}}}'
            

Test du serveur A2A local

Testez votre serveur A2A localement à l'aide de 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" }}}'
            

Tests sur Bedrock Runtime AgentCore

Après avoir testé votre conteneur localement, chargez-le sur Amazon Elastic Container Registry (Amazon ECR) et déployez-le sur Amazon Bedrock Runtime. AgentCore Vous pouvez effectuer un déploiement à l'aide de la console Amazon Bedrock AgentCore Runtime ou du AWS Command Line Interface (AWS CLI).

Bonnes pratiques pour la configuration des conteneurs

Considérations sur la sécurité

Optimisation des performances

Gestion des erreurs

Exigences relatives à la AWS Marketplace soumission

Lorsque vous soumettez votre conteneur AgentCore Runtime à AWS Marketplace, incluez :

Ressources supplémentaires

Pour plus d’informations, consultez les ressources suivantes :

Support pour AgentCore Runtime on AWS Marketplace

Pour les questions relatives à l'inscription de votre conteneur AgentCore Runtime sur AWS Marketplace, consultez la section Obtenir de l'aide pour AWS Marketplace.

Pour les questions techniques concernant AgentCore Runtime, consultez AWS Support la section Service clientèle.