想像一個掃描發票的收件箱，每頁都有一個條碼標示採購訂單。AI 代理可以在本機讀取資料夾中所有的條碼，無需上傳，並提供一個將每個檔案與其記錄匹配的表格。代理可以是 Claude、Cursor 或 GitHub Copilot；條碼的讀取由 GroupDocs.Signature.Mcp 伺服器完成。只需一個提示即可完成：

對資料夾中的每個 PDF，讀取條碼，並給我一個包含檔名、條碼值、頁碼的表格。

逐步說明（含設定與故障排除）請參考文件：如何使用 AI 從文件中提取 QR 代碼和條碼資料。

情境：從一堆檔案到路由佇列

郵件室、應付帳款團隊或案件管理櫃檯會大量接收文件。每份文件都附有機器可讀的代碼，正是為此而設。若未自動化，則需要有人手動將代碼輸入下一個系統。使用代理時，流程如下：

  1. 文件會放入伺服器設定使用的資料夾 (GROUPDOCS_MCP_STORAGE_PATH)。
  2. 代理對每個檔案呼叫 search_barcodes，並收集解碼後的值、頁碼與位置。
  3. 代理回傳表格。該表格即為檔案與 ERP、倉儲或案件系統中記錄之間的關聯鍵。
  4. 由人員或您之後控制的自動化步驟進行查詢與路由。

第 4 步特意保留在代理之外。請參閱下方「不應自動化的事項」。

哪個工具讀取哪種代碼？

search_qr_codes 讀取 QR 代碼。search_barcodes 讀取一維條碼，例如 Code39、Code128 與 EAN。每個工具皆回傳解碼文字、所在頁面與每個命中的位置。若不確定文件中包含哪種代碼，可同時請求兩者：

讀取 invoice.pdf 中的 QR 代碼與條碼，並告訴我它們的內容。

如何在眾多代碼中找到特定代碼？

兩個工具皆支援 text 篩選器，只回傳包含指定字串的代碼：

找出以 SHIP 開頭的條碼，並告訴我它位於哪一頁。

在包含十幾個代碼的文件中，這能讓答案與一長串值之間產生差異。

保持回應簡潔

兩個工具皆支援 returnImage。除非真的需要圖形，否則請關閉。解碼文字是代理推理的依據，而 base64 圖片會使回應變大且變慢。

範例對話（節錄）

You:    For every PDF in the folder, read the barcode, and give me a table
        of file name, barcode value, page.

Agent:  [search_barcodes] file=invoice-0007.pdf   found: 1
        [search_barcodes] file=invoice-0008.pdf   found: 1
        [search_barcodes] file=scan-0009.pdf      found: 0
        | file             | barcode value | page |
        | invoice-0007.pdf | PO-448210     | 1    |
        | invoice-0008.pdf | PO-448377     | 1    |
        scan-0009.pdf has no barcode in the pages that were processed.

說明性輸出：檔名與條碼值為虛構。工具會回傳上述欄位。

Signature 或 Parser：哪個伺服器讀取代碼？

當代碼是您同時加入的簽章元素，或文件雙向流動時（讀取進來的參考、完成工作，然後在外發文件上使用帶有新參考的 QR 代碼呼叫 sign），請使用 GroupDocs.Signature.Mcp。若您需要從任意掃描檔中提取資料，同時還需要文字、表格或中繼資料，請使用 GroupDocs.Parser.Mcp（僅以 Docker 映像提供；其 extract_barcodes 工具）。此伺服器可讀取簽章與代碼，但不會提取版面、欄位或表格。

不應自動化的事項

  • 它不是 OCR。 這些工具讀取的是代碼符號，而非印刷文字。若掃描頁面沒有代碼，則不會回傳任何結果，這算是正確的答案，而非失敗。
  • 解碼後的值屬於不可信的輸入。 它是由製作文件的人提供的。請先記錄、查詢並交叉驗證。不要讓代理在未審核的情況下直接使用它。

評估限制

若未取得授權，僅會處理文件的前兩頁，且每頁都會蓋上試用標記。第 3 頁的代碼將不會被找到，空的結果會被視為「無代碼」。請在信任空結果之前，讓代理呼叫 get_license_status 以確認授權狀態。

常見問題

Claude 能讀取此 PDF 中的 QR 代碼嗎？
是的。連線至伺服器後，Claude 會呼叫 search_qr_codes，在本機回報解碼文字、頁碼與位置。

如何使用 AI 從發票中提取條碼值？
請讓代理讀取檔案中的條碼。它會呼叫 search_barcodes 並回傳解碼值；若只想要特定代碼，可加入 text 篩選器。

我可以在文件資料夾中找出所有 QR 代碼嗎？
可以。請讓代理遍歷資料夾，列出每個 QR 代碼的檔案、解碼文字與頁碼。若未取得授權，僅會檢查每個檔案的前兩頁。

深入了解