> ## Documentation Index
> Fetch the complete documentation index at: https://docs.danubeai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AWS Lambda

> Let agents inspect functions, see recent invocations, errors and timeouts, and invoke on connections you allow

The Lambda connector combines the Lambda API with the function's CloudWatch logs and metrics, so one call answers "what has this function been doing". Setup and the IAM policy are on the [AWS page](/connectors/aws#lambda).

## Tools

| Tool                              | What it returns                                                                                                                                                                                                                          |
| --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Test Connection**               | The AWS account and identity, and whether it may list functions                                                                                                                                                                          |
| **List Functions**                | Functions with runtime, memory, timeout, architecture and last modified time                                                                                                                                                             |
| **Get Configuration**             | Handler, role, layers, VPC, dead-letter target, state and the **names** of the environment variables                                                                                                                                     |
| **Recent Invocations and Errors** | Invocations, errors, throttles and p99 duration from CloudWatch metrics; the latest REPORT lines parsed into duration, billed duration, memory used and cold-start init time; and the latest ERROR, exception and `Task timed out` lines |
| **Invoke**                        | Runs the function synchronously and returns the status code, function error, response payload (up to 256 KB) and the last 4 KB of its log. `read_write` connections only, confirmed                                                      |

## Safety

* **Environment values never leave AWS through Danube.** Get Configuration returns variable names only; values are dropped before the answer is built.
* **Invoke really runs the function**, with all its side effects, so it is a write tool: refused on a `read_only` connection and confirmed on every call. Grant `lambda:InvokeFunction` only on the functions agents may run.
* Only synchronous (`RequestResponse`) invocations. A function that is already running is not stopped by the call's timeout.

## Example prompts

* "Pull the last 50 errors from `/aws/lambda/checkout` in the past hour."
* "Is `checkout` timing out? Show recent invocations, cold starts and p99 duration."
* "Which environment variables does `billing-webhook` expect?"
* "Invoke `report-daily` with `{\"date\": \"2026-09-25\"}` and show me the result."