Saltar al contenido

Jitterbit HR Agent

Overview

El Jitterbit HR Agent (Agente de RRHH) es un agente de IA proporcionado a través de Jitterbit Marketplace que está diseñado para apoyar al equipo interno de RRHH de su organización. Este agente utiliza la técnica de Generación Aumentada por Recuperación (RAG), que combina el razonamiento de LLM con acceso a herramientas externas y fuentes de datos. El agente 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 nuevos empleados utilizando Jitterbit Studio.

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

  • Se integra con el modelo de lenguaje grande (LLM) de OpenAI para potenciar un Asistente de IA de RRHH inteligente al que se accede a través de una API personalizada creada con Jitterbit API Manager.

Este documento explica cómo configurar y operar el agente de IA. El documento primero cubre la arquitectura y los requisitos previos, luego proporciona ejemplos de solicitudes para mostrar lo que el agente puede hacer, y finalmente ofrece pasos para instalar, configurar y operar el agente.

AI agent architecture

Los siguientes diagramas representan la arquitectura implementada en el Agente de RRHH.

Pre-boarding (Antes del primer día)

--- config: 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

First-day onboarding

--- config: 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

First few weeks and training

--- config: 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

General usage

--- config: 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

Prerequisites

Para utilizar el Agente de RRHH, necesita los siguientes componentes.

Harmony components

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

OpenAI

Debes tener una suscripción a OpenAI para crear y gestionar los siguientes recursos:

  • Clave de API de OpenAI. Consulta la guía de OpenAI para más información.

Endpoints soportados

El diseño del agente de IA incorpora los siguientes endpoints. Puedes acomodar otros sistemas modificando las configuraciones de endpoints y flujos de trabajo del proyecto.

Sistema de Información de Recursos Humanos (HRIS)

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

Nota

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

Gestión de servicios

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

Documentación

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

Interfaz de chat

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

Si deseas utilizar una aplicación diferente como la 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 Recursos Humanos a los endpoints apropiados, proporciona la siguiente funcionalidad principal.

Pre-embarque de empleados

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

Incorporación del primer día

  • Proporciona una introducción al gerente, equipo y otros contactos útiles en la organización.
  • Realiza un seguimiento de las tareas pendientes para el nuevo empleado, los equipos de RRHH y 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 de tiempo especificado.
  • 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 un camino de aprendizaje personalizado basado en el rol laboral.

Ejemplos de solicitudes

Las siguientes son solicitudes de ejemplo que el Agente de RRHH puede manejar con acceso a los datos apropiados.

Preguntas relacionadas con RRHH

  • "¿Quién es mi gerente?"
  • "¿Quién estará ausente la próxima semana?"
  • "¿Quién estuvo ausente la semana pasada?"
  • "¿Quién estará ausente mañana?"
  • "¿Está [Insertar Nombre] ausente hoy?"

Preguntas relacionadas con servicios de TI

  • "¿Cómo restablezco mi contraseña?"
  • "Necesito ayuda para configurar mi computadora."
  • "¿Puedes ayudarme a configurar mi cuenta de correo electrónico?"
  • "Mi mouse está roto. ¿Qué debo hacer?"
  • "Mi laptop no está cargando. ¿Qué debo hacer?"
  • "Necesito un mouse nuevo. ¿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. Descargar personalizaciones e instalar el proyecto de Studio.
  2. Revisar flujos de trabajo del proyecto.
  3. Preparar BambooHR.
  4. Crear un formulario de Google.
  5. Preparar Jitterbit Cloud Datastore.
  6. Configurar variables del proyecto.
  7. Probar conexiones.
  8. Agregar plantillas de correo electrónico.
  9. Crear horarios.
  10. Desplegar el proyecto.
  11. Crear la API personalizada de Jitterbit.
  12. Crear la aplicación de Slack, probar la conexión de Slack y redeplegar el proyecto.
  13. Activar los flujos de trabajo del proyecto.
  14. Solución de problemas.
  15. Uso de diferentes puntos finales.

Descargar personalizaciones e instalar el proyecto

Sigue estos pasos para descargar archivos de personalización e 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 HR Agent. Para localizar el agente, puedes usar la barra de búsqueda o, en el panel de Filtros bajo Tipo, seleccionar Agente de IA para filtrar la visualización y mostrar solo los agentes de IA disponibles.

  3. Haz clic en el enlace de 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 referirte a la documentación después de iniciar el proyecto.

  4. Haz clic en Iniciar Proyecto para abrir un diálogo de configuración de dos pasos. El 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, en su lugar aparece Obtener este agente. Haz clic en Obtener este agente para abrir un diálogo informativo, 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 la 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 diálogo de configuración incluye una advertencia de no importar la plantilla antes de aplicar las personalizaciones de los puntos finales. Esa advertencia no se aplica a este agente de IA y se puede ignorar. 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 se creará el proyecto de Studio, luego haz clic en Crear Proyecto.

  8. Se muestra un diálogo de progreso. Una vez que indique que el proyecto ha sido creado, utiliza el enlace del diálogo Ir a Studio o abre el proyecto directamente desde la página de Proyectos de Studio.

Revisar flujos de trabajo del proyecto

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

Nota

En el proyecto, los nombres de los flujos de trabajo precedidos por un asterisco (*) indican flujos de trabajo principales que inician cadenas de acciones. Estos flujos de trabajo principales suelen estar programados o ser activados 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
Operaciones Comunes Infraestructura central Manual Ninguna
Llamadas de RRHH Infraestructura central Llamado por otros flujos de trabajo BambooHR
Llamadas de Plataforma Infraestructura central Llamado por otros flujos de trabajo Slack o alternativa
Llamadas de ITS Infraestructura central Llamado por otros flujos de trabajo Jira o alternativa
Correos Electrónicos Infraestructura central Llamado por otros flujos de trabajo Configuración SMTP
Llamada a Datastore Infraestructura central Llamado por otros flujos de trabajo Cloud Datastore
Bot de Plataforma de Comunicación Infraestructura central API Llamadas de Plataforma, API Personalizado
OpenAI - Llamada a Función OpenAI/LLM Llamado por flujos de trabajo programados API de OpenAI
OpenAI - Intérprete de Código OpenAI/LLM Llamado por otros flujos de trabajo API de OpenAI
OpenAI - Análisis de PDF OpenAI/LLM Llamado por otros flujos de trabajo API de OpenAI
OpenAI - Enrutador AskHR OpenAI/LLM Llamado por flujos de trabajo de chatbot API de OpenAI
OpenAI - Llamada a Función AskHR OpenAI/LLM Llamado por chatbot API de OpenAI, Enrutador AskHR
AskHR - Después de la Herramienta - Inicio OpenAI/LLM Llamado por Llamada a Función AskHR Varía según la herramienta
Pre Onboarding - Oferta Firmada Pre-boarding Programado Llamadas de RRHH, Llamada a Función de OpenAI
Pre Onboarding - Documentos de la Semana Antes Pre-boarding Programado Llamadas de RRHH, Correos Electrónicos
Pre Onboarding - Solicitud de ITSM Pre-boarding API Llamadas de RRHH, Llamadas de ITS, API Personalizado
Primer Día - Presentaciones Primer día Programado Llamadas de RRHH, Correos Electrónicos
Primer Día - Escribir Publicación en LI Primer día Programado Llamadas de RRHH, OpenAI
Primera Semana - Ruta de Aprendizaje Personalizada Primera semana Programado Llamadas de RRHH, Intérprete de Código de OpenAI
General - Tareas de RRHH Restantes del Empleado En curso Programado Llamadas de RRHH
Primera Semana - Tickets de IT en Progreso En curso Programado Llamadas de RRHH, Llamadas de ITS

Categorías de flujo de trabajo y descripciones

Flujos de trabajo de infraestructura básica

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. Debe actualizar el script de Plantillas de Correo Electrónico HTML para alinearlo con las plantillas de correo electrónico de su empresa, asegurándose de que todas las variables existentes dentro de las plantillas permanezcan sin cambios o se modifiquen de acuerdo con sus necesidades.

Llamadas de RRHH

Este flujo de trabajo centraliza las operaciones básicas de RRHH para el proyecto. Estas operaciones fundamentales de RRHH se utilizan en flujos de trabajo individuales posteriores, con todas las respuestas estandarizadas y mapeadas a esquemas comunes.

Llamadas de Plataforma

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

Llamadas de ITS

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

Nota

Al usar Jira, el agente de IA utiliza dos operaciones para crear tickets: ITSM - Crear Tarea en JIRA y Actualizar Tarea en JIRA. Debido a las limitaciones de la API de Jira, ambas operaciones deben trabajar juntas como un único proceso de creación de tickets.

Correos Electrónicos

Este flujo de trabajo maneja las comunicaciones por correo electrónico requeridas del proyecto y se utiliza con frecuencia a lo largo del ciclo de vida del proyecto.

Llamada a la Base de Datos

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 recupera a través de una consulta cuando se necesitan para el proyecto.
  • Elimina el registro una vez que ya no es necesario.
Bot de Plataforma de Comunicación

Nota

Si no estás utilizando Slack, puedes ignorar este flujo de trabajo y no se activará.

Este flujo de trabajo gestiona las solicitudes de bot de Slack entrantes. 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/LLM

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

OpenAI - Llamada a Funciones

Este flujo de trabajo sirve como el mecanismo centralizado de llamada a funciones 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 en función de los mensajes proporcionados por el usuario al LLM. Está diseñado para ser activado por acciones que se originan fuera de la plataforma de comunicación o del chatbot.

OpenAI - Intérprete de Código

Este flujo de trabajo realiza análisis bajo demanda de documentos CSV para identificar resultados específicos que coincidan con varios casos de uso. Por ejemplo, determina qué aplicaciones deben recibir acceso según el rol laboral 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 AskHR

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

OpenAI - Llamada a Funciones AskHR

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

AskHR - Después de la herramienta

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

Flujos de trabajo de pre-embarque

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

Pre Embarque - Oferta Firmada

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

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

Para obtener detalles sobre cómo configurar el horario, consulte la sección Crear horarios.

Pre Embarque - Semana Antes de Documentos

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

  • Alerta al gerente relevante, a los equipos de TI y de RRHH.
  • Envía un correo electrónico que contiene documentos esenciales de incorporación, como información sobre la cultura de la empresa y los beneficios para empleados.
Pre Embarque - Solicitud ITSM

Este flujo de trabajo es iniciado por 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 horario para identificar automáticamente a los empleados cuya fecha de contratación (primer día de trabajo) es hoy, y luego realizar acciones específicas como se describe a continuación.

Primer Día - Introducciones

Este flujo de trabajo realiza las siguientes acciones:

  • Envía mensajes de alerta al gerente del nuevo empleado.
  • Redacta un correo electrónico de introducción que contiene información esencial del primer día y enlaces de la empresa.
Primer Día - Escribir Publicación en LI

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.

Primera Semana - Ruta de Aprendizaje Personalizada

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

  • Realiza un análisis de CSV para hacer coincidir sus posiciones 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 las operaciones continuas de RRHH y TI a lo largo del ciclo de vida del empleado.

General - Tareas de RRHH Restantes del Empleado

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

  • Verifica si hay empleados con tareas incompletas dentro de un período de 90 días.
  • Genera correos electrónicos separados tanto para el empleado como para el equipo de RRHH, detallando las tareas específicas de las que cada parte es responsable.
Primera Semana - Tickets de TI en Progreso

Este flujo de trabajo se ejecuta según un horario para gestionar proactivamente las tareas pendientes de incorporación de servicios de TI para nuevos empleados. Realiza las siguientes acciones:

  • Escanea a los empleados que están en su primera semana y aún tienen 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 está completo.
  • Envía un mensaje directo al empleado, ofreciendo asistencia para asegurar que reciba el soporte de TI necesario.

Preparar BambooHR

Los siguientes componentes esenciales deben ser creados en BambooHR para el Agente de RRHH. 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 Agente de RRHH utiliza estas carpetas para encontrar recursos relevantes para la funcionalidad del flujo de trabajo.

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

  2. Haz clic en + Agregar Carpeta.

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

    • Documentos de Capacitación
    • Documentos de Incorporación (TODOS)
    • Documentos de TI
  4. Haz clic en Guardar o Crear para crear la carpeta.

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

Agregar archivos en las carpetas

Para que los flujos de trabajo del Agente de RRHH funcionen, se deben colocar archivos específicos dentro de las carpetas correspondientes de BambooHR. El paquete del Agente de RRHH proporciona archivos CSV de muestra. Es crucial que la estructura de cualquier archivo de reemplazo permanezca idéntica; sin embargo, los nombres de los archivos pueden cambiarse. Si se cambia un nombre de archivo, esta modificación debe aplicarse de manera consistente en todas las demás partes del proyecto donde se haga referencia al nombre del archivo, ya que estos archivos son esenciales para el funcionamiento de los flujos de trabajo.

Subir documentos de capacitación

El paquete del Agente de RRHH incluye un archivo CSV de muestra llamado TEMPLATE - HR Agent Onboarding Courses - Job Role.csv. Este archivo enumera los cursos obligatorios asignados a cada rol laboral.

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

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

  3. Guarda el archivo actualizado.

  4. Inicia sesión en BambooHR.

  5. Desde el menú de la izquierda, selecciona Archivos.

  6. Haz clic en la carpeta Documentos de Capacitación.

  7. Haz clic en Subir.

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

Subir documentos de TI

El paquete del Agente de RRHH incluye tres archivos CSV de muestra para el flujo de trabajo de creación de tickets de incorporación de TI (Pre Incorporación | Solicitud de ITSM). Sube solo los archivos que apliquen al proceso de incorporación de TI de tu empresa:

  • TEMPLATE - IT_Apps_JobRole.csv: Enumera las aplicaciones a las que cada rol laboral puede acceder.
  • TEMPLATE - IT_G-Suite Groups.csv: Enumera los grupos de Google Workspace a los que cada rol laboral puede acceder.
  • TEMPLATE - IT_LaptopChoice_JobRole.csv: Enumera el tipo de laptop asignado a cada rol laboral.

Sigue estos pasos para subir los documentos de TI:

  1. Abre cada archivo CSV que necesites del paquete de Agente de RRHH.

  2. Reemplaza los datos de muestra con los roles laborales y recursos de TI de tu empresa. No modifiques los encabezados de las columnas ni la estructura del archivo.

  3. Guarda cada archivo actualizado.

  4. En BambooHR, ve a Archivos.

  5. Haz clic en la carpeta Documentos de TI para abrirla.

  6. Haz clic en Subir.

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

Subir documentos de incorporación

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

Para subir archivos a esta carpeta:

  1. Reúne los documentos de incorporación que deseas enviar a los nuevos empleados.

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

  3. Haz clic en la carpeta Documentos de Incorporación (TODOS) para abrirla.

  4. Haz clic en Subir.

  5. Selecciona uno o más archivos de tu computadora y haz clic en Abrir.

Crear informes personalizados en BambooHR

Debes crear dos informes personalizados en BambooHR para que el Agente de RRHH los recupere:

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

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

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

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

  3. Haz clic en + Nuevo Informe (generalmente en la parte superior derecha).

  4. Ingresa un nombre para el informe: Informe de Empleados.

  5. Agrega los siguientes campos al informe:

    • Nombre
    • Apellido
    • Fecha de Contratación
    • País
    • Correo Electrónico Laboral
    • Correo Electrónico Personal
    • Correo Electrónico del Supervisor
    • Nombre del Supervisor
    • URL de LinkedIn
    • Departamento
    • Título del Trabajo
    • Reporta a
    • Región de Usuario SRE

      Nota

      SRE User Region es un campo personalizado. Este campo se utiliza al crear un ticket de incorporación de TI. Si su empresa no requiere esta información, este campo es opcional. De lo contrario, asegúrese de crear este campo personalizado en BambooHR siguiendo la documentación del generador de campos personalizados.

    BambooHR solo hace disponibles ciertos campos de empleados después de la fecha de contratación de un empleado. Para apoyar los flujos de trabajo de preincorporación, debe crear y llenar manualmente los siguientes campos personalizados cuando agregue un nuevo registro de empleado:

    • NewHireDepartment
    • NewHireJobTitle
    • NewHireReportsTo

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

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

  7. Haga clic en Guardar.

Crear informe de tareas de empleados

Para generar las tareas de recursos humanos restantes necesarias para el proyecto del Agente de Recursos Humanos, utilice el siguiente procedimiento para crear un informe que incluya todas las tareas esenciales de los empleados requeridas para el proyecto:

  1. Inicie sesión en su panel de BambooHR.

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

  3. Haga clic en + Nuevo Informe (generalmente en la parte superior derecha).

  4. Ingrese un nombre para el informe: Informe de Tareas de Empleados.

  5. Agregue 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. Haga clic en Guardar.

Crear clave API de BambooHR

Debe generar una clave API para conectar BambooHR dentro del proyecto. Para crear su clave API, siga las instrucciones de BambooHR para Crear una Nueva Clave API (se requieren permisos). Una vez que se crea la clave API, asegúrese de guardarla. Esta clave se utiliza en los siguientes pasos de configuración.

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 gestión de servicios de TI (Preincorporación | Solicitud de ITSM). Estos pasos se pueden omitir si se prefiere una alternativa a Google Forms. Sin embargo, las API personalizadas de Jitterbit en los siguientes pasos Crear la API personalizada de Jitterbit aún deben seguirse, y la API debe ser activada por su formulario preferido.

Crear el formulario

  1. Ve a Google Forms.

  2. Crea un formulario en blanco.

  3. Agrega los siguientes campos obligatorios:

    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. Dale un nombre a tu formulario: Formulario de Incorporación.

Vincular el formulario a una hoja de Google

  1. En el editor del formulario, haz clic en Respuestas.

  2. Haz clic en el ícono verde de Google Sheets en la parte superior derecha.

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

  4. Ingresa el nombre de la hoja de cálculo: Formulario de Incorporación (Respuestas).

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

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

  • Marca de tiempo
  • Nombre completo
  • Dirección
  • Número de teléfono
  • Correo electrónico

Si el orden de las columnas es diferente, las preguntas del formulario pueden no coincidir con el orden esperado. Para solucionar esto, reorganiza las preguntas en tu formulario para que coincidan con la secuencia anterior.

Configurar el Apps Script

  1. En la hoja de Google vinculada, ve a Extensiones > Apps Script.
  2. Se abre el editor de Apps Script. Por defecto, el script se llama Proyecto sin título.
  3. En la parte superior del editor, haz clic en Proyecto sin título y renómbralo a Formulario de Incorporación (Respuestas).
  4. En el editor de Apps Script, elimina cualquier código existente.
  5. Abre el archivo googleForm_appScript.js del paquete de Agente de RRHH.
  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 desencadenador 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 ícono de Desencadenadores en la barra lateral izquierda.

  2. Haz clic en Agregar desencadenador.

  3. Configura la configuración del desencadenador:

    • Elige qué función ejecutar: Selecciona onFormSubmit.
    • Selecciona la fuente del evento: Selecciona Desde la hoja de cálculo.
    • Selecciona el tipo de evento: Selecciona Al enviar el formulario.
    • Configuración de notificación de fallos: Selecciona Notificarme inmediatamente.
  4. Haz clic en Guardar.

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

Comparte el formulario

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

  2. Haz clic en Enviar.

  3. Haz clic en el ícono de enlace para obtener el enlace compartible.

  4. En Obtener enlace, cambia la configuración de acceso a Cualquiera con 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.

Prepara Jitterbit Cloud Datastore

Si aún no tienes un token de acceso de 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 configuración.

Crear un almacenamiento de claves en Jitterbit Cloud Datastore llamado candidate_welcome_emails, con campos que tienen los nombres y tipos listados en la tabla a continuación.

A medida que agregues campos personalizados, utiliza la tabla a continuación para determinar si cada uno debe ser activado como Requerido en la interfaz de usuario de Cloud Datastore. Los campos AlternativeKey y Value son campos predeterminados que no se pueden eliminar ni activar.

candidate_welcome_emails

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

Nombre Tipo Requerido Definición del valor Descripción
Key Texto Autocompletado 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 Autocompletado Esto no se utiliza.
Value Texto No Autocompletado Nombre y apellido del candidato sin espacios. Este valor se genera dentro del flujo de trabajo Pre Onboarding Offer Signed.
CandidateEmail Texto No Autocompletado 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 No Autocompletado El contenido del correo electrónico que se genera para el candidato. Esto contiene el contenido personalizado del correo electrónico. Su valor se genera dentro del flujo de trabajo Pre Onboarding | Offer Signed.

Configurar variables del proyecto

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

Esto se puede hacer utilizando el menú de acciones del proyecto para seleccionar Variables del Proyecto y abrir 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 Recursos Humanos y TI para completar los valores de las variables en esta sección.

Nombre de la 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 API para el nombre de usuario de autenticación básica de BambooHR. Consulta la documentación sobre cómo obtener una clave 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 la elección de laptop.
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 las 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 para la autenticación básica de Jira.
jira.task.reporter ID interno del reportero en Jira.
jira.task.assignee ID interno del asignado en Jira.
jira.project.name Nombre del proyecto en Jira.
jira.baseUrl URL base de Jira para solicitudes HTTP.
jira.api.token Token de API de Jira. Consulta conexión de Jira para enlaces útiles que te ayuden a crear tu token de API.

Confluence

Nombre de variable Descripción
confluence.username Nombre de usuario para la autenticación básica de Confluence.
confluence.apiKey Contraseña para la autenticación básica de Confluence. Para más información sobre dónde obtener tu clave de API, visita Gestionar 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 a lo largo del proyecto.
email.to.hr Dirección de correo electrónico del departamento de Recursos Humanos para recibir notificaciones a lo largo del proyecto.

Nota

El conector de correo electrónico utiliza seguridad SMTP configurada en SSL y el puerto SMTP configurado en 465.

OpenAI y GPT

Nombre de variable Descripción
openAI.apiKey Clave API de OpenAI para autenticación. Para más información, visita OpenAI.
openAi.url.path Ruta URL para llamadas a la API de OpenAI. Asignada dinámicamente por la aplicación. Déjala vacía.
gpt.toolChoice Modo de selección de herramienta para la llamada a funciones de GPT. Debe configurarse en auto.
gpt.temperature Controla la aleatoriedad en las respuestas de GPT (0.0-2.0). Déjalo vacío para usar el valor predeterminado o especifica un valor personalizado.
gpt.model Identificador del modelo GPT. Debe configurarse en GPT-4o.
gpt.maxTokens Número máximo de tokens en las 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 aplicación 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 TI. Se encuentra en los detalles del canal.
slack.hrChannel.ID ID del canal de Slack para notificaciones de RRHH. 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 aplicación.

Nota

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

Otro

Nombre de variable Descripción
your.company El nombre de tu empresa. Ejemplo: Jitterbit
welcome.form La URL del formulario que se 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 TI.
Introduction.companyContact.url La URL de contactos esenciales de la empresa.
hr.tasks.link Una URL que guía a los empleados a completar sus tareas restantes de RRHH. Si no existe una URL dedicada, proporciona la página principal de tu plataforma de RRHH.
cloud.datastore.key Tu clave de Cloud Datastore. Para más detalles, consulta Preparar Jitterbit Cloud Datastore.
resource.IT.page El ID de la página de incorporación de TI. El chatbot hace referencia a esta página al responder preguntas sobre la incorporación de TI.
Introduction.orgChart.url La URL de tu organigrama.
offerSigned.LastModifiedDate.Manual.Date La fecha de ejecución del flujo de trabajo manual que anula la fecha almacenada en caché para el flujo de trabajo Pre Onboarding | Offer Signed.
offerSigned.LastModifiedDate.Manual Establecer en true para habilitar la anulación de la fecha de ejecución manual para el flujo de trabajo Pre Onboarding | Offer Signed.

Probar conexiones

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

Esto se puede hacer desde la pestaña Endpoints y conectores del proyecto en la paleta de componentes de diseño, pasando el cursor sobre cada endpoint y haciendo clic en Probar.

Agregar plantillas de correo electrónico

En el flujo de trabajo Operaciones Comunes, en su operación Scripts Comunes, puedes encontrar un script llamado Plantillas de Correo Electrónico HTML. Este script contiene todas las plantillas de correo electrónico para el proyecto. Se incluyen plantillas de muestra de Jitterbit como guía, pero deben ser reemplazadas por las plantillas de correo electrónico reales de tu empresa.

Crear horarios

Ciertos flujos de trabajo requieren ejecución programada. El agente de IA incluye un horario preconfigurado, Horario Diario, que está configurado para disparos diarios.

Tienes la opción de usar este Horario Diario existente (esto se puede hacer desde el menú de acciones de la operación en Configuraciones > Horarios) o crear un nuevo horario. Las operaciones que se enumeran a continuación deben tener un horario asociado:

  • Controlador - Buscar Oferta Firmada
  • Controlador - Buscar Nuevo Empleado - Semana Anterior
  • Controlador - Buscar Presentaciones
  • Controlador - Buscar Escribir Publicación en LI
  • Controlador - Buscar - Ruta de Aprendizaje Personalizada
  • Controlador - Buscar - Tareas de RRHH Restantes del Empleado
  • Controlador - Buscar - Tickets de TI en Progreso

Desplegar el proyecto

  1. Abre el flujo de trabajo Llamadas a Datastore.

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

    • Insertar Correo Electrónico de Bienvenida
    • Consultar Correo Electrónico de Bienvenida
    • Eliminar Elementos
  3. Haz clic en cada actividad de endpoint de Cloud Datastore y selecciona el almacenamiento llamado candidate_welcome_emailsStudio que creaste en el paso de Preparar Jitterbit Cloud Datastore.

  4. Haz clic en Siguiente, y luego haz clic en Finalizar.

  5. Repite los pasos 3 y 4 para cada actividad de punto final de Cloud Datastore.

  6. Despliega el proyecto de Studio. Esto se puede hacer utilizando el menú de acciones del proyecto para seleccionar Desplegar.

Crea la API personalizada de Jitterbit

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

Crea el controlador de solicitudes de API de Slack bot

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

  • Servicio API: HR Agent - PlatformBot | Inbound Event
  • Ruta: /
  • Proyecto: Selecciona el proyecto de Studio creado a partir del Jitterbit HR Agent en Marketplace
  • Operación a activar: PlatformBot | Inbound Event
  • Método: POST
  • Tipo de respuesta: System Variable

Retén la URL del servicio de la API publicada para usarla en la creación de la aplicación de Slack. La URL del servicio se puede encontrar en el panel de detalles de API en la pestaña Servicios al pasar el cursor sobre la columna Acciones del servicio y hacer clic en Copiar URL del servicio API.

Crea el controlador de solicitudes de API de Google Form

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

  • Nombre del servicio: HR Agent - Create ITSM Request API
  • Proyecto: Selecciona el proyecto de Studio creado a partir del 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 ha desplegado el proyecto Jitterbit HR Agent
    • Tipo: API Key
    • Clave: X-APIKey
    • Valor: Recibes una clave única. Copia este valor por ahora. Esto es necesario para completar la configuración del formulario de Google.
    • Haz clic en Guardar.

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 el Formulario de Google. Puedes encontrar la URL del servicio en el panel de detalles de la API en la pestaña Servicios. Para copiar la URL, pasa el cursor sobre la columna Acciones del servicio y haz clic en Copiar URL del servicio de API. Después de tener tanto la clave de API como la URL del servicio, completa la configuración del formulario de Google 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.

Crea la aplicación de Slack, prueba la conexión y vuelve a implementar el proyecto

Para crear la interfaz de chat del Agente de RRHH en Slack, crea una aplicación de Slack utilizando el archivo de manifiesto de la aplicación de Slack proporcionado con los archivos de personalización de este agente de IA. Alternativamente, créala desde cero.

Si utilizas el archivo de manifiesto de la aplicación de Slack proporcionado (slack_app_manifest.json), debes reemplazar los siguientes marcadores de posición con tus propios valores de configuración:

Marcador de posición Descripción
{{Reemplazar con el nombre del bot de Slack}} El nombre que deseas que tenga tu bot de Slack, tal como se muestra a los usuarios. Hay dos lugares en el manifiesto donde debes reemplazar este valor.
{{Reemplazar con la URL de la API de Jitterbit}} La URL del servicio de la API personalizada de Jitterbit que creaste en Crea el controlador de solicitudes de API del bot de Slack.

Después de instalar la aplicación de Slack, obtén su token de bot.

Reabre la configuración de variables del proyecto e ingresa el token del bot para el valor de la variable del proyecto slack.bot.user.token.

Una vez que el token del bot esté configurado, prueba la conexión de Slack y vuelve a implementar el proyecto.

Nota

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

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

Activar los flujos de trabajo del proyecto

Para fines de prueba, prepara tus registros de prueba y ejecuta las siguientes operaciones. Puedes ejecutar una operación utilizando la opción Ejecutar de la operación, que aparece cuando pasas el cursor sobre la operación:

  • 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 son activados por 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. Enviar un mensaje directo a la aplicación de Slack inicia el disparador 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. Enviar un formulario de muestra inicia el disparador de la API personalizada.

Todos los demás flujos de trabajo son activados por otras operaciones y dependen de las que se enumeran arriba. No están destinados a ejecutarse por sí solos.

Solución de problemas

Revisa los registros de API y los registros de operaciones para obtener información detallada sobre la solución de problemas.

Para asistencia adicional, contacta al soporte de Jitterbit.

Uso de diferentes endpoints

Si cambias el endpoint utilizado en la plantilla, debes modificar varios componentes del proyecto. Esta sección describe las actualizaciones requeridas 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 entender cómo funcionan y puede permitirte reutilizar scripts existentes para tus endpoints.

Plataformas HRIS

Si tu empresa utiliza una plataforma de recursos humanos diferente a BambooHR, utiliza la guía 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. Debido a que 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 solicitantes.
  • Get Applicant Status - Prep for Details: Prepara los datos del solicitante para una recuperación detallada.
  • Get Applicant Details: Recupera información detallada sobre los solicitantes.

Estas operaciones se ejecutan en el controlador Controller - Search Offer Signed. Cuando las operaciones detectan un candidato con un 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 los mapeos de campo para asignar las variables requeridas (por ejemplo, offerSigned_manager).

Si creas nuevas operaciones para los requisitos de tu plataforma de recursos humanos, agrégalas al controlador Controller - Search Offer Signed.

Recuperar informes personalizados de tu plataforma de recursos humanos

La operación GET Custom Report by ID tiene dos propósitos:

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

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

Los siguientes flujos de trabajo utilizan esta operación:

Flujo de trabajo Operación de llamada Operación de procesamiento
AskHR | Después de la herramienta | Iniciar - encontrar_manager Iniciar - encontrar_manager AskHr - encontrar_manager - Directorio de empleados a esquema de empleado común
Pre Onboarding | Semana antes de documentos Controlador - Buscar nuevo empleado - Semana antes GET Report - Datos de semana antes a esquema de modelo de empleado común
Pre Onboarding | Solicitud ITSM Iniciar | API de solicitud ITSM GET Report - Directorio de empleados a esquema de modelo de empleado ITSM común
Primer día | Presentaciones Controlador - Buscar presentaciones GET Report - Datos de presentaciones del primer día a esquema de modelo de empleado común
Primer día | Escribir publicación en LI Controlador - Buscar escribir publicación en LI GET Report Empleado - Datos de publicación en LI a esquema de modelo de empleado común
Primera semana | Ruta de aprendizaje personalizada Controlador - Buscar - Ruta de aprendizaje personalizada Ruta de aprendizaje personalizada - Datos de empleados a esquema de modelo de empleado común
General | Tareas de HR restantes del empleado Controlador - Buscar - Tareas de HR restantes del empleado Tareas de HR restantes del empleado a Tareas de HR planas
Primera semana | Tickets de IT en progreso Controlador - Buscar - Tickets de IT en progreso GET Report Empleado - Filtrar primera semana a esquema de modelo de empleado común

Para cada flujo de trabajo, 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 flujo de trabajo General | Tareas de RRHH restantes del empleado utiliza GET Custom Report by ID para el informe de tareas de RRHH restantes. Si no puedes usar la misma operación para este flujo de trabajo, crea una nueva operación y llámala desde el controlador Controller - Search - Employee Remaining HR Tasks.

Recuperar datos del empleado por ID

La operación Get Employee by Id recupera datos de un solo empleado de tu plataforma de RRHH. 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 RRHH.
  2. Abre la transformación Get Employee Details by Id para actualizar el esquema de origen y completar los mapeos de campo para asignar las variables requeridas.

Descargar archivos de tu plataforma de RRHH

Las siguientes operaciones descargan archivos de tu plataforma de RRHH:

  • 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: Maneja la descarga de archivos a través de la API.
Configurar Get List of Files
  1. Actualiza la operación con la llamada a la API de tu plataforma de RRHH 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 flujo de trabajo.
  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.
Configurar 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 flujo de trabajo cuando descargas un solo archivo de una carpeta.

Configurar Obtener lista de archivos - Descargar todos los archivos

Esta operación descarga todos los archivos de la carpeta filtrada. La operación se utiliza principalmente en el flujo de trabajo Pre Onboarding | Semana antes de los documentos para enviar documentos de incorporación. Para más información, consulta Revisar flujos de trabajo del proyecto.

Configurar Obtener lista de archivos - Descargar archivo v2

Esta operación está vinculada tanto a Obtener lista de archivos - Filtrar y descargar un solo archivo como a Obtener lista de archivos - Descargar todos los archivos como su siguiente paso. Actualiza la operación con la llamada a la API de tu plataforma de recursos humanos para manejar la descarga del archivo.

Recuperar datos de tiempo libre de empleados

La operación Obtener una lista de quién está fuera se utiliza en los flujos de trabajo de AskHR para responder preguntas de los usuarios como "¿Quién está 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 recursos humanos que recupera datos de ausencia.
  2. Usa 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 finalización 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 guía en esta sección para modificar tu proyecto.

Crear 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 - Crear tarea en 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 la consistencia:

    • $it_laptopChoice_list: La elección de laptop del nuevo empleado.
    • $it_application_list: La lista de aplicaciones a provisionar.
    • $it_gSuite_list: La lista de servicios de Google Workspace a provisionar.
    • $newHire_department: El departamento del nuevo empleado.
    • $newHire_region: La región del nuevo empleado.
  3. Asegúrate de que tu operación llene la variable $newHire_itTicket con la URL del ticket de IT de la respuesta de la API.

Recuperar tickets de IT en progreso

La operación Search ITSM Issue recupera tickets de incorporación de IT en progreso. Esta operación se ejecuta como parte del flujo de trabajo Primera Semana | Tickets de IT en Progreso.

Para configurar esta operación para una plataforma ITSM diferente, completa los siguientes pasos:

  1. Actualiza la operación Search ITSM Issue para utilizar el endpoint de la API de tu plataforma ITSM para recuperar tickets de incorporación de IT 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 campo.

Plataformas de gestión del conocimiento

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

Recuperar contenido de incorporación de IT

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

Para configurar esta operación para una plataforma de gestión del conocimiento diferente, completa los siguientes pasos:

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

  2. Actualiza la operación AskHr - Get IT Onboarding Content para utilizar el endpoint de la 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 llene la variable $it_onboarding_content con el contenido recuperado. El agente de IA utiliza esta variable en un aviso de LLM para responder preguntas de los usuarios en el bot de Slack.

Plantillas CSV

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

Las siguientes operaciones contienen indicaciones diseñadas 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 basadas en el rol laboral
Prompt - Application List TEMPLATE - IT_Apps_JobRole.csv Determina las aplicaciones a provisionar según el rol laboral
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 laptops basadas en el rol laboral

Si modificas la estructura de un archivo de plantilla CSV, actualiza la indicació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, utiliza la guía 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 de ITS Calls.

Para configurar el agente de IA para usar una plataforma de formularios diferente, completa los siguientes pasos:

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

  2. Abre la transformación Respuesta del formulario al esquema común de empleados 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, utiliza la guía en esta sección para modificar tu proyecto.

El agente de IA utiliza Cloud Datastore para almacenar correos electrónicos de bienvenida en borrador y direcciones de correo electrónico de candidatos. El datastore permite la inserción, consulta y eliminación de registros. Necesitas la dirección de correo electrónico del candidato almacenada para enviar el correo electrónico de bienvenida después de la aprobación del gerente.

Importante

No cambies los nombres de las variables globales. Usa los nombres de las variables tal como están definidos.

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

Almacenar datos del correo electrónico de bienvenida

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

Campo de datos Variable o valor
Cuerpo del 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 del registro fullname = $offerSigned_name + $offerSigned_surName;
fullname_cleaned = Replace(fullname, " ", "");
"WE-" + fullname_cleaned

Eliminar datos del correo electrónico de bienvenida

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

Configura la operación para aceptar el ID de registro interno de la variable $dataStore_item_id. La operación incluye declaraciones 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 de $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, utiliza la guía en esta sección para modificar tu proyecto.

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

Configurar el controlador de eventos entrantes

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

Actualizar variables del proyecto

Actualiza las siguientes variables del 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 RRHH
slack.bot.id ID del usuario del bot (utilizado para evitar que el bot responda a sus propios mensajes)
slack.bot.user.token Token de acceso OAuth del 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 la plataforma

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

Configura tu operación para llenar las siguientes variables:

Variable Descripción Valor
$platform_bot_id_pass Validación de origen del mensaje Establecer en "true" si el mensaje es de un usuario real
$platform_userID Identificador de usuario ID del usuario que envió 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 la 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 los 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 que 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 la 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 en el historial de conversación y mapea 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 última respuesta en un hilo. Este nodo se llena con variables de la operación Validate Platform Message.

Actualiza el esquema de origen de la 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 (usado para eliminación posterior)

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 la 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 tu 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 mensaje 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 utilizando su ID de usuario.

Configura tu 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 de un usuario y su ID de usuario utilizando su nombre completo.

Configura tu 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 llena las siguientes variables:

    Variable Descripción
    $platform_email Dirección de correo electrónico del usuario
    $platform_userID ID del usuario

La operación compara el nombre completo del usuario de tu plataforma con $llm_response_manager_full_name o $newHire_fullName para encontrar al usuario correcto. Actualiza esta lógica para que coincida con la estructura de datos de usuario 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.