Skip to main content

S3WriterTool

Description

The S3WriterTool is designed to write content to files in Amazon S3 buckets. This tool allows CrewAI agents to create or update files in S3, making it ideal for workflows that require storing data, saving configuration files, or persisting any other content to AWS S3 storage.

Installation

To use this tool, you need to install the required dependencies:

Steps to Get Started

To effectively use the S3WriterTool, follow these steps:
  1. Install Dependencies: Install the required packages using the command above.
  2. Configure AWS Credentials: Set up your AWS credentials as environment variables.
  3. Initialize the Tool: Create an instance of the tool.
  4. Specify S3 Path and Content: Provide the S3 path where you want to write the file and the content to be written.

Example

The following example demonstrates how to use the S3WriterTool to write content to a file in an S3 bucket:
Code

Parameters

The S3WriterTool accepts the following parameters when used by an agent:
  • file_path: Required. The S3 file path in the format s3://bucket-name/file-name.
  • content: Required. The content to write to the file.

AWS Credentials

The tool requires AWS credentials to access S3 buckets. You can configure these credentials using environment variables:
  • CREW_AWS_REGION: The AWS region where your S3 bucket is located. Default is us-east-1.
  • CREW_AWS_ACCESS_KEY_ID: Your AWS access key ID.
  • CREW_AWS_SEC_ACCESS_KEY: Your AWS secret access key.

Usage

When using the S3WriterTool with an agent, the agent will need to provide both the S3 file path and the content to write:
Code

Error Handling

The S3WriterTool includes error handling for common S3 issues:
  • Invalid S3 path format
  • Permission issues (e.g., no write access to the bucket)
  • AWS credential problems
  • Bucket does not exist
When an error occurs, the tool will return an error message that includes details about the issue.

Implementation Details

The S3WriterTool uses the AWS SDK for Python (boto3) to interact with S3:
Code

Conclusion

The S3WriterTool provides a straightforward way to write content to files in Amazon S3 buckets. By enabling agents to create and update files in S3, it facilitates workflows that require cloud-based file storage. This tool is particularly useful for data persistence, configuration management, report generation, and any task that involves storing information in AWS S3 storage.