Saltar al contenido

Agente de RH Jitterbit

Descripción general

Jitterbit proporciona el Agente de RH a los clientes a través de Jitterbit Marketplace. Este agente está diseñado para apoyar al equipo interno de RH de tu organización. 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 de IA realiza las siguientes funciones:

  • Se conecta a BambooHR u otros Sistemas de Información de Recursos Humanos (HRIS) para recuperar datos de incorporación en tiempo real para nuevas contrataciones usando Jitterbit Studio.

  • Se conecta a Jira (u otras soluciones de gestión de servicios y trabajo) para iniciar y hacer un seguimiento de solicitudes.

  • Se integra con un LLM para potenciar un Asistente de IA de RH inteligente al que accedes a través de una API personalizada creada con Jitterbit API Manager.

Este documento explica cómo configurar y operar este agente de IA. Cubre arquitectura y requisitos previos, ejemplos de indicaciones que muestran lo que puede hacer el agente, y pasos para instalar, configurar y operar el agente de IA.

Arquitectura del agente de IA

Los siguientes diagramas muestran la arquitectura implementada en el Agente de RH.

Pre-incorporación (Antes del primer día)

--- config: themeVariables: lineColor: '#6b7280' edgeLabelBackground: '#f5f5f5' flowchart: padding: 30 nodeSpacing: 80 rankSpacing: 50 --- graph %% Path 1 NFHT("Notify hiring team (offer signed)") CHHU("Candidate hired, HCM updated") ITES("Informing hiring team through email and Slack") UECV("Understand employee from their CV") IOBF("Include onboarding form") CRWE("Create welcome email for approval") MGTA{"Manager team approval"} SEDH("Send the email") %% Path 2 ITSP("IT setup and preferences (ITSM)") CFTF("Candidate fills the form") ACOF("Analyze company onboarding files") CITT("Create IT ticket") IHAI("Inform HR and IT") %% Path 3 WBDS("Week before document submission") FESN("Find employee starting next week") SAUT("Send automated email with onboarding details (company culture, benefits, etc.)") SNMH("Send notification to the manager and HR") subgraph BOUNDARY[ ] direction LR NFHT ITSP WBDS %% Path 1 CHHU --> ITES IOBF --> CRWE NFHT ---> ITES ITES --> UECV UECV --> CRWE CRWE --> MGTA MGTA -->|Yes| SEDH SEDH --> SEDH_END([End]) MGTA --->|No| MGTA_END([End]) %% Path 2 CFTF --> ACOF ITSP ---> ACOF ACOF --> CITT CITT --> IHAI IHAI ----> IHAI_END([End]) %% Path 3 FESN --> SAUT WBDS ---> SAUT SAUT --> SNMH SNMH -----> SNMH_END([End]) end classDef default fill:white, stroke:black, stroke-width:3px, rx:15px, ry:15px classDef Plain fill:white, stroke:none, stroke-width:3px, rx:15px, ry:15px classDef Dotted stroke:black, stroke-dasharray: 8 4 class BOUNDARY Plain

Incorporación del primer día

--- config: themeVariables: lineColor: '#6b7280' edgeLabelBackground: '#f5f5f5' flowchart: padding: 30 nodeSpacing: 80 rankSpacing: 50 --- graph %% Path 1 FDIT("First day introductions") FEST_A("Find employee starting today") SEWI("Send email with introduction to departments, company and onboarding documents") SNTM("Send notification to the manager") %% Path 2 LIPO("LinkedIn post") FEST_B("Find employee starting today") DPLP("Draft a personalized LinkedIn post") STEE("Send it to employee via email") subgraph BOUNDARY[ ] FDIT LIPO %% Path 1 FEST_A --> SEWI FDIT ---> SEWI SEWI --> SNTM SNTM --> SNTM_END([End]) %% Path 2 FEST_B --> DPLP LIPO ---> DPLP DPLP --> STEE STEE --> STEE_END([End]) end classDef default fill:white, stroke:black, stroke-width:3px, rx:15px, ry:15px classDef Plain fill:white, stroke:none, stroke-width:3px, rx:15px, ry:15px classDef Dotted stroke:black, stroke-dasharray: 8 4 class BOUNDARY Plain

Primeras semanas y capacitación

--- config: themeVariables: lineColor: '#6b7280' edgeLabelBackground: '#f5f5f5' flowchart: padding: 30 nodeSpacing: 80 rankSpacing: 50 --- graph %% Path 1 PLPH("Personalized learning path") FEST_A("Find employee starting today") CPLR("Create personalized learning based on role") STVE("Send it to employee via email") %% Path 2 IPIT("In progress IT tickets") FEST_B("Find employee on first week") FIPI("Find in-progress IT tickets for employees who started working already") IPTF{"In-progress ticket found?"} IHAI("Inform HR and IT") SEMH("Send employee message asking if any help needed") subgraph BOUNDARY[ ] PLPH IPIT %% Path 1 FEST_A --> CPLR PLPH ---> CPLR CPLR --> STVE STVE ----> STVE_END([End]) %% Path 2 FEST_B --> FIPI FIPI --> IPTF IPIT ---> FIPI IPTF ---->|No| IPTF_END([End]) IPTF -->|Yes| IHAI IHAI --> SEMH SEMH --> SEMH_END([End]) end classDef default fill:white, stroke:black, stroke-width:3px, rx:15px, ry:15px classDef Plain fill:white, stroke:none, stroke-width:3px, rx:15px, ry:15px classDef Dotted stroke:black, stroke-dasharray: 8 4 class BOUNDARY Plain

Uso general

--- config: themeVariables: lineColor: '#6b7280' edgeLabelBackground: '#f5f5f5' flowchart: padding: 30 nodeSpacing: 80 rankSpacing: 50 --- graph %% Path ERHT("Employee remaining HR tasks") FEHT("Find employee with HR tasks") FEDH("Filter employee +/- 90 days from hire date") STFH("Split tasks for HR assigned and employee assigned") SNTE("Send notification to employee") SNTH("Send notification to HR") subgraph BOUNDARY[ ] ERHT %% Path ERHT --> FEHT FEHT --> FEDH FEDH --> STFH STFH --> SNTE SNTE --> SNTE_END([End]) STFH --> SNTH SNTH --> SNTH_END([End]) end classDef default fill:white, stroke:black, stroke-width:3px, rx:15px, ry:15px classDef Plain fill:white, stroke:none, stroke-width:3px, rx:15px, ry:15px classDef Dotted stroke:black, stroke-dasharray: 8 4 class BOUNDARY Plain

Requisitos previos

Para usar el Agente de RH, necesitas los siguientes componentes.

Componentes de Harmony

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

Puntos de conexión soportados

El diseño del agente de IA incorpora los siguientes puntos de conexión. Puedes adaptar otros sistemas modificando las configuraciones de puntos de conexión y flujos de trabajo del proyecto.

Sistema de Información de Recursos Humanos (HRIS)

El agente de IA utiliza BambooHR como fuente de datos de empleados, incluyendo tareas requeridas, documentos e información del trabajo.

Nota

Debes tener los permisos apropiados en tu HRIS para crear claves de API y acceder a los datos requeridos para esta integración.

Modelo de lenguaje grande (LLM)

El agente de IA utiliza OpenAI como proveedor de LLM. Para usar OpenAI, debes tener una suscripción a OpenAI para crear y administrar una clave de API de OpenAI. Consulta la guía de OpenAI para obtener más información.

Gestión de servicios

El agente de IA utiliza Jira como sistema de gestión de servicios y trabajo para la creación de tickets.

Documentación

El agente de IA utiliza Confluence como fuente de documentación de TI.

Interfaz de chat

El diseño del agente de IA incorpora Slack como interfaz de chat para interactuar con el agente de IA.

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

Funciones principales

Cuando conectas el Agente de RH a los puntos de conexión apropiados, proporciona la siguiente funcionalidad principal.

Pre-incorporación de empleados

  • Notifica al equipo de contratación sobre una oferta aceptada.
  • Crea un correo de bienvenida y solicita aprobación para enviarlo al nuevo empleado.
  • Notifica al nuevo empleado sobre tareas requeridas y documentación asignada según la ley local y regulación de residencia del candidato.
  • Crea un ticket para la incorporación de TI, especificando equipos, aplicaciones y grupos de correo requeridos.

Incorporación del primer día

  • Proporciona una introducción al gerente, equipo y otros contactos útiles en toda la organización.
  • Hace un seguimiento de tareas pendientes para el nuevo empleado, equipos de RH e TI, y proporciona actualizaciones a medida que se completan las tareas.
  • Ofrece asistencia si los pasos de incorporación permanecen incompletos después de un período especificado de tiempo.
  • Proporciona una interfaz de chat dedicada para que los nuevos empleados hagan preguntas relacionadas con la incorporación y soliciten apoyo. El agente de IA puede enviar tickets de servicio de TI en nombre del usuario.

Primeras semanas y capacitación

  • Proporciona una ruta de aprendizaje personalizada según el departamento.

Ejemplos de indicaciones

A continuación se presentan ejemplos de indicaciones que el Agente de HR puede manejar con acceso a los datos apropiados.

  • "¿Quién es mi gerente?"
  • "¿Quién está fuera la próxima semana?"
  • "¿Quién estuvo fuera la semana pasada?"
  • "¿Quién está fuera mañana?"
  • "¿[Insertar nombre] está fuera hoy?"
  • "¿Cómo restablezco mi contraseña?"
  • "Necesito ayuda para configurar mi computadora."
  • "¿Puedes ayudarme a configurar mi cuenta de correo electrónico?"
  • "Mi ratón está roto. ¿Qué debo hacer?"
  • "Mi laptop no se carga. ¿Qué debo hacer?"
  • "Necesito un nuevo ratón. ¿Puedes crear un ticket para mí?"

Instalación, configuración y operación

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

  1. Descarga las personalizaciones e instala el proyecto de Studio.
  2. Prepara BambooHR.
  3. Prepara Jira.
  4. Crea un formulario de Google.
  5. Crea la aplicación de Slack.
  6. Prepara Jitterbit Cloud Datastore.
  7. Configura las variables del proyecto.
  8. Prueba las conexiones.
  9. Agrega plantillas de correo electrónico.
  10. Crea cronogramas.
  11. Implementa el proyecto.
  12. Crea la API personalizada de Jitterbit.
  13. Revisa los flujos de trabajo del proyecto.
  14. Desencadena los flujos de trabajo del proyecto.
  15. Solución de problemas.
  16. Uso diferente del endpoint.

Descarga las personalizaciones e instala el proyecto

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

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

  2. Localiza el agente de IA denominado Jitterbit HR Agent. Para localizar el agente, puedes usar la barra de búsqueda o, en el panel Filtros bajo Tipo, selecciona Agente de IA para filtrar la visualización y mostrar solo los agentes de IA disponibles.

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

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

    Nota

    Si aún no has comprado el agente de IA, aparece Obtener agente. Haz clic en Obtener agente para abrir un cuadro de diálogo informativo y luego haz clic en Enviar para solicitar 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 introducir la estructura de los archivos CSV, crear la aplicación de Slack y crear el script de la aplicación de Google Form. Selecciona los archivos y haz clic en Descargar archivos:

    • Script de aplicación de Google Form

      • googleForm_appScript.js
    • Archivos de plantilla CSV

      • TEMPLATE - IT_Apps_JobRole.csv
      • TEMPLATE - IT_G-Suite Groups.csv
      • TEMPLATE - IT_LaptopChoice_JobRole.csv
      • TEMPLATE - HR Agent Onboarding Courses - Job Role.csv
    • Archivo de manifiesto de la aplicación de Slack

      • slack_app_manifest.json

    Consejo

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

  6. Haz clic en Siguiente.

  7. En el paso de configuración 2, Crear un nuevo proyecto, selecciona un entorno donde deseas crear el proyecto de Studio y luego haz clic en Crear proyecto.

  8. Se muestra un cuadro de diálogo de progreso. Después de que indique que el proyecto se ha creado, usa el enlace del cuadro de diálogo Ir a Studio o abre el proyecto directamente desde la página Proyectos de Studio.

Preparar BambooHR

Se deben crear los siguientes componentes esenciales en BambooHR para el HR Agent. Estos componentes son necesarios para recuperar la información requerida para la ejecución del flujo de trabajo.

Crear carpetas en BambooHR

Crea las siguientes carpetas en BambooHR. El HR Agent utiliza estas carpetas para encontrar los recursos relevantes para la funcionalidad del flujo de trabajo.

  1. Desde tu panel de BambooHR, abre la sección Files (Archivos).

  2. Haz clic en + Add Folder (+ Agregar carpeta).

  3. En el cuadro de diálogo, ingresa uno de los siguientes nombres de carpeta:

    • Training Documents
    • Onboarding Documents (ALL)
    • IT Documents
  4. Haz clic en Save (Guardar) o Create (Crear) para crear la carpeta.

  5. Repite los pasos 2-4 para cada carpeta restante.

Agregar archivos a carpetas

Para que los flujos de trabajo del HR Agent funcionen, se deben colocar archivos específicos en las carpetas correspondientes de BambooHR. El paquete del HR Agent proporciona archivos CSV de ejemplo. Es crucial que la estructura de cualquier archivo de reemplazo permanezca idéntica; sin embargo, los nombres de archivo pueden cambiar. Si se cambia un nombre de archivo, esta modificación se debe aplicar de manera consistente en todas las otras partes del proyecto donde se hace referencia al nombre del archivo, ya que estos archivos son esenciales para el funcionamiento de los flujos de trabajo.

Cargar documentos de capacitación

El paquete del HR Agent incluye un archivo CSV de ejemplo denominado TEMPLATE - HR Agent Onboarding Courses - Job Role.csv. Este archivo enumera los cursos obligatorios asignados a cada departamento.

  1. Abre TEMPLATE - HR Agent Onboarding Courses - Job Role.csv del paquete del HR Agent.

  2. Actualiza el archivo con la información de cursos específica de tu empresa. Mantén intacta la estructura de columnas y el formato.

  3. Guarda el archivo actualizado.

  4. Inicia sesión en BambooHR.

  5. En el menú de la izquierda, selecciona Files (Archivos).

  6. Haz clic en la carpeta Training Documents (Documentos de capacitación).

  7. Haz clic en Upload (Cargar).

  8. Selecciona tu archivo CSV actualizado y haz clic en Open (Abrir).

Cargar documentos de TI

El paquete del HR Agent incluye tres archivos CSV de ejemplo para el flujo de trabajo de creación de tickets de incorporación de TI (Pre Onboarding | ITSM Request). Carga solo los archivos que correspondan al proceso de incorporación de TI de tu empresa:

  • TEMPLATE - IT_Apps_JobRole.csv: enumera las aplicaciones a las que cada departamento puede acceder.
  • TEMPLATE - IT_G-Suite Groups.csv: enumera los grupos de Google Workspace a los que cada departamento puede acceder.
  • TEMPLATE - IT_LaptopChoice_JobRole.csv: enumera el tipo de portátil asignado a cada departamento.

Sigue estos pasos para cargar los documentos de TI:

  1. Abre cada archivo CSV que necesites del paquete del HR Agent.

  2. Reemplaza los datos de ejemplo con los departamentos de tu empresa y los recursos de TI. No modifiques los encabezados de columna ni la estructura del archivo.

  3. Guarda cada archivo actualizado.

  4. En BambooHR, ve a Files (Archivos).

  5. Haz clic en la carpeta IT Documents (Documentos de TI) para abrirla.

  6. Haz clic en Upload (Cargar).

  7. Selecciona uno o más de tus archivos CSV actualizados y haz clic en Open (Abrir).

Cargar documentos de incorporación

Carga documentos como guías de cultura empresarial, resúmenes de beneficios para empleados, calendarios de eventos empresariales, noticias y actualizaciones de la empresa, políticas y procedimientos de oficina, e información de contacto del equipo.

Para cargar archivos en esta carpeta:

  1. Recopila los documentos de incorporación que deseas enviar a los nuevos empleados.

  2. En BambooHR, ve a Files (Archivos) desde el menú de la izquierda.

  3. Haz clic en la carpeta Onboarding Documents (ALL) (Documentos de incorporación [TODOS]) para abrirla.

  4. Haz clic en Upload (Cargar).

  5. Selecciona uno o más archivos de tu equipo y haz clic en Open (Abrir).

Crear informes personalizados en BambooHR

Se deben crear dos informes personalizados en BambooHR para que el HR Agent pueda recuperar:

  1. Una lista completa que detalle todos los empleados actuales.
  2. Una lista para cada empleado que detalle todas las tareas de HR incompletas, ya sea asignadas directamente al empleado o a su contacto de HR designado.
Crear informe de empleados

Para generar los datos de empleados necesarios para el proyecto del HR Agent, crea un informe que incluya toda la información esencial del empleado:

  1. Inicia sesión en tu panel de BambooHR.

  2. En la barra de navegación superior, haz clic en Reports (Informes).

  3. Haz clic en + New Report (+ Nuevo informe) (generalmente en la esquina superior derecha).

  4. Ingresa un nombre para el informe: Employees Report.

  5. Agrega los siguientes campos al informe:

  6. Nombre

  7. Apellido
  8. Fecha de contratación
  9. País
  10. Correo electrónico del trabajo
  11. Correo electrónico personal
  12. Correo electrónico del supervisor
  13. Nombre del supervisor
  14. URL de LinkedIn
  15. Departamento
  16. Puesto
  17. Reporta a
  18. Región del usuario de SRE

    Nota

    Región del usuario de SRE es un campo personalizado. Se utiliza al crear un ticket de incorporación de TI. Si tu empresa no requiere esta información, este campo es opcional. De lo contrario, asegúrate de crear este campo personalizado en BambooHR siguiendo la documentación del generador de campos personalizados.

BambooHR solo pone a disposición ciertos campos de empleado después de la fecha de contratación del empleado. Para admitir los flujos de trabajo previos a la incorporación, debes crear y completar manualmente los siguientes campos personalizados cuando agregues un nuevo registro de empleado:

  • NewHireDepartment
  • NewHireJobTitle
  • NewHireReportsTo

Para crear estos campos personalizados en BambooHR, sigue la documentación del generador de campos personalizados.

  1. Los resultados del filtro deben ser Todos los empleados.

  2. Haz clic en Guardar.

Crear informe de tareas de empleados

Para generar las tareas de RR.HH. restantes necesarias de los empleados para el proyecto del agente de RR.HH., utiliza el siguiente procedimiento para crear un informe que incluya todas las tareas esenciales de empleados requeridas para el proyecto:

  1. Inicia sesión en tu panel de control de BambooHR.

  2. En la barra de navegación superior, haz clic en Informes.

  3. Haz clic en + Nuevo informe (generalmente en la esquina superior derecha).

  4. Introduce un nombre para el informe: Informe de tareas de empleados.

  5. Agrega los siguientes campos al informe:

    • Tarea
    • Categoría
    • Lista de tareas
    • Asignado a
    • Fecha de vencimiento
    • Fecha de finalización
    • Completado
  6. Los resultados del filtro deben ser Todos los empleados.

  7. Haz clic en Guardar.

Crear clave de API de BambooHR

Debes generar una clave de API para conectar BambooHR dentro del proyecto. Para crear tu clave de API, sigue las instrucciones de BambooHR para Crear una nueva clave de API (se requieren permisos). Una vez creada la clave de API, asegúrate de guardarla. Esta clave se utiliza en los siguientes pasos de configuración.

Preparar Jira

Crea los siguientes campos personalizados y agréguelos al objeto Tarea:

  1. Nombre completo
  2. Reporta a
  3. Departamento
  4. Puesto
  5. Región

Cada campo personalizado debe utilizar el tipo text.

Para obtener orientación sobre cómo crear campos personalizados, consulta la documentación de Atlassian sobre administración de campos personalizados.

Nota

Puedes modificar estos campos personalizados según sea necesario. Por ejemplo, puedes eliminar campos, agregar nuevos o renombrar campos existentes. Si realizas cambios en los campos personalizados, también debes actualizar las asignaciones de transformación en la operación ITSM - Create Task in JIRA Request.

Después de completar todos los pasos hasta Probar conexiones, también debes actualizar la actividad Problema de Jira. Consulta Actualizar la actividad Problema de Jira.

Crear un formulario de Google

Este formulario está diseñado para nuevos candidatos. Se incluye en su correo electrónico de bienvenida para recopilar información esencial e iniciar el proceso de creación de tickets de administración de servicios de TI (Pre Onboarding | ITSM Request). Se pueden omitir estos pasos si se prefiere una alternativa a Google Forms. Sin embargo, los API personalizadas de Jitterbit en los siguientes pasos Crear la API personalizada de Jitterbit aún deben seguirse, y el API debe ser activado por tu formulario preferido.

Crear el formulario

  1. Ve a Google Forms.

  2. Crea un formulario en blanco.

  3. Agrega los siguientes campos requeridos:

    1. Nombre completo (tipo de pregunta: Respuesta corta)

    2. Dirección (tipo de pregunta: Párrafo)

    3. Número de teléfono (tipo de pregunta: Respuesta corta)

    4. Correo electrónico (tipo de pregunta: Respuesta corta, con validación de Correo electrónico habilitada)

    5. Asigna un nombre a tu formulario: Formulario de incorporación.

  1. En el editor de formularios, haz clic en Respuestas.

  2. Haz clic en el icono verde de Google Sheets en la esquina superior derecha.

  3. Selecciona Crear una nueva hoja de cálculo.

  4. Ingresa el nombre de la hoja de cálculo: Onboarding Form (Responses).

  5. Haz clic en Crear para vincular el formulario a la hoja de cálculo.

La hoja de cálculo crea automáticamente columnas según tus preguntas del formulario. Verifica que las columnas aparezcan en el siguiente orden, ya que el script depende de esta secuencia exacta:

  • Timestamp
  • Full Name
  • Address
  • Phone Number
  • Email

Si el orden de las columnas es diferente, es posible que las preguntas del formulario no coincidan con el orden esperado. Para corregir esto, reordena las preguntas en tu formulario para que coincidan con la secuencia anterior.

Configurar Apps Script

  1. En la Google Sheet vinculada, ve a Extensiones > Apps Script.
  2. Se abre el editor de Apps Script. Por defecto, el script se llama Untitled project.
  3. En la parte superior del editor, haz clic en Untitled project y renómbralo a Onboarding Form (Responses).
  4. En el editor de Apps Script, elimina cualquier código existente.
  5. Abre el archivo googleForm_appScript.js del paquete HR Agent.
  6. Copia todo el código de googleForm_appScript.js y pégalo en el editor de Apps Script.
  7. En el código pegado, deja YOUR_ENDPOINT_HERE y YOUR_API_KEY_HERE como marcadores de posición. Actualizarás estos valores más tarde en Crear la API personalizada de Jitterbit.
  8. Haz clic en Guardar.

Configurar el trigger de envío del formulario

Configura el script para que se ejecute automáticamente cuando alguien envíe el formulario.

  1. En el editor de Apps Script, haz clic en el icono Triggers en la barra lateral izquierda.

  2. Haz clic en Add Trigger.

  3. Configura los ajustes del trigger:

    • Choose which function to run: Selecciona onFormSubmit.
    • Select event source: Selecciona From spreadsheet.
    • Select event type: Selecciona On form submit.
    • Failure notification settings: Selecciona Notify me immediately.
  4. Haz clic en Guardar.

Cuando un usuario envía el formulario, el script envía la respuesta a tu proyecto HR Agent y activa la operación Create ITSM Request API.

Compartir el formulario

  1. Ve a tus Google Forms en forms.google.com y abre tu formulario de incorporación.

  2. Haz clic en Enviar.

  3. Haz clic en el icono de enlace para obtener el enlace compartible.

  4. En Obtener enlace, cambia la configuración de acceso a Cualquiera que tenga el enlace.

  5. Haz clic en Copiar enlace para copiar la URL del formulario.

  6. Comparte este enlace con los nuevos empleados para que puedan acceder y enviar el formulario.

Crear la aplicación de Slack

Para crear la interfaz de chat de Slack, sigue estos pasos:

  1. Crea una aplicación de Slack usando el archivo de manifiesto de la aplicación de Slack (slack_app_manifest.json) proporcionado con los archivos de personalización de este agente de IA. También puedes crear la aplicación desde cero.

  2. Si usas el archivo de manifiesto proporcionado, reemplaza 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. Reemplaza este valor en dos lugares en el manifiesto.
    {{Replace with Jitterbit API URL}} La URL del servicio de la API personalizada de Jitterbit que creaste en Crear el manejador de solicitudes de API del bot de Slack.
  3. Instala la aplicación en tu espacio de trabajo de Slack.

  4. Obtén el token del bot (para el campo Bot User OAuth Token de la conexión de Slack) e ingresa su valor para la variable del proyecto slack.bot.user.token.

  5. Prueba la conexión de Slack y vuelve a implementar el proyecto.

Nota

Agrega tu Slackbot a tus canales de TI y RRHH. Completa los siguientes pasos:

  • Navega al canal donde quieres que se una el bot. En el campo de entrada de mensajes, escribe /invite @YourBotName, donde YourBotName es el nombre de tu bot.
  • Repite este paso para cada canal donde quieras agregar el bot (TI y RRHH).

Prepara Jitterbit Cloud Datastore

Si aún no tienes un token de acceso a Cloud Datastore, sigue la documentación para generar uno. Una vez que crees tu token de acceso, guárdalo. Este token se utiliza en los siguientes pasos de la configuración.

Crea un almacenamiento de claves en Jitterbit Cloud Datastore llamado candidate_welcome_emails. Los campos Key, AlternativeKey y Value están presentes por defecto. Agrega los campos personalizados que tienen los nombres y tipos que se enumeran en la tabla siguiente.

candidate_welcome_emails

Este almacenamiento de claves contiene la lista de nombres de candidatos, correos electrónicos y contenidos de correo de bienvenida personalizados.

Nombre del campo Tipo Descripción
Key Texto Se completa automáticamente. Nombre y apellido del candidato con el prefijo WE- sin espacios. Ejemplo: WE-FirstLast. Este valor se genera dentro del flujo de trabajo Pre Onboarding \| Offer Signed.
AlternativeKey Texto No se utiliza.
Value Texto Se completa automáticamente. Nombre y apellido del candidato sin espacios. Este valor se genera dentro del flujo de trabajo Pre Onboarding \| Offer Signed.
CandidateEmail Texto Se completa automáticamente. La dirección de correo electrónico del candidato. Este valor se genera dentro del flujo de trabajo Pre Onboarding \| Offer Signed.
CandidateEmailBody Texto grande Se completa automáticamente. El contenido del correo electrónico que se genera para el candidato. Esto contiene el contenido de correo personalizado. Su valor se genera dentro del flujo de trabajo Pre Onboarding \| Offer Signed.

Configura variables de proyecto

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

Para configurar variables de proyecto, utiliza el menú de acciones del proyecto para seleccionar Project Variables. Esto abre un panel en la parte inferior de la página donde puedes revisar y establecer los valores.

BambooHR

Consejo

Te recomendamos que trabajes con tus departamentos de RRHH y TI para completar los valores de variables en esta sección.

Nombre de variable Descripción
bambooHr.base.url URL base de BambooHR para solicitudes HTTP. Ejemplo: https://{companyDomain}.bamboohr.com/
bamboo.password Contraseña de autenticación básica de BambooHR.
bamboo.apiKey Tu clave de API para el nombre de usuario de autenticación básica de BambooHR. Consulta la documentación sobre cómo obtener una clave de API.
bamboo.path.reports.employeeTasks ID del informe personalizado para tareas de empleados. Este ID aparece en la URL cuando visitas el informe. Por ejemplo, en la URL https://{companyDomain}.bamboohr.com/reports/custom/Employee+Tasks+Reports/103, el ID es 103.
bamboo.path.reports.employees ID del informe personalizado para empleados. Este ID aparece en la URL cuando visitas el informe. Por ejemplo, en la URL https://{companyDomain}.bamboohr.com/reports/custom/Employee+Tasks+Reports, el ID es 101
bamboo.folder.trainingDocuments Nombre de la carpeta donde se almacenan los documentos de capacitación.
bamboo.folder.onboarding Nombre de la carpeta que contiene documentos de incorporación que deben enviarse a los nuevos empleados una semana antes de su fecha de inicio. Esta carpeta no debe incluir documentos de firma.
bamboo.folder.itDocuments Nombre de la carpeta donde se almacenan los documentos de TI.
bamboo.folder.file.itLaptopChoice Nombre del archivo donde se almacenan los detalles de selección de portátil.
bamboo.folder.file.itGSuite Nombre del archivo donde se almacenan los detalles de Google Workspace.
bamboo.folder.file.itApps Nombre del archivo donde se almacenan los detalles de aplicaciones.
bamboo.folder.file.courses Nombre del archivo donde se almacenan los detalles de los cursos.

Jira

Nombre de variable Descripción
jira.username Nombre de usuario de autenticación básica de Jira.
jira.task.reporter ID interno de Jira del reportero.
jira.task.assignee ID interno de Jira del asignado.
jira.project.name Nombre del proyecto de Jira.
jira.baseUrl URL base de Jira para solicitudes HTTP.
jira.api.token Token de API de Jira. Consulta Conexión de Jira para obtener enlaces útiles que te ayuden a crear tu token de API.

Confluence

Nombre de variable Descripción
confluence.username Nombre de usuario de autenticación básica de Confluence.
confluence.apiKey Contraseña de autenticación básica de Confluence. Para más información sobre dónde obtener tu clave de API, visita Administrar tokens de API.
confluence.base.url La URL base para obtener documentación de incorporación de TI.

Correo electrónico

Para más información sobre el uso de las variables, consulta la documentación.

Nombre de variable Descripción
email.smtp.username Nombre de usuario para autenticarse con el servidor SMTP.
email.smtp.password Contraseña para autenticarse con el servidor SMTP.
email.smtp.host Nombre de host o dirección IP del servidor SMTP para enviar correos electrónicos.
email.from Dirección de correo electrónico del remitente utilizada en el campo De para todos los correos salientes.
email.to.it Dirección de correo electrónico del departamento de TI para recibir notificaciones del sistema durante el proyecto.
email.to.hr Dirección de correo electrónico del departamento de Recursos Humanos para recibir notificaciones durante el proyecto.

Nota

El conector de correo electrónico utiliza seguridad SMTP establecida en SSL y puerto SMTP establecido en 465.

OpenAI

Nombre de variable Descripción
openAI.apiKey Clave de API de OpenAI para autenticación. Para más información, visita OpenAI.
openAi.url.path Ruta de URL para llamadas de API de OpenAI. Asignada dinámicamente por la aplicación. Déjala vacía.
gpt.toolChoice Modo de selección de herramienta para llamadas de función GPT. Debe establecerse en auto.
gpt.temperature Controla la aleatoriedad en respuestas de GPT (0.0-2.0). Déjalo vacío para usar el valor predeterminado o especifica un valor personalizado.
gpt.model Identificador de modelo GPT. Debe establecerse en GPT-4o.
gpt.maxTokens Número máximo de tokens en respuestas de GPT. Déjalo vacío para usar el valor predeterminado o especifica un valor personalizado.

Slack

Nombre de variable Descripción
slack.bot.user.token Token de acceso OAuth del usuario bot obtenido después de crear la app de Slack. Se utiliza para la autenticación en la conexión de Slack.
slack.itChannel.ID ID del canal de Slack para notificaciones de IT. Se encuentra en los detalles del canal.
slack.hrChannel.ID ID del canal de Slack para notificaciones de HR. Se encuentra en los detalles del canal.
slack.bot.id ID del usuario bot de Slack (ID de miembro). Se utiliza para evitar que el bot responda a sus propios mensajes. Se encuentra en los detalles de la app.

Nota

La app de Slack se crea en un paso posterior. Por ahora, puedes dejar en blanco las variables slack.bot.id y slack.bot.user.token.

Otros

Nombre de variable Descripción
your.company El nombre de tu empresa. Ejemplo: Jitterbit
welcome.form La URL del formulario para enviar a los candidatos en el correo electrónico de bienvenida. Si creaste un formulario de Google, consulta Crear un formulario de Google.
learningPath.enrollment.key La URL de tu organigrama.
Introduction.helpfulIT.url La URL de enlaces o información útil de IT.
Introduction.companyContact.url La URL de contactos esenciales de la empresa.
hr.tasks.link Una URL que guía a los empleados para completar sus tareas de HR pendientes. Si no existe una URL dedicada, proporciona la página principal de tu plataforma de HR.
cloud.datastore.key Tu clave de Cloud Datastore. Para más detalles, consulta Preparar Jitterbit Cloud Datastore.
resource.IT.page El ID de página de la página de onboarding de IT. El chatbot hace referencia a esta página al responder preguntas sobre onboarding de IT.
Introduction.orgChart.url La URL de tu organigrama.
offerSigned.LastModifiedDate.Manual.Date La fecha de ejecución manual del flujo de trabajo que anula la fecha en caché del flujo de trabajo Pre Onboarding \| Offer Signed.
offerSigned.LastModifiedDate.Manual Establécelo en true para habilitar la anulación de fecha de ejecución manual del flujo de trabajo Pre Onboarding \| Offer Signed.

Probar conexiones

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

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

Agregar plantillas de correo electrónico

En el flujo de trabajo Common Operations, en su operación Common Scripts, encontrarás un script llamado HTML Email Templates. Este script contiene todas las plantillas de correo electrónico del proyecto. Se incluyen plantillas de ejemplo de Jitterbit como referencia, pero deben reemplazarse con las plantillas de correo electrónico reales de tu empresa.

Actualizar la actividad de Jira Issue

Debes actualizar la actividad de Jira Issue para incluir los campos personalizados creados en Preparar Jira:

  1. Ve a la operación ITSM - Create Task in JIRA.
  2. Abre la actividad Issue de Jira.
  3. En Paso 2: Selecciona un proyecto, haz clic en Actualizar y selecciona tu proyecto.
  4. En Paso 3: Selecciona un objeto, haz clic en Actualizar y selecciona Task.
  5. Haz clic en Siguiente y luego en Finalizado.

Crear programaciones

Ciertos flujos de trabajo requieren ejecución programada. El agente de IA incluye una programación preconfigurada, Daily Schedule, que está configurada para activadores diarios.

Tienes la opción de usar esta Daily Schedule existente (esto se puede hacer desde el menú acciones de la operación en Configuración > Programaciones) o crear una nueva programación. Las operaciones que se enumeran a continuación deben tener una programación asociada:

  • Controller - Search Offer Signed
  • Controller - Search New Hire - Week Before
  • Controller - Search Introductions
  • Controller - Search Write LI Post
  • Controller - Search - Personalized Learning Path
  • Controller - Search - Employee Remaining HR Tasks
  • Controller - Search - In-progress IT Tickets

Desplegar el proyecto

  1. Abre el flujo de trabajo Datastore Calls.

  2. Localiza las siguientes tres actividades del endpoint de Cloud Datastore:

    • Insert Welcome Email
    • Query Welcome Email
    • Delete Items
  3. Haz clic en cada actividad del endpoint de Cloud Datastore y selecciona el almacenamiento llamado candidate_welcome_emailsStudio que creaste en el paso Preparar Jitterbit Cloud Datastore.

  4. Haz clic en Siguiente y luego en Finalizar.

  5. Repite los pasos 3 y 4 para cada actividad del endpoint de Cloud Datastore.

  6. Despliega el proyecto de Studio.

    Para desplegar el proyecto, usa el menú acciones del proyecto para seleccionar Desplegar.

Crear la API personalizada de Jitterbit

Crea una API personalizada usando API Manager para uno de los siguientes:

Crear el controlador de solicitud de API del bot de Slack

Esta API personalizada de Jitterbit activa la operación PlatformBot | Inbound Event. Configura y publica la API personalizada con los siguientes parámetros:

  • API Service: HR Agent - PlatformBot | Inbound Event
  • Path: /
  • Project: Selecciona el proyecto de Studio creado desde Jitterbit HR Agent en Marketplace
  • Operation To Trigger: PlatformBot | Inbound Event
  • Method: POST
  • Response Type: System Variable

Guarda la URL del servicio de la API publicada para usarla al crear la app de Slack. La URL del servicio se encuentra en el panel de detalles de API en la pestaña Services pasando el cursor sobre la columna Actions del servicio y haciendo clic en Copiar URL del servicio API.

Crear el gestor de solicitudes de la API de Google Forms

Esta API personalizada de Jitterbit activa la operación Create ITSM Request API. Configura y publica la API personalizada con los siguientes parámetros:

  • Nombre del servicio: HR Agent - Create ITSM Request API
  • Proyecto: Selecciona el proyecto de Studio creado a partir de Jitterbit HR Agent en Marketplace
  • Operación: Create ITSM Request API
  • Método: POST
  • Tipo de respuesta: System Variable
  • Perfil de seguridad: Crear nuevo perfil
    • Nombre del perfil: HR Agent
    • Entorno: Selecciona el entorno donde se implementó el proyecto Jitterbit HR Agent
    • Tipo: API Key
    • Clave: X-APIKey
    • Valor: Recibes una clave única. Cópiala por ahora. Se requiere para completar la configuración de Google Forms.
    • Haz clic en Save.

Asegúrate de asignar el perfil de seguridad a la configuración de la API y guárdalo. Retén la URL del servicio de la API publicada para usarla en Google Forms. Puedes encontrar la URL del servicio en el panel de detalles de la API en la pestaña Services. Para copiar la URL, colócate sobre la columna Actions del servicio y haz clic en Copy API service URL. Una vez que tengas la clave de API y la URL del servicio, completa la configuración de Google Forms en el script de la aplicación. Asegúrate de guardar el script de la aplicación después de agregar la URL del servicio y la clave de API.

Revisa los flujos de trabajo del proyecto

En el proyecto de Studio abierto, revisa los flujos de trabajo junto con las descripciones siguientes para entender qué hacen. Utiliza la tabla de resumen siguiente para identificar qué flujos de trabajo requieren configuración y cómo se activan.

Nota

En el proyecto, los nombres de flujos de trabajo que comienzan con un asterisco (*) indican flujos de trabajo principales que inician cadenas de acciones. Estos flujos de trabajo principales generalmente se programan o se activan por API y llaman a los flujos de trabajo de infraestructura central según sea necesario. Los flujos de trabajo sin asteriscos son flujos de trabajo de apoyo.

Nombre del flujo de trabajo Categoría Tipo de activación Dependencias clave
Common Operations Infraestructura central Manual Ninguna
HR Calls Infraestructura central Llamado por otros flujos de trabajo BambooHR
Platform Calls Infraestructura central Llamado por otros flujos de trabajo Slack o alternativa
ITS Calls Infraestructura central Llamado por otros flujos de trabajo Jira o alternativa
Emails Infraestructura central Llamado por otros flujos de trabajo Configuración de SMTP
Datastore Call Infraestructura central Llamado por otros flujos de trabajo Cloud Datastore
Communication Platform Bot Infraestructura central API Platform Calls, API personalizada
OpenAI - Function Calling OpenAI Llamado por flujos de trabajo programados API de OpenAI
OpenAI - Code Interpreter OpenAI Llamado por otros flujos de trabajo API de OpenAI
OpenAI - PDF Analysis OpenAI Llamado por otros flujos de trabajo API de OpenAI
OpenAI - AskHR Router OpenAI Llamado por flujos de trabajo de chatbot API de OpenAI
OpenAI - AskHR Function Calling OpenAI Llamado por chatbot API de OpenAI, Enrutador de AskHR
AskHR - After Tool - Start OpenAI Llamado por OpenAI AskHR Function Calling Varía según la herramienta
Pre Onboarding - Offer Signed Pre-incorporación Programado HR Calls, OpenAI Function Calling
Pre Onboarding - Week Before Documents Pre-incorporación Programado HR Calls, Emails
Pre Onboarding - ITSM Request Pre-incorporación API HR Calls, ITS Calls, API personalizada
First Day - Introductions Primer día Programado HR Calls, Emails
First Day - Write LI Post Primer día Programado HR Calls, OpenAI
First Week - Personalized Learning Path Primera semana Programado HR Calls, Intérprete de código de OpenAI
General - Employee Remaining HR Tasks En curso Programado HR Calls
First Week - In-progress IT Tickets En curso Programado HR Calls, ITS Calls

Flujos de trabajo de infraestructura central

Estos flujos de trabajo proporcionan operaciones fundamentales que se utilizan en todo el proyecto.

Operaciones comunes

Este flujo de trabajo contiene scripts comunes para el proyecto. Debes actualizar el script HTML Email Templates para alinearlo con las plantillas de correo electrónico de tu empresa, asegurándote de que todas las variables existentes dentro de las plantillas permanezcan sin cambios o se cambien según tus necesidades.

Llamadas de RRHH

Este flujo de trabajo centraliza las operaciones principales de RRHH del proyecto. Estas operaciones fundamentales de RRHH se utilizan en flujos de trabajo individuales posteriores, y todas las respuestas se estandarizan y asignan a esquemas comunes.

Llamadas de plataforma

Este flujo de trabajo consolida las operaciones fundamentales de la plataforma de comunicación elegida (por ejemplo, Slack). Las operaciones de plataforma estandarizadas se utilizan en flujos de trabajo posteriores. Una función clave es capturar valores esenciales en variables o mover respuestas de operaciones a flujos de trabajo posteriores para estandarizarlos en esquemas comunes para un uso consistente.

Llamadas de ITS

Este flujo de trabajo consolida las operaciones fundamentales de la plataforma de servicio de TI elegida (por ejemplo, Jira). Las operaciones de servicio de TI estandarizadas se utilizan en flujos de trabajo posteriores. Una función clave es capturar valores esenciales en variables o mover respuestas de operaciones a flujos de trabajo posteriores para estandarizarlos en esquemas comunes para un uso consistente.

Nota

Al usar Jira, el agente de IA utiliza dos operaciones para crear tickets: ITSM - Create Task in JIRA y Update Task in JIRA. Debido a limitaciones de la API de Jira, ambas operaciones deben funcionar juntas como un único proceso de creación de tickets.

Correos electrónicos

Este flujo de trabajo gestiona las comunicaciones de correo electrónico requeridas del proyecto y se utiliza frecuentemente durante todo el ciclo de vida del proyecto.

Llamada a datastore

Este flujo de trabajo gestiona correos electrónicos de bienvenida personalizados realizando las siguientes acciones:

  • Los guarda en una base de datos con claves únicas.
  • Los obtiene mediante una consulta cuando sea necesario para el proyecto.
  • Elimina el registro una vez que ya no sea necesario.
Bot de plataforma de comunicación

Nota

Si no utilizas Slack, puedes ignorar este flujo de trabajo y no se activará.

Este flujo de trabajo gestiona las solicitudes entrantes del bot de Slack. Se activa a través de una API personalizada de Jitterbit cada vez que un usuario interactúa con la interfaz de chat del bot 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.

Flujos de trabajo de OpenAI

Estos flujos de trabajo se integran con OpenAI para potenciar la automatización inteligente y la funcionalidad del chatbot.

OpenAI - Llamada de función

Este flujo de trabajo sirve como el mecanismo centralizado de llamada de función para el LLM, procesando solicitudes iniciadas por flujos de trabajo programados (como Pre Onboarding | Offer Signed). Su función principal es determinar qué herramienta ejecutar según las indicaciones del usuario proporcionadas al LLM. Está diseñado para ser activado por acciones originarias fuera de la plataforma de comunicación o chatbot.

OpenAI - Intérprete de código

Este flujo de trabajo realiza análisis bajo demanda de documentos CSV para identificar resultados de coincidencia específicos para varios casos de uso. Por ejemplo, determina qué aplicaciones se debe conceder acceso según el departamento del nuevo empleado.

OpenAI - Análisis de PDF

Este flujo de trabajo analiza currículos en PDF para resumir su contenido, permitiendo que el LLM genere correos electrónicos de bienvenida personalizados.

OpenAI - Enrutador de AskHR

Este flujo de trabajo sirve como punto de conexión intermedio dentro del uso general del chatbot AskHR, gestionando la reformulación del diálogo, la síntesis de contenido y la composición de respuestas.

OpenAI - Llamada de función de AskHR

Este flujo de trabajo sirve como el mecanismo centralizado de llamada de función para el LLM, procesando solicitudes iniciadas por usuarios a través del chatbot AskHR. Su función principal es determinar qué herramienta ejecutar según los mensajes del usuario. Está diseñado para ser activado por acciones originarias desde la plataforma de comunicación o chatbot.

AskHR - After Tool

Este patrón de flujo de trabajo inicia una secuencia de acciones después de que el flujo de trabajo de invocación de funciones de AskHR selecciona una herramienta. Existen múltiples instancias de este flujo de trabajo con diferentes nombres de herramientas (por ejemplo, AskHR | After Tool | Start - null_tool). La variante null_tool indica que el LLM determinó que la solicitud del chatbot del usuario no era adecuada para ninguna de las herramientas disponibles actualmente.

Flujos de trabajo de pre-incorporación

Estos flujos de trabajo automatizan tareas antes del primer día del nuevo empleado.

Pre Onboarding - Offer Signed

Este flujo de trabajo verifica periódicamente si hay candidatos que han firmado una oferta y realiza las siguientes acciones:

  • Identifica candidatos que han aceptado ofertas.
  • Envía mensajes de alerta a los equipos internos.
  • Redacta un correo de bienvenida con un formulario de incorporación para el candidato.
  • Envía el correo de bienvenida al futuro gerente del candidato junto con un mensaje de Slack para aprobación final.

Para obtener detalles sobre la configuración del cronograma, consulta la sección Create schedules.

Pre Onboarding - Week Before Documents

Este flujo de trabajo se ejecuta según un cronograma para identificar a los empleados cuya fecha de inicio (primer día de trabajo) está programada para la semana siguiente. Una vez identificados, realiza automáticamente las siguientes acciones:

  • Alerta al gerente, equipo de TI y equipos de RRHH relevantes.
  • Envía un correo electrónico que contiene documentos de incorporación esenciales, como información sobre la cultura empresarial y los beneficios de los empleados.
Pre Onboarding - ITSM Request

Este flujo de trabajo se inicia mediante una API personalizada de Jitterbit cada vez que un nuevo empleado envía un formulario. Realiza las siguientes acciones:

  • Analiza la posición del nuevo empleado en comparación con varios documentos CSV.
  • Crea un ticket de TI para el proceso de incorporación.
  • Notifica a los equipos de RRHH y TI a través de correo electrónico y una plataforma de comunicación (por ejemplo, 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.

Flujos de trabajo del primer día

Estos flujos de trabajo se ejecutan según un cronograma para identificar automáticamente a los empleados cuya fecha de inicio (primer día de trabajo) es hoy, y luego realizan acciones específicas como se describe a continuación.

First Day - Introductions

Este flujo de trabajo realiza las siguientes acciones:

  • Envía mensajes de alerta al gerente del nuevo empleado.
  • Redacta un correo de presentación que contiene información esencial del primer día y enlaces de la empresa.
First Day - Write LI Post

Este flujo de trabajo envía un correo electrónico con una publicación de LinkedIn que se puede compartir en el perfil del nuevo empleado.

Flujos de trabajo de la primera semana

Este flujo de trabajo apoya a los nuevos empleados durante su primera semana.

First Week - Personalized Learning Path

Este flujo de trabajo se ejecuta según un cronograma para identificar a los empleados cuya fecha de inicio es hoy y realiza las siguientes acciones:

  • Realiza análisis de CSV para hacer coincidir sus puestos con cursos de capacitación relevantes.
  • Genera y envía un correo electrónico personalizado que proporciona orientación sobre la capacitación requerida.

Flujos de trabajo de operaciones continuas

Estos flujos de trabajo gestionan operaciones continuas de RRHH y TI a lo largo del ciclo de vida del empleado.

General - Employee Remaining HR Tasks

Este flujo de trabajo se ejecuta según un cronograma para automatizar recordatorios de tareas de RRHH pendientes. Realiza las siguientes acciones:

  • Verifica si hay empleados con tareas incompletas dentro de una ventana de 90 días.
  • Genera correos electrónicos separados tanto para el empleado como para el equipo de RRHH, detallando las tareas específicas que cada parte es responsable de completar.
First Week - In-progress IT Tickets

Este flujo de trabajo se ejecuta según un cronograma para administrar de forma proactiva las tareas de incorporación de servicio de TI pendientes para nuevos empleados. Realiza las siguientes acciones:

  • Busca empleados que estén en su primera semana y aún tengan tickets de servicio de TI incompletos.
  • Notifica a TI y RRHH con alertas separadas cuando el ticket de servicio de TI de un nuevo empleado aún no se completa.
  • Envía un mensaje directo al empleado, ofreciendo ayuda para asegurar que reciban el soporte de TI necesario.

Activar los flujos de trabajo del proyecto

Para propósitos de prueba, prepara tus registros de prueba y ejecuta las siguientes operaciones. Puedes ejecutar una operación usando la opción Ejecutar de la operación, que aparece al pasar el cursor sobre ella:

  • Controller - Search Offer Signed
  • Controller - Search New Hire - Week Before
  • Controller - Search Introductions
  • Controller - Search Write LI Post
  • Controller - Search - Personalized Learning Path
  • Controller - Search - Employee Remaining HR Tasks
  • Controller - Search - In-progress IT Tickets

Los otros dos flujos de trabajo principales se activan mediante las API personalizadas de Jitterbit:

  • PlatformBot | Inbound Event: Slack activa este flujo de trabajo a través de la API personalizada HR Agent - PlatformBot | Inbound Event. El envío de un mensaje directo a la app de Slack inicia el activador de la API personalizada.
  • Create ITSM Request API: Google Form activa este flujo de trabajo a través de la API personalizada HR Agent - Create ITSM Request API. El envío de un formulario de muestra inicia el activador de la API personalizada.

El resto de los flujos de trabajo se activan mediante otras operaciones y están en niveles inferiores respecto a los listados anteriormente. No están diseñados para ejecutarse por separado.

Solución de problemas

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

Para obtener ayuda adicional, contacta al equipo de soporte de Jitterbit.

Uso diferente del endpoint

Si cambias el endpoint utilizado en la plantilla, debes modificar varios componentes del proyecto. En esta sección se describen las actualizaciones necesarias para cada flujo de trabajo que utiliza el endpoint.

Importante

Antes de modificar el proyecto, revisa los componentes que planeas cambiar. Revisar los componentes te ayuda a comprender cómo funcionan y podría permitirte reutilizar scripts existentes para tus endpoints.

Plataformas HRIS

Si tu empresa utiliza una plataforma de recursos humanos distinta a BambooHR, utiliza la orientación en esta sección para modificar tu proyecto.

El flujo de trabajo HR Calls contiene todas las operaciones que extraen datos de plataformas de recursos humanos. Como cada plataforma de recursos humanos tiene documentación y capacidades de API únicas, los pasos para recuperar información varían entre diferentes plataformas de recursos humanos.

Detectar y procesar ofertas firmadas

Las siguientes operaciones detectan candidatos que han firmado ofertas y activan el flujo de trabajo de procesamiento de ofertas:

  • Get Applicant Status: Recupera el estado actual de los candidatos.
  • Get Applicant Status - Prep for Details: Prepara los datos del candidato para recuperación detallada.
  • Get Applicant Details: Recupera información detallada sobre los candidatos.

Estas operaciones se ejecutan en el controlador Controller - Search Offer Signed. Cuando las operaciones detectan un candidato con estado de oferta firmada, activan la operación Start - Single Offer para procesar el flujo de trabajo.

Completa los siguientes pasos para configurar la operación Start - Single Offer:

  1. Abre la transformación Offer Signed Data to Common Model Employee Schema.
  2. Actualiza el esquema de origen.
  3. Completa las asignaciones de campos para designar las variables requeridas (por ejemplo, offerSigned_manager).

Si creas nuevas operaciones para tus requisitos de plataforma HRIS, agrégalas al controlador Controller - Search Offer Signed.

Recuperar reportes personalizados desde tu plataforma HRIS

La operación GET Custom Report by ID cumple dos funciones:

  1. Recuperar una lista de empleados.
  2. Recuperar tareas de recursos humanos pendientes.

Después de que la operación recupera los datos del reporte, el agente llama a una operación posterior que asigna los datos de origen a un esquema común (common_schema_employeeInfo) y designa variables que el flujo de trabajo requiere.

Los siguientes flujos de trabajo utilizan esta operación:

Flujo de trabajo Operación que llama Operación de procesamiento
AskHR | After Tool | Start - find_manager Start - find_manager AskHr - find_manager - Employees Directory to Common Employee schema
Pre Onboarding | Week before documents Controller - Search New Hire - Week Before GET Report - Week Before Data to Common Model Employee Schema
Pre Onboarding | ITSM Request Start | ITSM Request API GET Report - Employee Directory to ITSM Common Model Employee Schema
First Day | Introductions Controller - Search Introductions GET Report - First Day Introductions Data to Common Model Employee Schema
First Day | Write LI Post Controller - Search Write LI Post GET Report Employee - LI Post Data to Common Model Employee Schema
First Week | Personalized Learning Path Controller - Search - Personalized Learning Path Personalized Learning Path - Employees Data to Common Model Employee Schema
General | Employee Remaining HR Tasks Controller - Search - Employee Remaining HR Tasks Employee Remaining HR Tasks to Flat HR Tasks
First Week | In-progress IT Tickets Controller - Search - In-progress IT Tickets GET Report Employee - Filter First Week to Common Model Employee Schema

Para cada workflow, abre la transformación de la operación de procesamiento y completa los siguientes pasos:

  1. Actualiza el esquema de origen para que coincida con tu plataforma de HR.
  2. Completa los mapeos de campos para asignar las variables requeridas.

Nota

El workflow General | Employee Remaining HR Tasks utiliza GET Custom Report by ID para el informe de tareas restantes de HR. Si no puedes usar la misma operación para este workflow, crea una nueva operación y llámala desde el controlador Controller - Search - Employee Remaining HR Tasks.

Recupera datos de empleados por ID

La operación Get Employee by Id recupera datos de un solo empleado desde tu plataforma de HR. La operación Get Employee Details by Id mapea los datos de origen al esquema común (common_schema_employeeInfo).

Completa los siguientes pasos para configurar estas operaciones:

  1. Actualiza la operación Get Employee by Id con la llamada a la API de tu plataforma de HR.
  2. Abre la transformación Get Employee Details by Id para actualizar el esquema de origen y completar los mapeos de campos para asignar las variables requeridas.

Descarga archivos desde tu plataforma de HR

Las siguientes operaciones descargan archivos desde tu plataforma de HR:

  • Get List of Files: Recupera una lista de carpetas.
  • Get List of Files - Filter for Folders v2: Filtra la lista de carpetas para identificar la carpeta correcta.
  • Get List of Files - Filter & Download Single File: Descarga un solo archivo de una carpeta.
  • Get List of Files - Download All Files: Descarga todos los archivos de una carpeta.
  • Get List of Files - Download File v2: Gestiona la descarga del archivo a través de la API.
Configura Get List of Files
  1. Actualiza la operación con la llamada a la API de tu plataforma de HR para obtener una lista de carpetas.
  2. En la configuración de variables de BambooHR, actualiza las variables que comienzan con bamboo.folder. Estas variables identifican la carpeta correcta para cada workflow.
  3. Abre la transformación Get List of Files - Filter for Folders v2 para actualizar el esquema de origen.
  4. Completa los mapeos de transformación de acuerdo con los comentarios en el esquema de destino.
Configura Get List of Files - Filter & Download Single File

En la configuración de variables de BambooHR, actualiza las variables que comienzan con bamboo.folder.file. Estas variables identifican el archivo correcto para cada workflow cuando descargas un solo archivo de una carpeta.

Configura Get List of Files - Download All Files

Esta operación descarga todos los archivos de la carpeta filtrada. La operación se utiliza principalmente en el workflow Pre Onboarding | Week before documents para enviar documentos de incorporación. Para más información, consulta Review project workflows.

Configura Get List of Files - Download File v2

Esta operación está vinculada tanto a Get List of Files - Filter & Download Single File como a Get List of Files - Download All Files como su siguiente paso. Actualiza la operación con la llamada a la API de tu plataforma de HR para gestionar la descarga del archivo.

Recupera datos de tiempo libre de empleados

La operación Get a list of Who's Out se utiliza en workflows de AskHR para responder preguntas de usuarios como "¿Quién estará fuera de la oficina mañana?".

Para configurar esta operación, completa los siguientes pasos:

  1. Actualiza la operación para llamar al endpoint de la API de tu plataforma de HR que recupera datos de ausencia.
  2. Utiliza las siguientes variables para filtrar el rango de fechas en tu solicitud HTTP:

    • $llm_response_start_date: La fecha de inicio que el LLM genera según la solicitud del usuario en una plataforma de comunicación como Slack.

    • $llm_response_end_date: La fecha de fin que el LLM genera según la solicitud del usuario en una plataforma de comunicación como Slack.

Plataformas ITSM

Si tu empresa utiliza una plataforma de Gestión de Servicios de TI (ITSM) diferente a Jira, utiliza la orientación en esta sección para modificar tu proyecto.

Crea tickets de incorporación de TI

Para configurar estas operaciones para una plataforma ITSM diferente, completa los siguientes pasos:

  1. Actualiza la operación ITSM - Create Task in JIRA para usar el endpoint de la API de tu plataforma ITSM.

  2. (Opcional.) Considera usar estas variables comunes en la operación para mantener consistencia:

  3. $it_laptopChoice_list: La opción de laptop elegida por el nuevo empleado.

  4. $it_application_list: La lista de aplicaciones a provisionar.
  5. $it_gSuite_list: La lista de servicios de Google Workspace a provisionar.
  6. $newHire_department: El departamento del nuevo empleado.
  7. $newHire_region: La región del nuevo empleado.

  8. Asegúrate de que tu operación complete la variable $newHire_itTicket con la URL del ticket de TI desde la respuesta de la API.

Recuperar tickets de TI en progreso

La operación Search ITSM Issue recupera tickets de incorporación de TI en progreso. Esta operación se ejecuta como parte del flujo de trabajo First Week | In-progress IT Tickets.

Para configurar esta operación en una plataforma ITSM diferente, sigue estos pasos:

  1. Actualiza la operación Search ITSM Issue para usar el endpoint de API de tu plataforma ITSM para recuperar tickets de incorporación de TI en progreso.
  2. Abre la transformación GET IT Newhire In-progress tickets - to Common Model IT Ticket Schema para actualizar el esquema de origen y completar los mapeos de campos.

Plataformas de gestión del conocimiento

Si tu empresa utiliza una plataforma de gestión del conocimiento diferente a Confluence, usa la orientación en esta sección para modificar tu proyecto.

Recuperar contenido de incorporación de TI

La operación AskHr - Get IT Onboarding Content recupera contenido desde tu página de documentación de incorporación de TI. El agente de IA utiliza este contenido para responder preguntas relacionadas con TI en el bot de Slack. Esta operación utiliza la variable de proyecto confluence.base.url.

Para configurar esta operación en una plataforma de gestión del conocimiento diferente, sigue estos pasos:

  1. (Opcional) En la sección variables de proyecto, agrega una variable para la URL base de tu plataforma.

  2. Actualiza la operación AskHr - Get IT Onboarding Content para usar el endpoint de API de tu plataforma.

  3. Actualiza la transformación de la operación para que coincida con el esquema de respuesta de tu plataforma.

  4. Asegúrate de que tu operación complete la variable $it_onboarding_content con el contenido recuperado. El agente de IA utiliza esta variable en un prompt de LLM para responder preguntas de usuarios en el bot de Slack.

Plantillas CSV

Las plantillas CSV son un componente fundamental de este proyecto. Las plantillas permiten flujos de trabajo que analizan archivos y generan correos electrónicos y tickets de TI personalizados. Aunque puedes personalizar los datos en estas plantillas para tu empresa, si modificas la estructura de la plantilla, debes actualizar los prompts asociados.

Las siguientes operaciones contienen prompts diseñados para archivos de plantilla CSV específicos:

Operación Archivo de plantilla CSV Propósito
Prompt - Courses List TEMPLATE - HR Agent Onboarding Courses - Job Role.csv Genera recomendaciones de cursos según el departamento
Prompt - Application List TEMPLATE - IT_Apps_JobRole.csv Determina aplicaciones a provisionar según el departamento
Prompt - GSuite List TEMPLATE - IT_G-Suite Groups.csv Asigna grupos de Google Workspace
Prompt - Laptop Choice List TEMPLATE - IT_LaptopChoice_JobRole.csv Proporciona opciones de laptop según el departamento

Si modificas la estructura de un archivo de plantilla CSV, actualiza el prompt de la operación correspondiente para que coincida con la nueva estructura.

Plataformas de envío de formularios

Si tu empresa utiliza una plataforma de envío de formularios diferente a Google Forms, usa la orientación en esta sección para modificar tu proyecto.

El agente de IA utiliza un formulario para recopilar información para iniciar el flujo de trabajo ITS Calls.

Para configurar el agente de IA para usar una plataforma de formularios diferente, sigue estos pasos:

  1. Configura tu formulario para enviar datos de usuarios a la API personalizada de Jitterbit.

  2. Abre la transformación Form Response to Common Employee Schema para actualizar el esquema de origen y completar los mapeos de campos.

Plataformas de almacenamiento de datos

Si tu empresa utiliza una plataforma de almacenamiento de datos diferente a Cloud Datastore, consulta la orientación en esta sección para modificar tu proyecto.

El agente de IA utiliza Cloud Datastore para almacenar borradores de correos de bienvenida y direcciones de correo electrónico de candidatos. El almacén de datos permite insertar, consultar y eliminar registros. Necesitas la dirección de correo electrónico del candidato almacenada para enviar el correo de bienvenida después de la aprobación del gerente.

Importante

No cambies ningún nombre de variable global. Utiliza los nombres de variables tal como están definidos.

Para configurar el agente de IA con una plataforma de almacenamiento de datos diferente, actualiza las siguientes operaciones:

Almacenar datos de correo de bienvenida

La operación Datastore | Insert Welcome Email inserta los siguientes datos en el almacén de datos:

Campo de datos Variable o valor
Cuerpo de correo electrónico redactado $llm_response_email_body
Nombre completo del candidato (sin espacios) fullname = $offerSigned_name + $offerSigned_surName;
fullname_cleaned = Replace(fullname, " ", "");
fullname_cleaned
Dirección de correo electrónico del candidato $offerSigned_email
Clave de registro fullname = $offerSigned_name + $offerSigned_surName;
fullname_cleaned = Replace(fullname, " ", "");
"WE-" + fullname_cleaned

Eliminar datos de correo de bienvenida

La operación Datastore | Delete Welcome Email elimina registros después de que se envíe el correo al candidato o si el gerente rechaza el correo redactado.

Configura la operación para aceptar el ID de registro interno desde la variable $dataStore_item_id. La operación incluye instrucciones de registro para rastrear la eliminación:

WriteToOperationLog("------------------------------");
WriteToOperationLog("Deleting Key: WE-" + $dataStore_Key + " With itemID: " + $dataStore_item_id);
WriteToOperationLog("------------------------------");
$dataStore_item_id

La operación de consulta recupera el valor $dataStore_item_id, que identifica el registro a eliminar.

Plataformas de comunicación

Si tu empresa utiliza una plataforma de comunicación diferente a Slack, consulta la orientación en esta sección para modificar tu proyecto.

El agente de IA utiliza Slack para notificaciones de TI, recursos humanos y gerentes, así como para todas las interacciones con usuarios.

Configurar el controlador de eventos entrantes

Configura tu plataforma de comunicación para enviar eventos de solicitud de usuarios a la API personalizada de Jitterbit. La operación PlatformBot | Inbound Event recibe estos eventos e inicia la cadena de operaciones que procesan los mensajes de usuario.

Actualizar variables de proyecto

Actualiza las siguientes variables de proyecto para que coincidan con tu plataforma de comunicación:

Nombre de variable Descripción
slack.itChannel.ID ID del canal de notificaciones de TI
slack.hrChannel.ID ID del canal de notificaciones de recursos humanos
slack.bot.id ID de usuario del bot (se utiliza para evitar que el bot responda a sus propios mensajes)
slack.bot.user.token Token de acceso OAuth de usuario del bot

Consejo

Puedes renombrar estas variables para que coincidan con tu plataforma (por ejemplo, cambiar slack.itChannel.ID a teams.itChannel.ID). Cuando renombres una variable, todas las referencias a esa variable se actualizan automáticamente en todo tu proyecto, incluidos scripts y transformaciones.

Validar mensajes de plataforma

La operación Validate Platform Message verifica que los mensajes entrantes provengan de un usuario final en lugar del bot, y extrae variables para su uso posterior.

Configura tu operación para completar las siguientes variables:

Variable Descripción Valor
$platform_bot_id_pass Validación de origen del mensaje Establece en "true" si el mensaje proviene de un usuario real
$platform_userID Identificador de usuario ID de usuario de quien envía el mensaje
$platform_ts Marca de tiempo del mensaje Marca de tiempo del mensaje
$platform_thread_ts Marca de tiempo de respuesta en hilo Marca de tiempo del mensaje de respuesta cuando se envía en un hilo
$platform_channel Identificador de canal ID del canal donde se envió el mensaje

Actualiza los esquemas de origen y destino de tu transformación para que coincidan con la API de tu plataforma de comunicación.

Enviar mensajes de notificación

La operación Post Notification Message to Channel envía mensajes o respuestas a canales de la plataforma.

Configura tu operación para usar las siguientes variables:

Variable Descripción
$platform_channel ID del canal donde se envía el mensaje
$platform_thread_ts Marca de tiempo del hilo del mensaje original
$platform_notification_text Cuerpo del mensaje a enviar

Si $platform_thread_ts contiene un valor (mayor a 0), la operación envía la respuesta a ese hilo. De lo contrario, la operación envía un nuevo mensaje al canal. Configura esta lógica en tu mapeo de transformación:

if($platform_thread_ts > 0, $platform_thread_ts)

Actualiza los esquemas de origen y destino de tu transformación para que coincidan con la API de tu plataforma de comunicación.

Recuperar historial de conversación

La operación Conversation History recupera los últimos cinco mensajes del historial de conversación y asigna los mensajes al esquema de destino común common_conversation_history_schema.json.

El esquema de destino incluye un nodo thread_latest_reply que representa la respuesta más reciente en un hilo. Este nodo se completa con variables de la operación Validate Platform Message.

Actualiza el esquema de origen de tu transformación para que coincida con la API de tu plataforma de comunicación.

Enviar indicador de escritura

La operación Post Typing to Channel envía un indicador de escritura al canal.

Configura tu operación para usar las siguientes variables:

Variable Descripción
$platform_channel ID del canal donde se envía el indicador
$platform_thread_ts Marca de tiempo del hilo del mensaje original
Cuerpo del mensaje Formato del indicador de escritura de tu plataforma
$platform_typing_ts Marca de tiempo del mensaje del indicador de escritura (se usa para eliminarlo después)

Si $platform_thread_ts contiene un valor, la operación envía el indicador de escritura a ese hilo. De lo contrario, envía el indicador al canal. Configura esta lógica en tu mapeo de transformación:

if(Length($platform_thread_ts) > 0, $platform_thread_ts, unmap());

Actualiza los esquemas de origen y destino de tu transformación para que coincidan con la API de tu plataforma de comunicación.

Eliminar indicador de escritura

La operación Delete Message elimina el indicador de escritura del canal después de que el bot envía su respuesta.

Configura la operación para usar las siguientes variables:

Variable Descripción
$platform_channel ID del canal donde se envió el indicador de escritura
$platform_typing_ts Marca de tiempo del indicador de escritura a eliminar

Actualiza los esquemas de origen y destino de la transformación para que coincidan con la API de tu plataforma de comunicación.

Recuperar correo electrónico del usuario por ID de usuario

La operación Get User Email by UserId recupera la dirección de correo electrónico de un usuario usando su ID de usuario.

Configura la operación para usar las siguientes variables:

Variable Descripción
$platform_userID ID de usuario a buscar
$slack.bot.user.token Token de autenticación

Actualiza los esquemas de origen y destino de la transformación para que coincidan con la API de tu plataforma de comunicación.

Recuperar información del usuario por nombre

La operación Get UserID & Email by Name and Surname recupera la dirección de correo electrónico e ID de usuario de un usuario usando su nombre completo.

Configura la operación para usar las siguientes variables:

  • Esquema de solicitud

    Variable Descripción
    $slack.bot.user.token Token de autenticación
  • Esquema de respuesta

    La operación completa las siguientes variables:

    Variable Descripción
    $platform_email Correo del usuario
    $platform_userID ID del usuario

La operación compara el nombre completo del usuario desde tu plataforma con $llm_response_manager_full_name o $newHire_fullName para encontrar el usuario correcto. Actualiza esta lógica para que coincida con la estructura de datos de usuarios de tu plataforma:

pass = false;
real_name = json$get_response$item.members$item.profile$real_name$;
if($llm_response_manager_full_name == real_name || $newHire_fullName == real_name,
  pass = true;
  WriteToOperationLog("We found a matching slack user for: " + $llm_response_manager_full_name + " " + $newHire_fullName);
);
//pass = true;
Pass

Actualiza los esquemas de origen y destino de la transformación para que coincidan con la API de tu plataforma de comunicación.