AWS Target fungsi Lambda

Target Lambda memungkinkan Anda menghubungkan gateway Anda ke fungsi AWS Lambda yang mengimplementasikan alat Anda. Ini berguna ketika Anda ingin mengeksekusi kode kustom sebagai tanggapan terhadap pemanggilan alat.

Anda membuat fungsi Lambda menggunakan layanan Lambda AWS . Untuk membuat fungsi, Anda harus melakukan hal berikut:

Setelah Anda membuat fungsi, Anda mengonfigurasi izin untuk gateway agar dapat mengaksesnya.

Tinjau pertimbangan dan batasan utama untuk membantu Anda memutuskan apakah target Lambda berlaku untuk kasus penggunaan Anda. Jika ya, Anda dapat membuat skema alat dan fungsi Lambda dan kemudian mengatur izin untuk gateway untuk dapat mengakses target. Pilih topik untuk mempelajari lebih lanjut:

Pertimbangan dan keterbatasan utama

Saat bekerja dengan target Lambda, perhatikan batasan dan pertimbangan berikut:

Skema alat fungsi Lambda

Bagian ini menjelaskan struktur skema alat yang mendefinisikan alat yang dapat dikembalikan oleh fungsi Lambda Anda. Setelah Anda menentukan skema alat Anda, Anda dapat melakukan salah satu hal berikut:

Pilih topik untuk mempelajari lebih lanjut tentang detail skema alat atau untuk melihat contoh:

Definisi alat

Saat Anda menambahkan fungsi Lambda sebagai target gateway, Anda memberikan ToolDefinitionsaat menyediakan konfigurasi target. Struktur definisi alat adalah sebagai berikut:

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

Definisi alat berisi bidang-bidang berikut:

outputSchemaBidang inputSchema dan keduanya memetakan ke tipe objek SchemaDefinition, dijelaskan di bagian berikut.

Definisi skema tingkat atas untuk skema input dan output

outputSchemaBidang inputSchema dan di tingkat atas definisi alat keduanya memetakan ke tipe objek SchemaDefinitionyang berisi bidang berikut:

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

Jika Anda menyertakan properties bidang untuk mendefinisikan argumen untuk alat, Anda memberikan definisi skema untuk setiap argumen. Berbagai jenis definisi skema diuraikan di bagian selanjutnya.

Definisi skema properti

Setiap properti di tingkat atas SchemaDefinition memetakan ke SchemaDefinitionobjek yang memiliki persyaratan yang sedikit berbeda dari definisi skema tingkat atas. Bidang yang tersedia tergantung pada type untuk properti. Untuk melihat bentuk SchemaDefinition untuk tipe, pilih dari tab berikut:

Jika Anda menyertakan properti tipe objek lain, Anda akan menambahkan properti lain secara rekursif. SchemaDefinition

Contoh definisi alat Lambda

Pilih tab untuk melihat contoh definisi alat yang dapat Anda sertakan dalam fungsi Lambda Anda.

Format input fungsi Lambda

Ketika AgentCore gateway Amazon Bedrock memanggil fungsi Lambda, ia meneruskan event objek dan objek ke fungsi context tersebut. Event handler Lambda yang Anda tulis dapat mengakses nilai dalam objek ini.

Objek acara

Peta properties dari dari inputSchema ke nilai mereka, seperti yang dikembalikan oleh alat. Misalnya, jika skema masukan Anda berisi properti keywords dancategory, objek acara bisa menjadi berikut:

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

Objek konteks

Berisi metadata berikut:

Format objek konteks adalah sebagai berikut:

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

Fungsi Lambda yang Anda tulis dapat mengakses properti peristiwa dan objek konteks. Anda dapat menggunakan kode boilerplate berikut untuk memulai:

# 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