Archivos | Plazbot Docs

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

01const file = await plazbot.agent.addFile({
02  fileUrl: "https://example.com/docs/contrato.pdf",
03  reference: "Contrato de servicio entre Plazbot y Proveedor.",
04  tags: ['whatsapp', 'pricing', 'conversations'],
05  agentId: agentId
06});
07 
08console.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.

01const validated = await plazbot.agent.validateFile({
02  fileId: file.fileId
03});
04 
05console.log("Estado:", validated.status);

Eliminar Archivo

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

01await plazbot.agent.deleteFile({
02  fileId: file.fileId,
03  agentId: agentId
04});

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í

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