​
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.
CampoTipoRequeridoDescripción
fileUrlstring✅ SíURL pública del archivo a subir. Solo se permiten los formatos .pdf, .doc, .docx.
referencestring✅ SíDescripción detallada del contenido del archivo. Se utiliza para decidir si el archivo debe ser consultado.
agentIdstring✅ SíID del agente al que se asociará el archivo.
tags arrayNoSon 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

const file = await bot.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);

​
Validar Archivo

Servicio que se consume para poder validar si el archivo ya subio a la base Vectorial, los estados son IN PROCESS y COMPLETE. 
const validated = await bot.validateFile({
  fileId: file.id
});

console.log("✅ File Validated:", validated);

​
Eliminar Archivo

Servicio para eliminar el archivo de la base de Plazbot y base Vectorial. 
const deleted = await bot.deleteFile({
  fileId: file.id,
  agentId: agentId
});

​
Tipos de Archivos Soportados

ExtensiónTipoTamaño MáximoOCR/Extracción
.pdfDocumentos10 MB✅ Sí
.docxWord5 MB✅ Sí
.txtTexto plano2 MB✅ Sí
.csvDatos estructurados10 MB✅ Sí
.xlsxExcel10 MB✅ Sí
Los archivos se procesan automáticamente para extraer su contenido y hacer que esté disponible para el agente durante las conversaciones.