Files

Files trabaja con los archivos de tu OneDrive: lista los de una carpeta, trae un archivo concreto (con su contenido o el texto que contiene), sube archivos nuevos, actualiza o elimina uno existente y crea enlaces para compartirlo.

Úsalo cuando un flujo necesita guardar en OneDrive lo que produce, por ejemplo un informe o un adjunto recibido por correo, o cuando necesita leer documentos que el equipo guarda allí.

Cuándo usarlo

• Quieres guardar en OneDrive los adjuntos que llegan por correo.
• Un agente de IA tiene que leer el texto de un contrato o de una propuesta guardada en OneDrive.
• Quieres listar los PDF de una carpeta para procesarlos uno a uno.
• Necesitas enviar a un cliente un enlace de solo lectura a un documento.

Configuración

Necesitas una credencial Microsoft One Drive, que se conecta iniciando sesión con tu cuenta de Microsoft. Al crearla eliges el acceso: con Read solo puedes leer; para subir, actualizar o eliminar, elige Read, Create, Update and Delete. Consulta Credenciales.

Campo	Qué hace
Credential (obligatorio)	La credencial Microsoft One Drive con la que se accede a tus archivos.
Operation (obligatorio)	Lo que hace el componente. Ver Operaciones. Por defecto, Get Folder Files.
Selection Mode	Cómo indicas la carpeta en Get Folder Files y Upload Files: By Selector (la eliges en una lista), By Path (escribes su ruta, por ejemplo /Documentos/Facturas), By Folder Id (escribes su identificador) o By URL (pegas su enlace). Según lo que elijas aparece Select folder o un campo de texto para la ruta, el identificador o el enlace.
Selection Mode	Cómo indicas el archivo en Get File y Delete File: By Selector, By Path, By File Id o By URL. Según lo que elijas aparece Select file o un campo de texto para la ruta, el identificador o el enlace. En Update File el archivo se elige siempre con Select file.
File Type	Qué archivos se listan: document, image, video, audio, pdf, spreadsheet, presentation, archive, code o all. Por defecto, all. Solo en Get Folder Files.
Download File Content	Si está activado, se incluye el contenido de cada archivo en el resultado. Desactivado por defecto. En Get Folder Files y Get File.
Load File Content	Si está activado, se extrae el texto de cada archivo (por ejemplo, de un PDF o un Word) para que un agente pueda leerlo. En Get Folder Files necesita también Download File Content. Desactivado por defecto. En Get Folder Files y Get File.
File to upload	Los archivos que se suben. Conecta aquí la salida de otro componente que entregue archivos, como un adjunto de correo. Solo en Upload Files.
File Id or URL	Alternativa a File to upload cuando no conectas nada: la dirección web del archivo que quieres subir. Solo en Upload Files.
New Name	El nombre nuevo del archivo. Déjalo vacío para no cambiarlo. Solo en Update File.
New Content	El contenido nuevo del archivo: conecta un archivo o un texto. Déjalo vacío para cambiar solo el nombre. Solo en Update File.
Select Item	El archivo que quieres compartir. Solo en Create Sharing Link.
Link Type	Qué permite el enlace: View (ver), Edit (editar) o Embed (insertar en una web). Por defecto, View. Solo en Create Sharing Link.
Scope	Quién puede usar el enlace: Anonymous (cualquiera que lo tenga) u Organization (solo personas de tu organización). Por defecto, Anonymous. Solo en Create Sharing Link.

Operaciones

Operación	Qué hace
Get Folder Files	Lista los archivos de una carpeta, con su nombre, tamaño, enlace, tipo y fechas. Puede incluir su contenido o su texto.
Get File	Trae los datos de un archivo concreto y, si lo pides, su contenido o su texto.
Upload Files	Sube uno o varios archivos a la carpeta indicada.
Update File	Cambia el nombre o el contenido de un archivo existente.
Delete File	Elimina un archivo.
Create Sharing Link	Crea un enlace para compartir un archivo y devuelve también su enlace de descarga directa.

Resultado

La salida Data devuelve un elemento por cada archivo listado, subido o consultado, con su identificador, nombre, tamaño, enlace, tipo y fechas; con Load File Content incluye además el texto del archivo. Delete File y Update File devuelven una confirmación, y Create Sharing Link devuelve el enlace para compartir, el enlace de descarga directa y su caducidad si la tiene.

Puedes conectar el resultado a un agente para que lea los documentos, a un componente de correo para enviar el enlace o a otro componente que use los archivos. El componente también se puede conectar a un Agente como herramienta, para que el agente decida cuándo buscar o guardar archivos. Ver Tool Mode.

Ejemplo

Un despacho quiere guardar en OneDrive los contratos firmados que sus clientes envían por correo.

1. Un componente de correo entrega los adjuntos de cada mensaje recibido.
2. Añade Files con la operación Upload Files y la credencial Microsoft One Drive del despacho.
3. En Selection Mode elige By Path y escribe /Clientes/Contratos firmados.
4. Conecta los adjuntos a File to upload.
5. Si quieres avisar al responsable, conecta la salida Data a un componente de correo con el enlace de cada archivo subido.

Buenas prácticas

• Activa Load File Content solo cuando el flujo necesite leer el texto: con muchos archivos grandes la ejecución tarda más.
• Usa Organization en Scope para documentos internos; Anonymous crea un enlace que funciona para cualquiera que lo reciba.
• Delete File no pide confirmación. Comprueba antes con Get File que el archivo es el correcto.

Componentes relacionados

• Folders: crear, eliminar y compartir carpetas de OneDrive.
• Search: buscar archivos en OneDrive.
• OneDrive Webhook: iniciar un flujo cuando cambia un archivo.