Skip to content
CrewAI 文档版本 跟随上游 源快照 0b244c2e 更新于 2026-10-18

PDF 文本写入工具

PDFTextWritingTool 将文本写入 PDF 中的特定位置,并支持自定义字体。

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)

示例

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

直接使用

python
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 文件。

BytesRouter 是社区翻译站点,所有译文仅供参考,一切以官方英文原文为准。