메인 콘텐츠로 건너뛰기

개요

CrewAI는 네이티브 멀티모달 파일 입력을 지원하여 이미지, PDF, 오디오, 비디오, 텍스트 파일을 에이전트에 직접 전달할 수 있습니다. 파일은 각 LLM 프로바이더의 API 요구사항에 맞게 자동으로 포맷됩니다.
파일 지원을 위해서는 선택적 crewai-files 패키지가 필요합니다. 다음 명령어로 설치하세요:
파일 처리 API는 현재 얼리 액세스 단계입니다.

파일 타입

CrewAI는 5가지 특정 파일 타입과 타입을 자동 감지하는 일반 File 클래스를 지원합니다:

파일 소스

source 파라미터는 여러 입력 타입을 받아들이고 적절한 핸들러를 자동으로 감지합니다:

경로에서

URL에서

바이트에서

파일 사용하기

파일은 여러 레벨에서 전달할 수 있으며, 더 구체적인 레벨이 우선순위를 가집니다.

Crew와 함께

crew를 킥오프할 때 파일을 전달합니다:

Task와 함께

특정 작업에 파일을 첨부합니다:

Flow와 함께

flow에 파일을 전달하면 자동으로 crew에 상속됩니다:

단독 에이전트와 함께

에이전트 킥오프에 직접 파일을 전달합니다:

파일 우선순위

여러 레벨에서 파일이 전달될 때, 더 구체적인 레벨이 상위 레벨을 오버라이드합니다:
예를 들어, Flow와 Task 모두 "chart"라는 이름의 파일을 정의하면, Task의 버전이 사용됩니다.

프로바이더 지원

각 프로바이더는 서로 다른 파일 타입을 지원합니다. CrewAI는 각 프로바이더의 API에 맞게 파일을 자동으로 포맷합니다.
Google Gemini 모델은 비디오를 포함한 모든 파일 타입을 지원합니다 (최대 1시간, 2GB). 비디오 콘텐츠를 처리해야 할 때 Gemini를 사용하세요.
프로바이더가 지원하지 않는 파일 타입을 전달하면 (예: OpenAI에 비디오) UnsupportedFileTypeError가 발생합니다. 처리해야 하는 파일 타입에 따라 프로바이더를 선택하세요.

파일 전송 방식

CrewAI는 각 프로바이더에 파일을 전송하는 최적의 방법을 자동으로 선택합니다:

프로바이더 전송 방식

이를 직접 관리할 필요가 없습니다. CrewAI는 파일 크기와 프로바이더 기능에 따라 가장 효율적인 방법을 자동으로 사용합니다. 파일 업로드 API가 없는 프로바이더는 모든 파일에 인라인 base64를 사용합니다.

파일 처리 모드

프로바이더 제한을 초과할 때 파일 처리 방식을 제어합니다:

프로바이더 제약사항

각 프로바이더는 파일 크기와 규격에 대한 특정 제한이 있습니다:

OpenAI

  • 이미지: 최대 20 MB, 요청당 최대 10개 이미지
  • PDF: 최대 32 MB, 최대 100 페이지
  • 오디오: 최대 25 MB, 최대 25분

Anthropic

  • 이미지: 최대 5 MB, 최대 8000x8000 픽셀, 최대 100개 이미지
  • PDF: 최대 32 MB, 최대 100 페이지

Google Gemini

  • 이미지: 최대 100 MB
  • PDF: 최대 50 MB
  • 오디오: 최대 100 MB, 최대 9.5시간
  • 비디오: 최대 2 GB, 최대 1시간

AWS Bedrock

  • 이미지: 최대 4.5 MB, 최대 8000x8000 픽셀
  • PDF: 최대 3.75 MB, 최대 100 페이지

프롬프트에서 파일 참조하기

작업 설명에서 파일의 키 이름을 사용하여 파일을 참조합니다: