> 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`


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://whitepaper.aitech.io/agentforge/tools/s3.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.