OfficeAgent.NET 是一个基于 Open XML SDK 构建的 .NET 文档自动化库，用于对 Word .docx、PowerPoint .pptx 和 Excel .xlsx 文件进行结构化、可验证的操作。它把文档意图转化为类型化、经过验证的操作，而不是直接拼接 XML。
用途方面，该库可用于生成文档和演示文稿、进行针对性编辑、更新表格、样式和图片，以及管理批注和审阅状态。它面向需要以编程方式处理 Office Open XML 文件的 .NET 应用和编码智能体。
主要能力包括：支持 Word 的文本、段落、表格、图片、样式、内容控件、批注线程、脚注和尾注、页面几何与分页、文档属性以及修订标记；支持 PowerPoint 的文本、项目符号、运行和段落格式、模板槽位、样式复制、表格、图片、文本框、嵌入视频和音频、演讲者备注、可解析批注、页脚和幻灯片编号、节、切换和动画，以及幻灯片生命周期（添加、删除、重排、复制）；支持 Excel 的公式编辑（设置工作簿在 Excel 打开时重新计算），可选包 OfficeAgent.Excel.Calculation 可计算一组经过验证的 Excel 函数并将结果写为缓存值。
使用方式上，同一引擎提供三种形式：面向支持 Model Context Protocol 的智能体的 MCP 服务器；面向 Microsoft Agent Framework 和 Microsoft.Extensions.AI 的工具；以及供应用直接控制工作流的 .NET API。应用可以直接使用引擎，无需 MCP。每次编辑遵循四步：Inspect 返回文档的结构化映射；Find 搜索文本并返回经过内容验证的锚点；Preview 针对当前文档验证计划并报告拟议更改而不写入；Apply 提交完整计划并通过配置的提供程序保存。计划（DocumentPlan）是类型化、可 JSON 序列化的操作列表。锚点同时记录位置和预期内容，如果内容或可选文档快照已更改，验证会失败而不是静默定位到不同位置。所有操作要么应用于一个内存事务，要么都不应用。
文档通过配置的提供程序访问。注册后，编辑调用使用 (connectionId, documentId) 对，而不是存储路径或凭据。文件系统提供程序将注册限制在其根目录内；SharePoint 提供程序使用其配置身份的权限。CreateAsync 在连接内创建新文档，请求的 .docx 或 .pptx 扩展名选择已注册的空白文档工厂。
适用场景包括：生成文档和演示文稿、对现有文档进行针对性编辑、更新表格和样式、管理批注和审阅状态、在磁盘或 SharePoint 上编辑文件、构建合同审阅智能体、从模板批量生成报价、将文档差异转化为可审阅的 Word 修订标记、将多个文档组装为一个可编辑包等。
限制方面：该库编辑 Word .docx、PowerPoint .pptx 和 Excel .xlsx 文件，但不自动化 Office 桌面应用程序。核心引擎不渲染页面、不计算 Word 字段、不评估 Excel 公式。依赖分页、目录渲染或字段重算的操作不在核心范围内。Preview 报告结构性更改。可选渲染包可通过外部进程生成 PDF 派生的页面图像，但尚不能检测溢出或页面适配问题。PresentationML 没有修订模型，因此修订标记仅限 Word。动画仅覆盖可表达为过滤 p:animEffect 的效果；飞入、缩放和运动路径会被拒绝而不是近似处理。独立服务器不为 HTTP 托管提供身份验证层，需自行置于身份验证之后。文件系统根目录是信任边界，其 ACL 必须阻止不受信任的主体在服务器运行时创建、重命名或替换条目。令牌节省取决于连接方式：按 id 寻址文档可使包不进入对话，检查可通过保真度和分页收窄；内联 *_content 工具是刻意的例外，它们以 base64 双向携带整个文件，令牌成本与文件大小成正比，适合单次自包含调用，不适合一系列编辑。审阅指导是可选的：对于审阅任务，仅服务器本身不会让智能体在编辑前阅读未解决的批注或选择修订标记；word-document-review 技能教授该工作流。
项目采用 MIT 许可证，可自托管，不收集遥测、分析或回传数据。它只读写给定文件夹、SharePoint 库或会话连接中的文档，除宿主配置的 SharePoint 连接会联系 Microsoft Graph 外，不联系任何第三方。商业支持和部署协助由 dotaction 提供，该服务独立于项目，受其自身协议约束，不改变库的许可证、兼容性承诺或社区支持政策。