> For the complete documentation index, see [llms.txt](https://whitepaper.aitech.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://whitepaper.aitech.io/agentforge/tools/s3.md).

# s3

### Usage Instructions

Retrieve and view files from Amazon S3 buckets using presigned URLs.

### Where to Find Your AWS Access Keys

1. **Sign in to the AWS Management Console:** Log in with your **IAM user credentials**. It is a security best practice to use an IAM user instead of your root account for daily tasks.
2. **Navigate to the IAM Dashboard:** You can do this by typing `"IAM"` in the search bar at the top of the console and selecting the service.
3. **Go to the "Users" Section:** In the navigation pane on the left, choose **Users**.
4. **Select Your User Name:** Click on the specific **IAM user** for whom you want to manage the keys.
5. **Go to the "Security credentials" Tab:** On the user's details page, click on the **Security credentials** tab.
6. **Find the "Access keys" Section:** Scroll down this page to find a table that lists your access keys.

{% hint style="warning" %}
The **"Access key ID"** will be visible, but the **"Secret access key"** is **not**. The secret key is only displayed once, at the time it's created. If you lose the secret key, you must create a new access key pair.
{% endhint %}

### Tools

#### `s3_get_object`

Retrieve an object from an AWS S3 bucket

**Input**

| Parameter         | Type   | Required | Description                |
| ----------------- | ------ | -------- | -------------------------- |
| `accessKeyId`     | string | Yes      | Your AWS Access Key ID     |
| `secretAccessKey` | string | Yes      | Your AWS Secret Access Key |
| `s3Uri`           | string | Yes      | S3 Object URL              |

**Output**

| Parameter  | Type   | Description     |
| ---------- | ------ | --------------- |
| `url`      | string | Presigned URL   |
| `metadata` | json   | Object metadata |

**Screenshot**

### Notes

* Category: `tools`
* Type: `s3`