Agente QBR Deck de Jitterbit

Descripción general

Jitterbit proporciona el Agente QBR Deck a los clientes a través de Jitterbit Marketplace. Este agente automatiza la creación de presentaciones de revisión trimestral de negocios (QBR) en Google Slides mediante la recopilación de datos de clientes de Salesforce, NetSuite y API de uso del producto, procesando esos datos con IA para producir resúmenes e información estructurados. El 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 de barra oblicua de Slack, consulta Salesforce para obtener detalles de la cuenta, contactos y casos de soporte, recupera datos del proyecto de NetSuite e importa métricas de uso del producto de API regionales. Un LLM procesa los datos combinados y genera resúmenes e información narrativa. Luego, el agente duplica una plantilla de Google Slides en Google Drive, completa las diapositivas con el contenido generado y envía el enlace de la presentación completada (o una notificación de error) al usuario en Slack.

El agente realiza las siguientes tareas:

• Recibe solicitudes de generación de QBR de usuarios mediante comandos de barra oblicua de Slack.
• Consulta Salesforce para obtener información de la cuenta, detalles de la región, contactos y casos de soporte.
• Recupera datos del proyecto de NetSuite.
• Importa métricas de uso del producto desde API de uso del producto regional.
• Normaliza todos los datos recopilados en un formato canónico para procesarlos.
• Envía los datos combinados a un LLM para generar resúmenes e información.
• Duplica una plantilla de diapositivas de QBR en Google Drive para el cliente de destino.
• Completa las diapositivas con contenido generado por IA.
• Envía el enlace de la presentación completada o una notificación de error al usuario en Slack.

Este documento explica cómo configurar y operar este agente de IA. Cubre la arquitectura, los requisitos previos, la orientación sobre cómo usar el agente y los 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 en Salesforce, NetSuite y API de uso del producto, luego usa un LLM para sintetizar los datos en una presentación de Google Slides completa. Una interacción típica sigue estos pasos:

1. Un usuario envía un comando de barra oblicua /completeqbr al bot de Slack, especificando un nombre de cliente o un ID de cuenta de Salesforce.
2. Slack llama al extremo de la API de Jitterbit, lo que activa el controlador de solicitud principal.
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 desde la API de uso del producto 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 e información para cada sección de diapositivas.
8. El agente duplica la plantilla de QBR de Google Slides en Google Drive y completa 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, el cliente no se encuentra o se devuelven varias coincidencias), el agente envía una notificación de error en su lugar.

Diagrama de flujo de trabajo

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

Requisitos previos

Se necesitan los siguientes componentes para usar este agente de IA.

Componentes de Harmony

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

• Jitterbit Studio
• Jitterbit API Manager
• Agente QBR Deck adquirido como complemento de licencia.

Extremos admitidos

El agente de IA se conecta a los siguientes extremos. Se pueden adaptarse otros sistemas modificando las configuraciones de extremos 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 de Microsoft Azure con permisos para crear un recurso de Azure OpenAI con un modelo implementado.

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 API y credenciales con permisos para leer registros de cuentas, contactos y casos.

NetSuite

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

API 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/Oriente Medio/África (EMEA) y Asia-Pacífico (APAC). Debes tener claves de API válidas para las regiones aplicables.

Slack

El agente utiliza Slack como 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 rellenar la presentación generada. Debes tener un proyecto de Google Cloud con ambas API habilitadas y una cuenta de servicio con acceso de Editor a la unidad compartida que contiene la plantilla de QBR y las carpetas de salida.

Indicaciones del agente

El agente QBR Deck recibe todas las solicitudes como comandos de barra inclinada enviados al bot de Slack. Esta sección describe los comandos admitidos y proporciona ejemplos de entrada.

Directrices de indicaciones

Sigue estas directrices al enviar comandos al agente:

• Especifica un cliente usando el parámetro customer= seguido del nombre del cliente o del 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 dirigirse a un registro específico.
• Usa /completeqbr para generar una presentación QBR completa.
• Usa /singleslideqbr para generar una sola diapositiva. Usa los parámetros customer= y slide= para especificar el cliente y qué diapositiva generar.

Ejemplos de indicaciones

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

Presentación QBR completa

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

QBR de diapositiva única

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. Implementar 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 solución de problemas, consulta Solución de problemas.

Descarga e instala el proyecto

Sigue estos pasos para instalar el proyecto de 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 QBR Deck Agent. Para localizarlo, utiliza la barra de búsqueda o, en el panel Filters, bajo Type, selecciona AI Agent para limitar la visualización a agentes de IA.

3. Haz clic en el enlace Documentation del agente 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 Start Project para abrir un diálogo de configuración de dos pasos.

   Nota

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

   Consejo

   El diálogo de configuración incluye una advertencia para no importar la plantilla antes de aplicar personalizaciones de extremo. Esta advertencia no aplica a este agente de IA y se puede ignorar. En su lugar, sigue el orden recomendado de pasos en esta documentación.

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

6. Haz clic en Next.

7. En el paso de configuración 2, Create a New Project, selecciona un entorno donde se creará el proyecto de Studio y luego haz clic en Create Project.

8. Después de que el diálogo de progreso indique que el proyecto se ha creado, utiliza el enlace Go to Studio del diálogo o abre el proyecto directamente desde la página Projects de Studio.

Configura Azure OpenAI

Crea un recurso de Azure OpenAI e implementa un modelo para usar como LLM para el agente:

1. Inicia sesión en el portal de Azure y crea un recurso de Azure OpenAI en tu suscripción.
2. En Azure AI Foundry, crea una implementación y anota el nombre de la implementación y el ID del modelo.
3. Copia la clave de API y la URL del extremo de la sección Keys and Endpoint del recurso.
4. Guarda la clave, el extremo y los detalles de la implementación en las variables de proyecto correspondientes listadas bajo Azure OpenAI.

Configura 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 Google Drive API y Google Slides API bajo APIs & Services > Library.
2. Ve a IAM & Admin > Service Accounts y crea una nueva cuenta de servicio.
3. En la pestaña Keys, haz clic en Add Key > Create new key, selecciona JSON y descarga el archivo de clave generado.
4. Del archivo JSON descargado, extrae los valores client_email, private_key y project_id y guárdalos en las variables de proyecto correspondientes listadas bajo Google Cloud.
5. Establece la variable Google_OAuth_Scopes en https://www.googleapis.com/auth/drive.

Prepara Google Drive

Carga la plantilla de QBR en 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 My Drive).
2. Otorga a la cuenta de servicio (el valor de Google_Client_Email) acceso de Editor a la Unidad compartida.
3. Carga el archivo ZIP descargado en Descarga e instala el proyecto en la Unidad compartida y extrae su contenido. Verifica que se creen dos carpetas: New Documents y QBR Template.
4. Abre la carpeta QBR Template, 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 New Documents y copia el ID de la carpeta de la URL (la cadena después de /folders/).
6. Guarda ambos IDs en las variables de proyecto Google_Drive_Template_File_Id y Google_Drive_Destination_Folder.

Configurar variables de proyecto

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

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

Salesforce

NetSuite

Google Cloud

API de uso del producto

Azure OpenAI

Probar conexiones

Prueba las configuraciones del endpoint para verificar la conectividad usando los valores de variables de proyecto definidos.

Para probar conexiones, ve a la pestaña Project endpoints and connectors de la paleta de componentes de diseño, pasa el cursor sobre cada endpoint y haz clic en Test.

Implementar el proyecto

Implementa el proyecto de Studio.

Para implementar el proyecto, usa el menú de acciones del proyecto y selecciona Deploy.

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 API Request Handler en el flujo de trabajo 1.0 Main Entry – Slack API Request Handler.
3. Publica la API y copia la URL del endpoint generada.
4. Usa esta URL tanto para los marcadores de posición {{Jitterbit API for complete QBR Report}} como {{Jitterbit API for Partial QBR Report}} al configurar el manifiesto de la aplicación Slack. Solo se requiere una API; ambos comandos de barra diagonal usan el mismo endpoint.

Crear y configurar la aplicación Slack

Crear una aplicación de Slack y configurarla para llamar al endpoint de la API de Jitterbit:

1. Ve a api.slack.com/apps y selecciona o crea tu aplicación de Slack.
2. Navega a App Manifest en el menú de la izquierda y haz clic en Edit Manifest.
3. Pega el JSON del manifiesto proporcionado con el proyecto en el editor.
4. Reemplaza los dos marcadores de posición {{Jitterbit API for complete QBR Report}} y {{Jitterbit API for Partial QBR Report}} con la misma URL del endpoint de la API de Jitterbit creada en Create a custom API. Ambos comandos barra utilizan el mismo endpoint; el agente los enruta internamente según el nombre del comando.
5. Haz clic en Save Changes para aplicar la configuración.
6. Instala o reinstala la aplicación en tu workspace si se te solicita.

Revisar los flujos de trabajo del proyecto

El proyecto 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 Main Entry – Slack API Request Handler

Este flujo de trabajo actúa como controlador central del agente. Recibe solicitudes de comandos barra de Slack entrantes a través del endpoint de la API de Jitterbit, valida la entrada y enruta 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 Main – AI Agent Tools Logic

Este flujo de trabajo ejecuta la lógica de procesamiento de IA principal. 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 Utility – Duplicate Google Slides Template

Este flujo de trabajo maneja la gestión de plantillas. Se autentica con Google Cloud mediante un token de OAuth, recupera el archivo de plantilla de QBR configurado de 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 Utility – Google Slides

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

4.0 Tool – Canonical Input Handler

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

5.0 Utility – Salesforce

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

6.0 Utility – NetSuite

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

7.0 Utility – AskJBSales

Este workflow gestiona 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 workflow de procesamiento de IA.

9.0 Utility – Slack

Este workflow gestiona comunicaciones salientes 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 workflows del proyecto

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

Antes de que el agente pueda recibir comandos, la app de Slack debe instalarse en tu espacio de trabajo y las URLs de los puntos finales de la API deben configurarse en el manifiesto de la app. Consulta Create and configure the Slack app y Create a custom API.

Solución de problemas

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

• API logs
• Operation logs

Para obtener asistencia adicional, comunícate con el soporte de Jitterbit.