注释
本文介绍了由 标准线束驱动的代理或代理流中使用的功能。
Important
这是一项预览功能。
- Microsoft正式发布之前发布预览版功能，以便客户能够提前访问并提供反馈。
- 预览功能具有受限的功能，不适用于生产用途。
- Microsoft可能会更改预览 MCP 工具名称和参数。 避免硬编码依赖项。 Microsoft 提供场景支持。
- 预览功能受Microsoft补充使用条款的约束。
概述
| 服务器 ID | 租户级 URL | 显示名称 | Description |
|---|---|---|---|
mcp_SharePointRemoteServer |
https://agent365.svc.cloud.microsoft/agents/tenants/{tenantId}/servers/mcp_SharePointRemoteServer |
Sharepoint | SharePoint操作工具。 使用此服务器管理网站、列表、列表项、列、文档库、文件、文件夹和文件共享。 文件操作仅限于 5 MB 或更少的文件。 |
可用工具
findSite
查找你可以访问的 SharePoint 站点。 返回与搜索查询匹配的特定网站，如果未提供查询，则返回前 20 个相关网站。
可选参数：
- searchQuery： 搜索查询（整个或部分网站名称）。 省略此参数将返回前 20 个可访问站点。
getSiteByPath
通过精确的主机名和服务器相对路径解析 SharePoint 站点。 仅当具有完整的网站 URL 结构时，才使用此方法。 仅知道网站名称时使用 findSite 。
所需参数：
- 主机 名： 确切主机名（例如，“contoso.sharepoint.com”）
- serverRelativePath： 相对于服务器的路径（例如“sites/Marketing”）。 前导斜杠为可选。
listSubsites
列出SharePoint网站的所有子网站（子网站）。
所需参数：
- siteId： 父 SharePoint 网站的 ID（格式：“hostname，siteCollectionId，webId”）
列出网站中的文档库
列出指定SharePoint网站中的文档库（驱动器）。
可选参数：
- siteId： SharePoint 网站的 ID（默认值：“root”）
获取站点中的默认文档库
获取SharePoint网站中的默认文档库（驱动器）。
可选参数：
- siteId： SharePoint 网站的 ID（默认值：“root”）
getFolderChildren
枚举文档库（驱动器）中指定父文件夹中包含的前 20 个文件和文件夹（DriveItems）。
所需参数：
- documentLibraryId： 文档库的 ID（驱动器）
可选参数：
- parentFolderId： 父文件夹的ID（默认：“root”）。
findFileOrFolder
通过搜索查询查找用户可访问的文件或文件夹 (DriveItem)。 搜索用户有权访问的所有网站和文档库。
所需参数：
- searchQuery： 搜索查询（整个或部分文件名）
获取文件或文件夹元数据
从SharePoint中的指定文档库（drive）获取文件或文件夹（DriveItem）的元数据。
所需参数：
- fileOrFolderId： 文件或文件夹的 ID （DriveItem）
- documentLibraryId： 文档库的 ID（驱动器）
getFileOrFolderMetadataByUrl（获取文件或文件夹元数据通过网址）
从共享URL获取文件或文件夹（DriveItem）的元数据。 只有具有访问文件的现有显式权限的用户才能获取元数据。
所需参数：
- fileOrFolderUrl： 文件或文件夹的 URL。 该 URL 无法兑换以与用户共享；用户必须已拥有明确的访问权限。
readSmallTextFile
读取（下载）一个小于5 MB的文本文件，来自特定的文档库（驱动器）。
所需参数：
- fileId： 要读取或下载的文件的 ID（DriveItem）
- documentLibraryId： 文档库的 ID（驱动器）
readSmallBinaryFile
从特定文档库（驱动器）读取小于 5 MB 的二进制文件。 文件内容以 base64 编码的字符串的形式返回。
所需参数：
- fileId： 要读取或下载的文件的 ID（DriveItem）
- documentLibraryId： 文档库的 ID（驱动器）
创建小型文本文件
创建或上传小于5MB的文本文件到特定的文档库（驱动器）。
所需参数：
- 文件名： 文件名称，包括扩展名。
- 内容正文： 文件的文本内容。
- documentLibraryId： 文档库的 ID（驱动器）
可选参数：
- parentFolderId： 父文件夹的ID（默认：“root”）。
创建小型二进制文件
通过将其内容进行 Base64 编码，在指定文档库（驱动器）中创建小于 5 MB 的二进制文件。
所需参数：
- 文件名： 文件名称，包括扩展名。
- base64Content： 编码为 base64 字符串的二进制文件内容。
- documentLibraryId： 文档库的 ID（驱动器）
可选参数：
- parentFolderId： 父文件夹的ID（默认：“root”）。
创建文件夹
在指定的文档库（驱动器）内创建新文件夹（DriveItem）。 如果存在同名的文件夹，系统将添加数字后缀（例如 NewFolder （1） 。
所需参数：
- folderName： 文件夹的名称
- documentLibraryId： 文档库的 ID（驱动器）
可选参数：
- parentFolderId： 父文件夹的ID（默认：“root”）。
文件或文件夹重命名
重命名指定文档库（驱动器）中的文件或文件夹（DriveItem）。 新名称必须符合命名约定。
所需参数：
- documentLibraryId： 文档库的 ID（驱动器）
- fileOrFolderId： 要重命名的文件或文件夹的 ID
- newFileOrFolderName： 新名称
可选参数：
- Etag： 用于并发控制的 ETag
deleteFileOrFolder (删除文件或文件夹)
从指定的文档库（驱动器）中删除文件或文件夹（DriveItem）。
所需参数：
- documentLibraryId： 文档库的 ID（驱动器）
- fileOrFolderId： 要删除的文件或文件夹的 ID
可选参数：
- Etag： 用于并发控制的 ETag
移动文件或文件夹
将文件或文件夹（DriveItem）移动到目标文件夹。 支持在SharePoint中跨不同的文档库（驱动器）移动。 此操作为异步操作。 使用 checkOperationStatus 来监控进度。
所需参数：
- sourcedoclibid：源文档库（驱动器）的 ID
- sourcefileid： 要移动的源文件或文件夹的 ID
- destdoclibid：目标文档库（驱动器）的 ID
- destfolderid： 目标文件夹的 ID（必须存在）
可选参数：
- newfilename： 已移动项的新名称
copyFileOrFolder
将文件或文件夹（DriveItem）复制到目标文件夹。 支持跨 SharePoint 中的不同文档库进行复制。 此操作为异步操作。 使用 checkOperationStatus 来监控进度。
所需参数：
- sourcedoclibid：源文档库（驱动器）的 ID
- sourcefileid： 要复制的源文件或文件夹的 ID
- destdoclibid：目标文档库（驱动器）的 ID
- destfolderid： 目标文件夹的 ID（必须存在）
可选参数：
- newfilename： 复制项的新名称
checkOperationStatus
使用从原始操作返回的操作令牌检查异步操作的状态，例如复制或移动。
所需参数：
-
operationToken： 从异步操作返回的操作令牌，例如
copyFileOrFolder或moveFileOrFolder
从URL上传文件
将文件从SharePoint或OneDrive URL 上传到文档库（驱动器）中的目标文件夹。 该文件是从源 URL 复制的，因此不会更改原始文件。
所需参数：
- sourceUrl： 源 URL（必须是有效的 SharePoint 或 OneDrive URL）
-
destinationDocumentLibraryId： 目标文档库的 ID。 使用
me访问用户的 OneDrive
可选参数：
-
destinationFolderId： 目标文件夹的 ID（默认值：
root） - 文件名： 新文件名;默认为原始文件名
共享文件或文件夹 (shareFileOrFolder)
发送共享邀请，以授予对指定文档库（drive）中的文件或文件夹（DriveItem）的读取或写入权限。
所需参数：
- documentLibraryId： 文档库的 ID（驱动器）
- fileOrFolderId： 要共享的文件或文件夹的 ID
- recipientEmails： 收件人的电子邮件地址数组
- roles：角色数组：‘read’、'write'（‘write’ 同时授予读写权限）
可选参数：
- 消息：邀请电子邮件的自定义消息（默认值：我们正在协作的文件如下）。
- sendInvitation： 是否发送共享邀请（默认值：true）
在文件上设置敏感性标签
设置指定文档库（驱动器）中文件的敏感度标签。
所需参数：
- documentLibraryId： 文档库的 ID（驱动器）
- fileId： 文件的 ID（DriveItem）
- sensitivityLabelId： 要删除的敏感度标签的 ID 或空字符串
可选参数：
- assignmentMethod： 赋值方法：“standard”、“privileged”、“auto”或“unknownFutureValue”（默认值：“privileged”）
- justificationText： 用于审核目的的理由文本;降级或删除标签时必需（默认值：“MCPServer 已更改”）
listLists
获取特定网站上可用的所有SharePoint列表。 用于发现网站中存在哪些列表。
所需参数：
- siteId： SharePoint 网站的 ID（格式：“hostname，siteCollectionId，webId”）
createList
在站点内创建新的 SharePoint 列表。
所需参数：
- siteId： SharePoint 网站的 ID
- displayName： 新列表的显示名称
可选参数：
-
列： 列作为键值对的集合：
[{ Key: 'JobTitle', Value: 'text' }]。 有效类型：文本、multilineText、数字、布尔值、dateTime、选项、查找、personOrGroup、超链接、货币、计算 - 模板： 列表模板类型（默认值：“genericList”）。 选项：通用列表、文档库、事件、任务、公告、联系人、链接、调查、问题追踪、讨论板
deleteList
从网站删除 SharePoint 列表。 删除整个列表容器及其中的所有项。 此操作不能撤消。
所需参数：
- siteId： SharePoint 网站的 ID
- listId： 要删除的列表的 ID
可选参数：
- Etag： 用于并发控制的 ETag
发送列表邀请
发送共享邀请以授予对 SharePoint 列表的权限。
所需参数：
- listId： 要共享的 SharePoint 列表的 ID
- recipientEmails： 收件人的电子邮件地址数组
- 角色： 角色：“read”（仅查看）、“contribute”（查看、添加、更新、删除项目）、“edit”（包括列表结构的完整编辑）
可选参数：
- siteUrl： 包含列表的 SharePoint 网站的网站 URL
- sendEmail： 是否发送电子邮件通知（默认值：true）
listListItems
从特定的 SharePoint 列表中获取项（行/记录）。
所需参数：
- siteId： SharePoint 网站的 ID
- listId： SharePoint 列表的 ID
获取列表项
通过其 ID 从 SharePoint 列表中获取单个项（行或记录）。
所需参数：
- siteId： SharePoint 网站的 ID
- listId： SharePoint 列表的 ID
- itemId： 特定列表项的 ID
createListItem
在SharePoint list中创建新项（行或记录）。
所需参数：
- siteId： SharePoint 网站的 ID
- listId： SharePoint 列表的 ID
-
字段： 字段值的键值对，例如
[{ Key: 'Title', Value: 'Software Engineer' }, { Key: 'Department', Value: 'Engineering' }]。 通常需要填写“标题”字段。
更新列表项
更新 SharePoint 列表中的现有项（行或记录）。 仅更新指定的字段;省略的字段保留其值。
所需参数：
- siteId： SharePoint 网站的 ID
- listId： SharePoint 列表的 ID
- itemId： 要更新的项的 ID
- 字段： 要更新的字段键值对
可选参数：
- Etag： 用于并发控制的 ETag
删除列表项
从SharePoint list中删除项（行或记录）。
所需参数：
- siteId： SharePoint 网站的 ID
- listId： SharePoint 列表的 ID
- itemId： 要删除的项的 ID
可选参数：
- Etag： 用于并发控制的 ETag
listColumns
获取 SharePoint 列表中的所有列。
所需参数：
- siteId： SharePoint 网站的 ID
- listId： SharePoint 列表的 ID
创建列
在SharePoint list中创建新列。 支持许多列类型，包括文本、数字、选项、dateTime、布尔值、用户、查找、计算等。
所需参数：
- siteId： SharePoint 网站的 ID
- listId： SharePoint 列表的 ID
- 名字： 内部列名称（编程标识符）
- columnType：列类型：文本、备注、数字、整数、布尔、dateTime、单选、多选、货币、查找、用户、URL、计算、术语、多术语、位置、地理位置、缩略图、计数器、计算、contentTypeId、文件、附件、GUID、outcomeChoice、approvalStatus
可选参数：
-
columnProperties： 基于类型的设置（例如，
{ "maxLength": 255 }用于文本，{ "choices": ["A","B","C"] }用于选择） - 描述： 列的描述
- displayName： UI 中显示的显示名称（默认值为“name”）
- 必填： 将列设置为必填项（默认值：false）
- 隐藏： 隐藏视图中的列（默认值：false）
updateColumn
更新 SharePoint 列表中的现有列。
所需参数：
- siteId： SharePoint 网站的 ID
- listId： SharePoint 列表的 ID
- columnId： 要更新的列的 ID
可选参数：
- columnType： 列类型（提供“columnProperties”时需要）
- columnProperties： 要更新的特定类型的属性
- 描述： 新说明
- displayName： 新的显示名称
- 隐藏： 隐藏或显示列
- 必需：使列必需或可选
删除列
从 SharePoint 列表中删除一列。 警告： 此操作删除所有项在该列中存储的所有数据。
所需参数：
- siteId： SharePoint 网站的 ID
- listId： SharePoint 列表的 ID
- columnId： 要删除的列的 ID
主要功能
站点管理
- 按名称查找网站或浏览可访问的网站。
- 通过精确的 URL 路径获取站点。
- 列出子站点和子站点。
- 全面的网站层次结构导航。
文档库管理
- 列出网站中的所有文档库。
- 获取默认文档库。
- 浏览文件夹内容（最多20个项目）。
- 创建和管理文件夹结构。
文件操作
- 创建文本和二进制文件（5MB或以下）。
- 阅读文本和二进制文件（5MB或以下）。
- 删除、重命名和移动文件和文件夹。
- 跨文档库复制文件和文件夹。
- 从SharePoint或OneDrive URL 上传文件。
- 在所有可访问的网站上搜索文件和文件夹。
- 获取文件和文件夹元数据。
异步操作
- 跨文档库异步复制和移动文件和文件夹。
- 使用操作令牌检查异步操作的状态。
列表操作
- 创建、读取和删除列表。
- 支持多个列表模板，包括泛型、文档库、事件和任务。
- 使用基于角色的权限共享列表。
- 通过创建、读取、更新和删除列表项来管理列表项。
列管理
- 创建多种类型的列，例如文本、备注、数字、布尔值、日期和时间、选择、查阅、用户、URL、计算等。
- 更新列属性和元数据。
- 配置列要求和可见性。
- 设置特定于类型的列属性。
共享和权限
- 与用户共享文件、文件夹和列表。
- 使用基于角色的访问控制，包括读取、写入、贡献和编辑角色。
- 发送电子邮件通知以便分享。
- 请柬中的自定义消息。
安全性与合规性
- 应用和删除敏感度标签。
- 使用多个分配方法，包括标准、特权和自动分配方法。
- 支持审核理由。
- 将并发控制与 eTags 配合使用。
备注
- 文件操作仅限于上传和下载的 5 MB 或更少的文件。
- 复制和移动操作是异步的。 使用
checkOperationStatus来监控进度。 - 复制和移动操作支持SharePoint中的跨库操作。
-
uploadFileFromUrl需要有效的SharePoint或OneDrive源 URL。 - eTag 为更新和删除提供并发控制。
- 重复的文件夹名称自动添加数字后缀。
- 无法撤消列表删除。
- 删除列会删除该列中存储的所有数据。
- 默认情况下，搜索操作返回前 20 个结果。