要使用 AI 代理批量转换文件夹，请将 GroupDocs.Conversion.Mcp 服务器指向该文件夹，并用一句话描述任务。代理会遍历文件，对每个文档调用一次转换引擎，并在 Claude、Cursor 或 GitHub Copilot 本地报告生成的结果。这是一种由一句话驱动的批处理：

将我的 documents 文件夹中的所有 DOCX 转换为 PDF，保留原文件

带有配置和故障排除的逐步说明请参见文档：如何使用 AI 代理批量转换文件夹中的文档。本文将从首次提示到处理失败的完整会话进行演示。

从哪里开始：存储文件夹还是提示？

先配置存储文件夹。批处理作业的成功与否取决于文件夹映射，而映射只需在服务器条目中设置一次，而不是在每个提示中重复。两个环境变量控制映射：

{
  "mcpServers": {
    "groupdocs-conversion": {
      "type": "stdio",
      "command": "dnx",
      "args": ["GroupDocs.Conversion.Mcp", "--yes"],
      "env": {
        "GROUPDOCS_MCP_STORAGE_PATH": "/path/to/invoices",
        "GROUPDOCS_MCP_OUTPUT_PATH": "/path/to/invoices/converted"
      }
    }
  }
}

GROUPDOCS_MCP_STORAGE_PATH 是代理可以读取的文件夹。GROUPDOCS_MCP_OUTPUT_PATH 是转换后文件的存放位置。设置好这两个路径后，源文件夹保持不变，所有结果都会写入 converted。这是批处理最干净的布局。dnx 命令需要 .NET 10 SDK；Docker 镜像 ghcr.io/groupdocs-conversion/conversion-net-mcp:latest 会将文件夹挂载为 /data。在注册服务器后，重新启动 Claude Desktop、Claude Code、VS Code 或 Cursor。

第一个提示会做什么？

先给代理一个最简单的指令：

将此文件夹中的所有内容从 DOCX 转换为 PDF。

代理会枚举文件夹，并对每个文件调用 convert 工具，参数为 format: "pdf"。每次调用都会从存储中读取文件名并返回保存后的文件名。运行两次后，第二次会在第一次生成的文件旁边创建新文件，文件名会有所区别。

如何添加过滤器或规则？

提示本身就是编排层。过滤、排序和错误策略都可以用自然语言描述：

将所有 PDF 转换为 Markdown；跳过已经转换的文件。

将发票转换为 PDF/A 以便归档，并列出任何转换失败的文件。

为每个演示文稿生成 PNG 预览图。

若需要排序，代理可以先调用 get_document_info，该调用会返回文件类型、页数和基本属性，而不进行实际转换：

先检查每个 PDF 的页数，仅转换页数超过 10 页的文件。

“页数超过 10 页”的判断由代理自行完成，实际转换仍由引擎负责。

当某个文件转换失败会怎样？

当引擎无法转换文件时（例如源格式不受支持或密码错误），对应文件的响应文本会以操作名称和失败原因开头。若文件名不存在，返回的会是服务器可见的文件列表，以便代理自行纠正。对于受保护的文件，convert 接受可选的 password 参数。

因此，错误策略应写入提示中：“列出任何转换失败的文件”会让代理在运行结束时提供报告，防止失败被忽略。阅读报告后，只重新运行失败的文件即可。

示例会话

以下是一个简化的示例会话。文件名为虚构，回复基于文档行为而非截图。

You:    将发票转换为 PDF/A 以便归档，并列出任何转换失败的文件。
Agent:  [枚举发票文件]
Agent:  [逐个调用 convert]
Agent:  已将 11 个文件转换到输出文件夹。
        失败：invoice-0412.docx（受密码保护，未提供密码）。

如何跟踪大文件夹的进度？

代理通常一次处理一个文件，因此运行时间会随文件数量和大小线性增长。若需要进度报告，只需在提示中说明：“每处理十个文件后告诉我一次”或“在结束时给出摘要”。几百份文档运行良好，最终报告会列出所有处理情况。建议先在一个小子集上测试，人工检查两三份输出，然后再对完整文件夹执行。

如果批处理必须无人值守怎么办？

代理会话需要人为启动。若要实现计划任务，可参考 n8n 使用指南，该指南展示了如何使用工作流工具驱动同一服务器；引擎也可以通过 GroupDocs.Conversion .NET 库进行脚本化。对于需要即时报告的临时批处理，仍可使用聊天方式。

有哪些限制？

  • 评估模式下批处理上限为 15 份文档。 未授权时，单个服务器进程最多只能打开 15 份文档，输出会带有评估水印。超过此数量的调用会失败，直至服务器重启。可在开始真实批处理前使用 get_license_status 检查模式，或询问 “conversion server 的许可证状态是什么？”。
  • 计量授权需要外部访问。 使用计量密钥时，使用情况会上报至 GroupDocs 服务器，因此防火墙内的机器应使用许可证文件。文档内容永不上传。
  • 扫描文件保持为图像。 OCR 不在服务器中实现，纯图片 PDF 批处理后仍然是图像，无法获得文本层。

FAQ

如何使用 AI 将文件夹中的所有 DOCX 转换为 PDF？
先设置存储文件夹，然后用一句话让代理执行此操作。它会逐个通过本地服务器转换文件，整个过程不涉及上传。

AI 代理能在本地处理整个文件夹吗？
可以。代理和转换服务器都运行在本机，文件的读取和写入均在本地文件夹中完成。

自动化文档转换流水线的最佳方式是什么？
对于需要人工审查的临时批处理，使用聊天方式即可。若要实现定时流水线，可使用 n8n 等工作流工具驱动同一服务器，或直接使用 .NET 库编写脚本。

深入了解