Saltearse al contenido
Nappai Documentation

Pimberly Related Product Tool

El Pimberly Related Product Tool permite a los usuarios buscar y obtener información sobre productos relacionados dentro del catálogo de Pimberly. Solo necesitas indicar el número de referencia del producto y el componente se encargará de consultar la API de Pimberly y devolver los datos solicitados.

¿Cómo funciona?

Cuando activas el componente, se envía una solicitud a la API de Pimberly usando la clave API que has configurado previamente. El componente llama a AsyncPimberlyChannelAPI.get_related_product_detail con el número de referencia del producto y recibe una lista de productos relacionados. Cada producto se empaqueta en un objeto Data para que puedas usarlo en tu flujo de trabajo. Además, el componente crea un BaseTool que puede ser utilizado por un modelo de lenguaje para realizar la misma búsqueda de forma automática.

Entradas

  • Product Reference Nr.
    El número de referencia del producto que quieres consultar.
    Ejemplo: 12345

  • Related Product Attribute in Pimberly
    El nombre del atributo que contiene la relación de productos en Pimberly.
    Valor por defecto: Related products

  • Related Product Attribute Details in Pimberly
    Los campos que quieres que se devuelvan para cada producto relacionado.
    Ejemplo por defecto:

    Primary ID,Title,Serie,Amount,Currency,Compatibility,Series Compatibility

Nota importante:
Este componente necesita una credencial de tipo Pimberly API.

  1. Ve a la sección de credenciales de Nappai y crea una credencial llamada Pimberly API con tu Pimberly API Key.
  2. En el componente, selecciona esa credencial en el campo Credential.

Salidas

  • Data – Una lista de objetos Data que contienen la información de los productos relacionados.
  • Tool – Un objeto BaseTool que puede ser usado por un modelo de lenguaje para ejecutar la misma búsqueda de forma automática.

Ejemplo de Uso

  1. Añade el componente al flujo de trabajo.
  2. Configura las entradas:
    • Product Reference Nr.: 98765
    • Related Product Attribute in Pimberly: Related products
    • Related Product Attribute Details in Pimberly: 
      Primary ID,Title,Serie,Amount,Currency,Compatibility,Series Compatibility
  3. Selecciona la credencial Pimberly API en el campo Credential.
  4. Ejecuta el flujo.
  5. El componente devolverá una lista de productos relacionados que puedes usar en tablas, gráficos o para alimentar a un modelo de IA.

Componentes Relacionados

  • Pimberly Product Search Tool – Busca productos por nombre o categoría.
  • Pimberly Inventory Checker – Verifica la disponibilidad de un producto en el inventario.

Consejos y Mejores Prácticas

  • Revisa la documentación de Pimberly para conocer los atributos disponibles y sus valores.
  • Limita la cantidad de campos devueltos a los que realmente necesitas; esto reduce la latencia y el consumo de datos.
  • Utiliza la salida Tool cuando quieras que un modelo de lenguaje realice la búsqueda de forma automática dentro de un flujo de conversación.
  • Prueba con un número de referencia válido antes de integrar el componente en un flujo de producción.

Consideraciones de Seguridad

  • La clave API se almacena de forma segura en la credencial Pimberly API y no se expone en el flujo de trabajo.
  • Evita compartir la credencial en entornos públicos o con usuarios que no necesiten acceso a la API de Pimberly.
  • Si sospechas que la clave ha sido comprometida, revísala y genera una nueva en la sección de credenciales de Nappai.