# Hướng Dẫn Chi Tiết: Cách Biến AWS Lambda Thành Công Cụ MCP Với Amazon Bedrock AgentCore Gateway ## Mở Đầu Trong kỷ nguyên phát triển ứng dụng serverless và integração AI, việc chuyển đổi các hàm AWS Lambda thành các công cụ tương tác thông qua giao thức Model Context Protocol (MCP) đang trở thành xu hướng quan trọng. Amazon Bedrock AgentCore Gateway cung cấp một cầu nối mạnh mẽ để kết nối các chức năng hiện có và API với các agent AI thông qua MCP — một giao thức tối ưu cho việc tương tác giữa agent và công cụ. Ở bài viết này, chúng ta sẽ tập trung hướng dẫn chi tiết từng bước để biến các hàm Lambda sẵn có thành các công cụ MCP, giúp mở rộng khả năng tích hợp và vận hành. Bài viết sử dụng ví dụ thực tế với hai hàm Lambda `GetOrderByID` và `GetOrdersByCreatedDates`, đồng thời minh họa cách tương tác hiệu quả với agent thông qua Strands MCP Client. --- ## Tổng Quan Về Quá Trình Chuyển Đổi Lambda Thành Công Cụ MCP ### Giới Thiệu Về Amazon Bedrock AgentCore Gateway AgentCore Gateway là thành phần trung gian kết nối các công cụ như Lambda function hoặc API vào một đầu mối truy cập chung, giúp các agent có thể gọi đến các công cụ này thông qua giao thức MCP. Các bước chính gồm: - Khai báo các công cụ (tools) bằng các schema, parametrhoá đúng với hàm Lambda. - Tạo Gateway endpoint để làm điểm truy cập. - Thêm các target (các Lambda function) vào Gateway, cấu hình routing. - Cung cấp IAM authorization phù hợp. - Kết nối agent và Gateway endpoint để tương tác. ### Kiến Trúc Hoạt Động - Agent gửi yêu cầu đến Gateway endpoint. - Gateway chuyển tiếp yêu cầu tới hàm Lambda tương ứng theo cấu hình target. - Hàm Lambda thực thi và trả kết quả trả về qua Gateway về agent. ![Kiến trúc Amazon Bedrock AgentCore Gateway](https://github.com/awslabs/amazon-bedrock-agentcore-samples/blob/main/01-tutorials/02-AgentCore-gateway/01-transform-lambda-into-mcp-tools/architecture.png?raw=true) Ghi chú: Việc cấu hình chính xác các schema và quyền IAM là yếu tố then chốt đảm bảo Gateway có thể gọi đúng hàm Lambda và bảo mật truy cập. --- ## Hướng Dẫn Chi Tiết Từng Bước ### 1. Chuẩn Bị Môi Trường - Cài đặt *Jupyter Notebook* với kernel Python. - Cài đặt công cụ `uv` từ [Astral](https://docs.astral.sh/uv/getting-started/installation/). - AWS credentials được cấu hình sẵn trong `~/.aws/credentials`. - Tạo hoặc sử dụng Cognito User Pool để xác thực truy cập. ### 2. Xác Định AWS Region và Khởi Tạo IAM Role ```python import os import agent_core_utils os.environ['AWS_DEFAULT_REGION'] = 'us-east-1' agentcore_gateway_iam_role = agent_core_utils.create_agentcore_gateway_role("sample-lambdagateway") print("Agentcore gateway role ARN: ", agentcore_gateway_iam_role['Role']['Arn']) ``` - IAM Role cần quyền quản lý Gateway và gọi Lambda functions. - Ảnh minh họa: IAM Role và các policy liên quan (mô tả trên AWS Console). ### 3. Thiết Lập Amazon Cognito User Pool ```python import boto3 cognito = boto3.client("cognito-idp", region_name=os.environ['AWS_DEFAULT_REGION']) user_pool_id = agent_core_utils.get_or_create_user_pool(cognito, "sample-agentcore-gateway-pool") agent_core_utils.get_or_create_resource_server(cognito, user_pool_id, "sample-agentcore-gateway-id", "sample-agentcore-gateway-name", [ {"ScopeName": "gateway:read", "ScopeDescription": "Read access"}, {"ScopeName": "gateway:write", "ScopeDescription": "Write access"} ]) client_id, client_secret = agent_core_utils.get_or_create_m2m_client(cognito, user_pool_id, "sample-agentcore-gateway-client", "sample-agentcore-gateway-id") print(f"Cognito Client ID: {client_id}") ``` - Cognito dùng để tạo token bảo mật khi agent truy cập Gateway. - Sử dụng `client_id` và `client_secret` để lấy token. ### 4. Tạo AgentCore Gateway với Xác Thực Cognito JWT ```python import boto3 gateway_client = boto3.client('bedrock-agentcore-control', region_name=os.environ['AWS_DEFAULT_REGION']) auth_config = { "customJWTAuthorizer": { "allowedClients": [client_id], "discoveryUrl": f'https://cognito-idp.{os.environ["AWS_DEFAULT_REGION"]}.amazonaws.com/{user_pool_id}/.well-known/openid-configuration' } } create_response = gateway_client.create_gateway( name='LambdaOrderGateway', roleArn=agentcore_gateway_iam_role['Role']['Arn'], protocolType='MCP', authorizerType='CUSTOM_JWT', authorizerConfiguration=auth_config, description='AgentCore Gateway with AWS Lambda target type' ) gatewayID = create_response["gatewayId"] gatewayURL = create_response["gatewayUrl"] print(f"Gateway ID: {gatewayID}") print(f"Gateway URL: {gatewayURL}") ``` Bạn cần đảm bảo IAM role đã được cấp quyền tương thích để tạo Gateway và API Gateway đang hoạt động. ### 5. Cấu Hình Lambda Function Target – Định Nghĩa Công Cụ MCP #### Ví dụ cho Lambda `GetOrderById` ```python order_by_id_lambda_target_config = { "mcp": { "lambda": { "lambdaArn": '${YourGetOrderByIdLambdaFunctionARN}', "toolSchema": { "inlinePayload": [ { "name": "get_order_by_id_tool", "description": "tool to get the order by id", "inputSchema": { "type": "object", "properties": { "id": {"type": "string"} }, "required": ["id"] } } ] } } } } ``` #### Ví dụ cho Lambda `GetOrdersByCreatedDates` ```python order_by_created_dates_lambda_target_config = { "mcp": { "lambda": { "lambdaArn": '${YourGetOrdersByCreatedDatesLambdaFunctionARN}', "toolSchema": { "inlinePayload": [ { "name": "get_orders_by_created_dates_tool", "description": "tool to get the order by created dates", "inputSchema": { "type": "object", "properties": { "startDate": {"type": "string"}, "endDate": {"type": "string"} }, "required": ["startDate","endDate"] } } ] } } } } ``` #### Cấu hình Credential cho Lambda Target ```python credential_config = [ { "credentialProviderType" : "GATEWAY_IAM_ROLE" } ] ``` #### Tạo Targets trên Gateway ```python response_1 = gateway_client.create_gateway_target( gatewayIdentifier=gatewayID, name='GetOrderByIdLambda', description='Order by id Lambda Target', targetConfiguration=order_by_id_lambda_target_config, credentialProviderConfigurations=credential_config ) response_2 = gateway_client.create_gateway_target( gatewayIdentifier=gatewayID, name='GetOrderByCreatedDatesLambda', description='Orders by created dates Lambda Target', targetConfiguration=order_by_created_dates_lambda_target_config, credentialProviderConfigurations=credential_config ) ``` Việc cấu hình chính xác input schema sẽ giúp agent hiểu và truyền tham số hợp lệ cho hàm Lambda khi gọi. ### 6. Xác Thực và Tương Tác Với Agent Để gọi dịch vụ qua AgentCore Gateway, agent cần: - Lấy token xác thực từ Cognito. - Tạo MCP client tương tác với endpoint gateway. - Khởi tạo websocket hoặc kết nối HTTP để gửi yêu cầu. Ví dụ cách lấy Token: ```python token_response = agent_core_utils.get_token(user_pool_id, client_id, client_secret, f"{RESOURCE_SERVER_ID}/gateway:read {RESOURCE_SERVER_ID}/gateway:write", REGION) token = token_response["access_token"] ``` Tạo client và agent (dùng model Bedrock Nova-pro): ```python from strands import Agent from strands.models import BedrockModel from strands.tools.mcp.mcp_client import MCPClient model = BedrockModel( model_id="us.amazon.nova-pro-v1:0", temperature=0.7 ) mcp_client = MCPClient(lambda: create_streamable_http_transport(gatewayURL, token)) with mcp_client: tools = get_full_tools_list(mcp_client) print(f"Available tools: {[tool.tool_name for tool in tools]}") agent = Agent(model=model, tools=tools) response = agent("Give me the information about order with id 12345") print(response) ``` Lưu ý: Nếu Lambda function được viết bằng Java, bạn cần điều chỉnh phần xử lý input để nhận tham số trực tiếp (theo dạng Map) thay vì sự kiện API Gateway Proxy Event nhằm tương thích với cách Gateway truyền dữ liệu. --- ## Các Vấn Đề và Giải Pháp Khi Kết Nối Lambda Với AgentCore Gateway ### Vấn Đề Tham Số Null Trong Lambda Runtime (Java) - Sự kiện truyền tới Lambda thường khác với trigger thông thường (API Gateway HTTP Event) khi gọi qua AgentCore Gateway. - Phiên bản Lambda Java mặc định sử dụng `APIGatewayProxyRequestEvent` để lấy `pathParameters`, tuy nhiên đối với AgentCore Gateway, các tham số này có thể null do Gateway truyền input dưới dạng map thuần túy. ### Giải Pháp - Viết Lambda handler nhận input trực tiếp dưới dạng `Map`: ```java @Override public APIGatewayProxyResponseEvent handleRequest(Map params, Context context) { String id = params.get("id"); ... } ``` - Điều này giúp Lambda nhận đúng dữ liệu truyền tham số và chạy trơn tru hơn. ### Tương Tác Với Agent – Các Thí Dụ Khi Gọi Lambda Trực Tiếp Qua Gateway | Câu hỏi Agent | Tool gọi tương ứng | Kết quả | |------------------------------------------|---------------------------------------|-------------------------------------------------------------| | "Give me the information about order with id 12345" | GetOrderByIdLambda | Trả thông tin order tương ứng | | "Can you list orders created between 2025-08-01 and 2025-08-05" | GetOrdersByCreatedDatesLambda | Danh sách các đơn hàng trong khoảng thời gian đúng format | | "What is the total value of all these orders together?" | Lambda tính tổng đơn hàng | Tổng giá trị chính xác | ### Quan Sát Khi Lambda Có Lỗi - Nếu Lambda function bị lỗi (vd: `NullPointerException`), agent không trả lời và dừng trong trạng thái “đang nghĩ”. - Cần thêm cơ chế bắt lỗi và trả về thông tin lỗi rõ ràng từ Lambda để agent xử lý. --- ## Các Chỉ Số Hiệu Suất Quan Trọng Của AgentCore Gateway | Tên metric | Ý nghĩa | |---------------------|---------------------------------------------| | ListMemory | Đo bộ nhớ khi liệt kê công cụ | | InitializeMcp | Thời gian khởi tạo giao thức MCP | | ListToolsMcp | Hiệu suất liệt kê công cụ | | CallToolMcp | Thời gian và trạng thái gọi từng công cụ | ![CloudWatch Metrics](https://media2.dev.to/dynamic/image/width=800/https%3A%2F%2Fdev-to-uploads.s3.amazonaws.com%2Fuploads%2Farticles%2F1wnv1ybjxe2foxa69qej.png) Giám sát chặt chẽ các metric này giúp tối ưu hiệu quả hoạt động và phát hiện sớm lỗi phát sinh. --- ## Kết Luận Trong phần này của chuỗi bài hướng dẫn, chúng ta đã hoàn tất quá trình **biến các hàm AWS Lambda hiện có thành các công cụ MCP sử dụng Amazon Bedrock AgentCore Gateway**. Qua ví dụ với hai Lambda `GetOrderByID` và `GetOrdersByCreatedDates`, bạn đã hiểu cách: - Thiết lập IAM Role và Cognito User Pool để bảo mật. - Khai báo schema công cụ MCP chính xác. - Tạo AgentCore Gateway và cấu hình các target Lambda. - Tương tác an toàn và hiệu quả với agent sử dụng Strands MCP Client. Bạn đã sẵn sàng mở rộng các dịch vụ AWS Lambda hiện tại thành các công cụ thông minh, dễ dàng tích hợp AI agent để nâng cao trải nghiệm người dùng và tự động hóa công việc! --- ## Tham Khảo 1. [Amazon Bedrock AgentCore Gateway Documentation](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/) 2. [AWS Serverless Applications với Java và Aurora DSQL](https://dev.to/aws-heroes/serverless-applications-with-java-and-aurora-dsql-part-1-introduction-and-sample-application-10ip) 3. [Github: Amazon Bedrock AgentCore Samples](https://github.com/awslabs/amazon-bedrock-agentcore-samples) 4. [Strands MCP Client Documentation](https://strandsagents.com/latest/documentation/) 5. [Amazon Cognito User Pools](https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-identity-pools.html) --- Bạn có thể tải toàn bộ mã nguồn minh họa tại [Github của tác giả](https://github.com/Vadym79/AWSLambdaJavaWithAmazonDSQL) để thực hành và tùy biến cho dự án riêng của mình.

AWS Lambda Hóa Công Cụ AI: Hướng Dẫn Kích Hoạt với Amazon Bedrock AgentCore Gateway (Phần 3)