> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Box

> Almacenamiento seguro de archivos, uso compartido, colaboración y gobernanza a través de tu cuenta conectada.

# Box

Usa Box cuando tu flujo de trabajo necesite gestión segura de archivos y carpetas, uso compartido o revisión. También puedes usarlo para buscar contenido, añadir comentarios y enviar documentos para firma.

## Configuración

| Opción | Requerido | Descripción |
| - | - | - |
| Name | No | Etiqueta para el paso en el lienzo del flujo de trabajo. |
| Authentication | Yes | La cuenta conectada de Box que se usará para este paso. |
| Action | Yes | La acción de Box a realizar (por ejemplo, Get file information, Update file, Download file, Copy file). |
| Arguments | Yes | Campos del formulario por acción generados a partir del esquema de la acción. Cada campo de texto tiene un botón **Insert Variable** para insertar valores `{{placeholder}}`. Hay una pestaña **Raw JSON** disponible para uso avanzado. |
| When the step fails | No | Controla si el flujo de trabajo debe **Terminate Workflow** o **Continue** si este paso falla. |

Antes de configurar este paso, conecta Box en **Integrations** para tu espacio de trabajo usando el flujo de inicio de sesión. Si no hay ninguna conexión activa disponible, el paso muestra una advertencia con un enlace a **Integrations** en lugar del selector de cuenta.

## Formulario de Arguments

Cuando seleccionas una acción, la sección **Arguments** muestra un formulario impulsado por el esquema de entrada de la acción.

Cambia a la pestaña **Raw JSON** cuando prefieras escribir a mano el objeto completo de argumentos. Los cambios en cualquiera de las dos pestañas se mantienen sincronizados.

## Acciones comunes

| Acción | Descripción |
| - | - |
| **Get file information** | Recupera los detalles de un archivo. |
| **Update file** | Actualiza los detalles o propiedades de un archivo. |
| **Download file** | Descarga el contenido de un archivo en formato binario. |
| **Copy file** | Crea una copia de un archivo en otra carpeta. |
| **Get folder information** | Recupera los detalles de una carpeta y sus primeros elementos. |
| **Create folder** | Crea una nueva carpeta vacía. |
| **Update folder** | Actualiza los detalles o la configuración de una carpeta. |
| **List folder items** | Enumera los elementos de una carpeta. |
| **List file comments** | Enumera todos los comentarios de un archivo. |
| **Create comment** | Añade un comentario a un archivo o responde a un comentario. |
| **Get comment** | Recupera el contenido y los metadatos de un comentario. |
| **List file collaborations** | Enumera las colaboraciones activas y pendientes en un archivo. |
| **List folder collaborations** | Enumera las colaboraciones activas y pendientes en una carpeta. |

Las acciones destructivas, como eliminar registros, no están disponibles en el selector de acciones del flujo de trabajo.

## Salida

Este paso almacena la respuesta de Box como la salida del paso. La forma de la respuesta depende de la acción.

Usa la referencia completa de salida en pasos posteriores:

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

## Ejemplo

1. Abre **Integrations** y conecta Box si aún no lo has hecho.
2. Añade un paso **Box** a tu flujo de trabajo.
3. Selecciona una cuenta conectada en **Authentication**.
4. Elige **Get file information** en **Action**.
5. Completa los campos requeridos. Usa **Insert Variable** para hacer referencia a la salida de un paso anterior para cualquier valor de campo.
6. Haz clic en **Run** en el encabezado del paso para probar la acción y luego revisa la carga útil devuelta en **Output**.

## Casos de uso

### Revisar un archivo y comentar

1. Buscar contenido
2. Obtener información del archivo
3. Crear comentario

### Compartir una carpeta con un compañero de equipo

1. Obtener información de la carpeta
2. Crear colaboración
3. Añadir enlace compartido

### Enviar un documento para firma

1. Obtener información del archivo
2. Crear solicitud de Box Sign
3. Obtener solicitud de Box Sign

## Notas

* Este paso depende de una integración de Box conectada en tu espacio de trabajo.
* El selector de acciones del flujo de trabajo muestra un conjunto curado de acciones. Los agentes con la herramienta Box pueden usar más de ellas.
* La pantalla de inicio de sesión puede mostrar la marca de autorización de terceros.

## Usar Box como herramienta del agente

También puedes añadir Box como una herramienta en el **Agent Editor**. Abre el agente, haz clic en **Add tool** y selecciona **Box**. En el panel de configuración de la herramienta, elige la cuenta conectada que el agente debe usar. El agente llama a acciones de Box cuando son relevantes para la conversación.

Ver también: [Integrations](https://docs.fetchhive.com/es/workspace/integrations.md), [Creating and Editing](https://docs.fetchhive.com/es/workflows/creating-and-editing.md) y [Testing and Iteration](https://docs.fetchhive.com/es/workflows/testing-and-iteration.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.