OneDrive 参考文档(预览)

Note

本文介绍了由 标准线束驱动的代理或代理流中使用的功能。

Important

这是一项预览功能。

  • Microsoft正式发布之前发布预览版功能,以便客户能够提前访问并提供反馈。
  • 预览功能具有受限的功能,不适用于生产用途。
  • Microsoft可能会更改预览 MCP 工具名称和参数。 避免硬编码依赖项。 Microsoft 提供场景支持。
  • 预览功能受Microsoft补充使用条款的约束。

Note

针对特定应用的 Microsoft 365 MCP 工具(Copilot、日历、邮件、SharePoint、OneDrive、Teams、User 和 Word)仅用于向后兼容,不应用于生产环境或新项目。 对于需要访问 Microsoft 365 资源的新项目,请使用 Work IQ MCP 和 Microsoft Copilot harness。 更多信息请参见 Copilot Studio 中的 Work IQ MCP。

Overview

服务器 ID 租户级 URL 显示名称 说明
mcp_OneDriveRemoteServer https://agent365.svc.cloud.microsoft/
agents/tenants/{tenantId}/servers/
mcp_OneDriveRemoteServer
OneDrive OneDrive操作工具。 使用此服务器管理用户个人OneDrive中的文件和文件夹。 所有文件操作限制为 ≤5MB。

可用工具

获取OneDrive

获取有关用户OneDrive的信息,包括驱动器元数据、配额和所有者信息。

不需要参数。

getFolderChildrenInMyOnedrive

枚举用户OneDrive中指定父文件夹中包含的前 20 个文件和文件夹(DriveItems)。

可选参数:

  • parentFolderId: 你想列出的文件和文件夹的父文件夹的ID(默认:“root”)

在我的OneDrive中查找文件或文件夹

通过搜索查询在用户的 OneDrive 中查找文件或文件夹(DriveItem)。 如果知道该项位于用户的OneDrive中,此方法比搜索所有可访问文件更有效。

所需参数:

  • 搜索查询: 搜索查询;可以是整个或部分文件名

获取我在OneDrive上的文件或文件夹元数据

从用户的OneDrive获取文件或文件夹(DriveItem)的元数据。

所需参数:

  • fileOrFolderId:用户OneDrive中文件或文件夹的ID

getFileOrFolderMetadataByUrl(获取文件或文件夹元数据通过网址)

从共享 URL 获取文件或文件夹(DriveItem)的元数据。 只有具有访问文件的现有显式权限的用户才能获取元数据。

所需参数:

  • fileOrFolderUrl: 文件或文件夹的URL。 不能通过兑换该 URL 来与用户共享;用户必须已具有显式访问权限。

readSmallTextFileFromMyOnedrive

从用户的OneDrive读取文本文件(下载)。

所需参数:

  • fileID: 用于读取或下载的文件(DriveItem)的ID。

在我的OneDrive中创建小文本文件

创建或上传小于 5 MB 的文本文件,并将其上传到用户的OneDrive。

所需参数:

  • 文件名: 要创建的文件名称
  • 内容正文: 文件内容。

可选参数:

  • parentFolderId: 父文件夹的 ID(默认:“root”)。

创建文件夹在我的OneDrive

在用户的OneDrive中创建一个新文件夹(DriveItem),作为指定父文件夹的子文件夹。 如果已存在同名的文件夹,该方法将添加数字后缀(例如 NewFolder (1) 。

所需参数:

  • 文件夹名称: 要创建的文件夹名称

可选参数:

  • parentFolderId: 父文件夹的 ID(默认:“root”)。

重命名文件或文件夹在我的OneDrive中

重命名用户OneDrive中的文件或文件夹(DriveItem)。 新名称必须符合命名约定。

所需参数:

  • fileOrFolderId: 要重命名的文件或文件夹的ID
  • newFileOrFolderName: 文件或文件夹的新名称

可选参数:

  • etag: 并发控制的ETag值。 仅当 DriveItem 的当前 ETag 匹配时,操作才会成功

删除我在 OneDrive 中的文件或文件夹

从用户的OneDrive中删除文件或文件夹(DriveItem)。

所需参数:

  • fileOrFolderId: 要删除的文件或文件夹的ID

可选参数:

  • etag: 并发控制的ETag值

分享我的 OneDrive 中的文件或文件夹

发送共享邀请,以授予用户OneDrive中对文件或文件夹(DriveItem)的读取或写入权限。

所需参数:

  • fileOrFolderId: 要分享的文件或文件夹的ID
  • 收件人电子邮件: 可邀请收件人的电子邮件地址阵列
  • 角色: 要分配的角色数组。 接受的值:“读取”、“写入”(选择“写入”将授予“读取”和“写入”权限)

可选参数:

  • 消息: 请在邀请邮件中包含的定制邮件。 默认值:“这是我们正在协作处理的文件。”
  • 发送邀请: 是否发送分享邀请。 默认值:true。

在我的OneDrive中文件上设置敏感度标签

设置用户OneDrive中文件的敏感度标签。

所需参数:

  • fileId: 文件 ID(DriveItem)
  • 敏感标签ID: 要分配敏感标签的ID,或用于移除的空字符串

可选参数:

  • assignmentMethod: 分配方法:'standard'、'privileged'、'auto' 或 'unknownFutureValue'(默认:'privileged')
  • justificationText: 用于审计目的的理由文本;在降级或移除标签时为必填(默认:'由MCPServer更改')

创建我的OneDrive中的小型二进制文件

通过对其内容进行 Base64 编码,在用户的 OneDrive 中创建一个小于 5 MB 的二进制文件。

所需参数:

  • 文件名: 要创建的文件名称,包括文件扩展名
  • base64Content: 编码为base64字符串的二进制文件内容

可选参数:

  • parentFolderId: 父文件夹的 ID(默认:“root”)。

readSmallBinaryFileFromMyOnedrive(从我的 OneDrive 读取小型二进制文件)

从用户的OneDrive读取小于 5 MB 的二进制文件。 以 base64 编码字符串的形式返回文件内容。

所需参数:

  • fileID: 用于读取或下载的文件(DriveItem)的ID。

复制我的OneDrive中的文件或文件夹

将文件或文件夹(DriveItem)复制到用户OneDrive中的目标文件夹。 此操作为异步操作。 使用 checkOperationStatusInMyOnedrive 来监控进度。

所需参数:

  • sourcefileid: 用于复制的源文件或文件夹(DriveItem)的ID
  • destfolderID:目标文件夹的 ID(必须存在于用户的 OneDrive 中)

可选参数:

  • newfilename: 复制项目的新名称(默认为原始名称)

moveFileOrFolderInMyOnedrive

将文件或文件夹(DriveItem)移动到用户OneDrive中的目标文件夹。 此操作为异步操作。 使用 checkOperationStatusInMyOnedrive 来监控进度。

所需参数:

  • sourcefileid: 要移动的源文件或文件夹(DriveItem)的ID
  • destfolderID:目标文件夹的 ID(必须存在于用户的 OneDrive 中)

可选参数:

  • newfilename: 移动的项目的新名称(默认为原始名称)

检查操作状态在我的OneDrive

使用从原始操作返回的操作令牌检查异步操作的状态,例如复制或移动。 如果仍在进行中,则返回进度信息;如果失败,则返回错误详细信息;如果成功完成,则返回最终文件或文件夹元数据。

所需参数:

  • 操作令牌: 操作令牌来自异步操作,如 copyFileOrFolderInMyOnedrive 或 moveFileOrFolderInMyOnedrive

主要功能

OneDrive管理

  • 获取OneDrive信息,例如配额和所有者
  • 访问用户的个人 OneDrive
  • 所有操作都以经过身份验证的用户的 OneDrive 为目标

文件搜索和发现

  • 在用户的 OneDrive 中按名称搜索文件和文件夹
  • 按 ID 或共享 URL 获取文件或文件夹元数据
  • 浏览文件夹内容(最多20个项目)。

文件操作

  • 创建文本和二进制文件(≤5 MB)
  • 读取文本和二进制文件(≤5 MB)
  • 使用并发控制删除文件
  • 使用 eTag 保护重命名文件
  • 异步复制和移动文件和文件夹

文件夹管理

  • 创建具有可选父路径的文件夹
  • 重复的文件夹名称自动添加数字后缀。
  • 列出文件夹内容(最多 20 个项目)
  • 获取文件夹元数据
  • 使用并发控制删除文件夹
  • 使用 eTag 保护重命名文件夹

共享和权限

  • 与用户共享文件和文件夹
  • 基于角色的访问控制(读取、写入)
  • 发送电子邮件通知以便分享。
  • 请柬中的自定义消息。

安全性与合规性

  • 应用和删除敏感度标签。
  • 使用多个分配方法,包括标准、特权和自动分配方法。
  • 支持审核理由。
  • 将并发控制与 eTags 配合使用。

备注

  • 所有操作都针对已验证用户的个人 OneDrive。
  • 文件操作仅限于上传和下载的 5 MB 或更少的文件。
  • 删除和重命名操作支持使用 ETag 进行并发控制。
  • 共享需要有效的电子邮件地址和适当的权限。
  • 敏感度标签需要适当的许可和配置。
  • 默认情况下,文件夹列表最多返回 20 个项目。