Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Objetivos de Amazon Bedrock AgentCore Runtime

Puede añadir un agente de Amazon Bedrock AgentCore Runtime como destino de puerta de enlace. La puerta de enlace envía el tráfico directamente al agente de tiempo de ejecución sin necesidad de agregar ni traducir protocolos. A diferencia de los objetivos MCP, que combinan las capacidades de las herramientas en un servidor MCP virtual unificado, el objetivo AgentCore Runtime reenvía las solicitudes y respuestas entre los clientes y el agente en tiempo de ejecución sin modificaciones.

Agregar un objetivo AgentCore de tiempo de ejecución a su puerta de enlace es útil cuando desea:

Consideraciones y limitaciones clave

Cuando trabaje con objetivos AgentCore de tiempo de ejecución, tenga en cuenta las siguientes consideraciones:

Configuración de destino

Al crear un destino AgentCore de tiempo de ejecución, se proporciona el ARN del tiempo de ejecución y un calificador opcional. La puerta de enlace resuelve el punto final del tiempo de ejecución internamente, por lo que no es necesario que construyas la URL del tiempo de ejecución tú mismo.

La configuración de destino de un destino en AgentCore tiempo de ejecución utiliza la siguiente estructura:

{
    "http": {
        "agentcoreRuntime": {
            "arn": "arn:aws:bedrock-agentcore:us-west-2:111122223333:runtime/RUNTIME_ID",
            "qualifier": "DEFAULT",
            "schema": {
                "source": {
                    "s3": {
                        "uri": "s3://DOC-EXAMPLE-BUCKET/agent-schema.yaml"
                    }
                }
            }
        }
    }
}

Invocar un objetivo de tiempo de ejecución AgentCore

Para invocar un objetivo en AgentCore tiempo de ejecución a través de la puerta de enlace, envía una solicitud POST a la URL de invocación del destino. El formato de la dirección URL es:

https://{gatewayId}.gateway.bedrock-agentcore.{region}.amazonaws.com/{targetName}/invocations

{gatewayId}Sustitúyala por tu ID de puerta de enlace, por la AWS región y {targetName} por el nombre del objetivo. {region}

En el siguiente ejemplo, se usa curl para invocar un objetivo de AgentCore tiempo de ejecución:

curl -X POST https://gateway-id.gateway.bedrock-agentcore.us-west-2.amazonaws.com/my-target/invocations \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <token>" \
    -d '{"input": {"prompt": "Hello"}}'

También puede usar el AgentCore SDK de Amazon Bedrock con una anulación de la URL de un punto final:

aws bedrock-agentcore invoke-agent-runtime \
    --endpoint-url https://gateway-id.gateway.bedrock-agentcore.us-west-2.amazonaws.com/my-target \
    --runtimeArn arn:aws:bedrock-agentcore:us-west-2:111122223333:runtime/RUNTIME_ID

Autorización de salida

AgentCore Los destinos de tiempo de ejecución admiten los siguientes tipos de autorización saliente:

Imponer el tráfico a través de la puerta de enlace

Puede gestionar su AgentCore tiempo de ejecución con una AgentCore puerta de enlace para que ésta se convierta en el punto de entrada único y controlado al tiempo de ejecución, lo que le proporcionará una autorización basada en políticas, barreras de protección de Amazon Bedrock, interceptores de solicitudes y respuestas y una observabilidad unificada, todo ello fuera del entorno del propio agente. Para conocer todos los motivos, consulte Front your runtime with an Gateway. AgentCore Pero esto solo es útil si no puedes saltarte la puerta de enlace y acceder directamente al motor de ejecución. Ahora puede hacerlo independientemente de si el tiempo de ejecución utiliza la autorización entrante de IAM (SIGv4) u OAuth (JWT).

Esta restricción se configura en el tiempo de ejecución. La puerta de enlace marca el origen de cada solicitud que reenvía y el motor de ejecución valida ese origen al entrar. El mecanismo específico depende del tipo de autorización entrante del tiempo de ejecución:

Comparación de capacidades con los objetivos de MCP

Puede integrar los servidores MCP con la AgentCore puerta de enlace de Amazon Bedrock de dos maneras: usar el tipo de destino MCP en modo de agregación o usar el AgentCore tipo de destino Runtime. En la siguiente tabla se comparan las capacidades de cada enfoque.