diff --git a/docs/user-guide/deploy/deploy_to_aws_lambda.md b/docs/user-guide/deploy/deploy_to_aws_lambda.md index 9cf814a3..b9336a2c 100644 --- a/docs/user-guide/deploy/deploy_to_aws_lambda.md +++ b/docs/user-guide/deploy/deploy_to_aws_lambda.md @@ -63,6 +63,10 @@ def handler(event: Dict[str, Any], _context) -> str: ## Infrastructure +!!! tip "Use Pre-built Lambda Layers" + + The easiest way to get started is to use our pre-built [Lambda Layers](lambda-layers.md) that include the Strands Agents SDK and its dependencies. You can also package your own dependencies if you need custom configurations. + To deploy the above agent to Lambda using the TypeScript CDK, prepare your code for deployment by creating the Lambda definition and an associated Lambda layer ([`AgentLambdaStack.ts`][AgentLambdaStack]): ```typescript diff --git a/docs/user-guide/deploy/lambda-layers.md b/docs/user-guide/deploy/lambda-layers.md new file mode 100644 index 00000000..119dc302 --- /dev/null +++ b/docs/user-guide/deploy/lambda-layers.md @@ -0,0 +1,26 @@ +# Strands Agents Lambda Layers + +AWS Lambda layers provide a convenient way to package libraries, custom runtimes, or other function dependencies that can be shared across multiple Lambda functions. The Strands Agents SDK publishes pre-built Lambda layers containing the SDK and its dependencies, making it easier to deploy your agents without managing dependencies yourself. + +For detailed instructions on how to use Lambda layers with your functions, see the [AWS Lambda Layers Documentation](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html). + +## ARN Format + +``` +arn:aws:lambda:{REGION}:856699698935:layer:strands-agents-{VERSION}-{ARCHITECTURE}:{LAYER_VERSION} +``` + +| Parameter | Values | +|-----------|--------| +| `REGION` | All commercial regions | +| `VERSION` | py3_10, py3_11, py3_12 | +| `ARCHITECTURE` | x86_64, arm64 | +| `LAYER_VERSION` | Layer version number | + +## Available Layers + + +| Version | PyPI Version | ARN Format | +|---------|--------------|------------| +| 4 | [1.0.0](https://pypi.org/project/strands-agents/1.0.0) | `arn:aws:lambda:{REGION}:856699698935:layer:strands-agents-{VERSION}-{ARCHITECTURE}:4` | +