S3ReaderTool
설명
S3ReaderTool
은 Amazon S3 버킷에서 파일을 읽기 위해 설계되었습니다. 이 도구를 사용하면 CrewAI 에이전트가 S3에 저장된 콘텐츠에 접근하고 가져올 수 있어, 데이터를 읽거나 설정 파일 또는 AWS S3 스토리지에 저장된 기타 콘텐츠를 필요로 하는 워크플로우에 이상적입니다.
설치
이 도구를 사용하려면 필요한 종속성을 설치해야 합니다:시작 단계
S3ReaderTool
을 효과적으로 사용하려면 다음 단계를 따르세요:
- 의존성 설치: 위 명령어를 사용하여 필요한 패키지를 설치합니다.
- AWS 자격 증명 구성: 환경 변수로 AWS 자격 증명을 설정합니다.
- 도구 초기화: 도구의 인스턴스를 생성합니다.
- S3 경로 지정: 읽고자 하는 파일의 S3 경로를 제공합니다.
예시
다음 예시는S3ReaderTool
을 사용하여 S3 버킷에서 파일을 읽는 방법을 보여줍니다:
Code
매개변수
S3ReaderTool
은 에이전트에 의해 사용될 때 다음과 같은 매개변수를 허용합니다:
- file_path: 필수입니다.
s3://bucket-name/file-name
형식의 S3 파일 경로입니다.
AWS 자격 증명
이 도구는 S3 버킷에 접근하기 위해 AWS 자격 증명이 필요합니다. 환경 변수를 사용하여 이러한 자격 증명을 구성할 수 있습니다:- CREW_AWS_REGION: S3 버킷이 위치한 AWS 리전입니다. 기본값은
us-east-1
입니다. - CREW_AWS_ACCESS_KEY_ID: AWS 액세스 키 ID입니다.
- CREW_AWS_SEC_ACCESS_KEY: AWS 시크릿 액세스 키입니다.
사용법
S3ReaderTool
을 agent와 함께 사용할 때, agent는 S3 파일 경로를 제공해야 합니다:
Code
오류 처리
S3ReaderTool
은 일반적인 S3 문제에 대한 오류 처리를 포함하고 있습니다:
- 잘못된 S3 경로 형식
- 누락되었거나 접근할 수 없는 파일
- 권한 문제
- AWS 자격 증명 문제
구현 세부사항
S3ReaderTool
은 AWS SDK for Python(boto3)을 사용하여 S3와 상호작용합니다:
Code
결론
S3ReaderTool
은 Amazon S3 버킷에서 파일을 읽을 수 있는 간단한 방법을 제공합니다. 에이전트가 S3에 저장된 콘텐츠에 액세스할 수 있도록 하여, 클라우드 기반 파일 액세스가 필요한 워크플로우를 지원합니다. 이 도구는 데이터 처리, 구성 관리, 그리고 AWS S3 스토리지에서 정보를 검색하는 모든 작업에 특히 유용합니다.