Agente de Presentaciones QBR de Jitterbit

Descripción General

Jitterbit proporciona el Agente de Presentaciones QBR a los clientes a través de Jitterbit Marketplace. Este agente automatiza la creación de presentaciones de revisión de negocios trimestral (QBR) en Google Slides al recopilar datos de clientes de Salesforce, NetSuite y APIs de uso de productos, y procesar esos datos con IA para producir resúmenes e insights estructurados. Este agente utiliza la técnica de Generación Aumentada por Recuperación (RAG), que combina el razonamiento de LLM con acceso a herramientas externas y fuentes de datos.

El agente recibe solicitudes a través de comandos slash de Slack, consulta Salesforce para obtener detalles de cuentas, contactos y casos de soporte, recupera datos de proyectos de NetSuite y extrae métricas de uso de productos de APIs regionales. Un LLM procesa los datos combinados y genera resúmenes narrativos e insights. Luego, el agente duplica una plantilla de Google Slides en Google Drive, llena las diapositivas con el contenido generado y envía el enlace de la presentación completada (o una notificación de error) de vuelta al usuario en Slack.

El agente realiza las siguientes tareas:

• Recibe solicitudes de generación de QBR de los usuarios a través de comandos slash de Slack.
• Consulta Salesforce para obtener información de cuentas, detalles de región, contactos y casos de soporte.
• Recupera datos de proyectos de NetSuite.
• Extrae métricas de uso de productos de APIs regionales de uso de productos.
• Normaliza todos los datos recopilados en un formato canónico para su procesamiento.
• Envía los datos combinados a un LLM para generar resúmenes e insights.
• Duplica una plantilla de diapositivas de QBR en Google Drive para el cliente objetivo.
• Llena las diapositivas con contenido generado por IA.
• Envía el enlace de la presentación completada o una notificación de error de vuelta al usuario en Slack.

Este documento explica cómo configurar y operar este agente de IA. Cubre arquitectura, requisitos previos, orientación sobre cómo solicitar al agente y pasos para instalar, configurar y operar el agente de IA.

Arquitectura del agente de IA

Este agente de IA genera presentaciones de QBR orquestando la recuperación de datos a través de Salesforce, NetSuite y APIs de uso de productos, y luego utiliza un LLM para sintetizar los datos en una presentación de Google Slides poblada. Una interacción típica sigue estos pasos:

1. Un usuario envía un comando de barra /completeqbr al bot de Slack, especificando un nombre de cliente o ID de cuenta de Salesforce.
2. Slack llama al endpoint de la API de Jitterbit, activando el controlador principal de solicitudes.
3. El agente consulta Salesforce para obtener información de la cuenta, detalles de la región, contactos y casos de soporte.
4. El agente recupera datos del proyecto de NetSuite.
5. El agente recupera métricas de uso del producto de la API de uso de productos regional correspondiente.
6. El agente normaliza todos los datos recopilados en un formato canónico.
7. El agente envía los datos normalizados al LLM, que genera resúmenes y perspectivas para cada sección de la diapositiva.
8. El agente duplica la plantilla de Google Slides de QBR en Google Drive y llena cada diapositiva con el contenido generado.
9. El agente envía el enlace de la presentación completada al usuario en Slack. Si ocurre un error (por ejemplo, si no se encuentra al cliente o se devuelven múltiples coincidencias), el agente envía una notificación de error en su lugar.

Diagrama de flujo

El siguiente diagrama muestra el flujo de trabajo principal para el manejo de solicitudes del Agente de QBR de Jitterbit.

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
• Agente de QBR adquirido como un complemento de licencia.

Endpoints soportados

El agente de IA se conecta a los siguientes endpoints. Puedes acomodar otros sistemas modificando las configuraciones de endpoints y flujos de trabajo del proyecto.

Modelo de lenguaje grande (LLM)

El agente de IA utiliza Azure OpenAI como proveedor de LLM. Para usar Azure OpenAI, debes tener una suscripción a Microsoft Azure con permisos para crear un recurso de Azure OpenAI con un modelo desplegado.

Salesforce

El agente consulta Salesforce para obtener datos de cuentas, detalles de regiones, contactos y casos de soporte. Debes tener una cuenta de Salesforce con acceso a la API y credenciales con permisos para leer registros de cuentas, contactos y casos.

NetSuite

El agente consulta NetSuite utilizando integración basada en SOAP para recuperar datos de proyectos. Debes tener una cuenta de NetSuite con credenciales de autenticación basadas en tokens que tengan permisos para leer registros de proyectos.

APIs de uso del producto

El agente recupera métricas de uso del producto desde puntos finales de API regionales que cubren América del Norte (NOAM), Europa/Medio Oriente/África (EMEA) y Asia-Pacífico (APAC). Debes tener claves de API válidas para las regiones aplicables.

Slack

El agente utiliza Slack como la interfaz conversacional y canal de notificaciones. Debes tener un espacio de trabajo de Slack donde puedas instalar una aplicación personalizada y la capacidad de crear y configurar un manifiesto de aplicación.

Google Cloud

El agente utiliza la API de Google Drive y la API de Google Slides para duplicar una plantilla y poblar la presentación generada. Debes tener un proyecto de Google Cloud con ambas APIs habilitadas y una cuenta de servicio con acceso de Editor a la Unidad Compartida que contiene la plantilla QBR y las carpetas de salida.

Prompts del agente

El Agente de la Presentación QBR recibe todas las solicitudes como comandos slash enviados al bot de Slack. Esta sección describe los comandos soportados y proporciona ejemplos de entradas.

Directrices de prompts

Sigue estas directrices al enviar comandos al agente:

• Especifica un cliente usando el parámetro customer= seguido del nombre del cliente o el ID de cuenta de Salesforce.
• Si el nombre coincide con más de una cuenta de Salesforce, el agente devuelve un error. Usa el ID de cuenta de Salesforce para dirigirte a un registro específico.
• Usa /completeqbr para generar una presentación completa de QBR.
• Usa /singleslideqbr para generar una sola diapositiva. Usa los parámetros customer= y slide= para especificar el cliente y qué diapositiva generar.

Ejemplos de comandos

Los siguientes ejemplos muestran los comandos que el agente soporta. Reemplaza <customer name> con el nombre del cliente o el ID de cuenta de Salesforce.

Presentación completa de QBR

Envía el siguiente comando para generar una presentación completa de QBR para un cliente.

Diapositiva única de QBR

Envía el siguiente comando para generar una sola diapositiva para un cliente. El parámetro slide= acepta los siguientes valores: title_1, Summary_1, Usage_1, Cases_1, Entitlements_1, Projects_1, o team_1.

Instalación, configuración y operación

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

1. Descargar e instalar el proyecto
2. Configurar Azure OpenAI
3. Configurar Google Cloud
4. Preparar Google Drive
5. Configurar variables del proyecto
6. Probar conexiones
7. Desplegar el proyecto
8. Crear una API personalizada
9. Crear y configurar la aplicación de Slack
10. Revisar flujos de trabajo del proyecto
11. Activar los flujos de trabajo del proyecto

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

Descargar e instalar el proyecto

Siga estos pasos para 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 QBR Deck Agent. Para localizar el agente, utilice la barra de búsqueda o, en el panel de Filtros bajo Tipo, seleccione Agente de IA para limitar la visualización a agentes de IA.

3. Haga clic en el enlace de Documentación del agente 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 diálogo de configuración de dos pasos.

   Nota

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

   Consejo

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

5. En el paso de configuración 1, Descargar Personalizaciones, descargue el archivo ZIP proporcionado que contiene la estructura de carpetas de Google Drive y la plantilla de diapositivas de QBR.

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. Después de que el diálogo de progreso indique que el proyecto ha sido creado, utilice el enlace del diálogo Ir a Studio o abra el proyecto directamente desde la página de Proyectos de Studio.

Configurar Azure OpenAI

Cree un recurso de Azure OpenAI y despliegue un modelo para usar como el LLM para el agente:

1. Inicie sesión en el portal de Azure y cree un recurso de Azure OpenAI en su suscripción.
2. En Azure AI Foundry, cree un despliegue y anote el nombre del despliegue y el ID del modelo.
3. Copie la clave de API y la URL del punto final de la sección Claves y Punto Final del recurso.
4. Almacene la clave, el punto final y los detalles del despliegue en las variables del proyecto correspondientes que se enumeran bajo Azure OpenAI.

Configurar Google Cloud

Crea una cuenta de servicio de Google Cloud para permitir que el agente acceda a Google Drive y Google Slides:

1. Ve a console.cloud.google.com, selecciona o crea un proyecto, y habilita la API de Google Drive y la API de Google Slides en APIs y Servicios > Biblioteca.
2. Ve a IAM y Admin > Cuentas de Servicio y crea una nueva cuenta de servicio.
3. En la pestaña Claves, haz clic en Agregar clave > Crear nueva clave, selecciona JSON y descarga el archivo de clave generado.
4. Desde el archivo JSON descargado, extrae los valores de client_email, private_key y project_id y guárdalos en las variables del proyecto correspondientes que se enumeran en Google Cloud.
5. Establece la variable Google_OAuth_Scopes en https://www.googleapis.com/auth/drive.

Preparar Google Drive

Sube la plantilla QBR a una Unidad Compartida y otorga acceso a la cuenta de servicio:

1. En Google Drive, asegúrate de que el destino sea una Unidad Compartida (no una carpeta personal de Mi Unidad).
2. Otorga a la cuenta de servicio (el valor de Google_Client_Email) acceso de Editor a la Unidad Compartida.
3. Sube el archivo ZIP descargado en Descargar e instalar el proyecto a la Unidad Compartida y extrae su contenido. Verifica que se creen dos carpetas: Nuevos Documentos y Plantilla QBR.
4. Abre la carpeta Plantilla QBR, localiza el archivo de plantilla de Google Slides y copia el ID del archivo de plantilla de la URL (la cadena larga entre /d/ y /edit).
5. Abre la carpeta Nuevos Documentos y copia el ID de la carpeta de la URL (la cadena después de /folders/).
6. Almacena ambos IDs en las variables del proyecto Google_Drive_Template_File_Id y Google_Drive_Destination_Folder.

Configurar variables del proyecto

En el proyecto de Studio instalado desde Marketplace, establece valores para las siguientes variables del proyecto.

Para configurar las variables del proyecto, utiliza el menú de acciones del proyecto y selecciona Variables del Proyecto para abrir el panel de configuración.

Salesforce

NetSuite

Google Cloud

Product usage APIs

Azure OpenAI

Probar conexiones

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

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

Desplegar el proyecto

Desplegar el proyecto de Studio.

Para desplegar el proyecto, utiliza el menú de acciones del proyecto y selecciona Desplegar.

Crear una API personalizada

Crea una API personalizada en Jitterbit API Manager para exponer el punto de entrada del agente:

1. En API Manager, crea una nueva API personalizada con un método POST en la ruta /newqbr.
2. Establece el desencadenador de operación en la operación Manejador de Solicitudes API en el flujo de trabajo 1.0 Entrada Principal – Manejador de Solicitudes API de Slack.
3. Publica la API y copia la URL del punto final generado.
4. Utiliza esta URL para ambos marcadores de posición {{Jitterbit API for complete QBR Report}} y {{Jitterbit API for Partial QBR Report}} al configurar el manifiesto de la aplicación de Slack. Solo se requiere una API; ambos comandos de barra utilizan el mismo punto final.

Crear y configurar la aplicación de Slack

Crea una aplicación de Slack y configúrala para llamar al punto final de la API de Jitterbit:

1. Ve a api.slack.com/apps y selecciona o crea tu aplicación de Slack.
2. Navega a Manifiesto de la Aplicación en el menú de la izquierda y haz clic en Editar Manifiesto.
3. Pega el JSON del manifiesto proporcionado con el proyecto en el editor.
4. Reemplaza ambos marcadores de posición {{Jitterbit API for complete QBR Report}} y {{Jitterbit API for Partial QBR Report}} con la misma URL del punto final de la API de Jitterbit creada en Crear una API personalizada. Ambos comandos de barra utilizan el mismo punto final; el agente los enruta internamente según el nombre del comando.
5. Haz clic en Guardar Cambios para aplicar la configuración.
6. Instala o reinstala la aplicación en tu espacio de trabajo si se te solicita.

Revisar flujos de trabajo del proyecto

El proyecto de Studio contiene nueve flujos de trabajo que implementan la funcionalidad del Agente de QBR Deck, organizados en dos grupos funcionales.

Entrada principal y lógica de IA

1.0 Entrada Principal – Manejador de Solicitudes de Slack API

Este flujo de trabajo sirve como el controlador central para el agente. Recibe solicitudes de comandos slash de Slack entrantes a través del punto final de la API de Jitterbit, valida la entrada y dirige las solicitudes a los flujos de trabajo de recopilación de datos apropiados. Después de la recopilación de datos, coordina las operaciones posteriores a la respuesta y orquesta los pasos de procesamiento de IA y generación de diapositivas.

8.0 Principal – Lógica de Herramientas del Agente de IA

Este flujo de trabajo ejecuta la lógica central de procesamiento de IA. Construye la carga útil de la solicitud a partir de los datos normalizados, la envía al LLM y procesa los resúmenes e insights devueltos. El contenido generado se pasa luego a los flujos de trabajo de Google Slides para su inserción en la presentación.

Flujos de trabajo de utilidad y herramientas

2.0 Utilidad – Duplicar plantilla de Google Slides

Este flujo de trabajo maneja la gestión de plantillas. Se autentica con Google Cloud utilizando un token OAuth, recupera el archivo de plantilla QBR configurado desde Google Drive, crea una copia de la plantilla, le asigna un nuevo ID de archivo y la mueve a la carpeta de destino configurada.

3.0 Utilidad – Google Slides

Este flujo de trabajo gestiona las actualizaciones del contenido de las diapositivas. Modifica los títulos de las diapositivas, el contenido del cuerpo y los resúmenes, recupera los metadatos de la presentación, maneja el mapeo de marcadores de posición y realiza actualizaciones finales para asegurar que todas las diapositivas reflejen los conocimientos generados por la IA.

4.0 Herramienta – Manejador de entrada canónica

Este flujo de trabajo estandariza los datos de solicitudes entrantes. Carga y normaliza datos de múltiples fuentes en un formato canónico unificado, asegurando consistencia antes de que los datos sean pasados al flujo de trabajo de procesamiento de IA.

5.0 Utilidad – Salesforce

Este flujo de trabajo integra datos de Salesforce en el flujo de trabajo. Consulta cuentas por nombre o ID de cuenta de Salesforce, recupera detalles de la región y obtiene contactos relacionados y casos de soporte para proporcionar contexto de CRM para el QBR.

6.0 Utilidad – NetSuite

Este flujo de trabajo recupera datos relacionados con proyectos de NetSuite. Busca y devuelve registros de proyectos para enriquecer el QBR con contexto operativo o financiero.

7.0 Utilidad – AskJBSales

Este flujo de trabajo maneja análisis de uso de productos. Recupera datos de uso de productos de los puntos finales de API regionales configurados, construye conjuntos de datos de uso estructurados y combina múltiples respuestas de API en los datos utilizados por el flujo de trabajo de procesamiento de IA.

9.0 Utilidad – Slack

Este flujo de trabajo maneja la comunicación saliente de Slack. Envía mensajes formateados a Slack, entregando el enlace de la presentación completada, actualizaciones de estado o notificaciones de error al usuario que activó la solicitud.

Activar los flujos de trabajo del proyecto

El agente QBR Deck se activa mediante comandos de barra de Slack enviados a la aplicación de Slack configurada. Cuando un usuario envía un comando /completeqbr o /singleslideqbr, Slack llama al punto final de la API de Jitterbit, lo que activa la operación API Request Handler en el flujo de trabajo 1.0 Main Entry – Slack API Request Handler.

Antes de que el agente pueda recibir comandos, la aplicación de Slack debe estar instalada en tu espacio de trabajo y las URL de los puntos finales de la API deben estar configuradas en el manifiesto de la aplicación. Consulta Crear y configurar la aplicación de Slack y Crear una API personalizada.

Solución de problemas

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

• Registros de API
• Registros de operaciones

Para asistencia adicional, contacta a soporte de Jitterbit.