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à.

AWS Obiettivi della funzione Lambda

I target Lambda ti consentono di connettere il tuo gateway alle funzioni AWS Lambda che implementano i tuoi strumenti. Ciò è utile quando si desidera eseguire codice personalizzato in risposta alle chiamate degli strumenti.

Crei una funzione Lambda utilizzando il AWS servizio Lambda. Per creare la funzione, devi fare quanto segue:

Dopo aver creato la funzione, si configurano le autorizzazioni per consentire al gateway di accedervi.

Esamina le principali considerazioni e limitazioni per aiutarti a decidere se un target Lambda è applicabile al tuo caso d'uso. In tal caso, puoi creare lo schema dello strumento e la funzione Lambda e quindi impostare le autorizzazioni affinché il gateway possa accedere al target. Per ulteriori informazioni, scegli un argomento:

Considerazioni e limitazioni principali

Quando lavori con obiettivi Lambda, tieni presente le seguenti limitazioni e considerazioni:

Schema dello strumento funzionale Lambda

Questa sezione spiega la struttura dello schema dello strumento che definisce uno strumento che la funzione Lambda può restituire. Dopo aver definito lo schema dello strumento, puoi effettuare una delle seguenti operazioni:

Seleziona un argomento per saperne di più sui dettagli dello schema dello strumento o per visualizzare alcuni esempi:

Definizione dello strumento

Quando aggiungi una funzione Lambda come destinazione del gateway, fornisci un ToolDefinition quando fornisci la configurazione della destinazione. La struttura della definizione dello strumento è la seguente:

{
    "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 definizione dello strumento contiene i seguenti campi:

I outputSchema campi inputSchema and sono entrambi mappati a un tipo di oggetto SchemaDefinition, descritto nella sezione seguente.

Definizione di schema di primo livello per schemi di input e output

I outputSchema campi inputSchema e al livello superiore della definizione dello strumento sono entrambi mappati a un tipo di oggetto SchemaDefinition che contiene i seguenti campi:

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

Se si include un properties campo per definire gli argomenti per lo strumento, si fornisce una definizione dello schema per ogni argomento. I diversi tipi di definizioni dello schema sono descritti nella sezione successiva.

Definizione dello schema delle proprietà

Ogni proprietà nel livello superiore è SchemaDefinition mappata a un SchemaDefinition oggetto che ha requisiti leggermente diversi dalla definizione dello schema di primo livello. I campi disponibili dipendono dal tipo type di proprietà. Per visualizzare la forma di un tipo, seleziona una delle seguenti schede: SchemaDefinition

Se includete un'altra proprietà del tipo di oggetto, ne aggiungerete un'altra in modo ricorsivo. SchemaDefinition

Esempi di definizioni degli strumenti Lambda

Seleziona una scheda per visualizzare esempi di definizioni di strumenti che puoi includere nella tua funzione Lambda.

Formato di input della funzione Lambda

Quando un AgentCore gateway Amazon Bedrock richiama una funzione Lambda, passa un event oggetto e un context oggetto alla funzione. Il gestore di eventi Lambda che scrivi può accedere ai valori in questi oggetti.

Oggetto evento

Una mappa properties dai valori inputSchema ai relativi valori, come restituito dallo strumento. Ad esempio, se lo schema di input contiene le proprietà keywords ecategory, l'oggetto evento potrebbe essere il seguente:

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

Oggetto di contesto

Contiene i seguenti metadati:

Il formato dell'oggetto di contesto è il seguente:

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

La funzione Lambda che scrivi può accedere alle proprietà dell'evento e dell'oggetto di contesto. È possibile utilizzare il seguente codice standard per iniziare:

# 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