想象一个装有扫描发票的收件箱，每页都有一个标识采购订单的条形码。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:    对文件夹中的每个 PDF，读取条形码，并给我一个包含文件名、条形码值、页码的表格。

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
        | 文件             | 条形码值      | 页码 |
        | invoice-0007.pdf | PO-448210     | 1    |
        | invoice-0008.pdf | PO-448377     | 1    |
        scan-0009.pdf 在已处理的页面中没有条形码。

示例输出：文件名和条形码值为虚构。工具返回上述字段。

Signature 或 Parser：哪个服务器读取代码？

当代码是您同样添加的签名元素，或文档双向流动时（读取传入的引用，完成工作后，在输出文档上使用携带新引用的 QR 码调用 sign），请使用 GroupDocs.Signature.Mcp。 当您从任意扫描件中提取数据，并且还需要同一文件中的文本、表格或元数据时，请使用 GroupDocs.Parser.Mcp（仅以 Docker 镜像形式提供；其 extract_barcodes 工具）。该服务器读取签名和代码，但不提取布局、字段或表格。

不应自动化的内容

  • 这不是 OCR。 这些工具读取代码符号，而不是印刷文本。没有代码的扫描页会返回空，这是一种正确的答案，而不是错误。
  • 解码后的值是未经信任的输入。 它由创建文档的人提供。请报告、查询并交叉核对。不要让代理在未经审查的情况下直接使用它。

评估限制

如果没有许可证，仅会处理文档的前 2 页，并在每页上加上试用标记。第 3 页上的代码根本找不到，空结果看起来就像“没有代码”。在信任空结果之前，请让代理调用 get_license_status。

常见问题

Claude 能读取此 PDF 中的 QR 码吗？
是的。服务器连接后，Claude 调用 search_qr_codes 并在本地报告解码后的文本、页码和位置。

如何使用 AI 从发票中提取条形码值？
让代理读取文件中的条形码。它会调用 search_barcodes 并返回解码值；如果只想要特定代码，可添加 text 过滤器。

我能在文档文件夹中找到所有 QR 码吗？
可以。让代理遍历文件夹，列出每个 QR 码的文件、解码文本和页码。没有许可证时，仅检查每个文件的前 2 页。

深入了解