跳轉到

常見任務 Prompt 範本

本頁提供 AI 代理程式執行各類 PDF 任務時的推薦操作模式（Task Flows），包含使用者意圖識別、工具選擇邏輯與回應範本。

任務一：分析 PDF 文件內容

觸發詞範例：「幫我看看這份 PDF」、「分析這個文件」、「這份報告說了什麼？」

操作流程

1. 呼叫 parse_pdf（獲取結構概覽）
2. 根據頁數決定是否需要分頁提取
3. 呼叫 extract_text（提取全文或指定頁）
4. 整理並摘要文件內容
5. 主動詢問使用者是否需要深入分析特定部分

推薦 Prompt 結構

System: You are helping the user analyze a PDF document using NextPDF tools.
When analyzing PDFs:
1. Always start with parse_pdf to understand the document structure.
2. Use extract_text to get the actual content.
3. Summarize findings clearly and offer follow-up actions.
4. Never modify the document unless explicitly requested.

User: 幫我分析 /workspace/annual-report-2025.pdf

工具呼叫序列

// Step 1
{"tool": "parse_pdf", "arguments": {"path": "/workspace/annual-report-2025.pdf", "include_structure": true}}

// Step 2 (if page count <= 20, extract all; otherwise ask for page range)
{"tool": "extract_text", "arguments": {"path": "/workspace/annual-report-2025.pdf", "mode": "structured"}}

回應範本

我已分析 annual-report-2025.pdf（48 頁，建立於 2026-01-05）。

文件概覽：
- 標題：2025 年度報告
- 作者：財務部門
- 結構：4 大章節，含 12 個子節

主要內容摘要：
[根據提取文字生成摘要]

您是否需要我：
1. 提取特定章節的詳細內容？
2. 比對與去年報告的差異？（需要 Pro 授權）
3. 將文件建立為可搜尋的知識庫？（需要 Enterprise 授權）

任務二：壓縮 PDF 檔案

觸發詞範例：「這個 PDF 太大了」、「幫我縮小這份文件」、「壓縮一下 PDF」

操作流程

1. 呼叫 parse_pdf 確認文件資訊（大小、頁數）
2. 告知使用者目前檔案大小與預期壓縮效果
3. 詢問輸出路徑（覆蓋原檔或另存新檔）
4. 取得確認後呼叫 compress_images
5. 回報壓縮結果（縮減比例）

推薦對話模式

使用者：「幫我壓縮 presentation.pdf，它有 15MB」

AI：「我檢查了 presentation.pdf（15.2 MB，32 頁）。
文件中有 48 張影像，是佔用空間的主要原因。

我將以 85% JPEG 品質壓縮影像，預估可縮小至 4-6 MB（約 60-70% 縮減）。
這會略微降低影像清晰度，但文字和圖表不受影響。

請問壓縮後的文件要：
a) 覆蓋原始文件（presentation.pdf）
b) 另存為新文件（presentation-compressed.pdf）」

使用者：「另存新文件」

AI：[呼叫 compress_images]

「完成！presentation-compressed.pdf 已儲存。
原始大小：15.2 MB → 壓縮後：4.8 MB（縮減 68.4%）」

任務三：合併多份 PDF

觸發詞範例：「把這幾個 PDF 合併」、「合併報告」、「將文件整合成一份」

操作流程

1. 確認所有輸入檔案路徑（向使用者確認順序）
2. 可選：呼叫 parse_pdf 確認每個檔案的頁數
3. 告知合併後的預期總頁數
4. 詢問輸出路徑
5. 呼叫 merge_pdfs
6. 回報合併結果

工具呼叫範例

{
  "tool": "merge_pdfs",
  "arguments": {
    "input_paths": [
      "/workspace/chapter-1.pdf",
      "/workspace/chapter-2.pdf",
      "/workspace/chapter-3.pdf",
      "/workspace/appendix.pdf"
    ],
    "output_path": "/workspace/complete-report.pdf",
    "preserve_bookmarks": true
  }
}

任務四：提取 PDF 表格資料（Pro）

觸發詞範例：「把這個 PDF 裡的表格提取出來」、「我需要這個報告的數字」

操作流程

1. 呼叫 parse_pdf 確認是否有表格
2. 詢問偏好的輸出格式（JSON / CSV / Markdown）
3. 呼叫 extract_tables
4. 顯示提取結果，詢問是否需要匯出為檔案

工具呼叫範例

{
  "tool": "extract_tables",
  "arguments": {
    "path": "/workspace/financial-data.pdf",
    "pages": "5-8",
    "output_format": "csv",
    "detect_headers": true
  }
}

回應範本

我從 financial-data.pdf 的第 5-8 頁中提取了 3 個表格：

**表格 1（第 5 頁）：季度財務摘要**
| 季度 | 營收（億）| 成本（億）| 淨利（億）|
|------|----------|----------|----------|
| Q1   | 45.2     | 32.1     | 13.1     |
| Q2   | 52.8     | 35.6     | 17.2     |

[表格 2、3...]

是否需要我將這些資料匯出為 CSV 文件？

任務五：比對兩份文件差異（Pro）

觸發詞範例：「這兩個版本有什麼不同？」、「幫我比對修訂前後的差異」

操作流程

1. 確認兩個 PDF 的路徑（original vs revised）
2. 詢問比對模式（文字差異 / 語意差異 / 視覺差異）
3. 呼叫 compare_pdfs
4. 以清晰的格式呈現差異結果

工具呼叫範例

{
  "tool": "compare_pdfs",
  "arguments": {
    "pdf_a_path": "/workspace/contract-v1.pdf",
    "pdf_b_path": "/workspace/contract-v2.pdf",
    "mode": "semantic",
    "ignore_whitespace": true
  }
}

任務六：從 HTML 生成 PDF

觸發詞範例：「幫我把這段 HTML 轉成 PDF」、「生成一份報告 PDF」、「把 Markdown 轉為 PDF」

操作流程

1. 接收 HTML / Markdown 內容（直接輸入或讀取文件）
2. 詢問頁面設定（A4 / Letter、縱向/橫向、邊距）
3. 詢問輸出路徑
4. 呼叫 generate_pdf
5. 確認生成結果

工具呼叫範例

{
  "tool": "generate_pdf",
  "arguments": {
    "content": "# 月度報告\n\n## 執行摘要\n\n本月業績...",
    "content_type": "markdown",
    "output_path": "/workspace/monthly-report.pdf",
    "options": {
      "page_size": "A4",
      "orientation": "portrait",
      "margin_mm": {"top": 20, "right": 20, "bottom": 20, "left": 20},
      "language": "zh-TW"
    }
  }
}

任務七：建立 PDF 知識庫（Enterprise）

觸發詞範例：「幫我把這些手冊建立成可搜尋的知識庫」、「把 PDF 加入 RAG 系統」

操作流程

1. 確認要索引的 PDF 清單
2. 確認目標向量資料庫（Qdrant / Pinecone / pgvector）
3. 說明操作將寫入外部系統（medium 風險確認）
4. 呼叫 embed_documents
5. 示範 semantic_search 查詢功能

工具呼叫序列

// Step 1: Embed documents
{
  "tool": "embed_documents",
  "arguments": {
    "paths": [
      "/workspace/user-manual-v3.pdf",
      "/workspace/faq-2026.pdf",
      "/workspace/policy-handbook.pdf"
    ],
    "vector_store": {
      "backend": "qdrant",
      "collection": "support-knowledge-base",
      "namespace": "tenant-main"
    },
    "options": {
      "chunking_strategy": "semantic",
      "max_chunk_size": 512
    }
  }
}

// Step 2: Test search
{
  "tool": "semantic_search",
  "arguments": {
    "query": "退款申請流程",
    "vector_store": {
      "backend": "qdrant",
      "collection": "support-knowledge-base",
      "namespace": "tenant-main"
    },
    "options": {"top_k": 3}
  }
}

任務八：數位簽章 PDF（Pro，High Risk）

觸發詞範例：「幫我簽署這份合約」、「在 PDF 上蓋章」

操作流程（含強制 HITL）

1. 呼叫 parse_pdf 確認文件資訊
2. 確認簽章憑證路徑
3. 展示完整的簽章參數摘要
4. 明確告知法律含義
5. 等待使用者明確確認（"是"/"確認"/"yes"）
6. 取得確認後才呼叫 sign_pdf
7. 回報簽章結果

強制 HITL 對話範本

AI：「我即將對 contract-final.pdf 執行數位簽章：

簽章參數：
- 文件：contract-final.pdf（24 頁）
- 簽章者：王小明（證書：ACME-Signing-Cert.p12）
- 簽章級別：PAdES B-B（符合 ETSI EN 319 142-1）
- 時間戳記：是（RFC 3161）
- 簽章原因：「合約確認與授權」

⚠️ 重要提示：
- 數位簽章在法律上具有效力
- 簽章後文件不可修改（如需修改需重新簽章）
- 請確認您具有使用此憑證進行簽章的合法授權

請輸入「確認簽章」以繼續，或「取消」中止操作。」

參見