Pimberly Document Loader
Pimberly Document Loader trae de Pimberly los productos actualizados desde una fecha y prepara con cada uno un texto y una ficha de datos. Tú eliges qué atributos forman el texto y cuáles se guardan como datos del producto. También puede leer los documentos PDF enlazados en el producto, como fichas técnicas o manuales.
Úsalo para alimentar una base de conocimiento con tu catálogo, de modo que un asistente pueda responder preguntas sobre tus productos.
Cuándo usarlo
- Crear un asistente de ventas que conoce todo el catálogo y sus características.
- Responder dudas técnicas a partir de las fichas técnicas en PDF de cada producto.
- Actualizar cada semana la base de conocimiento con los productos que han cambiado.
- Preparar los textos de producto para revisarlos o traducirlos.
Configuración
Necesitas una credencial Pimberly API con la clave de acceso de tu cuenta de Pimberly. Consulta Credenciales.
| Campo | Qué hace |
|---|---|
| Credential (obligatorio) | La credencial Pimberly API. |
| Since Date | Trae los productos actualizados desde esta fecha, por ejemplo 2026-01-01. Si lo dejas vacío, trae los actualizados en la última semana. |
| Text fields separated by comma | Los atributos del producto que forman el texto, separados por comas. Si lo dejas vacío, el texto incluye todos los atributos, cada uno con su nombre. |
| Metadata Fields to include | Los atributos que se guardan como datos del producto, separados por comas. Con *, el valor inicial, se guardan todos. |
| Metadata Fields to exclude | Atributos que no quieres guardar como datos, separados por comas. |
| Document Fields to include | Los atributos del producto que contienen enlaces a documentos PDF, separados por comas. Si rellenas este campo, el componente descarga el primer PDF que encuentra en ellos para cada producto y su contenido pasa a ser el texto. |
| Source Field Template | Cómo se forma el origen de cada texto, usando atributos del producto entre llaves, por ejemplo https://www.mitienda.com/producto/{Primary ID}. Si algún atributo no existe, el origen queda como Pimberly. |
| Split by page | Con documentos PDF, crea un texto por cada página en lugar de uno por documento. Desactivado por defecto. |
Opciones avanzadas
| Campo | Qué hace |
|---|---|
| Max Results | El número máximo de productos que trae. Por defecto, 10. |
Resultado
La salida Data devuelve un elemento por producto, o por documento o página si usas Document Fields to include. Cada elemento lleva:
text: el texto del producto o del documento.- Los atributos que elegiste como datos del producto.
source: el origen, si configuraste Source Field Template. Con documentos, es el enlace del PDF, y además se añadedocument_type, el atributo del que salió.
Conecta la salida al componente que guarda los textos en tu base de conocimiento.
Ejemplo
Un fabricante de electrodomésticos quiere un asistente que responda con la información de sus fichas técnicas.
- Añade Pimberly Document Loader y elige la credencial Pimberly API.
- En Document Fields to include, escribe el nombre del atributo donde guardas el enlace a la ficha técnica.
- En Metadata Fields to include, escribe
Primary ID,Titlepara que cada texto sepa de qué producto es. - Activa Split by page si las fichas son largas.
- Conecta Data al componente que guarda los textos en la base de conocimiento que usa el asistente.
Buenas prácticas
- Escribe los nombres de los atributos exactamente como aparecen en Pimberly y sin espacios después de las comas.
- Si programas el flujo para que se ejecute cada semana, deja Since Date vacío: cada ejecución traerá lo que ha cambiado en los últimos siete días. Consulta Programador.
Componentes relacionados
- Pimberly API: para trabajar con los productos tal cual, sin convertirlos en textos.
- Pimberly Product Tool: para que un agente consulte un producto concreto.