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

# Listar archivos del agente

> Lista los archivos que tus agentes pueden enviarles a los leads, con su handle e instrucciones de envío, y opcionalmente si una tarea puede enviar cada uno.

Son los archivos que tus agentes les envían a los leads, como un folleto, una lista de precios o una foto. En la app aparecen en **Archivos para enviar**, en el panel derecho de cada agente. Consulta [Base de conocimiento, archivos y catálogos de productos](/docs/es/guides/agents/knowledge-base).

En la API, un agente es un `master_workflow` y una tarea es un `workflow`. La disponibilidad se guarda por tarea, así que `workflow_id` es el ID de una tarea.

## Cómo funcionan los archivos del agente

| Concepto | Qué significa |
| - | - |
| Un archivo para toda la cuenta | Todos los agentes leen el mismo archivo. Su nombre (`label`) y sus instrucciones de envío (`agent_instruction`) son compartidos por todos los agentes que lo envían. |
| Instrucciones de envío | `agent_instruction` le dice al agente cuándo enviar el archivo, por ejemplo "Cuando el lead pregunte por precios." |
| `@handle` estable | `handle` no cambia nunca, ni siquiera al renombrar el archivo. Las instrucciones y reglas que mencionan el `@handle` siguen funcionando. |
| Handles de carpetas antiguas | Cuando `legacy_folder_handle` tiene valor, un `@handle` de una carpeta antigua también envía este archivo. Sigue funcionando. |
| Disponible salvo que se quite | Una tarea puede enviar un archivo salvo que se haya quitado de esa tarea. |

## Revisa una tarea

Agrega `workflow_id` para recibir `enabled` de esa tarea: `true` cuando la tarea puede enviar el archivo y `false` cuando se quitó de ella. Sin `workflow_id`, `enabled` es `null`.

## Antes de empezar

* Las claves MCP necesitan `workflows:read` para leer y `workflows:write` para hacer cambios. Las claves de API con acceso completo no necesitan nada más.
* Para que algunas tareas dejen de enviar un archivo sin eliminarlo, usa [Cambiar disponibilidad](/docs/es/api/agent-files/set-agent-file-availability).
* Los errores devuelven `error` y un `message` legible. Tradúcelos a tu propio mensaje.


## API Specification

The full API specification for this endpoint is available in the [documentation index](https://docs.getnexor.ai/llms.txt).