AWS Objetivos de la función Lambda

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

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

Tras crear la función, debe configurar los permisos para que la puerta de enlace pueda acceder a ella.

Revise las consideraciones y limitaciones clave para ayudarle a decidir si un objetivo Lambda es aplicable a su caso de uso. Si es así, 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 Lambda, tenga en cuenta las siguientes limitaciones y consideraciones:

Esquema de herramientas 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. Tras 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 herramienta

Cuando agrega una función Lambda como destino de puerta de enlace, proporciona una ToolDefinitional proporcionar la configuración de 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 siguientes campos:

Ambos outputSchema campos inputSchema y se asignan a un tipo de objeto SchemaDefinition, tal como se describe en la siguiente sección.

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

Los outputSchema campos inputSchema y del nivel superior de la definición de la herramienta se asignan a un tipo de objeto SchemaDefinitionque 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 distintos 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 SchemaDefinitionobjeto que tiene requisitos ligeramente diferentes de los de la definición del esquema de nivel superior. Los campos disponibles dependen 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 la 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 Lambda que escriba puede acceder a los valores de estos objetos.

Objeto de evento

Un mapa properties de inputSchema a sus valores, tal como lo devuelve la herramienta. Por ejemplo, si el esquema de entrada contiene las propiedades keywords ycategory, el objeto del 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 escriba puede acceder a las propiedades del evento y del objeto de contexto. Para empezar, puede utilizar el siguiente código repetitivo:

# 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