Saltar al contenido

Agente de Ventas Jitterbit

Descripción general

El Agente de Ventas Jitterbit (Agente de Ventas) es un agente de IA proporcionado a través de Jitterbit Marketplace que está destinado a habilitar el equipo de ventas interno de su organización. Realiza lo siguiente:

  • Se conecta a NetSuite y Salesforce para obtener órdenes de venta, precios y datos de clientes en tiempo real utilizando Jitterbit Integration Studio.
  • Se integra con Azure OpenAI para potenciar un chatbot inteligente de Agente de Ventas accesible a través de una API personalizada creada con Jitterbit API Manager.

Este documento explica la configuración y operación del agente. Primero cubre los requisitos previos, luego proporciona ejemplos de solicitudes para mostrar lo que el agente puede hacer, y finalmente ofrece pasos para instalar, configurar y operar el agente.

Requisitos previos

Para utilizar el Agente de Ventas, se requieren o asumen los siguientes componentes en el diseño del agente.

Componentes de Harmony

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

Recursos de Azure

Debe tener una suscripción de Microsoft Azure con permisos para crear y gestionar los siguientes recursos:

  • Almacenamiento de Azure con un contenedor Blob para almacenar detalles de clientes.
  • Azure AI Search con un servicio de búsqueda que se puede configurar con un índice y un indexador.
  • Azure OpenAI con un modelo gpt-4o o gpt-4.1 desplegado.

Consejo

Para seleccionar niveles de precios basados en sus requisitos específicos y uso anticipado, consulte niveles de precios de Azure AI Search y precios de Azure OpenAI.

Endpoints compatibles

Los siguientes endpoints están incorporados en el diseño del agente, pero otros sistemas pueden ser acomodados modificando las configuraciones de endpoints y flujos de trabajo del proyecto:

  • NetSuite: La fuente de formularios de pedidos de clientes.
  • Salesforce: La fuente de las cuentas de clientes y precios de productos.
  • Slack: La interfaz de chat para interactuar con el agente.

Si se desea utilizar una aplicación diferente como interfaz de chat, se incluye un flujo de trabajo separado e instrucciones para una configuración de API genérica en este agente de IA.

Ejemplos de solicitudes

Aquí hay ejemplos de solicitudes que el Agente de Ventas puede manejar con acceso a los datos apropiados:

Preguntas sobre búsqueda de clientes

  • "Muéstrame todos los clientes en California."
  • "¿Qué clientes están ubicados en Sídney?"

Preguntas sobre formularios de pedido / detalles de licencias

  • "¿Qué productos ha comprado Acme Corp?"
  • "¿Cuántas 'Producto X' tiene licenciadas ByteTech GmbH?"
  • "¿Puedes darme los detalles del pedido para AcmeCloud Ltd?"
  • "¿Cuál es la duración de la suscripción para Zento Systems?"

Consulta de precios de productos o planes

  • "¿Cuál es el precio de 'Producto X' en USD?"
  • "¿Cuánto cuesta la suscripción Profesional?"
  • "¿Qué plan de suscripción permite 10 entornos?"
  • "¿Puedes calcular el costo de 15 'Producto X' y 4 'Producto Y'?"

Consultas sobre propietarios de cuentas

  • "¿Quién gestiona Acme Corp?"
  • "¿Qué clientes son propiedad de jsmith@abc.com?"
  • "Muestra los clientes atendidos por David Brown en Texas."
  • "Lista las cuentas gestionadas por Grace en el Reino Unido."

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 de Integration Studio.
  2. Revisar los flujos de trabajo del proyecto.
  3. Crear recursos de Microsoft Azure.
  4. Preparar Jitterbit Cloud Datastore.
  5. Configurar variables del proyecto.
  6. Probar conexiones.
  7. Desplegar el proyecto.
  8. Crear la API personalizada de Jitterbit.
  9. Crear la aplicación de Slack, probar la conexión de Slack y volver a desplegar el proyecto.
  10. Activar los flujos de trabajo del proyecto.

Descargar personalizaciones e instalar el proyecto

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

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

  2. Localiza el agente de IA llamado Jitterbit Sales Agent. Para localizar el agente, puedes usar la barra de búsqueda o, en el panel de Filtros bajo Tipo, seleccionar Agente de IA para limitar la visualización a los agentes de IA disponibles.

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

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

    Nota

    Si aún no has comprado el agente de IA, se mostrará Obtener este agente en su lugar. Haz clic en él para abrir un diálogo informativo, luego haz clic en Enviar para que un representante se comunique contigo sobre la compra del agente de IA.

  5. En el paso de configuración 1, Descargar Personalizaciones, se proporcionan los siguientes archivos para facilitar la configuración del índice y el indexador en Azure AI Search y para crear la aplicación de Slack. Selecciona los archivos y haz clic en Descargar Archivos:

    • Archivos de definición JSON del índice y el indexador de Azure AI Search

      • Azure_AI_Search_Datasource_Definition.json
      • Azure_AI_Search_Index_Definition.json
      • Azure_AI_Search_Indexer_Definition.json
    • Archivo de manifiesto de la aplicación de Slack

      • slack_app_manifest.json

    Consejo

    El diálogo de configuración incluye una advertencia de no importar la plantilla antes de aplicar las personalizaciones del punto final. Esa advertencia no se aplica a este agente de IA y se puede ignorar. Sigue el orden recomendado de pasos en esta documentación.

    Haz clic en Siguiente.

  6. En el paso de configuración 2, Crear un Nuevo Proyecto, selecciona un entorno donde se creará el proyecto de Integration Studio, luego haz clic en Crear Proyecto.

  7. Se mostrará un cuadro de diálogo de progreso. Una vez que indique que el proyecto ha sido creado, utiliza el enlace del cuadro de diálogo Ir a Integration Studio o abre el proyecto directamente desde la página de Proyectos de Integration Studio.

Revisar flujos de trabajo del proyecto

En el proyecto abierto de Integration Studio, revisa los flujos de trabajo junto con las descripciones a continuación para entender qué hacen. Las descripciones a continuación indican dónde podrías reemplazar el sistema modificando las configuraciones de punto final y los flujos de trabajo del proyecto.

  1. Utility-Upload Customer Order Forms to Azure

    Este flujo de trabajo automatiza el procesamiento de formularios de pedido al extraer detalles de NetSuite, subir documentos a Azure Blob Storage e indexarlos en el índice de búsqueda de Azure AI.

    Este flujo de trabajo debe ejecutarse primero para cargar todos los datos de clientes activos, haciendo que los detalles del cliente estén disponibles para el agente de IA. La ejecución del flujo de trabajo se describe en Activar los flujos de trabajo del proyecto más adelante en esta página.

    Si los datos de formularios de pedido de clientes de tu organización están en un sistema diferente a NetSuite, debes modificar las operaciones del flujo de trabajo para reemplazar los componentes específicos de NetSuite por aquellos de tu punto final.

  2. Main Entry - Slack API Request Handler

    Este flujo de trabajo gestiona las solicitudes entrantes del bot de Slack y verifica la autorización del usuario. Se activa a través de una API personalizada de Jitterbit cada vez que tu equipo de ventas interactúa con la interfaz de chat del bot de Slack (es decir, envía un mensaje de Slack). La configuración de la API personalizada de Jitterbit se describe en Crear la API personalizada de Jitterbit más adelante en esta página.

    Si no estás utilizando Slack, este flujo de trabajo puede ser ignorado y no se activará. Para usar una interfaz de chat diferente para que tu equipo de ventas interactúe, utiliza el flujo de trabajo Generic API Request Handler, que también se activa a través de una API personalizada de Jitterbit.

  3. Main - Lógica de Herramientas del Agente de IA

    Después de recibir la autorización del usuario a través de los flujos de trabajo Main Entry - Slack API Request Handler o Generic API Request Handler, este flujo de trabajo gestiona las solicitudes de llamada a funciones al modelo de lenguaje grande (LLM), tomando decisiones sobre qué herramienta ejecutar según la respuesta del LLM. Hay tres llamadas a herramientas principales:

    1. Customer_Order_Function: Esta herramienta aborda las consultas de los usuarios sobre formularios de pedidos de clientes al invocar la operación Main - Get Customer Order Form Details dentro del flujo de trabajo Tool-Customer Order Details.

    2. Pricing_Function: Esta herramienta aborda las consultas de los usuarios sobre precios de productos al invocar la operación Main - Pricing Sheet dentro del flujo de trabajo Tool-Pricing Sheets.

    3. Customer_Lookup_By_Location_Function: Esta herramienta aborda las consultas de los usuarios para obtener clientes por ubicación o propietario de la cuenta al invocar la operación Main - Customer Lookup dentro del flujo de trabajo Tool - Customer Lookup.

  4. Tool-Customer Order Details

    Este flujo de trabajo recupera los detalles del pedido del cliente desde NetSuite.

    Para usar un endpoint diferente a NetSuite, crea una nueva operación para recuperar formularios de pedidos del sistema y asigna los resultados a la extractedContent variable global. Luego, activa la nueva operación desde la operación Main - Get Customer Order Form Details.

  5. Tool-Pricing Sheets

    Este flujo de trabajo recupera los precios de productos desde Salesforce.

    En la configuración de la actividad de consulta de Salesforce, la siguiente consulta recupera información sobre precios de productos por agente. Si tu organización de Salesforce no utiliza estos objetos y campos, o si la información de precios de productos se almacena en diferentes objetos/campos, este flujo de trabajo no funcionará correctamente. En ese caso, el agente no podrá responder preguntas sobre precios. Personaliza la consulta en este flujo de trabajo para alinearla con el modelo de datos de tu organización de Salesforce:

    SELECT Product2.Description,
           Product2.Family,
           Product2.ProductCode,
           CurrencyIsoCode,
           Name,
           UnitPrice,
           Pricebook2.Name,
           Id
    FROM   PricebookEntry
    WHERE  IsDeleted = false
           AND IsArchived = false
           AND IsActive = true
           AND Pricebook2.IsActive = true
           AND Pricebook2.IsDeleted = false
           AND Pricebook2.IsArchived = false
           AND Product2.IsActive = true
           AND Product2.IsDeleted = false
           AND Product2.IsArchived = false
           AND CurrencyIsoCode = '{{ currencycode }}'
    ORDER BY Name
    

    Para utilizar un endpoint diferente al de Salesforce, crea una nueva operación para recuperar los precios de productos del sistema y asigna los resultados a la variable global pricing_sheet. Luego, activa la nueva operación desde la operación Main - Pricing Sheet.

  6. Herramienta - Búsqueda de Clientes

    Este flujo de trabajo recupera clientes de Salesforce.

    En la configuración de la actividad de Consulta de Salesforce, la siguiente consulta recupera información de cuentas de clientes. Si tu organización de Salesforce utiliza diferentes campos u objetos para los detalles del cliente, personaliza esta consulta en este flujo de trabajo en consecuencia:

    SELECT Id,
           BillingCity,
           BillingCountry,
           BillingState,
           Name
    FROM   Account
    WHERE  Type = 'Customer'
    

    Para utilizar un endpoint diferente al de Salesforce, crea una nueva operación para recuperar clientes del sistema y asigna los resultados a la variable global extractedContent. Luego, activa la nueva operación desde la operación Main - Customer Lookup.

  7. Utilidad - Obtener Todos los Propietarios de Cuentas

    Este flujo de trabajo recupera propietarios de cuentas de Salesforce.

    En la configuración de la actividad de Consulta de Salesforce, la siguiente consulta recupera propietarios de cuentas (nombre y correo electrónico) para todas las cuentas de tipo Customer o Partner. Si tu organización de Salesforce utiliza diferentes tipos de cuentas o campos personalizados para clasificar cuentas, personaliza esta consulta en este flujo de trabajo en consecuencia:

    SELECT OwnerId,
           Owner.Email,
           Owner.Name
    FROM   Account
    WHERE  Type IN ('Customer', 'Partner')
    

    Para utilizar un endpoint diferente al de Salesforce, crea una nueva operación para recuperar propietarios de cuentas del sistema y asigna los resultados a la variable Account_Owner_List. Luego, activa la nueva operación desde la operación Main - Get Owner List.

  8. Utilidad - Autorización de Usuario y Sesión

    Este flujo de trabajo gestiona la autorización de usuarios y la sesión. Utiliza Jitterbit Cloud Datastore para mantener una lista de usuarios autorizados y sus sesiones activas.

Para configurar este flujo de trabajo con un almacén de datos alternativo o un mecanismo de autorización para gestionar el acceso y las sesiones de los usuarios, modifica las operaciones del flujo de trabajo en consecuencia.

  1. Utilidad - Almacenamiento del Historial de Chats del Bot

    Este flujo de trabajo gestiona el almacenamiento del historial de chats del bot, lo cual es esencial para proporcionar contexto de memoria a los LLMs. Aprovecha Jitterbit Cloud Datastore para este propósito.

    Para integrarse con otras soluciones de almacenamiento de datos para almacenar y recuperar el historial de chats, modifica las operaciones del flujo de trabajo en consecuencia.

  2. Manejador de Solicitudes API Genérico

    Este flujo de trabajo procesa solicitudes API HTTP de cualquier aplicación. Para integrarse con tus aplicaciones, crea una API personalizada de Jitterbit que active la operación Manejador de Solicitudes API Genérico. La URL de esta API puede ser utilizada por cualquier aplicación para enviar y recibir solicitudes.

    La configuración de la API personalizada de Jitterbit se describe en Crear la API personalizada de Jitterbit más adelante en esta página.

Crear recursos de Microsoft Azure

Crea los siguientes recursos de Microsoft Azure y retén la siguiente información para configurar el agente de IA. Para crear y gestionar estos recursos, debes tener una suscripción de Microsoft Azure con los permisos apropiados.

Contenedor de Blob de Azure

Debes crear un contenedor de Blob de Azure para almacenar los detalles del cliente. Los datos del contenedor de Blob serán indexados en Azure AI Search utilizando un índice y un indexador.

Necesitarás la URL SAS del contenedor para usarla en la determinación de los valores de las variables del proyecto de Almacenamiento de Blob de Azure. Para generar la URL SAS:

  1. En el portal de Azure, navega a Cuentas de almacenamiento y abre la cuenta de almacenamiento específica.
  2. Desde el menú de recursos bajo Almacenamiento de datos, selecciona Contenedores y abre el contenedor específico.
  3. Desde el menú de recursos bajo Configuración, selecciona Tokens de acceso compartido.
  4. Usa el menú de Permisos para verificar que la firma de acceso compartido (SAS) para este contenedor tenga un mínimo de permisos de Lectura y Escritura:

    Permisos de URL SAS

  5. Haz clic en Generar token y URL SAS.

  6. Copia la URL SAS del Blob que se muestra en la parte inferior.
  7. Determina los valores de las variables del proyecto de Azure Blob Storage a partir de la URL SAS. La URL SAS tiene el formato {{ azure_blob_base_url }}/{{ Azure_Customer_Details_Container }}?{{ azure_customer_detail_blob_sig }}.

Si utilizas los archivos de definición JSON incluidos en los archivos de personalización del agente de IA para generar el índice y el indexador, también necesitarás la clave de cuenta de Azure Blob Storage. Para ver las claves de acceso de la cuenta:

  1. En el portal de Azure, navega a Cuentas de almacenamiento y abre la cuenta de almacenamiento específica.
  2. En el menú de recursos, bajo Seguridad + redes, selecciona Claves de acceso.
  3. Haz clic en Mostrar claves para revelar la clave de acceso que se utilizará durante la configuración de Azure AI Search.

    Claves de cuenta de almacenamiento

Servicio de búsqueda de Azure AI

Debes crear un servicio de búsqueda de Azure AI y configurar su índice y indexador para procesar los datos del contenedor Blob.

Necesitarás la URL del servicio de búsqueda de Azure AI y la clave API para determinar los valores de las variables del proyecto de Azure AI Search:

Puedes utilizar los archivos de definición JSON incluidos en los archivos de personalización del agente de IA para generar el índice y el indexador, o puedes crearlos tú mismo.

Si utiliza los archivos de definición proporcionados, debe reemplazar los siguientes marcadores de posición con sus propios valores de configuración:

Azure_AI_Search_Indexer_Definition.json

Marcador de posición Descripción
{{Su Nombre del Servicio de Búsqueda de Azure AI}} El nombre del servicio de búsqueda de Azure AI.

Azure_AI_Search_Datasource_Definition.json

Marcador de posición Descripción
{{Su Nombre del Servicio de Búsqueda de Azure AI}} El nombre del servicio de búsqueda de Azure AI.
{{Su Nombre de Cuenta de Blob de Azure}} El nombre de la cuenta de Blob de Azure.
{{Su Clave de Cuenta de Blob de Azure}} La clave de acceso para la cuenta de almacenamiento de Blob de Azure, obtenida como se describe en contenedor de Blob de Azure arriba.
{{su_nombre_contenedor_blob_azure}} El nombre del contenedor de Blob de Azure.

Recurso de Azure OpenAI

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

Necesitará el nombre del despliegue, la URL del endpoint de Azure OpenAI y la clave API para determinar los valores de las variables del proyecto de Azure OpenAI. Para encontrar estos valores:

  1. En el portal de Azure AI Foundry, abra el recurso específico de OpenAI.
  2. Los valores a utilizar para la URL del endpoint (azure_openai_base_url) y la clave API (azure_openai_api_key) se muestran en la página de inicio del recurso:

    Clave y URL de AI Foundry

  3. En el menú de navegación bajo Recursos compartidos, selecciona Despliegues. Se muestra el nombre del despliegue (Azure_OpenAI_Deployment_Name).

Preparar Jitterbit Cloud Datastore

Crea dos almacenes de claves en Jitterbit Cloud Datastore, Bot_Authorized_Users y askjb_sales_q_and_a, cuyos campos tienen los nombres y tipos que se enumeran en las tablas a continuación.

A medida que agregues campos personalizados, utiliza las tablas a continuación para determinar si cada uno debe ser activado como Requerido en la interfaz de usuario de Cloud Datastore. Los campos AlternativeKey y Value son campos predeterminados que no se pueden eliminar ni activar.

Después de agregar campos personalizados, agrega un registro de almacén de claves para cada usuario que estará autorizado para usar el bot agente de IA. Debes definir manualmente los valores marcados en las tablas a continuación. Puedes dejar en blanco los valores de los campos cuyos valores se autocompletan o no se utilizan.

Bot_Authorized_Users

Este almacén de claves contiene la lista de usuarios autorizados y sus sesiones. Debes ingresar manualmente las direcciones de correo electrónico de los usuarios que están autorizados para acceder al bot agente de IA.

Nombre Tipo Requerido Definición del valor Descripción
Key Texto Ingresar manualmente La dirección de correo electrónico del usuario autorizado para interactuar con el agente de IA a través del bot de Slack. Este valor se ingresa manualmente.
AlternativeKey Texto No Autocompletado La sesión para el usuario se generará automáticamente durante la ejecución. No se requiere entrada manual.
Value Texto No Ingresar manualmente La dirección de correo electrónico del usuario autorizado para interactuar con el agente de IA a través del bot de Slack. Este valor se ingresa manualmente. Aunque no está marcado como un campo requerido por defecto, proporcionar un valor es necesario para que el agente de IA funcione.

askjb_sales_q_and_a

Este almacenamiento de claves retiene el historial de chat de un bot para proporcionar contexto de memoria para el LLM. Se utiliza por la integración para almacenar el historial de preguntas y respuestas. Todos los datos se ingresan automáticamente durante la ejecución de la interacción.

Nombre Tipo Requerido Definición del valor Descripción
Key Texto Autocompletado Especifica el identificador único asignado a un mensaje por el sistema.
AlternativeKey Texto No Autocompletado Especifica el identificador único asignado a una sesión de chat por el sistema.
Value Texto No No utilizado No utilizado.
slackChannel Texto Autocompletado El ID del canal de Slack desde el cual se envía el mensaje.
User Texto Autocompletado El nombre de usuario de Slack de la persona que envía el mensaje.
FirstName Texto No Autocompletado Primer nombre de la persona que envía el mensaje.
LastName Texto No Autocompletado Apellido de la persona que envía el mensaje.
Email Texto Autocompletado Dirección de correo electrónico de la persona que envía el mensaje.
MessageTimestampText Texto Autocompletado El texto de la marca de tiempo del mensaje.
UserQuestion Texto Grande Autocompletado La pregunta o mensaje enviado por el usuario al agente de IA.
AIAnswer Texto Grande Autocompletado La respuesta generada por el agente de IA a la pregunta del usuario.
ai_reformulate_question Texto Grande No Autocompletado La pregunta del usuario después de ser reformulada o parafraseada por la IA para mejorar la comprensión.

Configurar variables del proyecto

En el proyecto de Integration Studio instalado anteriormente a través de Marketplace, se deben establecer valores para las siguientes variables del proyecto.

Esto se puede hacer utilizando el menú de acciones del proyecto para seleccionar Variables del Proyecto y abrir un panel en la parte inferior de la página donde se pueden revisar y establecer los valores.

Salesforce

Nombre de la variable Descripción
SF_Login_URL Servidor Host en la conexión de Salesforce
SF_Password Contraseña en la conexión de Salesforce
SF_Security_Token Token de seguridad en la conexión de Salesforce
SF_User_Name Nombre de usuario en la conexión de Salesforce

NetSuite

Nombre de la variable Descripción
NetSuite_Account Cuenta en la conexión de NetSuite
NetSuite_Consumer_Key Clave de consumidor en la conexión de NetSuite
NetSuite_Consumer_Secret Secreto de consumidor en la conexión de NetSuite
NetSuite_Base_URL URL base de NetSuite, como https://{{NetSuite_Account}}.suitetalk.api.netsuite.com.
NetSuite_Token_Key Clave de token en la conexión de NetSuite
NetSuite_Token_Secret Secreto de token en la conexión de NetSuite

Almacenamiento de Blob de Azure

Nombre de variable Descripción
Azure_Customer_Details_Container El nombre del contenedor de Blob de Azure para almacenar información del cliente de los formularios de pedido.
azure_customer_detail_blob_sig Firma de URL SAS para Azure_Customer_Details_Container.
azure_blob_base_url URL base del servicio de contenedor de Azure para Azure_Customer_Details_Container.

Consejo

Estos valores se pueden derivar de la URL SAS, que tiene el formato de {{azure_blob_base_url}}/{{Azure_Customer_Details_Container}}?{{azure_customer_detail_blob_sig}}.

Nombre de variable Descripción
customer_search_index_name El nombre del índice de Azure que almacena información del cliente de los formularios de pedido.
Azure_SalesOrders_Customer_Indexer El nombre del indexador de Azure que indexa datos desde Azure_Customer_Details_Container al índice customer_search_index_name.
azure_ai_search_url URL base del servicio de búsqueda de AI de Azure.
azure_ai_search_api_key Clave API para el servicio de búsqueda de AI de Azure.

Azure OpenAI

Nombre de variable Descripción
Max_Output_Tokens El número máximo de tokens que el LLM puede generar en una respuesta. GPT-4.1 admite hasta 32768 tokens, mientras que GPT-4o admite hasta 16384.
Azure_OpenAI_Deployment_Name El nombre de la implementación para LLM en Azure OpenAI.
azure_openai_base_url URL base del servicio de Azure OpenAI.
azure_openai_api_key Clave API para el servicio de Azure OpenAI.

Slack

Nombre de variable Descripción
salesorder_slack_bot_token El token del bot de Slack que se obtiene después de crear la aplicación de Slack, utilizado para el token de acceso OAuth del usuario Bot en la conexión de Slack.

Nota

La aplicación de Slack se crea en un paso posterior. Por ahora, puedes dejar esta variable en blanco.

Common

Nombre de variable Descripción
Authorized_User_Admin Nombre/correo electrónico del contacto que se muestra en la respuesta enviada al usuario cuando ocurre un error.
Customer_LastOrder_DefaultDate La fecha predeterminada (mm/dd/yyyy) desde la cual se extraen los pedidos de NetSuite durante la primera ejecución o una ejecución histórica cuando incrementalRun está configurado como false. Por ejemplo: 06/01/2004.
Default_Last_Sync_Date Fecha de última sincronización predeterminada que se utilizará si el valor de caché no está disponible.
incrementalRun Cuando es true, solo se extraen pedidos incrementales (nuevos o actualizados) de NetSuite. Cuando es false o está en blanco, se recupera un historial completo de pedidos desde la fecha predeterminada.
Only_Unexpired_Orders Cuando es true, solo se extraen los pedidos con nextbilldate mayor que la fecha de hoy de NetSuite.

Probar conexiones

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

Esto se puede hacer desde la pestaña Endpoints y conectores del proyecto en la paleta de componentes de diseño, pasando el cursor sobre cada endpoint y haciendo clic en Probar.

Desplegar el proyecto

Desplegar el proyecto de Integration Studio. Esto se puede hacer utilizando el menú de acciones del proyecto para seleccionar Desplegar.

Crear la API personalizada de Jitterbit

Crear una API personalizada utilizando API Manager para uno de los siguientes:

Crear el controlador de solicitudes de API de Slack bot

Esta API personalizada de Jitterbit activará la operación Controlador de solicitudes de API de Slack Bot. Configura y publica la API personalizada con los siguientes ajustes:

  • Servicio API: Controlador de solicitudes de API de Slack Bot
  • Ruta: /
  • Proyecto: Selecciona el proyecto de Integration Studio creado a partir del Agente de Ventas de Jitterbit en Marketplace
  • Operación a activar: Controlador de solicitudes de API de Slack Bot
  • Método: POST
  • Tipo de respuesta: Variable del sistema

Conserva la URL del servicio de la API publicada para su uso en la creación de la aplicación de Slack. La URL del servicio se puede encontrar en el panel de detalles de la API en la pestaña Servicios, pasando el cursor sobre la columna Acciones del servicio y haciendo clic en Copiar URL del servicio API.

Controlador de solicitudes de API genérico

Esta API personalizada de Jitterbit activará la operación Generic API request Handler. No es obligatorio. Crea esta API si estás utilizando otras aplicaciones para procesar solicitudes de API HTTP. Configura y publica la API personalizada con los siguientes ajustes:

  • Nombre del servicio: Generic API request Handler
  • Proyecto: Selecciona el proyecto de Integration Studio creado a partir del Jitterbit Sales Agent en Marketplace
  • Operación: Generic API request Handler
  • Método: POST
  • Tipo de respuesta: System Variable

Consejo

También puedes agregar un perfil de seguridad para la autenticación.

Cuerpo de la solicitud
{
    "username": "abc@abc.com",
    "sessionId": "123608",
    "prompt": "Order Forms details for xyz"
}
Respuesta
{
   "message": "Based on order forms, here are the complete order details: ...",
   "status_code": 200
}

Crea la aplicación de Slack, prueba la conexión y vuelve a desplegar el proyecto

Para crear la interfaz de chat del Sales Agent en Slack, crea una aplicación de Slack utilizando el archivo de manifiesto de la aplicación de Slack proporcionado con los archivos de personalización de este agente de IA. O, créala desde cero.

Si utilizas el archivo de manifiesto de la aplicación de Slack proporcionado (slack_app_manifest.json), debes reemplazar los siguientes marcadores de posición con tus propios valores de configuración:

Marcador de posición Descripción
{{Replace with Slack bot name}} El nombre que deseas que tenga tu bot de Slack, tal como se muestra a los usuarios. Hay dos lugares en el manifiesto donde debes reemplazar este valor.
{{Replace with Jitterbit API URL}} La URL del servicio de la API personalizada de Jitterbit que creaste en Crear el controlador de solicitudes de API del bot de Slack.

Después de instalar la aplicación de Slack, obtén su token de bot.

Vuelve a abrir la configuración de variables del proyecto e ingresa el token de bot para el valor de la variable del proyecto salesorder_slack_bot_token.

Una vez que se haya configurado el token de bot, prueba la conexión de Slack y vuelve a desplegar el proyecto.

Activar los flujos de trabajo del proyecto

Para el cargador de datos inicial, ejecuta la operación en el primer flujo de trabajo, Utility-Upload Customer Order Forms to Azure. Esto se puede hacer utilizando la opción Ejecutar de la operación, que se muestra al pasar el cursor sobre la operación. Necesitarás ejecutar la operación nuevamente en el futuro si tus datos se actualizan.

Consejo

Puede que desees programar esta operación en un horario para obtener datos actualizados de manera regular. Esto se puede hacer desde el menú de acciones de la operación en Configuración > Horarios.

Los otros dos flujos de trabajo principales son activados por las API personalizadas de Jitterbit:

  • Main Entry - Slack API Request Handler: Este flujo de trabajo se activa desde Slack a través de la API personalizada Slack Bot API Request Handler. Enviar un mensaje directo a la aplicación de Slack iniciará el disparador de la API personalizada.

  • Generic API Request Handler: Este flujo de trabajo se activa desde otra aplicación a través de la API personalizada Generic API request Handler. Enviar una solicitud a la API configurada iniciará el disparador de la API personalizada.

Todos los demás flujos de trabajo son activados por otras operaciones y están en la parte posterior de los mencionados anteriormente. No están destinados a ejecutarse por sí solos.

Solución de problemas

Revisa los registros de API y los registros de operaciones para obtener información detallada sobre la solución de problemas.

Para asistencia adicional, contacta al soporte de Jitterbit.