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

# Archivos

> Gestiona la base de conocimiento de tu agente con archivos

### Archivos del agente

Gestiona los archivos de la base de conocimiento (RAG) de tu agente. Los archivos se procesan y vectorizan automaticamente para que el agente pueda consultarlos durante las conversaciones.

***

### Listar archivos

```bash theme={null}
plazbot agent files list <agentId>
```

```text theme={null}
Archivos del agente:
──────────────────────────────────────────────────
1. ID: fil_abc123...
   Nombre: contrato-servicio.pdf
   Tags: legal, contratos

2. ID: fil_def456...
   Nombre: catalogo-productos.pdf
   Tags: ventas, productos
──────────────────────────────────────────────────
```

***

### Agregar archivo

Sube un archivo a la base de conocimiento del agente.

```bash theme={null}
plazbot agent files add <agentId> -u <url> [-r <referencia>] [-t <tags>]
```

| Parametro  | Flag              | Requerido | Descripcion                                      |
| ---------- | ----------------- | --------- | ------------------------------------------------ |
| Agent ID   | argumento         | Si        | ID del agente                                    |
| URL        | `-u, --url`       | Si        | URL publica del archivo (PDF, DOC, DOCX)         |
| Referencia | `-r, --reference` | No        | Descripcion del contenido (default: "documento") |
| Tags       | `-t, --tags`      | No        | Tags separados por coma                          |

```bash theme={null}
plazbot agent files add age_TZiOY... -u "https://ejemplo.com/catalogo.pdf" -r "Catalogo de productos 2025" -t "ventas,productos"
```

```text theme={null}
Archivo agregado exitosamente
   ID: fil_ghi789...
   El archivo se esta procesando...
```

***

### Verificar estado

Verifica si un archivo ya fue procesado y esta disponible.

```bash theme={null}
plazbot agent files status <fileId>
```

```text theme={null}
Estado del archivo:
   ID: fil_ghi789...
   Estado: Completed
```

***

### Eliminar archivo

```bash theme={null}
plazbot agent files delete <agentId> <fileId>
```

```text theme={null}
Archivo eliminado exitosamente
```

<Tip>
  Los archivos soportados son: PDF, DOC, DOCX, TXT, CSV y XLSX. El contenido se procesa automaticamente con OCR y se vectoriza para busqueda semantica.
</Tip>