---
title: OneDrive
description: 创建、上传、下载、列出和删除文件
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="onedrive"
  color="#E0E0E0"
/>

{/* MANUAL-CONTENT-START:intro */}
[OneDrive](https://onedrive.live.com) 是 Microsoft 的云存储和文件同步服务，允许用户在设备之间安全地存储、访问和共享文件。OneDrive 深度集成于 Microsoft 365 生态系统中，支持无缝协作、版本控制以及团队和组织间的实时内容访问。

了解如何在 Sim 中集成 OneDrive 工具，以自动提取、管理和组织您的云文件到工作流程中。本教程将指导您连接 OneDrive、设置文件访问权限，并使用存储的内容来推动自动化。非常适合与您的代理实时同步重要文档和媒体。

使用 OneDrive，您可以：

- **将文件安全存储在云端**：上传并从任何设备访问文档、图片和其他文件
- **组织您的内容**：轻松创建结构化文件夹并管理文件版本
- **实时协作**：共享文件，与他人同时编辑并跟踪更改
- **跨设备访问**：通过桌面、移动设备和网页平台使用 OneDrive
- **与 Microsoft 365 集成**：与 Word、Excel、PowerPoint 和 Teams 无缝协作
- **控制权限**：通过自定义访问设置和到期控制共享文件和文件夹

在 Sim 中，OneDrive 集成使您的代理可以直接与云存储交互。代理可以将新文件上传到特定文件夹，检索和读取现有文件，并列出文件夹内容以动态组织和访问信息。此集成允许您的代理将文件操作纳入智能工作流程中——自动化文档接收、内容分析和结构化存储管理。通过将 Sim 与 OneDrive 连接，您可以让代理以编程方式管理和使用云文档，消除手动步骤，并通过安全的实时文件访问增强自动化。
{/* MANUAL-CONTENT-END */}

## 使用说明

将 OneDrive 集成到工作流程中。可以创建文本和 Excel 文件，上传文件，下载文件，列出文件，以及删除文件或文件夹。

## 工具

### `onedrive_upload`

上传文件到 OneDrive

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `fileName` | string | 是 | 要上传的文件名称 |
| `file` | file | 否 | 要上传的文件 \(二进制\) |
| `content` | string | 否 | 要上传的文本内容 \(如果未提供文件\) |
| `mimeType` | string | 否 | 要创建文件的 MIME 类型 \(例如，.txt 的 text/plain，.xlsx 的 application/vnd.openxmlformats-officedocument.spreadsheetml.sheet\) |
| `folderSelector` | string | 否 | 选择上传文件的文件夹 |
| `manualFolderId` | string | 否 | 手动输入的文件夹 ID \(高级模式\) |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | boolean | 文件是否成功上传 |
| `file` | object | 上传的文件对象，包含元数据，包括 id、name、webViewLink、webContentLink 和时间戳 |

### `onedrive_create_folder`

在 OneDrive 中创建新文件夹

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `folderName` | string | 是 | 要创建的文件夹名称 |
| `folderSelector` | string | 否 | 选择要创建文件夹的父文件夹 |
| `manualFolderId` | string | 否 | 手动输入的父文件夹 ID（高级模式） |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | boolean | 文件夹是否成功创建 |
| `file` | object | 创建的文件夹对象，包含元数据，包括 id、name、webViewLink 和时间戳 |

### `onedrive_download`

从 OneDrive 下载文件

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `fileId` | string | 是 | 要下载的文件 ID |
| `fileName` | string | 否 | 可选的文件名覆盖 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `file` | file | 下载的文件存储在执行文件中 |

### `onedrive_list`

列出 OneDrive 中的文件和文件夹

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `folderSelector` | string | 否 | 选择要列出文件的文件夹 |
| `manualFolderId` | string | 否 | 手动输入的文件夹 ID \(高级模式\) |
| `query` | string | 否 | 用于筛选文件的查询 |
| `pageSize` | number | 否 | 要返回的文件数量 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | boolean | 文件是否成功列出 |
| `files` | array | 包含元数据的文件和文件夹对象数组 |
| `nextPageToken` | string | 用于检索下一页结果的令牌 \(可选\) |

### `onedrive_delete`

从 OneDrive 删除文件或文件夹

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `fileId` | string | 是 | 要删除的文件或文件夹的 ID |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | boolean | 文件是否成功删除 |
| `deleted` | boolean | 文件已删除的确认信息 |
| `fileId` | string | 已删除文件的 ID |

## 注意事项

- 类别：`tools`
- 类型：`onedrive`
