File & Document 도구 개요

CrewAI의 문서 처리 도구로 다양한 파일 형식을 읽고, 쓰고, 검색할 수 있어요.

출처: 문서

본문

이 도구들은 에이전트가 다양한 파일 형식과 문서 유형을 다룰 수 있게 해줍니다. PDF 읽기부터 JSON 데이터 처리까지, 이 도구들은 모든 문서 처리 요구를 해결해 줍니다.

사용 가능한 도구 (Available Tools)

File Read Tool

텍스트, 마크다운 등을 포함한 모든 파일 형식의 내용을 읽습니다.

File Write Tool

파일에 내용을 쓰고, 새 문서를 만들고, 처리된 데이터를 저장합니다.

PDF Search Tool

PDF 문서에서 텍스트 내용을 효율적으로 검색하고 추출합니다.

DOCX Search Tool

Microsoft Word 문서를 검색하고 관련 내용을 추출합니다.

JSON Search Tool

고급 쿼리 기능으로 JSON 파일을 파싱하고 검색합니다.

CSV Search Tool

CSV 파일을 처리·검색하고 특정 행과 열을 추출합니다.

XML Search Tool

XML 파일을 파싱하고 특정 요소와 속성을 검색합니다.

MDX Search Tool

MDX 파일을 검색하고 문서에서 내용을 추출합니다.

TXT Search Tool

패턴 매칭 기능으로 일반 텍스트 파일을 검색합니다.

Directory Search Tool

디렉터리 구조 안에서 파일과 폴더를 검색합니다.

Directory Read Tool

디렉터리 내용, 파일 구조, 메타데이터를 읽고 나열합니다.

OCR Tool

비전(vision) 기능이 있는 LLM을 사용해 이미지(로컬 파일 또는 URL)에서 텍스트를 추출합니다.

PDF Text Writing Tool

선택적인 커스텀 폰트와 함께 PDF 안의 특정 좌표에 텍스트를 씁니다.

일반적인 사용 사례 (Common Use Cases)

문서 처리 (Document Processing): 다양한 파일 형식에서 내용을 추출하고 분석합니다.
데이터 가져오기 (Data Import): CSV, JSON, XML 파일에서 구조화된 데이터를 읽습니다.
콘텐츠 검색 (Content Search): 대규모 문서 컬렉션 안에서 특정 정보를 찾습니다.
파일 관리 (File Management): 파일과 디렉터리를 정리하고 조작합니다.
데이터 내보내기 (Data Export): 처리된 결과를 다양한 파일 형식으로 저장합니다.

빠른 시작 예시 (Quick Start Example)

from crewai_tools import FileReadTool, PDFSearchTool, JSONSearchTool

# Create tools
file_reader = FileReadTool()
pdf_searcher = PDFSearchTool()
json_processor = JSONSearchTool()

# Add to your agent
agent = Agent(
    role="Document Analyst",
    tools=[file_reader, pdf_searcher, json_processor],
    goal="Process and analyze various document types"
)

문서 처리 팁 (Tips for Document Processing)

파일 권한 (File Permissions): 에이전트에 적절한 읽기/쓰기 권한이 있는지 확인하세요.
대용량 파일 (Large Files): 매우 큰 문서는 청크(chunking)를 고려하세요.
형식 지원 (Format Support): 지원되는 파일 형식을 확인하려면 도구 문서를 확인하세요.
오류 처리 (Error Handling): 손상되었거나 접근할 수 없는 파일에 대한 적절한 오류 처리를 구현하세요.

File & Document 도구 개요