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.

AWS Objetivos de funciones Lambda

Los objetivos de Lambda le permiten conectar su puerta de enlace a las funciones de AWS Lambda que implementan sus herramientas. Esto resulta útil cuando desea ejecutar código personalizado en respuesta a las invocaciones de herramientas.

La función Lambda se crea mediante el servicio AWS Lambda. Para crear la función, debe hacer lo siguiente:

Después de crear la función, configure los permisos para que la puerta de enlace pueda acceder a ella.

Revise las principales consideraciones y limitaciones que le ayudarán a decidir si un objetivo de Lambda es aplicable a su caso de uso. Si lo es, puede crear el esquema de la herramienta y la función Lambda y, a continuación, configurar los permisos para que la puerta de enlace pueda acceder al destino. Elija un tema para obtener más información:

Consideraciones y limitaciones clave

Cuando trabaje con objetivos de Lambda, tenga en cuenta las siguientes limitaciones y consideraciones:

Esquema de la herramienta de funciones Lambda

En esta sección se explica la estructura del esquema de herramientas que define una herramienta que la función Lambda puede devolver. Después de definir el esquema de la herramienta, puede realizar una de las siguientes acciones:

Seleccione un tema para obtener más información sobre los detalles del esquema de la herramienta o para ver ejemplos:

Definición de la herramienta

Cuando agrega una función Lambda como destino de puerta de enlace, proporciona una configuración ToolDefinition al proporcionar el destino. La estructura de la definición de la herramienta es la siguiente:

{
    "name": "string",
    "description": "string",
    "inputSchema": {
        "type": "object",
        "description" "string",
        "properties": {
            "string": SchemaDefinition
        },
        "required": ["string"]
    },
    "outputSchema": {
        "type": "object",
        "description" "string",
        "properties": {
            "string": SchemaDefinition
        },
        "required": ["string"]
    }
}

La definición de la herramienta contiene los campos siguientes:

inputSchemaTanto el campo como el outputSchema campo se asignan a un tipo de objeto SchemaDefinition, que se describe en la siguiente sección.

Definición de esquema de nivel superior para esquemas de entrada y salida

inputSchemaTanto outputSchema los campos como los del nivel superior de la definición de la herramienta se asignan a un tipo de objeto SchemaDefinition que contiene los siguientes campos:

{
    "type": "object",
    "description": "string",
    "properties": {
        "string": SchemaDefinition
    },
    "required": ["string"]
}

Si incluye un properties campo para definir los argumentos de la herramienta, proporciona una definición de esquema para cada argumento. Los diferentes tipos de definiciones de esquema se describen en la siguiente sección.

Definición del esquema de propiedades

Cada propiedad del nivel superior se SchemaDefinition asigna a un SchemaDefinition objeto que tiene requisitos ligeramente diferentes a los de la definición del esquema de nivel superior. Los campos disponibles dependen del type de la propiedad. Para ver la forma de un tipo, seleccione una de las siguientes pestañas: SchemaDefinition

Si incluye otra propiedad de tipo objeto, agregará otra de forma recursiva. SchemaDefinition

Ejemplos de definiciones de herramientas Lambda

Seleccione una pestaña para ver ejemplos de definiciones de herramientas que puede incluir en su función Lambda.

Formato de entrada de la función Lambda

Cuando una AgentCore puerta de enlace de Amazon Bedrock invoca una función Lambda, pasa un event objeto y un context objeto a la función. El controlador de eventos de Lambda que escriba puede acceder a los valores de estos objetos.

Objeto de evento

Un mapa de sus valores inputSchema a properties partir de los valores devueltos por la herramienta. Por ejemplo, si el esquema de entrada contiene las propiedades keywords ycategory, el objeto de evento podría ser el siguiente:

{
  "keywords": "wireless headphones",
  "category": "electronics"
}

Objeto de contexto

Contiene los siguientes metadatos:

El formato del objeto de contexto es el siguiente:

{
  "bedrockAgentCoreMessageVersion": "1.0",
  "bedrockAgentCoreAwsRequestId": "string",
  "bedrockAgentCoreMcpMessageId": "string",
  "bedrockAgentCoreGatewayId": "string",
  "bedrockAgentCoreTargetId": "string",
  "bedrockAgentCoreToolName": "string"
}

La función Lambda que escribas puede acceder a las propiedades del evento y del objeto de contexto. Puede usar el siguiente código repetitivo para empezar:

# Access context properties in your Lambda function
def lambda_handler(event, context):
    # Since the visible tool name includes the target name as a prefix, we can use this delimiter to strip the prefix
    delimiter = "___"

    # Get the tool name from the context
    originalToolName = context.client_context.custom['bedrockAgentCoreToolName']
    toolName = originalToolName[originalToolName.index(delimiter) + len(delimiter):]

    # Get other context properties
    message_version = context.client_context.custom['bedrockAgentCoreMessageVersion']
    aws_request_id = context.client_context.custom['bedrockAgentCoreAwsRequestId']
    mcp_message_id = context.client_context.custom['bedrockAgentCoreMcpMessageId']
    gateway_id = context.client_context.custom['bedrockAgentCoreGatewayId']
    target_id = context.client_context.custom['bedrockAgentCoreTargetId']

    # Process the request based on the tool name
    if tool_name == 'searchProducts':
        # Handle searchProducts tool
        pass
    elif tool_name == 'getProductDetails':
        # Handle getProductDetails tool
        pass
    else:
        # Handle unknown tool
        pass