Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Amazon Bedrock AgentCore Runtime per Marketplace AWS

Questo documento fornisce informazioni per Marketplace AWS i venditori che desiderano elencare agenti o strumenti di intelligenza artificiale che possono essere distribuiti su Amazon AgentCore Bedrock Runtime. Descrive i requisiti tecnici, le linee guida di configurazione e le migliori pratiche per preparare il container supportato da Bedrock AgentCore Runtime per. Marketplace AWS

Panoramica

Amazon Bedrock AgentCore Runtime offre un ambiente di hosting sicuro, serverless e progettato appositamente per la distribuzione e l'esecuzione di agenti o strumenti di intelligenza artificiale. Quando metti in vendita il tuo container Bedrock AgentCore Runtime Marketplace AWS, devi assicurarti che soddisfi requisiti specifici per funzionare correttamente all'interno dell'ambiente Bedrock. AgentCore

Requisiti tecnici del AgentCore contenitore Bedrock

Amazon Bedrock AgentCore Runtime ha diversi requisiti tecnici per elencare agenti AI, server MCP e server A2A.

Requisiti degli agenti

L'agente containerizzato deve soddisfare i seguenti requisiti fondamentali:

/ping- OTTIENI

Questo endpoint verifica che l'agente sia operativo e pronto a gestire le richieste.

Esempio di risposta:

{
  "status": "Healthy"
}
                

/invocations- POSTA

Questo è l'endpoint di interazione principale con l'agente quando i clienti chiamano l'agente per InvokeAgentRuntime intervenire con il payload in formato JSON. InvokeAgentRuntime supporta le risposte in streaming, permettendo ai clienti di ricevere risposte parziali non appena diventano disponibili.

Richiesta di esempio:

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

Risposte di esempio:

Requisiti del server MCP

Amazon Bedrock AgentCore Runtime consente di distribuire ed eseguire server Model Context Protocol (MCP). Quando configuri Amazon Bedrock AgentCore Runtime con il protocollo MCP, il servizio prevede contenitori di server MCP sul percorso. 0.0.0.0:8000/mcp Questo è il percorso predefinito supportato dalla maggior parte dei server MCP ufficiali. SDKs

Poiché Amazon Bedrock AgentCore Runtime fornisce l'isolamento della sessione per impostazione predefinita, richiede server HTTP in streaming senza stato. Il runtime aggiunge automaticamente un'Mcp-Session-Idintestazione per qualsiasi richiesta che non ne includa una. Ciò consente ai client MCP di mantenere la continuità della connessione alla stessa sessione di Amazon Bedrock AgentCore Runtime.

L'InvokeAgentRuntimeAPI trasmette direttamente i dati del payload, il che consente di inviare facilmente messaggi RPC tramite proxy per protocolli come MCP.

Requisiti:

Per ulteriori informazioni sui requisiti dei server MCP, consulta Distribuire i server MCP in Runtime. AgentCore

/mcp- PUBBLICA

Questo è l'endpoint di interazione principale con l'agente con cui i clienti chiamano il server MCP. InvokeAgentRuntime

Esempio di richiesta di elenco:

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

Esempio di risposta all'elenco:

Risposta JSON (non in 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"
  }
}
                

Esempio di richiesta di chiamata allo strumento:

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

Esempio di risposta alla chiamata dello strumento:

Risposta JSON (non in 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
  }
}
                

Requisiti del server A2A

Amazon Bedrock AgentCore Runtime consente di distribuire ed eseguire server Agent-to-Agent (A2A) nel Runtime. AgentCore Il supporto AgentCore del protocollo A2A di Amazon Bedrock consente una perfetta integrazione con i server A2A fungendo da livello proxy trasparente. Una volta configurato per A2A, Amazon Bedrock AgentCore prevede che i container eseguano server HTTP stateless e in streaming sulla porta nel percorso principale (0.0.0.0:9000/), 9000 in linea con la configurazione predefinita del server A2A.

Il servizio offre un isolamento delle sessioni di livello aziendale mantenendo al contempo la trasparenza del protocollo: i payload JSON-RPC dall'API vengono trasferiti direttamente al contenitore A2A senza modifiche. InvokeAgentRuntime Questa architettura preserva le funzionalità standard del protocollo A2A, come il rilevamento integrato degli agenti tramite Agent Cards at /.well-known/agent-card.json e la comunicazione JSON-RPC, aggiungendo al contempo l'autenticazione aziendale (SigV4/ 2.0) e la scalabilità. OAuth

I principali fattori di differenziazione dagli altri protocolli sono la porta (9000 vs 8080 per HTTP), il mount path (/vs/invocations) e il meccanismo standardizzato di rilevamento degli agenti, che rendono Amazon Bedrock AgentCore una piattaforma di distribuzione ideale per gli agenti A2A negli ambienti di produzione.

Requisiti:

Per ulteriori informazioni sui requisiti dei server A2A, consulta Deploy A2A servers in Runtime. AgentCore

/- PUBBLICA

Questo è il principale endpoint di interazione tra agenti con cui i clienti chiamano il server A2A. InvokeAgentRuntime

Esempio di richiesta di invocazione dell'agente:

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

Esempio di risposta alla chiamata dell'agente:

Risposta JSON (non in streaming):

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

Esempio di recupero della carta da parte di un agente:

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

/ping- OTTIENI

Questo è l'endpoint per eseguire i controlli sanitari.

Test del contenitore Bedrock Runtime AgentCore

Prima di inviarlo Marketplace AWS, testalo attentamente:

Test con agenti locali

Testa il tuo agente localmente usando 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 del server MCP locale

Testa il tuo server MCP localmente usando 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 del server A2A locale

Testa il tuo server A2A localmente usando 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" }}}'
            

Test su Bedrock Runtime AgentCore

Dopo aver testato il contenitore localmente, caricalo su Amazon Elastic Container Registry (Amazon ECR) e distribuiscilo su Amazon Bedrock Runtime. AgentCore Puoi eseguire la distribuzione utilizzando la console Amazon Bedrock AgentCore Runtime o AWS Command Line Interface ()AWS CLI.

Le migliori pratiche per la configurazione dei container

Considerazioni relative alla sicurezza

Ottimizzazione delle prestazioni

Gestione degli errori

Marketplace AWS Requisiti per la presentazione

Quando invii il contenitore AgentCore Runtime a Marketplace AWS, includi:

Risorse aggiuntive

Per ulteriori informazioni, consulta gli argomenti seguenti:

Support per AgentCore Runtime su Marketplace AWS

Per domande relative alla pubblicazione del contenitore AgentCore Runtime Marketplace AWS, consulta Ottenere assistenza per Marketplace AWS.

Per domande tecniche su AgentCore Runtime, consulta Supporto AWS e Servizio clienti.