As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Amazon Bedrock AgentCore Runtime para AWS Marketplace

Este documento fornece informações para AWS Marketplace vendedores que desejam listar agentes ou ferramentas de IA que podem ser implantados no Amazon Bedrock AgentCore Runtime. Ele descreve os requisitos técnicos, as diretrizes de configuração e as melhores práticas para preparar seu contêiner compatível com o Bedrock AgentCore Runtime para. AWS Marketplace

Visão geral do

O Amazon Bedrock AgentCore Runtime fornece um ambiente de hospedagem seguro, sem servidor e criado especificamente para implantar e executar agentes ou ferramentas de IA. Ao listar seu contêiner Bedrock AgentCore Runtime em AWS Marketplace, você precisa garantir que ele atenda aos requisitos específicos para funcionar adequadamente no ambiente Bedrock AgentCore .

Requisitos técnicos do AgentCore contêiner Bedrock

O Amazon Bedrock AgentCore Runtime tem diferentes requisitos técnicos para listar agentes de IA, servidores MCP e servidores A2A.

Requisitos do agente

O atendente em contêiner deve atender aos seguintes requisitos principais:

/ping: GET

Este endpoint verifica se o atendente está operacional e pronto para resolver as solicitações.

Resposta de exemplo:

{
  "status": "Healthy"
}
                

/invocations: POST

Esse é o principal endpoint de interação do agente quando os clientes ligam para o agente com InvokeAgentRuntime uma ação com a carga no formato JSON. InvokeAgentRuntime suporta respostas de streaming, permitindo que os clientes recebam respostas parciais à medida que elas se tornam disponíveis.

Solicitação de exemplo:

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

Respostas de exemplo:

Requisitos do servidor MCP

O Amazon Bedrock AgentCore Runtime permite que você implante e execute servidores Model Context Protocol (MCP). Quando você configura o Amazon Bedrock AgentCore Runtime com o protocolo MCP, o serviço espera contêineres de servidor MCP no caminho. 0.0.0.0:8000/mcp Esse é o caminho padrão SDKs suportado pela maioria dos servidores MCP oficiais.

Como o Amazon Bedrock AgentCore Runtime fornece isolamento de sessão por padrão, ele exige servidores HTTP streamáveis sem estado. O runtime adiciona automaticamente um cabeçalho Mcp-Session-Id para qualquer solicitação que não inclua um. Isso permite que os clientes MCP mantenham a continuidade da conexão com a mesma sessão do Amazon Bedrock AgentCore Runtime.

A API InvokeAgentRuntime passa diretamente pelos dados de carga útil, o que permite o proxy facilitado de mensagens RPC para protocolos como o MCP.

Requisitos:

Para saber mais sobre os requisitos do servidor MCP, consulte Implantar servidores MCP no AgentCore Runtime.

/mcp: POST

Esse é o principal endpoint de interação do agente quando os clientes ligam para o servidor MCP com. InvokeAgentRuntime

Solicitação da lista de exemplo:

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

Resposta da lista de exemplo:

Resposta JSON (sem 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"
  }
}
                

Solicitação de chamada da ferramenta de exemplo:

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

Resposta de chamada da ferramenta de exemplo:

Resposta JSON (sem 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
  }
}
                

Requisitos do servidor A2A

O Amazon Bedrock AgentCore Runtime permite que você implante e execute servidores Agent-to-Agent (A2A) no Runtime. AgentCore O suporte ao protocolo AgentCore A2A do Amazon Bedrock permite uma integração perfeita com servidores A2A, atuando como uma camada de proxy transparente. Quando configurado para A2A, o Amazon Bedrock AgentCore espera que os contêineres executem servidores HTTP sem estado e streamáveis 9000 na porta do caminho raiz (0.0.0.0:9000/), que se alinha à configuração padrão do servidor A2A.

O serviço fornece isolamento de sessão de nível corporativo, mantendo a transparência do protocolo - as cargas JSON-RPC da InvokeAgentRuntime API são passadas diretamente para o contêiner A2A sem modificação. Essa arquitetura preserva os recursos padrão do protocolo A2A, como descoberta de agentes integrada por meio de cartões de agente /.well-known/agent-card.json e comunicação JSON-RPC, ao mesmo tempo em que adiciona autenticação corporativa (SigV4/2.0) e escalabilidade. OAuth

Os principais diferenciais de outros protocolos são a porta (9000 versus 8080 para HTTP), o caminho de montagem (/vs/invocations) e o mecanismo padronizado de descoberta de agentes, tornando o Amazon Bedrock AgentCore uma plataforma de implantação ideal para agentes A2A em ambientes de produção.

Requisitos:

Para saber mais sobre os requisitos do servidor A2A, consulte Implantar servidores A2A no Runtime. AgentCore

/: POST

Esse é o principal endpoint de interação do agente quando os clientes ligam para o servidor A2A com. InvokeAgentRuntime

Exemplo de solicitação de invocação de 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"  
    }  
  } 
}
                

Exemplo de resposta de invocação de agente:

Resposta JSON (sem streaming):

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

Exemplo de recuperação de cartão de agente:

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

/ping: GET

Esse é o endpoint para realizar verificações de saúde.

Testando seu contêiner Bedrock AgentCore Runtime

Antes de enviar seu contêiner para AWS Marketplace, teste-o minuciosamente:

Teste do atendente local

Testar o atendente localmente usando o 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!"}'
            

Teste do servidor MCP local

Testar o servidor MCP localmente usando o 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"}}}'
            

Teste de servidor A2A local

Teste seu servidor A2A localmente usando o 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" }}}'
            

Testando no Bedrock AgentCore Runtime

Depois de testar seu contêiner localmente, faça o upload para o Amazon Elastic Container Registry (Amazon ECR) e implante-o no Amazon Bedrock Runtime. AgentCore Você pode implantar usando o console Amazon Bedrock AgentCore Runtime ou o AWS Command Line Interface (AWS CLI).

Práticas recomendadas para configuração do contêiner

Considerações sobre segurança

Otimização de desempenho

Tratamento de erros

Requisitos para AWS Marketplace submissão

Ao enviar seu contêiner AgentCore Runtime para AWS Marketplace, inclua:

Recursos adicionais

Para obter mais informações, consulte o seguinte:

Support for AgentCore Runtime em AWS Marketplace

Para questões relacionadas à listagem do seu contêiner AgentCore Runtime em AWS Marketplace, consulte Como obter suporte para AWS Marketplace.

Para perguntas técnicas sobre AgentCore Runtime, consulte AWS Support e Atendimento ao cliente.