¿Eres nuevo en Agents? Consulta Getting started with Agents en el Centro de ayuda de Profound.
Nodos disponibles
- List Products
- Get Product
- Create Products
- Update Products
- Add Products to List
- Remove Products from List
List Products
Lee una página de productos de una o más Product Lists de Salsify. Siempre se requiere un ámbito de Product List: Profound nunca lee toda la organización de Salsify.Entradas obligatorias
- Salsify Organization — Selecciona una organización conectada en el menú desplegable
- Product Lists — Los ID de las Product Lists de las que leer
Entradas opcionales
Salida
Un objeto JSON con un arraydata de productos y un objeto de metadatos con los detalles de paginación y el número total de productos que coinciden.Crear una cola de trabajo
Los nodos de Salsify están diseñados para ejecutarse en bucle: cada ejecución toma un lote de productos de una lista de origen, mejora el contenido, lo vuelve a escribir en Salsify y mueve los productos terminados a una lista de destino. Esta cola de trabajo permite que un solo Agent mejore todo un catálogo de productos, un lote a la vez. Este es un ejemplo de una cola de trabajo.1
Crea una lista de origen y una lista de destino
En Salsify, crea dos Product Lists, por ejemplo
Profound: to optimize y Profound: optimized. Añade los productos con los que quieres trabajar a la lista to optimize y deja vacía la lista optimized.2
Lee la lista de origen con List Products
Añade un nodo List Products. Introduce el ID de la lista
to optimize en Product Lists y el ID de la lista optimized en Excluded Lists, para que un producto que ya está terminado no se vuelva a leer nunca.3
Mejora el contenido
Pasa los productos a tus nodos de contenido (como un Prompt LLM) para reescribir el texto de marketing de cada registro de producto.
4
Vuelve a escribir el contenido con Update Products
Añade un nodo Update Products. Para cada producto, establece el Product ID y las propiedades que se actualizarán con el nuevo texto.
5
Registra los productos terminados con Add Products to List
Añade un nodo Add Products to List con el ID de la lista
optimized y los ID de producto de esta ejecución. Esta Product List en Salsify es ahora tu informe de progreso.6
Quita los productos de la cola con Remove Products from List
Añade un nodo Remove Products from List con el ID de la lista
to optimize y los mismos ID de producto. Los productos salen de la cola, pero permanecen en Salsify.Solución de problemas
El selector de propiedades está vacío o deshabilitado
El selector de propiedades está vacío o deshabilitado
- Selecciona primero una Salsify Organization. El selector permanece deshabilitado hasta que lo hagas.
- Introduce un Sample product ID. El selector lista las propiedades de ese único producto, así que usa un producto que tenga las propiedades que quieres escribir.
- Si el selector muestra Available when the payload below is a list of products, el payload de Products es texto o una variable. Cambia Data format a Raw JSON para editarlo.
List Products falla con un error de Salsify
List Products falla con un error de Salsify
- Confirma que el ID de la Product List es el segmento de la URL que aparece después de
product_lists/y antes de cualquier parámetro de consulta (?). - Confirma que la lista todavía existe en Salsify.
- Si usas Advanced Filter, comprueba que sea una expresión de filtro de Salsify válida.
List Products no devuelve productos de una lista que sí tiene productos
List Products no devuelve productos de una lista que sí tiene productos
- Confirma el ID de la Product List. Dos listas pueden tener nombres similares.
- Comprueba que una cláusula de Property Equality o un Advanced Filter no excluya todos los productos.
- Si acabas de añadir los productos a la lista, espera y vuelve a ejecutar el nodo. Salsify aplica los cambios de forma asíncrona, y es posible que tu nodo List Products aún no haya recibido el cambio.
Un nodo de escritura informa que las propiedades no existen
Un nodo de escritura informa que las propiedades no existen
Los ID de propiedad distinguen entre mayúsculas y minúsculas. Copia el ID exacto del selector de propiedades o de la salida de un nodo Get Product. Si la propiedad es nueva, créala primero en Salsify.
Create Products informa que un producto debe indicar la propiedad de ID de producto
Create Products informa que un producto debe indicar la propiedad de ID de producto
A un producto del lote le falta la propiedad que contiene el ID de producto de tu organización. Añádela, con un valor único, a cada producto del lote.
Update Products informa que no se encontraron productos
Update Products informa que no se encontraron productos
Salsify no tiene registro de esos ID de producto. Lee los ID con un nodo List Products y confirma que sean correctos.
Se rechaza una lectura por superar el límite de 10,000 resultados
Se rechaza una lectura por superar el límite de 10,000 resultados
Reduce Page o Results per Page, o limita la lectura a una Product List más pequeña. Como alternativa, crea una cola de trabajo, que siempre lee solo la primera página.
Un cambio hecho en Salsify no aparece en la siguiente lectura
Un cambio hecho en Salsify no aparece en la siguiente lectura
Salsify actualiza la pertenencia a las listas de forma asíncrona. Espera y vuelve a ejecutar el nodo.
Un nodo informa que se alcanzó el límite de solicitudes de Salsify
Un nodo informa que se alcanzó el límite de solicitudes de Salsify
El error te indica cuántos segundos faltan para que se restablezca el límite. Espera y vuelve a ejecutar el Agent. Para evitar alcanzar los límites de solicitudes, lee más productos por página y ejecuta menos nodos de Salsify al mismo tiempo.