Agente de Precios Competitivos de Jitterbit

Descripción General

Jitterbit proporciona el Agente de Precios Competitivos a los clientes a través de Jitterbit Marketplace. Este agente utiliza IA para analizar los precios de los competidores en los mercados, ayudando a las organizaciones a tomar decisiones de precios basadas en datos y a mantenerse competitivas.

El agente aprovecha los datos de mercado en tiempo real de Google Shopping para comparar los precios de productos entre competidores. Utilizando un análisis impulsado por IA, evalúa las estrategias de precios y recomienda precios óptimos basados en reglas comerciales configurables y objetivos de posicionamiento en el mercado.

El agente se integra con Azure OpenAI para realizar un análisis de precios inteligente. El agente se puede configurar para trabajar con o sin App Builder, dependiendo de sus necesidades. El agente realiza las siguientes tareas:

• (Opcional) Se conecta a SAP ECC para recuperar datos de productos (materiales) en tiempo real utilizando Jitterbit Studio. Los productos también se pueden proporcionar directamente a través de llamadas API.
• (Opcional) Almacena los productos recuperados en Jitterbit App Builder para la gestión y configuración de datos.
• Consulta la API de Google Shopping utilizando el SKU del producto para recuperar información de precios de competidores sobre todos los productos almacenados.
• Procesa productos individuales bajo demanda utilizando una API personalizada de Jitterbit.
• Crea mensajes dinámicos basados en la estrategia comercial configurable (almacenada en App Builder o variables del proyecto) para guiar las recomendaciones de precios.
• Se integra con Azure OpenAI para analizar los precios de los competidores y generar recomendaciones.
• Almacena los resultados del análisis de precios (en App Builder si se utiliza) y envía notificaciones de Slack para productos señalados.

Este documento explica cómo configurar y operar este agente de IA. Cubre la arquitectura y requisitos previos, consultas API de ejemplo que muestran lo que el agente puede hacer, y pasos para instalar, configurar y operar el agente de IA.

Arquitectura del agente de IA

Este agente de IA analiza los precios de los competidores y recomienda precios óptimos basados en datos de mercado y estrategia empresarial. Un flujo de trabajo típico sigue estos pasos:

1. Ejecutas el agente en un horario o manualmente, y el agente recupera productos de SAP ECC o App Builder.
2. Para cada producto, el agente consulta la API de Google Shopping para recopilar datos de precios de competidores, incluyendo precios mínimos, promedio y máximo.
3. El agente construye un aviso dinámico basado en reglas comerciales configurables almacenadas en App Builder (como la intención de posicionamiento en el mercado y la estrategia de anclaje de precios) o en variables del proyecto.
4. Azure OpenAI analiza los datos del mercado utilizando el aviso dinámico y devuelve recomendaciones de precios que incluyen el precio sugerido, el puntaje de confianza y los rangos de precios de los competidores.
5. El agente almacena los resultados del análisis en App Builder, devuelve resultados a través de la API para productos individuales o envía notificaciones de Slack, dependiendo de tu configuración.
6. Los productos con la bandera de notificación habilitada activan alertas de Slack cuando los precios cambian, se generan recomendaciones o cuando ejecutas cualquiera de los flujos de trabajo disponibles.
7. Puedes activar el análisis de productos individuales a través de una llamada API personalizada desde la interfaz de App Builder o ejecutar procesamiento por lotes para todos los productos. Ambos enfoques funcionan con o sin App Builder.

Diagramas de flujo de trabajo

Los siguientes diagramas representan los flujos de trabajo principales para esta integración. Dependiendo de si utilizas App Builder para el almacenamiento de datos y la configuración, los flujos de trabajo difieren en cómo recuperan los datos del producto y devuelven resultados.

Flujos de trabajo al usar App Builder

Al usar App Builder, el agente almacena datos de productos y resultados de análisis en las tablas de App Builder.

Análisis de precios por lotes

Puedes ejecutar el agente en un horario o manualmente para analizar todos los productos. Al usar una conexión ERP, puedes optar por almacenar productos en App Builder inmediatamente después de consultar el sistema ERP, y luego recuperarlos de App Builder para continuar con el flujo de trabajo del Agente de Precios Competitivos de Jitterbit.

Análisis de precios bajo demanda

Los usuarios inician el análisis de productos individuales a través de la interfaz de App Builder:

Flujos de trabajo al no usar App Builder

Al no usar App Builder, el agente recupera productos directamente de los sistemas ERP y devuelve resultados a través de respuestas de API y notificaciones de Slack.

Análisis de precios por lotes desde ERP

Una API activa al agente para recuperar productos de ERP y realizar análisis de precios:

Análisis de precios de un solo producto a través de API

Los usuarios inician el análisis de productos individuales a través de llamadas directas a la API con carga útil JSON:

Requisitos previos

Necesitas los siguientes componentes para usar este agente de IA.

Componentes de Harmony

Debes tener una licencia de Jitterbit Harmony con acceso a los siguientes componentes:

• Jitterbit Studio
• Jitterbit API Manager
• Jitterbit App Builder versión 4.55.1 con una base de datos PostgreSQL (opcional, para gestión de datos y configuración)
• Agente de Precios Competitivos de Jitterbit adquirido como un complemento de licencia

Puntos finales soportados

El agente de IA incorpora los siguientes puntos finales. Puedes adaptar otros sistemas modificando las configuraciones de puntos finales y flujos de trabajo del proyecto.

Modelo de lenguaje grande (LLM)

El agente de IA utiliza Azure OpenAI como proveedor de LLM para el análisis de precios. Para usar Azure OpenAI, debes tener una suscripción a Microsoft Azure con permisos para crear un recurso de Azure OpenAI con un modelo gpt-4o desplegado.

Fuente de datos

El agente de IA puede recuperar datos de productos de SAP ECC u otros sistemas ERP, o puedes proporcionar datos de productos directamente a través de llamadas API. Si eliges usar App Builder, este almacena y muestra la información del producto y los resultados del análisis de precios. Sin App Builder, el agente devuelve resultados directamente a través de respuestas API y notificaciones de Slack.

Datos de Google Shopping

El agente de IA utiliza SerpApi para acceder a los datos de Google Shopping. Debes tener una cuenta de SerpApi para usar la API de Google Shopping. Este servicio es externo a Google y Jitterbit. SerpApi ofrece planes gratuitos y de pago.

Servicio de notificación

El agente de IA utiliza Slack para enviar notificaciones sobre productos con la bandera de notificación habilitada cuando cambia un registro de producto. Puedes reemplazar Slack con cualquier otro punto de notificación modificando las configuraciones de punto final del proyecto y adaptando los flujos de trabajo a los esquemas requeridos por el servicio que elijas. Si usas Slack, debes crear una aplicación de Slack (usando el archivo slack_app_manifest.json proporcionado en la descarga de personalizaciones) y obtener los tokens de autenticación necesarios.

Ejemplos de consultas API

Los siguientes ejemplos muestran cómo llamar a la API personalizada de Jitterbit para realizar un análisis de precios.

Llamadas API con App Builder

Estos ejemplos demuestran llamadas API al usar App Builder para el almacenamiento y gestión de datos.

Análisis de precios de un solo producto

La API acepta detalles del producto de App Builder. App Builder proporciona la solicitud JSON de acuerdo con la regla de App Builder creada. La respuesta incluye los datos originales del producto más el análisis de precios generado por IA: precios mínimos, promedio y máximos de competidores, precio recomendado y puntaje de confianza.

• Endpoint:

  POST https://JBExample123456.jitterbit.net/defaultUrlPrefix/2.1/aiAgentPricingAgentApi/suggestedprice
  

• Request:

  {
  "productID": "391fd871-cc9a-4e93-af27-a6f2e11237ee",
  "brand": "Apple",
  "SKU": "iPhone 14 Pro Max 256 Gb",
  "description": "Smartphone Apple iPhone 14 Pro Max",
  "basePrice": 350,
  "category": "Smartphone",
  "AICompetitorMinimum": "",
  "AICompetitorAverage": "",
  "AICompetitorMaximum": "",
  "AIPriceRecommendation": "",
  "AIConfidenceScore": "",
  "flagNotification": 1
  }
  

• Response:

  {
  "productID": "391fd871-cc9a-4e93-af27-a6f2e11237ee",
  "brand": "Apple",
  "SKU": "iPhone 14 Pro Max 256 Gb",
  "description": "Smartphone Apple iPhone 14 Pro Max",
  "basePrice": 350,
  "category": "Smartphone",
  "AICompetitorMinimum": "$415.00",
  "AICompetitorAverage": "$537.06",
  "AICompetitorMaximum": "$879.00",
  "AIPriceRecommendation": "$626.53",
  "AIConfidenceScore": "75",
  "flagNotification": 1
  }
  

Análisis de precios por lotes para todos los productos

La API activa el procesamiento por lotes de todos los productos almacenados en App Builder. El proceso por lotes se ejecuta en segundo plano para evitar el tiempo de espera de la API.

• Endpoint:

  POST https://JBExample123456.jitterbit.net/defaultUrlPrefix/2.1/aiAgentPricingAgentApi/AppBuilderAllProductsSuggestedPrice
  

• Request: Ninguno requerido.

• Response:

  {
  "status": "Success",
  "message": "The integration will run but it will take some time. Please verify that the data is updated after some time"
  }
  

Llamadas a la API sin App Builder

Estos ejemplos demuestran llamadas a la API al realizar análisis de precios sin usar App Builder para el almacenamiento de datos.

Procesamiento por lotes desde ERP

La API activa el procesamiento por lotes de todos los productos del sistema ERP. El proceso por lotes se ejecuta en segundo plano para evitar el tiempo de espera de la API.

• Endpoint:

  POST https://JBExample123456.jitterbit.net/defaultUrlPrefix/2.1/aiAgentPricingAgentApi/ERPProductsSuggestedPrice
  

• Request: Ninguno requerido.

• Response:

  {
  "status": "Success",
  "message": "The integration will run but it will take some time. Please verify that the data is sent to your instant message application"
  }
  

Análisis de precios de un solo producto

La API permite el análisis de precios sin usar App Builder para el almacenamiento de datos. El agente devuelve resultados en la respuesta de la API y los envía a través de notificaciones de Slack.

• Endpoint:

  POST https://JBExample123456.jitterbit.net/defaultUrlPrefix/2.1/aiAgentPricingAgentApi/GenericProductSuggestedPrice
  

• Request:

  {
  "productID": "112233",
  "brand": "Apple",
  "SKU": "iPhone 14 Pro Max 256 Gb",
  "description": "Smartphone Apple iPhone 15 Pro Max",
  "basePrice": 345,
  "category": "Smartphone Apple",
  "AICompetitorMinimum": "",
  "AICompetitorAverage": "",
  "AICompetitorMaximum": "",
  "AIPriceRecommendation": "",
  "AIConfidenceScore": "",
  "flagNotification": 1
  }
  

• Response:

  {
  "productID": "112233",
  "brand": "Apple",
  "SKU": "iPhone 14 Pro Max 256 Gb",
  "description": "Smartphone Apple iPhone 15 Pro Max",
  "basePrice": 345,
  "category": "Smartphone Apple",
  "AICompetitorMinimum": "$359.99",
  "AICompetitorAverage": "$494.53",
  "AICompetitorMaximum": "$1080.00",
  "AIPriceRecommendation": "$419.76",
  "AIConfidenceScore": "75",
  "flagNotification": 1
  }
  

Instalación, configuración y operación

Sigue estos pasos para instalar, configurar y operar este agente de IA:

1. Descargar personalizaciones e instalar el proyecto
2. Crear recursos de Microsoft Azure
3. Crear la aplicación de Slack
4. Configurar variables del proyecto
5. Probar conexiones
6. Desplegar el proyecto
7. Crear la API personalizada de Jitterbit
8. Instalar la aplicación App Builder (opcional, solo para usuarios de App Builder)
9. Revisar flujos de trabajo del proyecto
10. Activar los flujos de trabajo del proyecto

Para obtener orientación sobre la resolución de problemas, consulte Resolución de problemas.

Descargar personalizaciones e instalar el proyecto

Siga estos pasos para descargar archivos de personalización e instalar el proyecto de Studio para el agente de IA:

1. Inicie sesión en el portal de Harmony en https://login.jitterbit.com y abra Marketplace.

2. Localice el agente de IA llamado Jitterbit Competitive Pricing Agent. Para localizar el agente, puede usar la barra de búsqueda o, en el panel de Filtros bajo Tipo, seleccionar Agente de IA para limitar la visualización a agentes de IA.

3. Haga clic en el enlace de Documentación del agente de IA para abrir su documentación en una pestaña separada. Mantenga la pestaña abierta para consultarla después de iniciar el proyecto.

4. Haga clic en Iniciar Proyecto para abrir un cuadro de diálogo de configuración de dos pasos para descargar personalizaciones e importar el agente de IA como un proyecto de Studio.

   Nota

   Si aún no ha comprado el agente de IA, se mostrará Obtenga este agente en su lugar. Haga clic en él para abrir un cuadro de diálogo informativo, luego haga clic en Enviar para que un representante se comunique con usted sobre la compra del agente de IA.

5. En el paso de configuración 1, Descargar Personalizaciones, se proporciona el siguiente archivo para facilitar la configuración de la aplicación de Slack. Seleccione el archivo y haga clic en Descargar Archivos:

   • Archivo de manifiesto de la aplicación de Slack: slack_app_manifest.json

6. Haga clic en Siguiente.

7. En el paso de configuración 2, Crear un Nuevo Proyecto, seleccione un entorno donde se creará el proyecto de Studio, luego haga clic en Crear Proyecto.

8. Se muestra un cuadro de diálogo de progreso. Una vez que indique que el proyecto ha sido creado, use el enlace del cuadro de diálogo Ir a Studio o abra el proyecto directamente desde la página de Proyectos de Studio.

Crear recursos de Microsoft Azure

Cree los siguientes recursos de Microsoft Azure y retenga la información para configurar el agente de IA. Para crear y administrar estos recursos, debe tener una suscripción de Microsoft Azure con los permisos apropiados.

Recurso de Azure OpenAI

Debes crear un recurso de Azure OpenAI y desplegar un modelo gpt-4o a través del portal de Azure AI Foundry.

Retén el nombre del despliegue, la URL del endpoint de Azure OpenAI y la clave API. Ingresarás estos valores en las variables del proyecto de Azure OpenAI cuando configures las variables del proyecto en el siguiente paso.

Para encontrar estos valores, sigue estos pasos:

1. En el portal de Azure AI Foundry, abre el recurso específico de OpenAI.

2. En la página de inicio del recurso, copia la URL del endpoint (usarás esto para la variable del proyecto azure_openai_base_url) y la clave API (usarás esto para la variable azure_openai_api_key).

3. En el menú de navegación bajo Recursos compartidos, selecciona Despliegues. Copia el nombre del despliegue (usarás esto para la variable azure_deployment_id).

Crear la aplicación de Slack

Para recibir notificaciones de Slack sobre cambios de precios, sigue estos pasos:

1. Crea una aplicación de Slack utilizando el archivo de manifiesto de la aplicación de Slack (slack_app_manifest.json) proporcionado con los archivos de personalización de este agente de IA. Alternativamente, crea la aplicación desde cero.

2. Si utilizas el archivo de manifiesto proporcionado, reemplaza los siguientes marcadores de posición con tus propios valores de configuración:

   Marcador de posición	Descripción
   {{Reemplazar con el nombre del bot de Slack}}	El nombre que deseas que tenga tu bot de Slack, tal como se muestra a los usuarios. Reemplaza este valor en dos lugares en el manifiesto.
   {{Reemplazar con la URL de la API de Jitterbit}}	La URL del servicio de la API personalizada de Jitterbit que creaste en Crear la API personalizada de Jitterbit.

3. Instala la aplicación en tu espacio de trabajo de Slack.

4. Obtén el token del bot (para el campo Token OAuth de Usuario Bot de la conexión de Slack) y ingresa su valor para la variable de proyecto slack_bot_oauth_user_token.

5. Configura la variable de proyecto slack_channel_name con el canal donde se deben enviar las notificaciones.

6. Ingresa el valor del token del bot para la variable de proyecto slack_bot_oauth_user_token y el nombre del canal para la variable de proyecto slack_channel_name. Configurarás estos en el siguiente paso.

Configurar variables de proyecto

En el proyecto de Studio instalado anteriormente desde Marketplace, debes establecer valores para las siguientes variables de proyecto.

Para configurar las variables de proyecto, utiliza el menú de acciones del proyecto para seleccionar Variables de Proyecto y abrir un panel en la parte inferior de la página donde puedes revisar y establecer los valores.

Slack

SAP

Google Shopping

Notificaciones por correo electrónico

Azure OpenAI

Constructor de Aplicaciones

Parámetros de aviso dinámico

Estas variables controlan el comportamiento de la IA al construir recomendaciones de precios.

Valores predeterminados del prompt

Los siguientes valores predeterminados deben mantenerse para las variables ai_System_Prompt y ai_Dynamic_Prompt. Modificar estos valores puede causar problemas en la ejecución de la IA.

Valor predeterminado de ai_System_Prompt

Eres un experto en compras y análisis de precios competitivos.\n Recibirás un documento JSON que contiene artículos de competidores con precios.\n Debes analizar SOLAMENTE los datos JSON proporcionados.\nTus responsabilidades:\n - Identificar todos los precios válidos de los competidores.\n - Calcular el precio mínimo de los competidores.\n - Calcular el precio máximo de los competidores.\n - Calcular el precio promedio de los competidores.\n - Contar el número de competidores válidos.\n - Calcular un puntaje de confianza basado en el conteo de competidores, la variación de precios y la consistencia de los datos.\n NO inventas datos.\n NO usas fuentes externas.\n NO modificas los límites de precios definidos por el sistema.\n Al recomendar un precio:\n - Debes recomendar un precio estrictamente dentro del límite inferior y superior de precios proporcionados.\n - Debes alinear la recomendación con la estrategia de precios y el ancla de mercado proporcionados.\n - Debes aplicar un comportamiento de respaldo cuando la confianza esté por debajo del umbral requerido.\n La respuesta siempre debe seguir exactamente la estructura de salida definida.\n

Valor predeterminado de ai_Dynamic_Prompt

\n'Configuración de la estrategia de precios:\n\n- Tipo de ancla de mercado: ||marketAnchor|| \n\n- Intención de posicionamiento: ||positioningIntent||\n\n- Peso del precio base: ||basePriceWeighting||%\n Esto controla cuán fuertemente el precio base influye en la recomendación final en relación con el ancla de mercado. 0% ignora el precio base, 100% ignora el ancla de mercado, 50% mezcla ambos por igual. Valor actual: ||basePriceWeighting||%\n\n- Porcentaje de prima/descuento: ||premiumDiscountPercentage||%\n Este porcentaje se aplica de acuerdo con la intención de posicionamiento. Los valores positivos aumentan el precio (prima), los valores negativos disminuyen el precio (descuento). Valor actual: ' + premiumDiscountPercentage + '%\n\n- Aumento máximo de precio permitido: ||maxPriceIncrease||%\n La IA no debe recomendar un precio más de este porcentaje por encima del precio base o del precio influenciado por el ancla. Valor actual: ||maxPriceIncrease||%\n\n- Disminución máxima de precio permitida: ||maxPriceDecrease||%\n La IA no debe recomendar un precio más de este porcentaje por debajo del precio base o del precio influenciado por el ancla. Valor actual: ||maxPriceDecrease||%\n\n- Tamaño mínimo de muestra de competidores: ||minimumCompetitorSampleSize||\n Si el número de competidores válidos está por debajo de este umbral, la IA debe activar un comportamiento de respaldo para evitar recomendaciones poco fiables. Valor actual: ||minimumCompetitorSampleSize||\n\n- Exclusión de valores atípicos: ||outlierExclusion||\n Si la exclusión de valores atípicos está habilitada, elimina precios extremos de competidores antes de calcular el mínimo, máximo y promedio. Se define como valores >2x o <0.5x la mediana. Valor actual: ||outlierExclusion||\n\nInstrucciones:\n\n1. A partir del JSON proporcionado, identifica todos los precios válidos de los competidores.\n2. Elimina los valores atípicos si la exclusión de valores atípicos está habilitada.\n3. Calcula:\n   - Precio mínimo de competidores como AICompetitorMinimum\n   - Precio máximo de competidores como AICompetitorMaximum\n   - Precio promedio de competidores como AICompetitorAverage\n4. Formatea todos los precios calculados como moneda con un prefijo "$" y exactamente dos decimales.\n5. Calcula un puntaje de confianza de 0 a 100 basado en el conteo de competidores, la variación de precios y la consistencia de los datos como AIConfidenceScore.\n6. Recomienda un precio final que:\n   - Alinee con el ancla de mercado seleccionada y la intención de posicionamiento\n   - Aplique el peso del precio base y el porcentaje de prima/descuento\n   - Respete los límites máximos de aumento/disminución de precios\n   - Permanezca estrictamente dentro del límite inferior y superior de precios definidos por el sistema\n   - Almacene el precio final recomendado como AIPriceRecomendation\n7. Si la confianza < umbral o el conteo de competidores < ||minimumCompetitorSampleSize||, aplica comportamiento de respaldo.\n8. Solo actualiza los campos que están vacíos ("").\n9. Devuelve solo JSON válido, comenzando con "{" y terminando con "}".\n\nAsegúrate de usar las etiquetas de apertura y cierre prescritas. No devuelvas la respuesta en formato markdown o de código, solo el texto plano.\nElimina cualquier ```json al principio o al final. La respuesta debe SER SOLO un JSON válido que comience con { y termine con }.\nNo envíes valores vacíos\nESTRUCTURA DE SALIDA (usa exactamente esta estructura):\n

Probar conexiones

Probar las configuraciones de los endpoints para verificar la conectividad utilizando los valores de las variables del proyecto definidas.

Para probar conexiones, ve a la pestaña Endpoints y conectores del proyecto en la paleta de componentes de diseño, pasa el cursor sobre cada endpoint y haz clic en Probar .

Desplegar el proyecto

Desplegar el proyecto de Studio.

Para desplegar el proyecto, utiliza el menú de acciones del proyecto para seleccionar Desplegar.

Crear la API personalizada de Jitterbit

Crear una API personalizada para múltiples servicios que desencadenen diferentes operaciones utilizando el Administrador de API.

Elige el conjunto apropiado de servicios a continuación según si utilizas App Builder o llamadas API directas, luego configura y publica la API personalizada.

Servicios para App Builder

Configura estos servicios si utilizas el enfoque de App Builder. Después de configurar los servicios, publica la API personalizada.

• Servicio 1: Obtener precio sugerido por IA

  Configuración	Valor
  Nombre del servicio	Obtener precio sugerido por IA
  Operación	Carga de datos inicial - Ejecución de API
  Ruta	/suggestedprice
  Método	POST
  Tipo de respuesta	Variable del sistema

• Servicio 2: Obtener precio sugerido para todos los productos de IA

  Configuración	Valor
  Nombre del servicio	Obtener precio sugerido para todos los productos de IA
  Operación	Manejador de solicitudes API de productos de App Builder
  Ruta	/AppBuilderAllProductsSuggestedPrice
  Método	POST
  Tipo de respuesta	Variable del sistema

Servicios para llamadas a la API (sin App Builder)

Configura estos servicios si utilizas llamadas a la API sin App Builder. Después de configurar los servicios, publica la API personalizada.

• Servicio 1: Carga Inicial de Datos de Productos

  Configuración	Valor
  Nombre del servicio	Carga Inicial de Datos de Productos
  Operación	Carga Inicial de Datos de Productos
  Ruta	/ERPProductsSuggestedPrice
  Método	POST
  Tipo de respuesta	Variable del sistema

• Servicio 2: Obtener Precio Sugerido por IA

  Configuración	Valor
  Nombre del servicio	Obtener Precio Sugerido por IA
  Operación	Carga Inicial de Datos - Ejecución de API Genérica
  Ruta	/GenericProductSuggestedPrice
  Método	POST
  Tipo de respuesta	Variable del sistema

Instalar la aplicación App Builder

Estas instrucciones solo son necesarias si estás utilizando App Builder para la gestión y configuración de datos. Si utilizas el agente de IA sin App Builder, omite esta sección y configura el agente utilizando variables de proyecto como se describe en Parámetros de aviso dinámicos.

Para instalar y configurar la aplicación App Builder, contacta a soporte de Jitterbit para obtener el archivo de instalación de App Builder (.lp file).

Instalar el archivo LP

Instala el paquete de lanzamiento en tu instancia de App Builder:

1. Inicia sesión en App Builder.

2. Ve a IDE.

3. En Deploy, haz clic en Instalar Release.

4. Haz clic en + Package y luego haz clic en Browse.

5. Selecciona el archivo LP proporcionado por soporte de Jitterbit.

6. Haz clic en Save. El panel de Release a la derecha muestra la información del paquete.

7. Cierra el diálogo de Package.

8. Confirma que los detalles son correctos y haz clic en Install.

Integración de API de App Builder

Los pasos en esta sección configuran la comunicación API bidireccional entre App Builder y la API personalizada de Jitterbit:

• Entrante: Permitir que Jitterbit llame a las API de App Builder para almacenar información del producto.
• Saliente: Permitir que App Builder llame a la API personalizada de Jitterbit para activar el análisis de precios.

Configurar la autenticación de API para llamadas entrantes

Configura la autenticación de API Key en App Builder para permitir que Jitterbit almacene datos del producto. Necesitas un proveedor de seguridad de API Key y API Keys específicas para los usuarios.

Configurar el servidor de datos para llamadas salientes

Configura el Constructor de Aplicaciones para llamar a la API personalizada de Jitterbit cuando los usuarios hagan clic en el botón Enviar datos a AI. Esto activa el flujo de trabajo Tool - Read AppBuilder Pricing Request.

1. Ve a IDE > Servidores de Datos y localiza el servidor de datos AI Pricing Agent API Source.

2. Haz clic en Abrir registro y luego haz clic en Editar.

3. En el campo URL, ingresa la URL de la API personalizada de Jitterbit que guardaste al crear la API personalizada de Jitterbit.

4. Haz clic en Guardar.

Actualizar variables del proyecto de Studio

Ahora que has completado la integración de la API del Constructor de Aplicaciones, ingresa los valores para las variables del proyecto del Constructor de Aplicaciones.

Actualizar tablas del Constructor de Aplicaciones usando APIs

El proyecto de Studio utiliza las variables project variables app_builder_base_url y app_builder_endpoint_url para llamar a los siguientes puntos finales del Constructor de Aplicaciones:

• Actualizar tabla de Productos: /products/[appBuilderProductID] (POST)
• Crear datos históricos del Constructor de Aplicaciones: /aiSearchLog (POST)

No se requiere configuración adicional. Estos puntos finales son utilizados automáticamente por los flujos de trabajo del proyecto.

Obtener datos del Constructor de Aplicaciones usando APIs

Para recuperar datos del Constructor de Aplicaciones utilizando la API REST nativa del Constructor de Aplicaciones, se utilizan las siguientes solicitudes:

• Obtener información del producto: GET - https://development.appbuilder.jitterbit.com/rest/v1/PricingAIAgentApp/products

• Obtener valores de configuración:

  • GET - https://development.appbuilder.jitterbit.com/rest/v1/PricingAIAgentApp/configurationControl
  • GET - https://development.appbuilder.jitterbit.com/rest/v1/PricingAIAgentApp/marketPriceAnchor
  • GET - https://development.appbuilder.jitterbit.com/rest/v1/PricingAIAgentApp/positioningIntent

Tablas del Constructor de Aplicaciones

La aplicación App Builder almacena y muestra la siguiente información en diferentes tablas.

Las siguientes tablas son utilizadas por la aplicación App Builder. Para obtener información detallada sobre los tipos de datos de App Builder y sus especificaciones, consulte la documentación de Tipos de datos de columna.

1. AISearchLog: Esta tabla almacena datos históricos de cada ejecución de IA.

   Nombre de columna	Tipo de dato	Descripción
   AISearchLogID	UUID	Identificador único
   date	DateTime	Marca de tiempo de la ejecución de IA
   productInformation	NVarchar(5000)	Información del producto con valores generados por IA
   configuration	NVarchar(5000)	Esquema de configuración utilizado en el análisis

2. ConfigurationControlValues: Esta tabla almacena la estrategia de análisis utilizada para crear el aviso dinámico para los resultados del análisis de precios.

   Nombre de columna	Tipo de dato	Descripción
   ConfigurationControlValueID	UUID	Identificador único
   marketPriceAnchorValueID	UUID	Referencia al valor ancla del precio de mercado
   positioningIntentID	UUID	Referencia al valor de intención de posicionamiento
   basePriceWeighting	TinyInt	Porcentaje que controla la influencia del precio base
   premiumDiscountPercentage	TinyInt	Porcentaje aplicado según la intención de posicionamiento
   maxPriceDecrease	TinyInt	Porcentaje máximo para la disminución de precios
   maxPriceIncrease	TinyInt	Porcentaje máximo para el aumento de precios
   minimumCompetitorSampleSize	NVarchar(50)	Mínimo de competidores requeridos para recomendaciones confiables
   outlierExclusion	Bit	Indicador booleano para habilitar la exclusión de valores atípicos
   dynamicPromptText	NVarchar(5000)	Parte variable del aviso que incorpora valores de configuración
   staticPromptText	NVarchar(5000)	Parte estática de las instrucciones de IA

3. marketPriceAnchorValues: Esta tabla almacena los valores desplegables utilizados en la configuración del análisis.

   Nombre de columna	Tipo de dato	Descripción
   marketPriceAnchorValueID	UUID	Identificador único
   marketPriceAnchorValue	NVarchar(50)	La opción de valor ancla: Promedio, Competidor más bajo, Mediana o Cuartil superior
   script	NVarchar(5000)	Script asociado al valor ancla

4. positioningIntentValues: Esta tabla almacena los valores desplegables utilizados en la configuración del análisis.

   Nombre de columna	Tipo de dato	Descripción
   positioningIntentID	UUID	Identificador único
   positioningIntentValue	NVarchar(50)	La opción de intención de posicionamiento: Coincidir con el mercado, Premium o Bajar el precio del mercado
   script	NVarchar(5000)	Script asociado a la intención de posicionamiento

5. Products: Esta tabla almacena información sobre productos. Pueble esta tabla manualmente o use el Tool - Get ERP Products with App Builder flujo de trabajo para importar productos automáticamente desde SAP ECC.

   Nombre de columna	Tipo de dato	Descripción
   ProductID	UUID	Identificador único del producto
   Brand	NVarchar(50)	Marca del producto
   SKU	NVarchar(50)	Unidad de Mantenimiento de Stock
   VinylAuditRefId	UUID	Identificador de referencia de auditoría de vinilo
   Description	NVarchar(100)	Descripción del producto
   BasePrice	Numeric(15,2)	Precio base del producto
   Category	NVarchar(50)	Categoría del producto
   AICompetitorMinimum	NVarchar(50)	Precio mínimo del competidor generado por IA
   AICompetitorAverage	NVarchar(50)	Precio promedio del competidor generado por IA
   AICompetitorMaximum	NVarchar(50)	Precio máximo del competidor generado por IA
   AIPriceRecommendation	NVarchar(50)	Precio recomendado generado por IA
   AIConfidenceScore	NVarchar(50)	Puntaje de confianza de IA para la recomendación
   SourceID	NVarchar(50)	Identificador del sistema fuente
   SourceName	NVarchar(50)	Nombre del sistema fuente
   flagNotification	Bit	Bandera booleana para habilitar notificaciones de Slack

Revisar flujos de trabajo del proyecto

El proyecto de Studio contiene 12 flujos de trabajo que implementan la funcionalidad del agente de precios de IA. Cada flujo de trabajo tiene un propósito específico en el proceso de análisis de precios. Comprender estos flujos de trabajo ayuda a determinar cuáles configurar y ejecutar según su enfoque de implementación.

Flujos de trabajo al usar App Builder

Herramienta - Leer Solicitud de Precios de AppBuilder

Este flujo de trabajo recibe información del producto a través de solicitudes de API de App Builder y llama a la API de Google Shopping, configuración de prompts, Azure OpenAI, notificaciones y flujos de trabajo de registro para realizar análisis de precios. El flujo de trabajo devuelve información de precios actualizada a las tablas de App Builder.

Entrada Principal - Controlador de Solicitudes de API de Productos de App Builder

Este flujo de trabajo llama a Herramienta - Leer Productos de la Tabla de AppBuilder para procesar todos los productos bajo demanda en lugar de esperar a una ejecución programada. Puedes activar este flujo de trabajo utilizando una API configurada en App Builder o ejecutarlo fuera de App Builder.

Entrada Principal - Controlador de Solicitudes de API de Slack

Este flujo de trabajo envía resultados de IA y un resumen del procesamiento a un canal de Slack cuando el campo flagNotification de un producto está marcado como verdadero. Puedes personalizar este flujo de trabajo para otros canales de comunicación creando un nuevo conector y operación.

Herramienta - Obtener Productos ERP con App Builder

Este flujo de trabajo se conecta a SAP u otros sistemas ERP para recuperar productos y almacenarlos en tablas de App Builder en un formato genérico. Al conectarse a SAP ECC, RFC_READ_TABLE llama a la tabla MARA para obtener la lista de materiales, y BAPI_MATERIAL_GETALL se utiliza para obtener los detalles de cada material. El flujo de trabajo contiene la operación Obtener Materiales de SAP. El flujo de trabajo se ejecuta según lo programado o manualmente.

Herramienta - Leer Productos de la Tabla de AppBuilder

Este flujo de trabajo procesa todos los productos de la tabla de App Builder. El flujo de trabajo contiene la operación Carga de Datos Inicial que llama a la API de Google Shopping, configuración de prompts, Azure OpenAI, notificaciones y flujos de trabajo de registro para realizar análisis de precios. El flujo de trabajo se ejecuta según lo programado o manualmente.

Utility - Store to App Builder

Este flujo de trabajo verifica si un producto existe en la tabla de App Builder. El flujo de trabajo actualiza el producto si existe, o crea un nuevo registro si no existe.

Utility - AppBuilder Logging

Este flujo de trabajo almacena información de ejecución en la tabla AISearchLog de App Builder cuando se ejecutan Tool - Read AppBuilder Pricing Request y Tool - Read Products From AppBuilder Table. El flujo de trabajo registra el esquema del producto con valores de IA y el esquema de configuración utilizado en cada ejecución.

Flujos de trabajo cuando no se utiliza App Builder

Tool - Get ERP Products

Este flujo de trabajo recibe solicitudes API para recuperar materiales de SAP u otros sistemas ERP, realiza análisis de precios utilizando Google Shopping y el LLM, y devuelve resultados a través de notificaciones de Slack. Al conectarse a SAP ECC, RFC_READ_TABLE llama a la tabla MARA para obtener la lista de materiales, y se utiliza BAPI_MATERIAL_GETALL para obtener los detalles de cada material. La llamada API requiere un parámetro obligatorio startingDate en la URL (por ejemplo, https://JBExample123456.jitterbit.net/defaultUrlPrefix/2.1/aiAgentPricingAgentApi/ERPProductsSuggestedPrice?startingDate=20250101) para limitar la búsqueda de productos. Sin este parámetro, la integración mostrará un error. Este flujo de trabajo es similar a Tool - Read Products From AppBuilder Table pero no almacena datos en App Builder.

Main Entry - Generic Single Pricing API Request Handler

Este flujo de trabajo recibe solicitudes API con información del producto en formato JSON y realiza análisis de precios sin requerir SAP ECC o App Builder. Proporcionas datos completos del producto en el cuerpo de la solicitud API, y el flujo de trabajo devuelve el producto con información de IA actualizada en la respuesta API. El flujo de trabajo envía notificaciones de Slack si el campo flagNotification está marcado como verdadero.

Main Entry - Slack API Request Handler

Este flujo de trabajo envía resultados de IA y un resumen del procesamiento a un canal de Slack cuando el campo flagNotification de un producto en la solicitud API está marcado como verdadero. Puedes personalizar este flujo de trabajo para otros canales de comunicación creando un nuevo conector y operación.

Flujos de trabajo compartidos

Los siguientes flujos de trabajo son utilizados tanto por App Builder como por enfoques que no son de App Builder. Estos flujos de trabajo se ejecutan automáticamente como parte de otros flujos de trabajo y no están destinados a la ejecución directa.

Herramienta - Configuración de Prompts de Construcción

Este flujo de trabajo construye prompts dinámicos para análisis de precios impulsados por IA. El flujo de trabajo busca la configuración almacenada en las tablas de App Builder cuando se utiliza App Builder, o construye prompts a partir de variables del proyecto cuando no se utiliza App Builder.

Utilidad - Buscar Productos en Google Shopping

Este flujo de trabajo llama a la API de Google Shopping para recuperar información de precios de mercado para productos. El flujo de trabajo utiliza el SKU del producto como filtro de consulta para buscar y recuperar datos de precios de competidores de Google Shopping.

Principal - Lógica de Herramientas del Agente de IA

Este flujo de trabajo llama al LLM (Azure OpenAI) para realizar análisis de precios basados en información del producto y datos de mercado.

Activar los flujos de trabajo del proyecto

Al usar App Builder

Si se utiliza una conexión ERP, ejecute la operación Obtener Materiales SAP en el flujo de trabajo Herramienta - Obtener Productos ERP con App Builder para cargar materiales en las bases de datos de App Builder. Alternativamente, puede proporcionar datos de productos directamente a través de la API sin una conexión ERP.

Para ejecutar una operación, pase el cursor sobre el nombre de la operación y seleccione la opción Ejecutar. Ejecute las operaciones nuevamente en el futuro cuando sus datos se actualicen.

Al no usar App Builder

Los siguientes flujos de trabajo se ejecutan a través de llamadas a la API sin requerir App Builder. Estos flujos de trabajo realizan análisis de precios sin almacenar resultados en las bases de datos de App Builder:

• Herramienta - Obtener Productos ERP: Una API activa este flujo de trabajo para obtener materiales de SAP u otro sistema, realizar análisis de precios y devolver resultados a través de notificaciones de Slack. Dado que este flujo de trabajo no requiere App Builder, se envían notificaciones de Slack para mostrar los resultados del análisis de precios para todos los productos.

• Entrada Principal - Manejador de Solicitudes de API de Precios Genéricos: Una API activa este flujo de trabajo con un cuerpo de solicitud JSON que contiene información del producto. El flujo de trabajo procesa el producto y envía los resultados del análisis de precios a través de notificaciones de Slack.

• Entrada Principal - Manejador de Solicitudes de API de Slack: Este flujo de trabajo se activa cuando el campo flagNotification en la solicitud de API está habilitado. El flujo de trabajo envía los resultados de IA y un resumen del procesamiento a Slack.

Solución de Problemas

Si encuentra problemas, revise los siguientes registros para obtener información detallada sobre la solución de problemas:

• Registros de API
• Registros de Operación

Para asistencia adicional, comuníquese con soporte de Jitterbit.