Skip to main content

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.

​
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 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. 
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. 
await plazbot.agent.deleteFile({
  fileId: file.fileId,
  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.