> ## 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

> Agregar archivos al Agente para que pueda responder información de tu empresa

### API de Archivos – Agregar, Validar y Eliminar Archivos

Esta API permite subir archivos (`.pdf`, `.doc`, `.docx`) y conectarlos con un agente de IA para que su contenido pueda ser procesado mediante tecnología de Recuperación Aumentada por Generación (RAG). Los archivos son analizados y divididos en fragmentos vectorizados que pueden ser utilizados durante la conversación con el usuario.

### Agregar Archivo

Sube un archivo y lo vincula con un agente de IA. El contenido del archivo será procesado y almacenado como fragmentos de conocimiento consultables.

| Campo       | Tipo     | Requerido | Descripción                                                                                                                                                                            |
| ----------- | -------- | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `fileUrl`   | `string` | ✅ Sí      | URL pública del archivo a subir. Solo se permiten los formatos `.pdf`, `.doc`, `.docx`.                                                                                                |
| `reference` | `string` | ✅ Sí      | Descripción detallada del contenido del archivo. Se utiliza para decidir si el archivo debe ser consultado.                                                                            |
| `agentId`   | `string` | ✅ Sí      | ID del agente al que se asociará el archivo.                                                                                                                                           |
| `tags   `   | `array`  | No        | Son referencias para poder entender mas la información dentro del archivo, si bien es cierto, con la Referencia existe mas posibilidades, con los tags complementa esta funcionalidad. |

#### Ejemplo

```ts theme={null}
const file = await plazbot.agent.addFile({
  fileUrl: "https://example.com/docs/contrato.pdf",
  reference: "Contrato de servicio entre Plazbot y Proveedor.",
  tags: ['whatsapp', 'pricing', 'conversations'],
  agentId: agentId
});

console.log("Archivo agregado:", file.fileId);
```

### Validar Archivo

Consulta si el archivo ya fue procesado y esta disponible en la base vectorial. Los estados son `IN PROCESS` y `COMPLETE`.

```ts theme={null}
const validated = await plazbot.agent.validateFile({
  fileId: file.fileId
});

console.log("Estado:", validated.status);
```

### Eliminar Archivo

Elimina el archivo de la base de Plazbot y de la base vectorial.

```ts theme={null}
await plazbot.agent.deleteFile({
  fileId: file.fileId,
  agentId: agentId
});
```

### Tipos de Archivos Soportados

| Extensión | Tipo                | Tamaño Máximo | OCR/Extracción |
| --------- | ------------------- | ------------- | -------------- |
| `.pdf`    | Documentos          | 10 MB         | ✅ Sí           |
| `.docx`   | Word                | 5 MB          | ✅ Sí           |
| `.txt`    | Texto plano         | 2 MB          | ✅ Sí           |
| `.csv`    | Datos estructurados | 10 MB         | ✅ Sí           |
| `.xlsx`   | Excel               | 10 MB         | ✅ Sí           |

<Warning>
  Los archivos se procesan automáticamente para extraer su contenido y hacer que esté disponible para el agente durante las conversaciones.
</Warning>