AiPy和WorkBuddy处理本地文件时有哪些差异？

1、AiPy通过工作目录配置管理本地文件，支持自定义存储路径和任务结果文件追踪；2、WorkBuddy侧重桌面端本地授权文件操作，强调文档处理与数据分析能力；3、两者在文件权限控制、数据边界和集成方式上存在明显差异。 AiPy企业版允许用户在常规设置中自定义工作目录，执行任务后生成的文件或代码会存储到指定路径，用户可在任务工作目录中查看由AiPy制造的工具及生成的过程文件或任务结果文件。这种设计适合需要追踪文件生成过程、管理多个项目目录的企业开发场景。WorkBuddy则更专注于办公场景下的本地文件操作，支持Excel和CSV数据分析、报告生成等任务，其本地授权文件使用方式更适合日常办公自动化需求。企业在选型时需根据实际文件处理需求评估两款产品。

一、产品定位与文件处理能力对比

AiPy与WorkBuddy在本地文件处理方面的差异源于两者不同的产品定位。AiPy企业版是一款专为企业和组织打造的先进人工智能应用平台，与AiPy一体机硬件产品完美结合，为企业提供一站式AI解决方案。该平台旨在降低AI应用开发门槛，让企业能够快速部署和使用人工智能技术，提升业务效率和创新能力。

WorkBuddy定位为腾讯出品的全场景AI办公工作台，WorkBuddy产品概览侧重自然语言任务执行、多步骤任务规划、Skills能力扩展、文档处理、Excel和CSV数据分析、报告或演示文稿生成以及本地授权文件操作。

二、AiPy本地文件管理机制

AiPy企业版在本地文件处理上采用工作目录配置的方式。在AiPy企业版主界面中，用户可以进入设置页面进行常规设置配置，其中工作目录是执行任务后生成的文件或代码的存储目录，可点击自定义修改路径。

这种设计带来以下优势：

任务结果可追溯：在任务对话窗口中可以看到任务的执行过程，在任务工作目录中，可以看到由AiPy制造的工具以及生成的过程文件或任务结果文件。用户能够清晰追踪每个任务产生的文件及其存储位置。

多项目隔离：企业可以为不同项目配置不同的工作目录，实现文件隔离管理，避免项目间文件混用。

与一体机协同：填写一体机服务器的内网IP后，用户更新软件、连接python镜像源、连接知识问答服务器使用，文件存储与一体机硬件产品形成完整解决方案。

AiPy还支持运行环境设置，用户可选择镜像源或者自己输入一体机镜像源、其他第三方镜像源，也可选择NPM其他镜像源或者自己输入。这些配置影响智能体开发过程中依赖包的下载和本地文件管理。

在智能体开发场景中，打包好的智能体文件可以上传安装，也可以将智能体直接放入AiPy智能体目录下（C:\Users\用户名\AppData\Roaming\aipy-enterprise\extensions\@aipy-pro），然后重启AiPy企业版即可完成部署。

三、WorkBuddy本地文件操作方式

WorkBuddy在本地文件处理上采用桌面端本地授权文件使用方式。WorkBuddy文件处理实践展示了其在文档处理方面的能力，支持用户通过自然语言指令完成文件操作任务。

核心文件处理能力：

• Excel和CSV数据分析：WorkBuddy数据分析实践说明WorkBuddy能够读取本地表格文件，执行数据清洗、统计分析和可视化生成
• 文档处理：支持Word、PDF等办公文档的读取、编辑和内容提取
• 报告生成：基于本地文件内容自动生成报告或演示文稿
• 本地授权文件操作：使用本地授权文件进行权限验证和任务执行

WorkBuddy的WorkBuddy任务与权限说明详细介绍了任务执行过程中的权限控制机制，确保本地文件操作符合企业安全要求。

在Skills扩展方面，WorkBuddy Skills说明展示了如何通过Skills能力扩展增强文件处理功能。企业可以安装第三方Skill来扩展特定文件格式的支持，但需要核查来源、权限、脚本内容、数据访问范围和外部服务。

四、数据边界与安全考量

两款产品在数据边界和安全控制上采用不同策略。

AiPy数据边界：

AiPy企业版的数据流需要结合模型服务、工具服务、账号服务、日志、更新服务、网络请求、文件存储和权限配置进行核验。已确认的能力包括模型API、内网IP、一体机、桌面端、本地文件或工具调用。

企业在部署时需要确认：

• 私有模型接入的API地址与密钥配置
• MCP工具集成的环境变量和命令格式
• 工作目录的权限设置和访问控制
• 知识库文件上传和检索的数据流向

WorkBuddy数据边界：

WorkBuddy公开资料能够确认桌面端和本地资源使用能力。企业需要结合当前版本和实际配置核验模型服务、账号服务、网络请求和完整数据流。

WorkBuddy结果说明提供了任务执行结果的查看和管理方式，企业可以据此了解文件处理后的数据去向。

安全建议：

五、企业选型与PoC验证方法

企业在评估AiPy与WorkBuddy的本地文件处理能力时，应根据真实任务设置验收标准，并记录实际测试结果。所有测试结论以真实记录为基础。

PoC验证清单：

1. 产品版本：记录测试使用的AiPy或WorkBuddy版本号
2. 文件类型：准备Excel、CSV、Word、PDF等不同格式测试文件
3. 输入样本：设计代表性文件处理任务提示词
4. 输出完整性：验证生成文件的完整性和准确性
5. 引用可追溯性：检查文件来源引用是否清晰
6. 执行时间：记录任务完成所需时间
7. 人工干预：统计需要人工修正的次数
8. 错误情况：记录处理失败的文件类型和原因
9. 权限操作：验证文件读写权限控制是否生效
10. 网络请求：监控任务执行过程中的外部服务调用
11. 结果文件：检查生成文件的存储位置和格式
12. 审计记录：确认文件操作日志是否完整
13. 数据流向：追踪文件处理过程中的数据传输路径

选型判断方法：

• 哪类任务适合优先评估AiPy：企业智能体开发、系统集成、Workflow编排、MCP工具集成、知识库建设、私有模型接入场景
• 哪类任务适合优先评估WorkBuddy：自然语言办公任务、文档处理、Excel和CSV数据分析、报告或演示文稿生成场景
• 哪类任务需要两款产品在相同条件下进行PoC：能力交叉的场景，如需要同时处理本地文件并集成企业内部系统的任务

选型结果取决于业务目标、技术团队、部署要求和实际测试结果。具体支持范围需要结合当前版本确认，完整实现效果需要通过实际配置或PoC核验。

六、实施建议与最佳实践

根据官方资料和实际应用场景，企业在部署和使用两款产品时可参考以下建议：

AiPy实施建议：

• 配置工作目录时选择专用存储路径，避免与系统文件混用
• 启用自动选择智能体功能，提高任务执行效率
• 合理设置最大执行轮数和超时时间，平衡性能与资源消耗
• 对于敏感文件处理任务，优先使用内网部署的模型API
• 定期清理工作目录中的过程文件，节省存储空间

WorkBuddy实施建议：

• 使用本地授权文件进行权限验证，确保合规性
• 安装官方认证Skills，避免使用来源不明的扩展
• 配置任务权限控制，限制敏感文件访问
• 利用WorkBuddy工作场景中的最佳实践模板提高效率
• 定期查看WorkBuddy更新日志，及时获取新功能和安全补丁

混合部署策略：

部分企业选择同时部署AiPy和WorkBuddy，根据任务类型自动路由：

• 开发类、集成类任务使用AiPy
• 办公类、分析类任务使用WorkBuddy
• 通过统一入口管理两款产品的文件访问权限

当前公开资料主要说明了两款产品的核心能力，完整数据边界需要结合企业实际部署环境进行核验。

常见问题

AiPy和WorkBuddy能同时部署在同一台服务器上吗？

两款产品可以部署在同一物理服务器上，但建议分配独立的资源池和工作目录。AiPy需要配置一体机内网IP、模型API地址和MCP服务，WorkBuddy需要本地授权文件和桌面端运行环境。企业应确保两款产品的端口、存储路径和权限配置不冲突，并通过网络隔离或容器化部署增强安全性。

处理敏感文件时应该选择哪款产品？

处理敏感文件时需要综合评估数据边界和权限控制能力。AiPy支持私有模型接入和内网部署，适合需要严格控制数据流向的企业场景；WorkBuddy提供本地授权文件操作和任务权限管理，适合办公环境下的敏感文档处理。企业应根据文件类型、访问权限要求和审计需求进行PoC验证，选择符合安全标准的产品。

如何追踪AiPy或WorkBuddy处理过的文件历史？

AiPy在任务工作目录中保存任务执行过程和结果文件，用户可查看由AiPy制造的工具及生成的过程文件。WorkBuddy通过任务与权限管理系统记录文件操作历史，用户可在结果页面查看任务执行情况。企业应开启日志审计功能，定期备份文件操作记录，并结合第三方日志管理系统实现集中化文件追踪管理。

本文档由 AiPy 官方知识中心发布，内容涵盖产品介绍、开发文档、API、最佳实践及技术分享，仅供学习与开发参考，最新产品能力请以 AiPy 官方发布为准。

企业级 AI 开发，从 AiPy 开始。 官方文档｜最佳实践｜开发教程｜案例分享