Agente de Inteligencia de Cuentas de Jitterbit

Descripción General

Jitterbit proporciona el Agente de Inteligencia de Cuentas a los clientes a través de Jitterbit Marketplace. Este agente ayuda a los representantes de cuentas a gestionar sus pipelines de manera más efectiva al proporcionar una lista priorizada de tareas de cuentas y al procesar automáticamente las notas de reuniones en registros de Salesforce accionables. El agente monitorea Salesforce en busca de tareas abiertas e informes de oportunidades, procesa las notas de reuniones recuperadas de Gmail y entrega los resultados a través de mensajes de Slack y resúmenes de correo electrónico programados.

El agente recibe solicitudes bajo demanda a través de Slack y utiliza un LLM para identificar la intención del usuario y recuperar la información relevante de Salesforce. Para las notas de reuniones, el agente consulta una bandeja de entrada de Gmail dedicada en busca de correos electrónicos que contengan enlaces de Google Docs, extrae los elementos de acción y los asistentes utilizando un LLM, y crea registros correspondientes de Tareas y Eventos en Salesforce. El estado de la sesión y los tokens de OAuth se mantienen en Jitterbit Cloud Datastore.

El agente realiza las siguientes tareas:

• Recibe solicitudes en lenguaje natural de los usuarios a través de Slack y devuelve una lista priorizada de tareas abiertas o informes de oportunidades.
• Recupera tareas abiertas de Salesforce asignadas al usuario que solicita, limitadas a los últimos 7 días y los próximos 30 días.
• Recupera informes de excepciones de una carpeta de Salesforce configurada y los devuelve al usuario que solicita.
• Consulta una bandeja de entrada de Gmail dedicada en busca de correos electrónicos de notas de reuniones del remitente configurado, recupera el Google Doc vinculado y extrae los elementos de acción y los asistentes utilizando un LLM.
• Crea registros de Tareas y Eventos en Salesforce para cada asistente identificado en una nota de reunión.
• Envía mensajes directos de Slack a los asistentes de la reunión con un resumen de la reunión y sus elementos de acción asignados.
• Envía resúmenes de correo electrónico programados y notificaciones de Slack a los usuarios registrados que contienen sus tareas abiertas y resúmenes de informes.

Este documento explica cómo configurar y operar este agente de IA. Cubre arquitectura y 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 presenta inteligencia de cuentas a través de una interfaz conversacional de Slack y flujos de trabajo automatizados programados. El agente opera en dos flujos principales.

Solicitudes de Slack bajo demanda

Una interacción típica bajo demanda sigue estos pasos:

1. Un usuario envía un mensaje en lenguaje natural al Agente de Inteligencia de Cuentas a través de Slack.
2. El agente llama al LLM para identificar la intención del usuario y seleccionar la herramienta apropiada para invocar.
3. La herramienta seleccionada consulta Salesforce para las tareas abiertas del usuario que realiza la solicitud o recupera informes de una carpeta de Salesforce configurada.
4. El LLM formatea los resultados y el agente publica la respuesta de vuelta al usuario en Slack.

Procesamiento de notas de reunión

El procesamiento de notas de reunión sigue estos pasos:

1. El agente consulta una bandeja de entrada de Gmail dedicada en busca de correos electrónicos del remitente de notas de reunión configurado.
2. Para cada nuevo correo electrónico, el agente extrae el enlace de Google Doc y verifica en Cloud Datastore para confirmar que el documento no ha sido procesado previamente.
3. El agente recupera el contenido del Google Doc y lo envía al LLM, que extrae los asistentes a la reunión y los elementos de acción.
4. El agente busca el ID de Contacto de Salesforce de cada asistente, luego crea un registro de Tarea para cada elemento de acción y un registro de Evento para cada asistente.
5. El agente envía a cada asistente un mensaje directo de Slack con el resumen de la reunión y sus elementos de acción asignados.

Diagrama de flujo de trabajo

El siguiente diagrama muestra los principales componentes y flujos de datos para el Agente de Inteligencia de Cuentas.

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 para exponer los puntos finales de OAuth de Slack y Gmail.
• Jitterbit Cloud Datastore para almacenar tokens de OAuth de Gmail, registros de reuniones procesados y detalles de notificación de usuarios.
• Agente de Inteligencia de Cuentas de Jitterbit adquirido como un complemento de licencia.

Endpoints compatibles

El agente de IA se conecta a los siguientes endpoints. Se pueden 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, se debe tener una suscripción a Microsoft Azure con permisos para crear un recurso de Azure OpenAI con un modelo desplegado.

Sistema CRM

El agente lee y escribe registros en Salesforce. Para usar Salesforce, se debe tener una cuenta de Salesforce con acceso a la API y permisos para leer Tareas, Eventos, Contactos e Informes, y para crear registros de Tareas y Eventos.

Plataforma de correo electrónico y documentos

El agente se conecta a Gmail para consultar una bandeja de entrada dedicada para correos electrónicos de notas de reuniones y a Google Docs para recuperar el contenido de las notas de reuniones. El acceso a Gmail utiliza credenciales de OAuth 2.0, y el acceso a Google Docs utiliza una Cuenta de Servicio de Google Cloud. Para usar estos servicios, se debe tener un proyecto de Google Cloud con la API de Gmail, la API de Google Docs y la API de Google Drive habilitadas, junto con un ID de Cliente de OAuth 2.0 para Gmail y una Cuenta de Servicio para Google Docs. Se recomienda una bandeja de entrada de Gmail dedicada para las notas de reuniones.

Plataforma de mensajería

El agente utiliza Slack como su interfaz conversacional y canal de notificaciones. Para usar Slack, se debe tener un espacio de trabajo de Slack con una aplicación de Slack configurada para recibir y responder a mensajes. Para instrucciones detalladas sobre cómo crear una aplicación de Slack, consulta Crear una aplicación de Slack.

Cloud Datastore

El agente utiliza Jitterbit Cloud Datastore para almacenar tokens de OAuth de Gmail, rastrear documentos de reuniones procesados para evitar el procesamiento duplicado y mantener detalles de usuarios para notificaciones por correo electrónico programadas. Cloud Datastore es parte de la plataforma Jitterbit Harmony y no requiere una cuenta de servicio separada.

Prompts del agente

El Agente de Inteligencia de Cuentas recibe solicitudes bajo demanda como mensajes en lenguaje natural enviados a la aplicación de Slack. Esta sección describe las reglas para crear prompts efectivos y proporciona ejemplos de prompts.

Directrices para prompts

Sigue estas directrices al enviar mensajes al agente:

• Las solicitudes están limitadas al usuario que envía el mensaje. El agente recupera tareas e informes asociados con tu cuenta de usuario de Salesforce, basado en tu dirección de correo electrónico de Slack.
• Las consultas de tareas abiertas devuelven tareas dentro de los últimos 7 días y los próximos 30 días. Los resultados pueden ser inexactos para filtros de fecha mayores a 7 días.
• Para consultas de tareas filtradas por fecha, incluye la fecha objetivo en tu mensaje utilizando un formato de fecha reconocible (por ejemplo, "antes del 30 de abril" o "antes del 2026-04-30").
• Para consultas de informes, proporciona el nombre exacto del contacto de Salesforce tal como aparece en su perfil de usuario de Salesforce.

Ejemplos de prompts

Los siguientes ejemplos de prompts muestran los tipos de solicitudes que el agente puede manejar. Reemplaza [Date] con tu fecha objetivo.

Tareas abiertas

Utiliza estos prompts para recuperar tus tareas abiertas de Salesforce:

Informes

Utiliza este prompt para recuperar detalles del informe de excepciones para un contacto específico. Reemplaza [Contact Name] con el nombre exacto del contacto tal como aparece en su perfil de usuario de Salesforce:

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 Google Cloud
3. Crear recursos de Microsoft Azure
4. Crear la aplicación de Slack
5. Configurar Cloud Datastore
6. Configurar variables del proyecto
7. Probar conexiones
8. Desplegar el proyecto
9. Crear APIs personalizadas de Jitterbit
10. Completar la autorización de Gmail OAuth
11. Revisar flujos de trabajo del proyecto
12. 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 Jitterbit Account Intelligence 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 los 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á Obtenga este 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.

5. En el paso de configuración 1, Descargar Personalizaciones, descargue el archivo de manifiesto de la aplicación de Slack proporcionado. Usará este archivo al crear la aplicación de Slack.

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, use el enlace del diálogo Ir a Studio o abra el proyecto directamente desde la página de Proyectos de Studio.

Configurar Google Cloud

El agente requiere dos tipos de credenciales de Google: credenciales de OAuth 2.0 para acceso a Gmail y una Cuenta de Servicio para acceso a Google Docs.

Configurar Gmail OAuth

La autenticación de Gmail utiliza OAuth 2.0. Cada entorno de implementación requiere sus propias credenciales de OAuth porque la URI de redirección es específica del entorno.

Siga estos pasos para cada entorno donde implemente el agente:

1. Implemente primero el proyecto de Studio y anote la URL base de la API Gateway desde API Manager > Mis APIs. Esta URL es necesaria al registrar la URI de redirección de OAuth en Google Cloud.

2. En Google Cloud Console, abre tu proyecto o crea uno nuevo para esta integración.

3. Habilita las siguientes APIs en APIs y Servicios > Biblioteca:

   • API de Gmail
   • API de Google Drive

4. Configura la pantalla de consentimiento de OAuth en APIs y Servicios > Pantalla de consentimiento de OAuth. Selecciona Interno si la cuenta de Gmail dedicada pertenece a una organización de Google Workspace. Selecciona Externo para una cuenta de Gmail personal. Agrega los siguientes alcances de OAuth:

   • https://www.googleapis.com/auth/gmail.readonly
   • https://www.googleapis.com/auth/drive.readonly

5. Crea un ID de Cliente de OAuth 2.0 en APIs y Servicios > Credenciales. Selecciona Aplicación web como tipo de aplicación.

6. En el campo URIs de redirección autorizados, agrega la URL del endpoint /oauth/callback utilizando la URL base de la API Gateway anotada en el paso 1, en el formato: https://<tu-organización>.jitterbit.com/oauth/callback.

7. Copia el ID de Cliente y el Secreto de Cliente generados. Almacénalos de forma segura e ingrésalos como variables del proyecto cuando configures las variables del proyecto.

Configurar una Cuenta de Servicio de Google Docs

El acceso a Google Docs utiliza una Cuenta de Servicio en lugar de credenciales de usuario OAuth.

Sigue estos pasos:

1. En Google Cloud Console, abre el mismo proyecto utilizado para Gmail OAuth o crea uno nuevo.

2. Habilita la API de Google Docs en APIs y Servicios > Biblioteca.

3. En IAM y Admin > Cuentas de Servicio, haz clic en Crear Cuenta de Servicio. Ingresa un nombre y una descripción, luego haz clic en Crear y Continuar.

4. Asigna un rol apropiado a la cuenta de servicio (por ejemplo, Visualizador), luego haz clic en Listo.

5. Haz clic en la cuenta de servicio para abrir sus detalles, luego selecciona la pestaña Claves.

6. Haz clic en Agregar clave > Crear nueva clave, selecciona JSON y haz clic en Crear. Guarda el archivo de clave JSON descargado de forma segura.

7. Desde el archivo de clave JSON, copia los valores de client_email y private_key. Ingrésalos como variables del proyecto cuando configures las variables del proyecto.

Crear recursos de Microsoft Azure

Crea los siguientes recursos de Microsoft Azure y anota la 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.

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

Anota el nombre del despliegue, la URL del endpoint y la clave API. Ingresa estos valores cuando configures las variables del proyecto.

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 y la clave API.

3. En el menú de navegación bajo Recursos compartidos, selecciona Despliegues. Copia el nombre del despliegue.

Crear la aplicación de Slack

Para habilitar la interfaz de Slack del agente, sigue estos pasos:

1. Crea una aplicación de Slack utilizando el archivo de manifiesto descargado en Descargar e instalar el proyecto. El manifiesto preconfigura el usuario del bot (mostrado como Account Wingman Assistant), los alcances de OAuth y las suscripciones de eventos para el Agente de Inteligencia de Cuenta. Instala la aplicación en tu espacio de trabajo de Slack.

2. Obtén el token del bot y conservalo para la variable del proyecto Bot_oauth_user_token.

3. Agrega un comando de barra de Slack a la aplicación, apuntando la URL de solicitud al endpoint de API personalizado /connect-gmail. Este comando permite a un administrador activar el flujo de autorización de OAuth de Gmail directamente desde Slack.

Configurar Cloud Datastore

El agente utiliza tres almacenamientos de claves de Cloud Datastore para gestionar credenciales de OAuth, deduplicar reuniones procesadas y almacenar detalles de notificación de usuarios:

Crea los siguientes almacenes de claves en Jitterbit Cloud Datastore:

AIA_Authorized_Users

Crea un almacenamiento de claves llamado AIA_Authorized_Users y agrega los siguientes campos personalizados:

• email (texto)
• refresh_token (texto)
• created_at (texto)

AIA_Processed_Meetings

Crea un almacenamiento de claves llamado AIA_Processed_Meetings y agrega los siguientes campos personalizados:

• doc_id (texto)
• processed_at (texto)

AIA_Notification_User_details

Crea un almacenamiento de claves llamado AIA_Notification_User_details y agrega los siguientes campos personalizados:

• SlackChannel (texto)
• SlackuserID (texto)

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 Project Variables para abrir el panel de configuración.

Habilita Mask Value para todos los campos de credenciales y tokens.

Salesforce

Azure OpenAI

Cloud Datastore

Slack

Gmail y Google

Probar conexiones

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

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 y selecciona Desplegar.

Crear APIs personalizadas de Jitterbit

El agente requiere tres APIs personalizadas. Crea cada una utilizando la opción Publicar como una API.

Controlador de eventos de Slack

Crea una API personalizada para la operación Solicitud del Bot de Slack en el flujo de trabajo Entrada Principal - Controlador de Solicitudes de API de Slack.

Configura estos ajustes para el servicio:

Después de publicar, copia la URL del servicio API y pégala en el campo Suscripciones de eventos > URL de solicitud de tu aplicación de Slack.

Puntos finales de OAuth de Gmail

Crea dos APIs personalizadas adicionales para el flujo de OAuth de Gmail:

punto final connect-gmail — activa la pantalla de consentimiento de Google OAuth para un administrador:

punto final oauth/callback — recibe el código de autorización después de que Google redirige de vuelta:

Después de publicar ambos puntos finales, regresa a Google Cloud Console y confirma que la URI de redirección autorizada para tu ID de cliente de OAuth 2.0 coincide exactamente con la URL /oauth/callback.

Completar la autorización de OAuth de Gmail

Después de que las API estén desplegadas, ejecuta el flujo de autorización OAuth para generar y almacenar el token de actualización de Gmail:

1. Activa el endpoint de la API /connect-gmail. Puedes hacerlo desde un navegador, utilizando el comando slash de Slack configurado en Crear la aplicación de Slack, o llamando al endpoint directamente.

2. Inicia sesión con la cuenta de Gmail dedicada para notas de reuniones y concede los permisos solicitados para Gmail y Google Drive en la pantalla de consentimiento de Google.

3. Google redirige al endpoint /oauth/callback. El agente intercambia el código de autorización por tokens de acceso y de actualización, y almacena el token de actualización en el almacenamiento de claves AIA_Authorized_Users de Cloud Datastore automáticamente.

4. En el proyecto de Studio, abre Variables del Proyecto y confirma que refresh_token ahora tiene un valor no vacío. Si sigue en blanco, revisa los registros de operaciones de OAuth Callback y Exchange Token en busca de errores.

Revisar flujos de trabajo del proyecto

El proyecto de Studio contiene 6 flujos de trabajo que implementan la funcionalidad del Agente de Inteligencia de Cuenta, organizados en tres grupos funcionales.

Manejo de solicitudes

Entrada Principal - Manejador de Solicitudes de API de Slack

Este flujo de trabajo es activado por la API personalizada de Jitterbit cada vez que un usuario envía un mensaje al bot de Slack. Gestiona las solicitudes entrantes del bot de Slack y mantiene el almacenamiento de claves AIA_Notification_User_details de Cloud Datastore para mantener los detalles del usuario de Slack disponibles para los flujos de trabajo de notificación por correo electrónico programados. Después de enrutar la solicitud, este flujo de trabajo pasa la información requerida al flujo de trabajo Principal - Lógica de Herramientas del Agente de IA.

Main - AI Agent Tools Logic

Este flujo de trabajo recibe la solicitud entrante del flujo de trabajo Main Entry - Slack API Request Handler, la analiza utilizando el LLM para identificar la función prevista y prepara una carga útil para invocar el flujo de trabajo de la herramienta de agente apropiada. Este flujo de trabajo también gestiona todas las solicitudes de LLM y captura las respuestas de LLM para su uso posterior.

Monitoreo de cuentas

Agente - Monitoreo de Tareas Abiertas

Este flujo de trabajo recupera tareas abiertas de Salesforce para el usuario que envió la solicitud de Slack. La operación maestra (SF_Open_Task_Monitoring) verifica un ID de usuario de Slack, llama a la operación Obtener Perfil de Usuario de Slack para obtener la dirección de correo electrónico del usuario, consulta Salesforce para el registro de usuario correspondiente y luego recupera todas las tareas con un estado de "No Iniciado" que caen dentro de los últimos 7 días y los próximos 30 días.

Agente - Monitoreo de Reportes de Excepción

Este flujo de trabajo recupera reportes de excepción de una carpeta de Salesforce configurada. Para autenticar directamente con la API de Salesforce, primero obtiene un token de acceso de Salesforce a través de OAuth. Luego, mapea el correo electrónico de Slack del usuario solicitante a su registro de usuario de Salesforce, recupera la lista de reportes de la carpeta especificada por la variable de proyecto SF_Folder_Id y obtiene los detalles de cada reporte relevante para construir la respuesta final.

Notas de reuniones y notificaciones

Agente - Notas de Reunión

Este flujo de trabajo maneja todo el proceso de notas de reuniones. Un administrador activa el flujo OAuth de Gmail a través del punto final de la API /connect-gmail. El flujo de trabajo intercambia el código de autorización por tokens OAuth y almacena el token de actualización en el almacenamiento de claves AIA_Authorized_Users de Cloud Datastore. En cada ejecución programada, el flujo de trabajo se autentica con Gmail, consulta la bandeja de entrada en busca de correos electrónicos de notas de reunión del remitente configurado y extrae el enlace de Google Doc de cada correo electrónico. Verifica el almacenamiento de claves AIA_Processed_Meetings para omitir cualquier documento ya procesado. Para documentos nuevos, recupera el contenido de Google Docs, lo envía al LLM para extraer asistentes y elementos de acción, busca el ID de contacto de Salesforce de cada asistente y crea registros de Tarea y Evento en Salesforce. Cada asistente también recibe un mensaje directo en Slack con el resumen de la reunión y sus elementos de acción asignados.

Herramienta - Correo Electrónico de Notificación de Horarios

Este flujo de trabajo se ejecuta según un horario para entregar resúmenes diarios de tareas e informes a todos los usuarios registrados en el almacenamiento de claves AIA_Notification_User_details de Cloud Datastore. Para cada usuario, llama a la operación Obtener Perfil de Usuario de Slack para confirmar que el usuario tiene una dirección de correo electrónico asociada, invoca la operación Lógica Principal-AI para compilar tareas abiertas e informes en un formato de correo electrónico y envía el resumen tanto al canal de Slack del usuario como a su dirección de correo electrónico.

Activar los flujos de trabajo del proyecto

El flujo de trabajo Main Entry - Slack API Request Handler se activa automáticamente cuando los usuarios envían mensajes al bot de Slack. No se requiere ninguna operación manual para iniciar interacciones bajo demanda.

Los flujos de trabajo Agent - Meeting Notes y Tool - Schedules Notification Email deben configurarse para ejecutarse en programas de operaciones. Dos programas tienen requisitos específicos:

• Agent - Meeting Notes: Programa para ejecutarse con una frecuencia que coincida con su cadencia de reuniones. Ejecutarlo varias veces al día es seguro porque los ID de documentos procesados se rastrean en Cloud Datastore para evitar registros duplicados.
• Tool - Schedules Notification Email: Programa para ejecutarse una vez al día. La consulta predeterminada recupera datos limitados al día actual, por lo que ejecutarlo más de una vez al día devuelve resultados duplicados.

Para configurar un programa, abra el menú de acciones de la operación y seleccione Configuración > Programas.

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 operaciones

Para errores de OAuth de Gmail, verifique los registros de operación OAuth Callback y Exchange Token. Confirme que la URI de redirección en Google Cloud Console coincida exactamente con la URL de API Gateway desplegada /oauth/callback, sin barra diagonal al final.

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