one-drive-automation

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

OneDrive Automation via Rube MCP

通过Rube MCP实现OneDrive自动化

Automate OneDrive operations including file upload/download, search, folder management, sharing links, permissions management, and drive browsing through Composio's OneDrive toolkit.

Toolkit docs: composio.dev/toolkits/one_drive

借助Composio的OneDrive工具包，自动化OneDrive的各类操作，包括文件上传/下载、搜索、文件夹管理、共享链接、权限管理及驱动器浏览。

工具包文档：composio.dev/toolkits/one_drive

Prerequisites

前提条件

Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
Active OneDrive connection via
```
RUBE_MANAGE_CONNECTIONS
```
with toolkit
```
one_drive
```
Always call
```
RUBE_SEARCH_TOOLS
```
first to get current tool schemas

必须已连接Rube MCP（需具备RUBE_SEARCH_TOOLS权限）
通过
```
RUBE_MANAGE_CONNECTIONS
```
并使用工具包
```
one_drive
```
激活OneDrive连接
请始终先调用
```
RUBE_SEARCH_TOOLS
```
以获取最新的工具架构

Setup

设置步骤

Get Rube MCP: Add

https://rube.app/mcp

as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.

Verify Rube MCP is available by confirming
```
RUBE_SEARCH_TOOLS
```
responds
Call
```
RUBE_MANAGE_CONNECTIONS
```
with toolkit
```
one_drive
```
If connection is not ACTIVE, follow the returned auth link to complete Microsoft OAuth
Confirm connection status shows ACTIVE before running any workflows

获取Rube MCP：在客户端配置中添加

https://rube.app/mcp

作为MCP服务器。无需API密钥 — 仅需添加端点即可使用。

通过确认
```
RUBE_SEARCH_TOOLS
```
能正常响应，验证Rube MCP是否可用
调用
```
RUBE_MANAGE_CONNECTIONS
```
并指定工具包
```
one_drive
```
若连接状态未显示为ACTIVE，请按照返回的授权链接完成Microsoft OAuth认证
在运行任何工作流之前，确认连接状态为ACTIVE

Core Workflows

核心工作流

1. Search and Browse Files

1. 搜索与浏览文件

When to use: User wants to find files or browse folder contents in OneDrive

Tool sequence:

```
ONE_DRIVE_GET_DRIVE
```
- Verify drive access and get drive details [Prerequisite]
```
ONE_DRIVE_SEARCH_ITEMS
```
- Keyword search across filenames, metadata, and content [Required]
```
ONE_DRIVE_ONEDRIVE_LIST_ITEMS
```
- List all items in the root of a drive [Optional]
```
ONE_DRIVE_GET_ITEM
```
- Get detailed metadata for a specific item, expand children [Optional]
```
ONE_DRIVE_ONEDRIVE_FIND_FILE
```
- Find a specific file by exact name in a folder [Optional]
```
ONE_DRIVE_ONEDRIVE_FIND_FOLDER
```
- Find a specific folder by name [Optional]
```
ONE_DRIVE_LIST_DRIVES
```
- List all accessible drives [Optional]

Key parameters:

```
q
```
: Search query (plain keywords only, NOT KQL syntax)
```
search_scope
```
:
```
"root"
```
(folder hierarchy) or
```
"drive"
```
(includes shared items)
```
top
```
: Max items per page (default 200)
```
skip_token
```
: Pagination token from
```
@odata.nextLink
```
```
select
```
: Comma-separated fields to return (e.g.,
```
"id,name,webUrl,size"
```
)
```
orderby
```
: Sort order (e.g.,
```
"name asc"
```
,
```
"name desc"
```
)
```
item_id
```
: Item ID for
```
GET_ITEM
```

expand_relations

: Array like

["children"]

["thumbnails"]

for

GET_ITEM

```
user_id
```
:
```
"me"
```
(default) or specific user ID/email

Pitfalls:

```
ONE_DRIVE_SEARCH_ITEMS
```
does NOT support KQL operators (
```
folder:
```
,
```
file:
```
,
```
filetype:
```
,
```
path:
```
); these are treated as literal text
Wildcard characters (
```
*
```
,
```
?
```
) are NOT supported and are auto-removed; use file extension keywords instead (e.g.,
```
"pdf"
```
not
```
"*.pdf"
```
)

ONE_DRIVE_ONEDRIVE_LIST_ITEMS

returns only root-level contents; use recursive

ONE_DRIVE_GET_ITEM

with

expand_relations: ["children"]

for deeper levels

Large folders paginate; always follow
```
skip_token
```
/
```
@odata.nextLink
```
until exhausted
Some drive ID formats may return "ObjectHandle is Invalid" errors due to Microsoft Graph API limitations

适用场景：用户需在OneDrive中查找文件或浏览文件夹内容

工具执行序列:

```
ONE_DRIVE_GET_DRIVE
```
- 验证驱动器访问权限并获取驱动器详情 [前提步骤]
```
ONE_DRIVE_SEARCH_ITEMS
```
- 按关键词搜索文件名、元数据及文件内容 [必填步骤]
```
ONE_DRIVE_ONEDRIVE_LIST_ITEMS
```
- 列出驱动器根目录下的所有项目 [可选步骤]
```
ONE_DRIVE_GET_ITEM
```
- 获取特定项目的详细元数据，可展开子项 [可选步骤]
```
ONE_DRIVE_ONEDRIVE_FIND_FILE
```
- 在指定文件夹中按精确名称查找特定文件 [可选步骤]
```
ONE_DRIVE_ONEDRIVE_FIND_FOLDER
```
- 按名称查找特定文件夹 [可选步骤]
```
ONE_DRIVE_LIST_DRIVES
```
- 列出所有可访问的驱动器 [可选步骤]

关键参数:

```
q
```
: 搜索查询词（仅支持纯关键词，不支持KQL语法）
```
search_scope
```
:
```
"root"
```
（文件夹层级）或
```
"drive"
```
（包含共享项目）
```
top
```
: 每页最大返回项目数（默认200）
```
skip_token
```
: 来自
```
@odata.nextLink
```
的分页令牌
```
select
```
: 逗号分隔的需返回字段（例如：
```
"id,name,webUrl,size"
```
）
```
orderby
```
: 排序规则（例如：
```
"name asc"
```
,
```
"name desc"
```
）
```
item_id
```
:
```
GET_ITEM
```
所需的项目ID

expand_relations

: 数组格式，如

["children"]

或

["thumbnails"]

，用于

GET_ITEM

展开关联内容

```
user_id
```
:
```
"me"
```
（默认值）或特定用户ID/邮箱

常见陷阱:

```
ONE_DRIVE_SEARCH_ITEMS
```
不支持KQL操作符（
```
folder:
```
,
```
file:
```
,
```
filetype:
```
,
```
path:
```
）；这些会被视为普通文本
不支持通配符（
```
*
```
,
```
?
```
），会被自动移除；请使用文件扩展名关键词替代（例如：用
```
"pdf"
```
而非
```
"*.pdf"
```
）

ONE_DRIVE_ONEDRIVE_LIST_ITEMS

仅返回根目录内容；如需深层目录，需递归调用

ONE_DRIVE_GET_ITEM

并设置

expand_relations: ["children"]

大型文件夹会分页；请始终跟随
```
skip_token
```
/
```
@odata.nextLink
```
直到所有页面加载完成
部分驱动器ID格式可能因Microsoft Graph API限制返回"ObjectHandle is Invalid"错误

2. Upload and Download Files

2. 文件上传与下载

When to use: User wants to upload files to OneDrive or download files from it

Tool sequence:

```
ONE_DRIVE_ONEDRIVE_FIND_FOLDER
```
- Locate the target folder [Prerequisite]
```
ONE_DRIVE_ONEDRIVE_UPLOAD_FILE
```
- Upload a file to a specified folder [Required for upload]
```
ONE_DRIVE_DOWNLOAD_FILE
```
- Download a file by item ID [Required for download]
```
ONE_DRIVE_GET_ITEM
```
- Get file details before download [Optional]

Key parameters:

```
file
```
: FileUploadable object with
```
s3key
```
,
```
mimetype
```
, and
```
name
```
for uploads
```
folder
```
: Destination path (e.g.,
```
"/Documents/Reports"
```
) or folder ID for uploads
```
item_id
```
: File's unique identifier for downloads
```
file_name
```
: Desired filename with extension for downloads
```
drive_id
```
: Specific drive ID (for SharePoint or OneDrive for Business)
```
user_id
```
:
```
"me"
```
(default) or specific user identifier

Pitfalls:

Upload automatically renames on conflict (no overwrite option by default)
Large files are automatically handled via chunking
```
drive_id
```
overrides
```
user_id
```
when both are provided
Item IDs vary by platform: OneDrive for Business uses
```
01...
```
prefix, OneDrive Personal uses
```
HASH!NUMBER
```
format
Item IDs are case-sensitive; use exactly as returned from API

适用场景：用户需向OneDrive上传文件或从OneDrive下载文件

工具执行序列:

```
ONE_DRIVE_ONEDRIVE_FIND_FOLDER
```
- 定位目标文件夹 [前提步骤]
```
ONE_DRIVE_ONEDRIVE_UPLOAD_FILE
```
- 将文件上传至指定文件夹 [上传必填步骤]
```
ONE_DRIVE_DOWNLOAD_FILE
```
- 按项目ID下载文件 [下载必填步骤]
```
ONE_DRIVE_GET_ITEM
```
- 下载前获取文件详情 [可选步骤]

关键参数:

```
file
```
: 用于上传的FileUploadable对象，包含
```
s3key
```
、
```
mimetype
```
和
```
name
```
```
folder
```
: 上传目标路径（例如：
```
"/Documents/Reports"
```
）或文件夹ID
```
item_id
```
: 下载所需的文件唯一标识符
```
file_name
```
: 下载文件的期望文件名（含扩展名）
```
drive_id
```
: 特定驱动器ID（适用于SharePoint或OneDrive for Business）
```
user_id
```
:
```
"me"
```
（默认值）或特定用户标识符

常见陷阱:

上传时若文件名冲突会自动重命名（默认无覆盖选项）
大文件会自动通过分块上传处理
若同时提供
```
drive_id
```
和
```
user_id
```
，
```
drive_id
```
优先级更高
项目ID因平台而异：OneDrive for Business使用
```
01...
```
前缀，OneDrive个人版使用
```
HASH!NUMBER
```
格式
项目ID区分大小写；请严格使用API返回的ID

3. Share Files and Manage Permissions

3. 文件共享与权限管理

When to use: User wants to share files/folders or manage who has access

Tool sequence:

ONE_DRIVE_ONEDRIVE_FIND_FILE

ONE_DRIVE_ONEDRIVE_FIND_FOLDER

- Locate the item [Prerequisite]

```
ONE_DRIVE_GET_ITEM_PERMISSIONS
```
- Check current permissions [Prerequisite]
```
ONE_DRIVE_INVITE_USER_TO_DRIVE_ITEM
```
- Grant access to specific users [Required]
```
ONE_DRIVE_CREATE_LINK
```
- Create a shareable link [Optional]
```
ONE_DRIVE_UPDATE_DRIVE_ITEM_METADATA
```
- Update item metadata [Optional]

Key parameters:

```
item_id
```
: The file or folder to share
```
recipients
```
: Array of objects with
```
email
```
or
```
object_id
```
```
roles
```
: Array with
```
"read"
```
or
```
"write"
```
```
send_invitation
```
:
```
true
```
to send notification email,
```
false
```
for silent permission grant
```
require_sign_in
```
:
```
true
```
to require authentication to access
```
message
```
: Custom message for invitation (max 2000 characters)
```
expiration_date_time
```
: ISO 8601 date for permission expiry
```
retain_inherited_permissions
```
:
```
true
```
(default) to keep existing inherited permissions

Pitfalls:

Using wrong
```
item_id
```
with
```
INVITE_USER_TO_DRIVE_ITEM
```
changes permissions on unintended items; always verify first
Write or higher roles are impactful; get explicit user confirmation before granting
```
GET_ITEM_PERMISSIONS
```
returns inherited and owner entries; do not assume response only reflects recent changes
```
permissions
```
cannot be expanded via
```
ONE_DRIVE_GET_ITEM
```
; use the separate permissions endpoint
At least one of
```
require_sign_in
```
or
```
send_invitation
```
must be
```
true
```

适用场景：用户需共享文件/文件夹或管理访问权限

工具执行序列:

ONE_DRIVE_ONEDRIVE_FIND_FILE

或

ONE_DRIVE_ONEDRIVE_FIND_FOLDER

- 定位目标项目 [前提步骤]

```
ONE_DRIVE_GET_ITEM_PERMISSIONS
```
- 查看当前权限设置 [前提步骤]
```
ONE_DRIVE_INVITE_USER_TO_DRIVE_ITEM
```
- 为特定用户授予访问权限 [必填步骤]
```
ONE_DRIVE_CREATE_LINK
```
- 创建可共享链接 [可选步骤]
```
ONE_DRIVE_UPDATE_DRIVE_ITEM_METADATA
```
- 更新项目元数据 [可选步骤]

关键参数:

```
item_id
```
: 需共享的文件或文件夹ID
```
recipients
```
: 对象数组，包含
```
email
```
或
```
object_id
```
```
roles
```
: 数组，包含
```
"read"
```
或
```
"write"
```
```
send_invitation
```
:
```
true
```
表示发送通知邮件，
```
false
```
表示静默授予权限
```
require_sign_in
```
:
```
true
```
表示需要身份验证才能访问
```
message
```
: 邀请邮件的自定义消息（最多2000字符）
```
expiration_date_time
```
: 权限过期时间（ISO 8601格式日期）
```
retain_inherited_permissions
```
:
```
true
```
（默认值）表示保留现有继承权限

常见陷阱:

若使用错误的
```
item_id
```
调用
```
INVITE_USER_TO_DRIVE_ITEM
```
，会意外修改其他项目的权限；请始终先验证项目ID
授予写入或更高权限影响重大；请在授予前获取用户明确确认
```
GET_ITEM_PERMISSIONS
```
会返回继承权限和所有者条目；请勿假设响应仅反映最近的更改
无法通过
```
ONE_DRIVE_GET_ITEM
```
展开
```
permissions
```
；请使用专用的权限端点
```
require_sign_in
```
或
```
send_invitation
```
至少有一个需设置为
```
true
```

4. Manage Folders (Create, Move, Delete, Copy)

4. 文件夹管理（创建、移动、删除、复制）

When to use: User wants to create, move, rename, delete, or copy files and folders

Tool sequence:

```
ONE_DRIVE_ONEDRIVE_FIND_FOLDER
```
- Locate source and destination folders [Prerequisite]
```
ONE_DRIVE_ONEDRIVE_CREATE_FOLDER
```
- Create a new folder [Required for create]
```
ONE_DRIVE_MOVE_ITEM
```
- Move a file or folder to a new location [Required for move]
```
ONE_DRIVE_COPY_ITEM
```
- Copy a file or folder (async operation) [Required for copy]
```
ONE_DRIVE_DELETE_ITEM
```
- Move item to recycle bin [Required for delete]
```
ONE_DRIVE_UPDATE_DRIVE_ITEM_METADATA
```
- Rename or update item properties [Optional]

Key parameters:

```
name
```
: Folder name for creation or new name for rename/copy
```
parent_folder
```
: Path (e.g.,
```
"/Documents/Reports"
```
) or folder ID for creation
```
itemId
```
: Item to move
```
parentReference
```
: Object with
```
id
```
(destination folder ID) for moves:
```
{"id": "folder_id"}
```
```
item_id
```
: Item to copy or delete
```
parent_reference
```
: Object with
```
id
```
and optional
```
driveId
```
for copy destination

@microsoft.graph.conflictBehavior

"fail"

"replace"

, or

"rename"

for copies

```
if_match
```
: ETag for optimistic concurrency on deletes

Pitfalls:

```
ONE_DRIVE_MOVE_ITEM
```
does NOT support cross-drive moves; use
```
ONE_DRIVE_COPY_ITEM
```
for cross-drive transfers
```
parentReference
```
for moves requires folder ID (not folder name); resolve with
```
ONEDRIVE_FIND_FOLDER
```
first
```
ONE_DRIVE_COPY_ITEM
```
is asynchronous; response provides a URL to monitor progress
```
ONE_DRIVE_DELETE_ITEM
```
moves to recycle bin, not permanent deletion
Folder creation auto-renames on conflict (e.g., "New Folder" becomes "New Folder 1")
Provide either
```
name
```
or
```
parent_reference
```
(or both) for
```
ONE_DRIVE_COPY_ITEM
```

适用场景：用户需创建、移动、重命名、删除或复制文件与文件夹

工具执行序列:

```
ONE_DRIVE_ONEDRIVE_FIND_FOLDER
```
- 定位源文件夹和目标文件夹 [前提步骤]
```
ONE_DRIVE_ONEDRIVE_CREATE_FOLDER
```
- 创建新文件夹 [创建必填步骤]
```
ONE_DRIVE_MOVE_ITEM
```
- 将文件或文件夹移动至新位置 [移动必填步骤]
```
ONE_DRIVE_COPY_ITEM
```
- 复制文件或文件夹（异步操作） [复制必填步骤]
```
ONE_DRIVE_DELETE_ITEM
```
- 将项目移至回收站 [删除必填步骤]
```
ONE_DRIVE_UPDATE_DRIVE_ITEM_METADATA
```
- 重命名或更新项目属性 [可选步骤]

关键参数:

```
name
```
: 新建文件夹名称，或重命名/复制后的新名称
```
parent_folder
```
: 创建文件夹的父路径（例如：
```
"/Documents/Reports"
```
）或父文件夹ID
```
itemId
```
: 需移动的项目ID
```
parentReference
```
: 包含
```
id
```
（目标文件夹ID）的对象，用于移动操作：
```
{"id": "folder_id"}
```
```
item_id
```
: 需复制或删除的项目ID
```
parent_reference
```
: 包含
```
id
```
和可选
```
driveId
```
的对象，用于复制目标位置

@microsoft.graph.conflictBehavior

: 复制时的冲突处理方式，可选

"fail"

"replace"

或

"rename"

```
if_match
```
: 删除操作中用于乐观并发的ETag

常见陷阱:

```
ONE_DRIVE_MOVE_ITEM
```
不支持跨驱动器移动；跨驱动器传输请使用
```
ONE_DRIVE_COPY_ITEM
```
移动操作的
```
parentReference
```
需使用文件夹ID（而非文件夹名称）；请先通过
```
ONEDRIVE_FIND_FOLDER
```
解析ID
```
ONE_DRIVE_COPY_ITEM
```
为异步操作；响应会提供用于监控进度的URL
```
ONE_DRIVE_DELETE_ITEM
```
仅将项目移至回收站，并非永久删除
文件夹创建时若名称冲突会自动重命名（例如："New Folder"变为"New Folder 1"）
调用
```
ONE_DRIVE_COPY_ITEM
```
时需提供
```
name
```
或
```
parent_reference
```
（或两者都提供）

5. Track Changes and Drive Information

5. 变更追踪与驱动器信息

When to use: User wants to monitor changes or get drive/quota information

Tool sequence:

```
ONE_DRIVE_GET_DRIVE
```
- Get drive properties and metadata [Required]
```
ONE_DRIVE_GET_QUOTA
```
- Check storage quota (total, used, remaining) [Optional]
```
ONE_DRIVE_LIST_SITE_DRIVE_ITEMS_DELTA
```
- Track changes in SharePoint site drives [Optional]
```
ONE_DRIVE_GET_ITEM_VERSIONS
```
- Get version history of a file [Optional]

Key parameters:

```
drive_id
```
: Drive identifier (or
```
"me"
```
for personal drive)
```
site_id
```
: SharePoint site identifier for delta tracking
```
token
```
: Delta token (
```
"latest"
```
for current state, URL for next page, or timestamp)
```
item_id
```
: File ID for version history

Pitfalls:

Delta queries are only available for SharePoint site drives via
```
ONE_DRIVE_LIST_SITE_DRIVE_ITEMS_DELTA
```
Token
```
"latest"
```
returns current delta token without items (useful as starting point)
Deep or large drives can take several minutes to crawl; use batching and resume logic

适用场景：用户需监控驱动器变更或获取驱动器/配额信息

工具执行序列:

```
ONE_DRIVE_GET_DRIVE
```
- 获取驱动器属性与元数据 [必填步骤]
```
ONE_DRIVE_GET_QUOTA
```
- 查看存储配额（总容量、已用容量、剩余容量） [可选步骤]
```
ONE_DRIVE_LIST_SITE_DRIVE_ITEMS_DELTA
```
- 追踪SharePoint站点驱动器的变更 [可选步骤]
```
ONE_DRIVE_GET_ITEM_VERSIONS
```
- 获取文件的版本历史 [可选步骤]

关键参数:

```
drive_id
```
: 驱动器标识符（或
```
"me"
```
表示个人驱动器）
```
site_id
```
: 用于变更追踪的SharePoint站点标识符
```
token
```
: 增量令牌（
```
"latest"
```
表示当前状态，URL表示下一页，或时间戳）
```
item_id
```
: 用于获取版本历史的文件ID

常见陷阱:

仅SharePoint站点驱动器可通过
```
ONE_DRIVE_LIST_SITE_DRIVE_ITEMS_DELTA
```
进行增量查询
令牌
```
"latest"
```
仅返回当前增量令牌，不包含项目（适合作为追踪起点）
深层或大型驱动器的爬取可能需要数分钟；请使用批量处理和恢复逻辑

Common Patterns

通用模式

ID Resolution

ID解析

User: Use
```
"me"
```
for authenticated user or specific user email/GUID

Item ID from find: Use

ONE_DRIVE_ONEDRIVE_FIND_FILE

ONE_DRIVE_ONEDRIVE_FIND_FOLDER

to get item IDs

Item ID from search: Extract from
```
ONE_DRIVE_SEARCH_ITEMS
```
results

Drive ID: Use

ONE_DRIVE_LIST_DRIVES

ONE_DRIVE_GET_DRIVE

to discover drives

Folder path to ID: Use
```
ONE_DRIVE_ONEDRIVE_FIND_FOLDER
```
with path, then extract ID from response

ID formats vary by platform:

OneDrive for Business/SharePoint:
```
01NKDM7HMOJTVYMDOSXFDK2QJDXCDI3WUK
```
OneDrive Personal:
```
D4648F06C91D9D3D!54927
```

用户: 对已认证用户使用
```
"me"
```
，或使用特定用户邮箱/GUID

通过查找获取项目ID: 使用

ONE_DRIVE_ONEDRIVE_FIND_FILE

或

ONE_DRIVE_ONEDRIVE_FIND_FOLDER

获取项目ID

通过搜索获取项目ID: 从
```
ONE_DRIVE_SEARCH_ITEMS
```
结果中提取

驱动器ID: 使用

ONE_DRIVE_LIST_DRIVES

或

ONE_DRIVE_GET_DRIVE

发现驱动器

文件夹路径转ID: 使用
```
ONE_DRIVE_ONEDRIVE_FIND_FOLDER
```
传入路径，然后从响应中提取ID

ID格式因平台而异:

OneDrive for Business/SharePoint:
```
01NKDM7HMOJTVYMDOSXFDK2QJDXCDI3WUK
```
OneDrive个人版:
```
D4648F06C91D9D3D!54927
```

Pagination

分页

OneDrive uses token-based pagination:

Follow
```
@odata.nextLink
```
or
```
skip_token
```
until no more pages
Set
```
top
```
for page size (varies by endpoint)
```
ONE_DRIVE_ONEDRIVE_LIST_ITEMS
```
auto-handles pagination internally
Aggressive parallel requests can trigger HTTP 429; honor
```
Retry-After
```
headers

OneDrive使用基于令牌的分页:

跟随
```
@odata.nextLink
```
或
```
skip_token
```
直到所有页面加载完成
设置
```
top
```
指定页面大小（不同端点默认值不同）
```
ONE_DRIVE_ONEDRIVE_LIST_ITEMS
```
内部会自动处理分页
频繁并行请求可能触发HTTP 429错误；请遵守
```
Retry-After
```
响应头

Path vs ID

路径与ID

Most OneDrive tools accept either paths or IDs:

Paths: Start with
```
/
```
(e.g.,
```
"/Documents/Reports"
```
)
IDs: Use unique item identifiers from API responses
Item paths for permissions: Use
```
:/path/to/item:/
```
format

大多数OneDrive工具支持路径或ID:

路径: 以
```
/
```
开头（例如：
```
"/Documents/Reports"
```
）
IDs: 使用API返回的唯一项目标识符
权限操作中的项目路径: 使用
```
:/path/to/item:/
```
格式

Known Pitfalls

已知陷阱

ID Formats

ID格式

Item IDs are case-sensitive and platform-specific
Never use web URLs, sharing links, or manually constructed identifiers as item IDs
Always use IDs exactly as returned from Microsoft Graph API

项目ID区分大小写且因平台而异
请勿将网页URL、共享链接或手动构造的标识符用作项目ID
请严格使用Microsoft Graph API返回的ID

Rate Limits

速率限制

Aggressive parallel
```
ONE_DRIVE_GET_ITEM
```
calls can trigger HTTP 429 Too Many Requests
Honor
```
Retry-After
```
headers and implement throttling
Deep drive crawls should use batching with delays

频繁并行调用
```
ONE_DRIVE_GET_ITEM
```
可能触发HTTP 429请求过多错误
请遵守
```
Retry-After
```
响应头并实现限流逻辑
深层驱动器爬取应使用批量处理并添加延迟

Search Limitations

搜索限制

No KQL support; use plain keywords only
No wildcard characters; use extension keywords (e.g.,
```
"pdf"
```
not
```
"*.pdf"
```
)
No path-based filtering in search; use folder listing instead
```
q='*'
```
wildcard-only queries return HTTP 400 invalidRequest

不支持KQL；仅使用纯关键词
不支持通配符；请使用扩展名关键词（例如：用
```
"pdf"
```
而非
```
"*.pdf"
```
）
搜索中不支持基于路径的过滤；请使用文件夹列表替代
```
q='*'
```
这类仅含通配符的查询会返回HTTP 400无效请求错误

Parameter Quirks

参数特殊性

```
drive_id
```
overrides
```
user_id
```
when both are provided
```
permissions
```
cannot be expanded via
```
GET_ITEM
```
; use dedicated permissions endpoint
Move operations require folder IDs in
```
parentReference
```
, not folder names
Copy operations are asynchronous; response provides monitoring URL

若同时提供
```
drive_id
```
和
```
user_id
```
，
```
drive_id
```
优先级更高
无法通过
```
GET_ITEM
```
展开
```
permissions
```
；请使用专用权限端点
移动操作的
```
parentReference
```
需使用文件夹ID，而非文件夹名称
复制操作为异步操作；响应会提供监控URL

Quick Reference

快速参考

Task	Tool Slug	Key Params
Search files	`ONE_DRIVE_SEARCH_ITEMS`	`q` , `search_scope` , `top`
List root items	`ONE_DRIVE_ONEDRIVE_LIST_ITEMS`	`user_id` , `select` , `top`
Get item details	`ONE_DRIVE_GET_ITEM`	`item_id` , `expand_relations`
Find file by name	`ONE_DRIVE_ONEDRIVE_FIND_FILE`	`name` , `folder`
Find folder by name	`ONE_DRIVE_ONEDRIVE_FIND_FOLDER`	`name` , `folder`
Upload file	`ONE_DRIVE_ONEDRIVE_UPLOAD_FILE`	`file` , `folder`
Download file	`ONE_DRIVE_DOWNLOAD_FILE`	`item_id` , `file_name`
Create folder	`ONE_DRIVE_ONEDRIVE_CREATE_FOLDER`	`name` , `parent_folder`
Move item	`ONE_DRIVE_MOVE_ITEM`	`itemId` , `parentReference`
Copy item	`ONE_DRIVE_COPY_ITEM`	`item_id` , `parent_reference` , `name`
Delete item	`ONE_DRIVE_DELETE_ITEM`	`item_id`
Share with users	`ONE_DRIVE_INVITE_USER_TO_DRIVE_ITEM`	`item_id` , `recipients` , `roles`
Create share link	`ONE_DRIVE_CREATE_LINK`	`item_id` , link type
Get permissions	`ONE_DRIVE_GET_ITEM_PERMISSIONS`	`item_id`
Update metadata	`ONE_DRIVE_UPDATE_DRIVE_ITEM_METADATA`	`item_id` , fields
Get drive info	`ONE_DRIVE_GET_DRIVE`	`drive_id`
List drives	`ONE_DRIVE_LIST_DRIVES`	user/group/site scope
Get quota	`ONE_DRIVE_GET_QUOTA`	(none)
Track changes	`ONE_DRIVE_LIST_SITE_DRIVE_ITEMS_DELTA`	`site_id` , `token`
Version history	`ONE_DRIVE_GET_ITEM_VERSIONS`	`item_id`

Powered by Composio

任务	工具标识	关键参数
搜索文件	`ONE_DRIVE_SEARCH_ITEMS`	`q` , `search_scope` , `top`
列出根目录项目	`ONE_DRIVE_ONEDRIVE_LIST_ITEMS`	`user_id` , `select` , `top`
获取项目详情	`ONE_DRIVE_GET_ITEM`	`item_id` , `expand_relations`
按名称查找文件	`ONE_DRIVE_ONEDRIVE_FIND_FILE`	`name` , `folder`
按名称查找文件夹	`ONE_DRIVE_ONEDRIVE_FIND_FOLDER`	`name` , `folder`
上传文件	`ONE_DRIVE_ONEDRIVE_UPLOAD_FILE`	`file` , `folder`
下载文件	`ONE_DRIVE_DOWNLOAD_FILE`	`item_id` , `file_name`
创建文件夹	`ONE_DRIVE_ONEDRIVE_CREATE_FOLDER`	`name` , `parent_folder`
移动项目	`ONE_DRIVE_MOVE_ITEM`	`itemId` , `parentReference`
复制项目	`ONE_DRIVE_COPY_ITEM`	`item_id` , `parent_reference` , `name`
删除项目	`ONE_DRIVE_DELETE_ITEM`	`item_id`
与用户共享	`ONE_DRIVE_INVITE_USER_TO_DRIVE_ITEM`	`item_id` , `recipients` , `roles`
创建共享链接	`ONE_DRIVE_CREATE_LINK`	`item_id` , link type
获取权限	`ONE_DRIVE_GET_ITEM_PERMISSIONS`	`item_id`
更新元数据	`ONE_DRIVE_UPDATE_DRIVE_ITEM_METADATA`	`item_id` , fields
获取驱动器信息	`ONE_DRIVE_GET_DRIVE`	`drive_id`
列出驱动器	`ONE_DRIVE_LIST_DRIVES`	user/group/site scope
获取配额	`ONE_DRIVE_GET_QUOTA`	(无)
追踪变更	`ONE_DRIVE_LIST_SITE_DRIVE_ITEMS_DELTA`	`site_id` , `token`
版本历史	`ONE_DRIVE_GET_ITEM_VERSIONS`	`item_id`

由 Composio 提供支持