الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://docs.crewai.com/llms.txt

Use this file to discover all available pages before exploring further.

PDFTextWritingTool

الوصف

كتابة نص في إحداثيات دقيقة على صفحة PDF، مع إمكانية تضمين خط TrueType مخصص اختيارياً.

المعاملات

معاملات التشغيل

  • pdf_path (str, مطلوب): مسار ملف PDF المدخل.
  • text (str, مطلوب): النص المراد إضافته.
  • position (tuple[int, int], مطلوب): إحداثيات (x, y).
  • font_size (int, الافتراضي 12)
  • font_color (str, الافتراضي "0 0 0 rg")
  • font_name (str, الافتراضي "F1")
  • font_file (str, اختياري): مسار ملف .ttf.
  • page_number (int, الافتراضي 0)

مثال

Code
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()

الاستخدام المباشر

Code
from crewai_tools import PDFTextWritingTool

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

نصائح

  • نقطة أصل الإحداثيات هي الزاوية السفلية اليسرى.
  • إذا كنت تستخدم خطاً مخصصاً (font_file)، تأكد من أنه ملف .ttf صالح.