PDF 텍스트 쓰기 도구

PDF 텍스트 쓰기 도구 (PDF Text Writing Tool)

CrewAI의 PDFTextWritingTool은 PDF 페이지의 정확한 좌표에 텍스트를 쓰는 도구예요. 필요하면 커스텀 TrueType 폰트를 임베딩할 수도 있어서, PDF에 워터마크를 넣거나 특정 위치에 주석을 달 때 아주 유용하답니다.

출처: 문서

본문

PDFTextWritingTool은 정확한 좌표의 PDF 페이지에 텍스트를 쓰고, 선택적으로 커스텀 TrueType 폰트를 임베딩하는 도구입니다.

실행 파라미터 (Run Parameters)

  • pdf_path (str, required): 입력 PDF 파일의 경로예요.
  • text (str, required): 추가할 텍스트입니다.
  • position (tuple[int, int], required): (x, y) 좌표입니다.
  • font_size (int, 기본값 12)
  • font_color (str, 기본값 "0 0 0 rg")
  • font_name (str, 기본값 "F1")
  • font_file (str, optional): .ttf 파일의 경로예요.
  • page_number (int, 기본값 0)

예시 (Example)

from crewai import Agent, Task, Crew
from crewai_tools import PDFTextWritingTool

tool = PDFTextWritingTool()

agent = Agent(
    role="PDF Editor",
    goal="Annotate PDFs",
    backstory="Documentation specialist",
    tools=[tool],
    verbose=True,
)

task = Task(
    description="Write 'CONFIDENTIAL' at (72, 720) on page 1 of ./sample.pdf",
    expected_output="Confirmation message",
    agent=agent,
)

crew = Crew(
    agents=[agent],
    tasks=[task],
    verbose=True,
)

result = crew.kickoff()

직접 사용하기 (Direct usage)

from crewai_tools import PDFTextWritingTool

PDFTextWritingTool().run(
  pdf_path="./input.pdf",
  text="CONFIDENTIAL",
  position=(72, 720),
  font_size=18,
  page_number=0,
)

팁 (Tips)

  • 좌표 원점은 왼쪽 아래(bottom‑left) 모서리예요.
  • 커스텀 폰트(font_file)를 사용한다면 반드시 유효한 .ttf 파일인지 확인하세요.

더 알아보기 (Learn more)