> ## Documentation Index > Fetch the complete documentation index at: https://docs.tryprofound.com/llms.txt > Use this file to discover all available pages before exploring further. # Uso de Excel en Agents > Lee y escribe libros de Excel con los nodos de Microsoft Excel para Agents Después de [conectar Microsoft SharePoint](/es/integrations/microsoft-365/connect-microsoft-sharepoint-to-profound), los siguientes nodos estarán disponibles en Profound Agents en **Microsoft Suite** > **Microsoft Excel**. Úsalos para leer valores y filas de un libro, volver a escribir celdas y filas, y crear nuevos libros u hojas de cálculo. Cada nodo se ejecuta con los permisos de la cuenta que selecciones en **Microsoft Account**. Un nodo solo puede acceder a los archivos que la cuenta conectada puede abrir. ¿Eres nuevo en Agents? Consulta [Getting started with Agents](https://help.tryprofound.com/articles/2212787792-create-an-agent) en el Centro de ayuda de Profound. ## Configuración compartida Cada nodo que trabaja sobre un libro existente recibe un **Workbook** y un **Worksheet name** opcional. Deja la hoja de cálculo vacía para usar la primera hoja visible. [**Create Workbook**](#create-workbook) crea un archivo nuevo, por lo que no tiene campo **Workbook**. ### Elegir un libro En la configuración del nodo, selecciona tu **Microsoft Account** y luego selecciona un libro de una de las siguientes maneras: * **Busca por nombre** en el campo **Workbook**. La búsqueda solo alcanza los archivos que Microsoft ha indexado, por lo que es posible que un archivo creado hace un momento todavía no aparezca. * **Pega el enlace de SharePoint o OneDrive** del libro en el mismo campo. * **Explora** seleccionando **Browse workbooks in OneDrive or SharePoint** en la parte inferior de la lista. Esto abre el selector de archivos de Microsoft, que también encuentra archivos que la búsqueda todavía no puede mostrar. * **Usa una variable** de la salida de un nodo anterior, por ejemplo el `workbook_ref` que devuelve [**Create Workbook**](#create-workbook). Los nodos funcionan con archivos `.xlsx` y `.xlsm`. ### Value property Varios nodos aceptan un **Value property** en **Advanced settings**. Controla cómo se manejan los valores de las celdas: * **Values**: interpreta el valor tal como se escribe, o tal como lo devuelven los nodos de lectura, de modo que `10` se convierte en el número 10 y `=A1+1` se convierte en una fórmula. * **Formulas**: trata cada valor de ese campo como una fórmula. * **Text**: devuelve la celda tal como se muestra. Disponible solo en los nodos de lectura, como [Get Values](#get-values). Una sola escritura puede incluir hasta 100,000 celdas, y una celda puede contener hasta 32,767 caracteres. Los números de más de 15 dígitos se escriben como texto, para que Excel no los redondee. ## Nodos disponibles ### Get Values Lee los valores de un rango de celdas. #### Entradas obligatorias * **Microsoft Account**: selecciona una cuenta conectada en el menú desplegable * **Workbook**: busca un libro por nombre, pega su enlace de SharePoint o OneDrive, o explóralo #### Entradas opcionales | Entrada | Valor predeterminado | Descripción | | - | - | - | | **Worksheet name** | Primera hoja visible | La hoja de cálculo de la que se leen los valores. | | **Range** | Rango usado (el rango de celdas que tienen valores) | Un rango de celdas en notación A1, como `A1:D10`. Déjalo vacío para leer todos los valores de la hoja. | | **Value property** (en **Advanced settings**) | **Values** | Qué propiedad de la celda se devuelve. Obtén más información en [Value property](#value-property) | | **Output format** (en **Advanced settings**) | **Rows (2D array)** | La forma de la salida: **Rows (2D array)**, **Records (list of dicts)**, **Columns (dict of lists)**, **CSV (string)**, **TSV (tab-separated)**, **HTML table**, **Markdown table** o **Raw (full API response)**. **Records** y **Columns** usan la primera fila del rango como nombres de columna. | #### Salida Un objeto JSON con los valores en el formato seleccionado, el formato de salida, el ID de referencia del libro, el nombre de la hoja de cálculo y el rango de celdas que se leyó. Para volver a escribir los valores con [**Create Workbook**](#create-workbook), selecciona en este nodo el mismo formato de salida que el formato de entrada de ese nodo. ### Get Row Lee una fila de una hoja de cálculo. #### Entradas obligatorias * **Microsoft Account**: selecciona una cuenta conectada en el menú desplegable * **Workbook**: busca un libro por nombre, pega su enlace de SharePoint o OneDrive, o explóralo * **Row selection**: **Specific row** (predeterminado), **First row** o **Last row** * **Row number**: obligatorio cuando **Row selection** está establecido en **Specific row**. Las filas se numeran desde `1` hasta `1,048,576` #### Entradas opcionales * **Worksheet name**: la hoja de cálculo de la que se lee la fila. De forma predeterminada, es la primera hoja visible * **Range**: limita las columnas de las que se lee la fila. Por ejemplo, `A1:D10` devuelve solo las columnas A a D. Déjalo vacío para leer todas las columnas que tienen datos #### Salida Un objeto JSON con la fila como un array de valores, el número de fila y un campo `record` que empareja cada valor de la fila con el nombre de columna de la primera fila. Cuando la fila leída es la primera fila, el campo `record` está vacío. ### Update Cell Escribe un valor en una sola celda. #### Entradas obligatorias * **Microsoft Account**: selecciona una cuenta conectada en el menú desplegable * **Workbook**: busca un libro por nombre, pega su enlace de SharePoint o OneDrive, o explóralo * **Cell**: la celda en la que se escribe, como `B2` * **Value**: el valor que se escribe: texto, un número, un booleano o una fórmula como `=SUM(A1:B1)`. Para escribir una fórmula, selecciona **Formulas** en **Value property** #### Entradas opcionales * **Worksheet name**: la hoja de cálculo en la que se escribe. De forma predeterminada, es la primera hoja visible * **Value property** (en **Advanced settings**): **Values** (predeterminado) o **Formulas**. Obtén más información en [Value property](#value-property) #### Salida Un objeto JSON con el ID de referencia y la URL del libro, el nombre de la hoja de cálculo, el rango de celdas que se actualizó y el número de celdas actualizadas. ### Write Rows Agrega o actualiza filas en una hoja de cálculo. #### Entradas obligatorias | Entrada | Descripción | Notas | | - | - | - | | **Microsoft Account** | Selecciona una cuenta conectada en el menú desplegable | - | | **Workbook** | Busca un libro por nombre, pega su enlace de SharePoint o OneDrive, o explóralo | - | | **Mode** | **Add rows** (predeterminado) agrega las filas después de la última fila no vacía. **Update rows** sobrescribe filas existentes | - | | **Row data format** | **Arrays** (predeterminado) o **JSON Objects** | Obtén más información en [Formato de Row data](#formato-de-row-data) | | **Row data** | Las filas que se escriben | Consulta [Formato de Row data](#formato-de-row-data) | #### Formato de **Row data** | Row data format | Mode | Forma | Ejemplo | | - | - | - | - | | **Arrays** | **Add rows** | Cada array interno es una fila de la hoja. Sus valores se escriben en las columnas en orden | `[["Alice", "alice@example.com", 90], ["Bob", "bob@example.com", 85]]` | | | **Update rows** | El primer valor de cada array interno es el número de la fila que se actualiza | `[[1, "Alice", "alice@example.com", 95], [3, "Charlie", "charlie@example.com", 88]]` | | **JSON Objects** | **Add rows** | Las claves de cada objeto son letras de columna | `[{"A": "Alice", "B": "alice@example.com", "C": 90}]` | | | **Update rows** | Cada objeto también incluye una clave `row_number` con el número de la fila que se actualiza | `[{"row_number": 1, "A": "Alice", "B": "alice@example.com"}]` | #### Entradas opcionales * **Worksheet name**: la hoja de cálculo en la que se escribe. De forma predeterminada, es la primera hoja visible * **Value property** (en **Advanced settings**): **Values** (predeterminado) o **Formulas**. Obtén más información en [Value property](#value-property) * **Start column** (en **Advanced settings**): la columna en la que se empieza a escribir, por ejemplo `A` o `E`. Déjalo vacío para empezar desde la primera columna (`A`) #### Salida Un objeto JSON con el ID de referencia y la URL del libro, el nombre de la hoja de cálculo, el rango de celdas que se actualizó y el número de filas creadas y actualizadas. En el modo **Update rows**, las filas se escriben de una en una. Si Excel informa un conflicto a mitad del proceso, las filas escritas antes de ese momento permanecen escritas. Vuelve a ejecutar el nodo para reescribir las mismas celdas. ### Create Workbook Crea un libro o agrega una hoja de cálculo a un libro que ya existe. #### Entradas obligatorias | Entrada | Descripción | Notas | | - | - | - | | **Microsoft Account** | Selecciona una cuenta conectada en el menú desplegable | - | | **Title** | El nombre del nuevo libro, o de la nueva hoja de cálculo cuando se establece **Add to Existing Workbook** | Escribe el nombre sin la extensión de archivo. El nodo agrega `.xlsx` automáticamente | | **Rows** | Los datos que se escriben en el nuevo libro o en una hoja de cálculo | Selecciona el formato de los datos en **Input format** | | **Input format** | El formato de los datos que se escriben: **JSON** (predeterminado), **Markdown table**, **CSV**, **TSV (tab-separated)** o **HTML table** | JSON acepta un array de objetos, un array de arrays o un objeto que asigna a cada nombre de columna una lista de valores | #### Entradas opcionales | Entrada | Valor predeterminado | Descripción | | - | - | - | | **Add to Existing Workbook** | Vacío | Déjalo vacío para crear un libro nuevo. Selecciona un libro para agregarle una hoja de cálculo en su lugar. **Destination folder** y **Worksheet name** no se aplican a un libro existente, por lo que desaparecen al seleccionar uno. | | **Destination folder** | Raíz de OneDrive | La carpeta que recibe el nuevo libro. Busca una carpeta por nombre, pega su enlace o explórala. | | **Worksheet name** (en **Advanced settings**) | `Sheet1` | El nombre de la primera hoja de cálculo del nuevo libro. | | **Value property** (en **Advanced settings**) | **Values** | **Values** o **Formulas**. Obtén más información en [Value property](#value-property) | #### Salida Un objeto JSON con el ID de referencia, la URL y el título del libro, y el nombre de la hoja de cálculo en la que se escribieron los datos. Para guardar la salida de [**Get Values**](#get-values) en un libro nuevo, selecciona el mismo formato en **Output format** en ese nodo y en **Input format** en este nodo. ## Solución de problemas Consulta [Solución de problemas de configuración de Microsoft 365 y errores de Agents](/es/integrations/microsoft-365/microsoft-365-integrations-troubleshooting#excel) para conocer los errores que informan los nodos de Excel.