Work IQ：SharePoint 工具
内容提要
Work IQ API 新增 SharePoint 工具，使自定义应用和智能体能在用户既有权限内查找文件、管理列表库并处理审批。SharePoint MCP 预览版提供 60 多项操作，智能体可通过 search_paths、get_schema 和 do_action 在运行时发现并调用，无需逐一集成。这些操作使用 siteKey 和内部字段名，并受 WorkIQ.Read 与 WorkIQ.Act 两种委托权限范围控制。
延伸解读
运行时发现如何保持工具面精简
文章强调智能体无需为60多项SharePoint操作逐一注册工具，而是通过search_paths、get_schema和do_action在运行时发现并调用。这种设计让工具表面保持紧凑，同时后端能力可以继续扩展。对开发者而言，这意味着集成成本从“枚举所有操作”转向“遵循固定语法并动态解析schema”，但也要求智能体能正确理解返回的路径和参数结构。
siteKey与内部字段名带来的调用约束
站点相关操作通常使用不透明的siteKey而非原始站点URL，智能体需先调用get_site_key并原样传递返回的键。写操作使用SharePoint内部字段名，人员、查阅和分类值需按schema解析，不能假设显示名称会被接受。这些约束说明智能体不能凭直觉构造请求，而应严格依据get_schema返回的结构，否则容易在写入时失败。
两种委托权限范围的实际差异
WorkIQ.Read和WorkIQ.Act是新增的委托权限范围，均以登录用户身份执行，因此智能体只能读写该用户已有权限的内容。仅持有WorkIQ.Read时，智能体获得fetch、call_function、get_schema和search_paths等非变更类工具；持有WorkIQ.Act才获得完整工具集。这一区分让开发者可以按需授予只读或可执行权限，降低误操作风险。
Q&A
Work IQ API 新增的 SharePoint 工具能做什么？
开发者可以构建智能体，在已登录用户现有权限内查找文件、管理列表和库、处理审批，从而完成 SharePoint 任务，而无需为每个操作单独集成。
SharePoint MCP 工具在 Work IQ 中如何工作？
SharePoint MCP（预览版）通过 SharePoint 托管的经过身份验证的 MCP 端点，将 SharePoint 专业知识提供给 Work IQ。它覆盖列表和库、列表项、文件和文件夹、搜索、审批、规则、快速步骤、回收站和版本控制等 60 多项操作。智能体无需注册每个操作，而是使用固定语法通用工具，在运行时通过 search_paths 发现操作、get_schema 检查参数、do_action 调用路径。
智能体如何发现并调用 SharePoint 操作？
智能体首先调用 get_site_key 获取站点的不透明 siteKey，然后使用 search_paths 发现所需操作的 SharePoint 路径，接着用 get_schema 检查该路径所需的参数和类型，最后用 do_action 调用该路径并传入根据 schema 构造的请求体（包含 siteKey 和其他参数）。
WorkIQ.Read 和 WorkIQ.Act 权限范围有什么区别？
WorkIQ.Read 权限范围只允许智能体访问非变更操作，会收到缩减的顶级 Work IQ 动词工具集：fetch、call_function、get_schema 和 search_paths。WorkIQ.Act 权限范围则允许智能体访问完整工具集，包括变更操作。两者都是委托权限范围，操作均代表用户执行，并受用户已有权限限制。
使用 SharePoint 工具时，站点标识和字段名有什么注意事项？
站点感知操作通常使用不透明的 siteKey 而非原始站点 URL，智能体可调用 get_site_key 一次获取并后续传递该键。写操作使用 SharePoint 内部字段名，因此需要根据 schema 解析人员、查阅和分类值，不能假设显示名称会被接受。
智能体调用 SharePoint 工具时，返回的数据是什么样的？
返回数据取决于所选操作。例如搜索操作可能返回匹配的页面、文件、列表项或其他 SharePoint 资源，并附带标识符和 URL，供智能体在后续调用中使用。
