Agente de Inteligencia de Cuentas de Jitterbit

Descripción general

Jitterbit proporciona el Agente de Inteligencia de Cuentas a clientes a través de Jitterbit Marketplace. Este agente ayuda a los representantes de cuentas a gestionar sus carteras de forma más eficaz proporcionando una lista diaria de tareas de cuenta priorizadas y procesando automáticamente notas de reuniones en registros de Salesforce procesables. El agente monitorea Salesforce en busca de tareas abiertas e informes de oportunidades, procesa notas de reuniones recuperadas de Gmail y entrega resultados mediante 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 información relevante de Salesforce. Para notas de reuniones, el agente consulta una bandeja de entrada de Gmail dedicada en busca de correos electrónicos con enlaces de Google Docs, extrae elementos de acción y asistentes utilizando un LLM, y crea registros de Tarea y Evento correspondientes 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 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 realiza la solicitud, 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 realiza la solicitud.
• Consulta una bandeja de entrada de Gmail dedicada en busca de correos electrónicos con notas de reuniones del remitente configurado, recupera el Google Doc vinculado y extrae elementos de acción y asistentes utilizando un LLM.
• Crea registros de Tarea y Evento de 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 usuarios registrados que contengan sus tareas abiertas y resúmenes de informes.

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

Arquitectura del agente de IA

Este agente de IA expone inteligencia de cuentas a través de una interfaz de Slack conversacional 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 en busca de 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 nuevamente al usuario en Slack.

Procesamiento de notas de reuniones

El procesamiento de notas de reuniones 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 reuniones configurado.
2. Para cada correo electrónico nuevo, el agente extrae el enlace de Google Doc y comprueba Cloud Datastore para confirmar que el documento no ha sido procesado ya.
3. El agente recupera el contenido del Google Doc y lo envía al LLM, que extrae asistentes de reuniones y 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 componentes principales y los flujos de datos del Agente de Inteligencia de Cuentas.

Requisitos previos

Necesitas los siguientes componentes para usar este agente de IA.

Componentes de Harmony

Debe 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 procesadas y detalles de notificaciones de usuarios.
• Jitterbit Account Intelligence Agent adquirido como complemento de licencia.

Puntos finales compatibles

El agente de IA se conecta a los siguientes puntos finales. Puede adaptarse a otros sistemas modificando las configuraciones de puntos finales y flujos de trabajo del proyecto.

Modelo de lenguaje grande (LLM)

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

Sistema CRM

El agente lee y escribe registros en Salesforce. Para usar Salesforce, 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 sondear una bandeja de entrada dedicada en busca de correos electrónicos con 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, 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 dedicada de Gmail para las notas de reuniones.

Plataforma de mensajería

El agente utiliza Slack como su interfaz conversacional y canal de notificaciones. Para usar Slack, debe tener un espacio de trabajo de Slack con una aplicación de Slack configurada para recibir y responder a mensajes. Para obtener instrucciones detalladas sobre cómo crear una aplicación de Slack, consulte 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 procesadas a fin de evitar procesamiento duplicado y mantener detalles de usuarios para notificaciones de correo electrónico programadas. Cloud Datastore forma parte de la plataforma Jitterbit Harmony y no requiere una cuenta de servicio separada, pero la cantidad de almacenamientos de claves disponibles depende del nivel de Cloud Datastore adquirido por su organización.

Solicitudes del agente

El Agente de Inteligencia de Cuenta recibe solicitudes bajo demanda como mensajes en lenguaje natural enviados a la aplicación de Slack. Esta sección describe las reglas para solicitudes efectivas y proporciona solicitudes de ejemplo.

Directrices de solicitudes

Siga estas directrices al enviar mensajes al agente:

• Las solicitudes se limitan al usuario que envía el mensaje. El agente recupera tareas e informes asociados con su cuenta de usuario de Salesforce, según su 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 anteriores a 7 días.
• Para consultas de tareas filtradas por fecha, incluya la fecha objetivo en su mensaje usando un formato de fecha reconocible (por ejemplo, "antes del 30 de abril" o "antes del 2026-04-30").
• Para consultas de informes, proporcione el nombre exacto del contacto de Salesforce tal como aparece en su perfil de usuario de Salesforce.

Solicitudes de ejemplo

Las siguientes solicitudes de ejemplo muestran los tipos de solicitudes que el agente puede manejar. Reemplace [Date] con su fecha objetivo.

Tareas abiertas

Utilice estas solicitudes para recuperar sus tareas abiertas de Salesforce:

Reportes

Usa este mensaje para recuperar los detalles del reporte de excepciones de 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 Slack
5. Configurar Cloud Datastore
6. Configurar las variables del proyecto
7. Probar conexiones
8. Implementar el proyecto
9. Crear API personalizadas de Jitterbit
10. Completar la autorización de OAuth de Gmail
11. Revisar los flujos de trabajo del proyecto
12. Activar los flujos de trabajo del proyecto

Para obtener orientación sobre solución de problemas, consulta Solución de problemas.

Descargar e instalar 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 Jitterbit Account Intelligence Agent. Para encontrar el agente, usa 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 this agent. Haz clic en él para abrir un diálogo informativo y luego haz clic en Submit para que un representante se comunique contigo sobre la compra del agente de IA.

5. En el paso de configuración 1, Download Customizations, descarga el archivo de manifiesto de la aplicación Slack proporcionado. Usarás este archivo cuando crees la aplicación Slack.

6. Haz clic en Next.

7. En el paso de configuración 2, Create a New Project, selecciona un ambiente 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, usa el enlace del diálogo Go to Studio o abre el proyecto directamente desde la página Projects 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 OAuth de Gmail

La autenticación de Gmail utiliza OAuth 2.0. Cada ambiente de implementación requiere sus propias credenciales de OAuth porque el URI de redirección es específico del ambiente.

Sigue estos pasos para cada ambiente donde implementes el agente:

1. Implementa primero el proyecto de Studio y toma nota de la URL base de API Gateway desde API Manager > My APIs. Esta URL es necesaria al registrar el 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 API bajo APIs & Services > Library:

   • Gmail API
   • Google Drive API

4. Configura la pantalla de consentimiento de OAuth bajo APIs & Services > OAuth consent screen. Selecciona Internal si la cuenta de Gmail dedicada pertenece a una organización de Google Workspace. Selecciona External para una cuenta personal de Gmail. 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 bajo APIs & Services > Credentials. Selecciona Web application como el tipo de aplicación.

6. En el campo Authorized redirect URIs, agrega la URL del endpoint /oauth/callback usando la URL base de API Gateway anotada en el paso 1, con el formato: https://<your-org>.jitterbit.com/oauth/callback.

7. Copia el Client ID y el Client Secret generados. Guárdalos de forma segura e introdúcelos como variables de proyecto cuando configures las variables de proyecto.

Configura una cuenta de servicio de Google Docs

El acceso a Google Docs utiliza una cuenta de servicio en lugar de credenciales de OAuth de usuario.

Sigue estos pasos:

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

2. Habilita la Google Docs API en APIs & Services > Library.

3. En IAM & Admin > Service Accounts, haz clic en Create Service Account. Ingresa un nombre y descripción, luego haz clic en Create and Continue.

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

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

6. Haz clic en Add Key > Create new key, selecciona JSON y haz clic en Create. Guarda el archivo de clave JSON descargado de forma segura.

7. Del archivo de clave JSON, copia los valores de client_email y private_key. Introdúcelos como variables de proyecto cuando configures las variables de proyecto.

Crea 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 administrar estos recursos, debes tener una suscripción de Microsoft Azure con los permisos apropiados.

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

Anota el nombre de la implementación, la URL del punto de conexión y la clave de API. Ingresa estos valores cuando configures las variables de 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 destino del recurso, copia la URL del punto de conexión y la clave de API.

3. En el menú de navegación en Shared resources, selecciona Deployments. Copia el nombre de la implementación.

Crea la aplicación de Slack

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

1. Crea una aplicación de Slack usando el archivo de manifiesto descargado en Descarga e instala el proyecto. El manifiesto preconfiguran el usuario del bot (mostrado como Account Wingman Assistant), los alcances de OAuth y las suscripciones a eventos para el agente de Account Intelligence. Instala la aplicación en tu espacio de trabajo de Slack.

2. Obtén el token del bot y consérva lo para la variable de proyecto Bot_oauth_user_token.

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

Configura Cloud Datastore

El agente utiliza tres almacenamientos de claves de Cloud Datastore para administrar credenciales de OAuth, desduplicar reuniones procesadas y almacenar detalles de notificaciones de usuario:

Crea los siguientes almacenamientos de claves en Jitterbit Cloud Datastore. Los campos Key, AlternativeKey y Value están presentes de forma predeterminada.

AIA_Authorized_Users

Crear un almacenamiento de claves llamado AIA_Authorized_Users. No se requieren campos personalizados.

AIA_Processed_Meetings

Crear un almacenamiento de claves llamado AIA_Processed_Meetings. No se requieren campos personalizados.

AIA_Notification_User_details

Crear un almacenamiento de claves llamado AIA_Notification_User_details. Agregar los siguientes campos personalizados:

Configurar variables del proyecto

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

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

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

Salesforce

Azure OpenAI

Cloud Datastore

Slack

Gmail y Google

Probar conexiones

Prueba las configuraciones del punto de conexión para verificar la conectividad usando los valores de variable del proyecto definidos.

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

Implementar el proyecto

Implementa el proyecto de Studio.

Para implementar el proyecto, utiliza el menú de acciones del proyecto y selecciona Implementar.

Crear API personalizadas de Jitterbit

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

Controlador de eventos de Slack

Crea una API personalizada para la operación Slack Bot Request en el flujo de trabajo Main Entry - Slack API Request Handler.

Configura estos parámetros para el servicio:

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

Extremos de OAuth de Gmail

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

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

Extremo oauth/callback — recibe el código de autorización después de que Google redirija:

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

Completa la autorización de OAuth de Gmail

Después de que se implementen las APIs, ejecuta el flujo de autorización de OAuth para generar y almacenar el token de actualización de Gmail:

1. Activa el extremo de API /connect-gmail. Puedes hacerlo desde un navegador, usando el comando de barra de Slack configurado en Crea la aplicación de Slack, o llamando al extremo directamente.

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

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

4. En el proyecto de Studio, abre Project Variables y confirma que refresh_token ahora tiene un valor no vacío. Si aún está en blanco, verifica los registros de operaciones de OAuth Callback e Exchange Token para detectar errores.

Revisa los flujos de trabajo del proyecto

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

Gestión de solicitudes

Main Entry - Slack API Request Handler

Este flujo de trabajo se activa mediante la API personalizada de Jitterbit cada vez que un usuario envía un mensaje al bot de Slack. Gestiona solicitudes del bot de Slack entrantes y mantiene el almacenamiento de clave Cloud Datastore AIA_Notification_User_details para mantener disponibles los detalles del usuario de Slack para flujos de trabajo de notificación de correo electrónico programados. Después de enrutar la solicitud, este flujo de trabajo pasa la información requerida al flujo de trabajo Main - AI Agent Tools Logic.

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 usando el LLM para identificar la función prevista y prepara una carga para invocar el flujo de trabajo de herramienta de agente apropiado. Este flujo de trabajo también gestiona todas las solicitudes de LLM y captura respuestas de LLM para uso posterior.

Monitoreo de cuentas

Agent - Open Task Monitoring

Este flujo de trabajo recupera tareas abiertas de Salesforce para el usuario que envió la solicitud desde Slack. La operación maestra (SF_Open_Task_Monitoring) verifica un ID de usuario de Slack, llama a la operación Get Slack User Profile para obtener la dirección de correo electrónico del usuario, consulta Salesforce para encontrar el registro de usuario coincidente y luego recupera todas las tareas con estado "Not Started" que se encuentren dentro de los últimos 7 días y los próximos 30 días.

Agent - Exception Report Monitor

Este flujo de trabajo recupera reportes de excepciones de una carpeta configurada en Salesforce. Para autenticarse 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 en 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

Agent - Meeting Notes

Este flujo de trabajo gestiona la canalización completa de notas de reuniones. Un administrador activa el flujo de OAuth de Gmail a través del punto de conexión de API /connect-gmail. El flujo de trabajo intercambia el código de autorización por tokens de OAuth y almacena el token de actualización en el almacenamiento de clave 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 de notas de reunión del remitente configurado y extrae el enlace de Google Docs de cada correo. Verifica el almacenamiento de clave 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 tareas y eventos en Salesforce. Cada asistente también recibe un mensaje directo de Slack con el resumen de la reunión y sus elementos de acción asignados.

Tool - Schedules Notification Email

Este flujo de trabajo se ejecuta según un cronograma para entregar resúmenes diarios de tareas y reportes a todos los usuarios registrados en el almacenamiento de clave AIA_Notification_User_details de Cloud Datastore. Para cada usuario, llama a la operación Get Slack User Profile para confirmar que el usuario tiene una dirección de correo electrónico asociada, invoca la operación Main-AI Logic para compilar tareas abiertas y reportes 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 workflows del proyecto

El workflow 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.

Estos workflows deben configurarse para ejecutarse una vez al día usando cronogramas de operaciones:

• Agent - Exception Report Monitor

• Agent - Meeting Notes

  Nota

  Solo la operación Query Token en este workflow requiere un cronograma. Configúrala para ejecutarse una vez al día.

• Agent - Open Task Monitoring

• Tool - Schedules Notification Email

  Nota

  La consulta predeterminada recupera datos del día actual, por lo que ejecutarla más de una vez al día devuelve resultados duplicados.

Para configurar un cronograma, abre el menú de acciones de la operación y selecciona Settings > Schedules.

Solución de problemas

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

• Registros de API
• Registros de operaciones

Para errores de OAuth de Gmail, consulta los registros de operaciones OAuth Callback e Exchange Token. Confirma que el URI de redirección en Google Cloud Console coincida exactamente con la URL de API Gateway /oauth/callback implementada, sin barra diagonal final.

Para obtener asistencia adicional, contacta al soporte de Jitterbit.