---
title: OneDrive
description: Crear, subir, descargar, listar y eliminar archivos
---

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

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

{/* MANUAL-CONTENT-START:intro */}
[OneDrive](https://onedrive.live.com) es el servicio de almacenamiento en la nube y sincronización de archivos de Microsoft que permite a los usuarios almacenar, acceder y compartir archivos de forma segura en todos sus dispositivos. Integrado profundamente en el ecosistema de Microsoft 365, OneDrive facilita la colaboración fluida, el control de versiones y el acceso en tiempo real al contenido entre equipos y organizaciones.

Aprende a integrar la herramienta OneDrive en Sim para extraer, gestionar y organizar automáticamente tus archivos en la nube dentro de tus flujos de trabajo. Este tutorial te guía a través de la conexión con OneDrive, la configuración del acceso a archivos y el uso del contenido almacenado para impulsar la automatización. Ideal para sincronizar documentos y medios esenciales con tus agentes en tiempo real.

Con OneDrive, puedes:

- **Almacenar archivos de forma segura en la nube**: Subir y acceder a documentos, imágenes y otros archivos desde cualquier dispositivo
- **Organizar tu contenido**: Crear carpetas estructuradas y gestionar versiones de archivos con facilidad
- **Colaborar en tiempo real**: Compartir archivos, editarlos simultáneamente con otros y realizar seguimiento de cambios
- **Acceder desde múltiples dispositivos**: Usar OneDrive desde plataformas de escritorio, móviles y web
- **Integrar con Microsoft 365**: Trabajar sin problemas con Word, Excel, PowerPoint y Teams
- **Controlar permisos**: Compartir archivos y carpetas con configuraciones de acceso personalizadas y controles de caducidad

En Sim, la integración con OneDrive permite a tus agentes interactuar directamente con tu almacenamiento en la nube. Los agentes pueden subir nuevos archivos a carpetas específicas, recuperar y leer archivos existentes, y listar contenidos de carpetas para organizar y acceder a la información de forma dinámica. Esta integración permite a tus agentes incorporar operaciones con archivos en flujos de trabajo inteligentes — automatizando la recepción de documentos, el análisis de contenido y la gestión estructurada del almacenamiento. Al conectar Sim con OneDrive, capacitas a tus agentes para gestionar y utilizar documentos en la nube de forma programática, eliminando pasos manuales y mejorando la automatización con acceso seguro a archivos en tiempo real.
{/* MANUAL-CONTENT-END */}

## Instrucciones de uso

Integra OneDrive en el flujo de trabajo. Puede crear archivos de texto y Excel, subir archivos, descargar archivos, listar archivos y eliminar archivos o carpetas.

## Herramientas

### `onedrive_upload`

Subir un archivo a OneDrive

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `fileName` | string | Sí | El nombre del archivo a subir |
| `file` | file | No | El archivo a subir \(binario\) |
| `content` | string | No | El contenido de texto a subir \(si no se proporciona un archivo\) |
| `mimeType` | string | No | El tipo MIME del archivo a crear \(p. ej., text/plain para .txt, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet para .xlsx\) |
| `folderSelector` | string | No | Seleccionar la carpeta donde subir el archivo |
| `manualFolderId` | string | No | ID de carpeta introducido manualmente \(modo avanzado\) |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Indica si el archivo se subió correctamente |
| `file` | object | El objeto del archivo subido con metadatos que incluyen id, nombre, webViewLink, webContentLink y marcas de tiempo |

### `onedrive_create_folder`

Crear una nueva carpeta en OneDrive

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `folderName` | string | Sí | Nombre de la carpeta a crear |
| `folderSelector` | string | No | Seleccionar la carpeta principal donde crear la carpeta |
| `manualFolderId` | string | No | ID de carpeta principal introducido manualmente \(modo avanzado\) |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Indica si la carpeta se creó correctamente |
| `file` | object | El objeto de la carpeta creada con metadatos que incluyen id, nombre, webViewLink y marcas de tiempo |

### `onedrive_download`

Descargar un archivo de OneDrive

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `fileId` | string | Sí | El ID del archivo a descargar |
| `fileName` | string | No | Anulación opcional del nombre del archivo |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `file` | file | Archivo descargado almacenado en los archivos de ejecución |

### `onedrive_list`

Listar archivos y carpetas en OneDrive

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `folderSelector` | string | No | Seleccionar la carpeta de la que listar archivos |
| `manualFolderId` | string | No | El ID de carpeta introducido manualmente (modo avanzado) |
| `query` | string | No | Una consulta para filtrar los archivos |
| `pageSize` | number | No | El número de archivos a devolver |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Si los archivos se listaron correctamente |
| `files` | array | Array de objetos de archivo y carpeta con metadatos |
| `nextPageToken` | string | Token para recuperar la siguiente página de resultados (opcional) |

### `onedrive_delete`

Eliminar un archivo o carpeta de OneDrive

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `fileId` | string | Sí | El ID del archivo o carpeta a eliminar |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Indica si el archivo se eliminó correctamente |
| `deleted` | boolean | Confirmación de que el archivo fue eliminado |
| `fileId` | string | El ID del archivo eliminado |
