Agente de RR.HH. de Jitterbit
Descripción general
Jitterbit proporciona el Agente de RR.HH. a los clientes a través de Jitterbit Marketplace. Este agente está diseñado para apoyar al equipo interno de RR.HH. 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 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 un LLM para potenciar un Asistente de IA de RR.HH. 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 la arquitectura y los requisitos previos, ejemplos de indicaciones que muestran qué puede hacer el agente, y pasos para instalar, configurar y operar el agente de IA.
Arquitectura del agente de IA
Los siguientes diagramas representan la arquitectura implementada en el Agente de RR.HH.
Pre-incorporación (Antes del primer día)
Incorporación del primer día
Primeras semanas y capacitación
Uso general
Requisitos previos
Para utilizar el Agente de RR.HH., necesitas los siguientes componentes.
Componentes de Harmony
Debes tener una licencia de Jitterbit Harmony con acceso a los siguientes componentes:
- Jitterbit Studio
- Jitterbit API Manager
- Agente de RR.HH. de Jitterbit adquirido como complemento de licencia
- Jitterbit Cloud Datastore (opcional)
Puntos de conexión compatibles
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 puesto.
Nota
Debes tener los permisos apropiados en tu HRIS para crear claves 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 gestionar una clave 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 RR.HH. a los puntos de conexión apropiados, proporciona la siguiente funcionalidad principal.
Pre-incorporación de empleados
- Notifica al equipo de contratación de una oferta aceptada.
- Crea un correo de bienvenida y solicita aprobación para enviarlo al nuevo empleado.
- Notifica al nuevo empleado sobre las tareas requeridas y el papeleo asignado según la ley local y la regulación de la residencia del candidato.
- Crea un ticket para la incorporación de TI, especificando el equipo requerido, las aplicaciones y los grupos de correo.
Incorporación del primer día
- Proporciona una introducción al gerente, equipo y otros contactos útiles en toda la organización.
- Rastrea las tareas pendientes para el nuevo empleado, los equipos de RR.HH. e TI, y proporciona actualizaciones conforme 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 presentar 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
Los siguientes son ejemplos de indicaciones que el Agente de HR puede manejar con acceso a los datos apropiados.
Preguntas relacionadas con HR
- "¿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?"
Preguntas relacionadas con servicios de IT
- "¿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 está cargando. ¿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:
- Descarga las personalizaciones e instala el proyecto de Studio.
- Prepara BambooHR.
- Prepara Jira.
- Crea un Google Form.
- Crea la aplicación de Slack.
- Prepara Jitterbit Cloud Datastore.
- Configura las variables del proyecto.
- Prueba las conexiones.
- Agrega plantillas de correo electrónico.
- Crea programaciones.
- Implementa el proyecto.
- Crea la API personalizada de Jitterbit.
- Revisa los flujos de trabajo del proyecto.
- Activa los flujos de trabajo del proyecto.
- Solución de problemas.
- Uso de diferentes endpoints.
Descarga las personalizaciones e instala el proyecto
Sigue estos pasos para descargar archivos de personalización e instalar el proyecto de Studio:
-
Inicia sesión en el portal de Harmony en https://login.jitterbit.com y abre Marketplace.
-
Ubica el agente de IA llamado Jitterbit HR Agent. Para ubicar el agente, puedes usar la barra de búsqueda o, en el panel Filtros bajo Tipo, selecciona Agente de IA para filtrar la pantalla y mostrar solo los agentes de IA disponibles.
-
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 iniciar el proyecto.
-
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, aparece Obtener agente en su lugar. Haz clic en Obtener 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.
-
En el paso de configuración 1, Descargar personalizaciones, se proporcionan los siguientes archivos para presentar la estructura de 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.csvTEMPLATE - IT_G-Suite Groups.csvTEMPLATE - IT_LaptopChoice_JobRole.csvTEMPLATE - 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 personalizaciones de endpoints. Esa advertencia no se aplica a este agente de IA y se puede ignorar. Sigue el orden recomendado de pasos en esta documentación.
-
-
Haz clic en Siguiente.
-
En el paso de configuración 2, Crear un nuevo proyecto, selecciona un entorno donde deseas crear el proyecto de Studio, luego haz clic en Crear proyecto.
-
Se muestra un diálogo de progreso. Después de que indique que el proyecto se ha creado, usa el enlace del diálogo Ir a Studio o abre el proyecto directamente desde la página Proyectos de Studio.
Preparar BambooHR
Los siguientes componentes esenciales deben crearse 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
Crear las siguientes carpetas en BambooHR. El HR Agent utiliza estas carpetas para encontrar recursos relevantes para la funcionalidad del flujo de trabajo.
-
Desde el panel de BambooHR, abre la sección Files.
-
Haz clic en + Add Folder.
-
En el cuadro de diálogo, ingresa uno de los siguientes nombres de carpeta:
Training DocumentsOnboarding Documents (ALL)IT Documents
-
Haz clic en Save o Create para crear la carpeta.
-
Repite los pasos 2-4 para cada carpeta restante.
Agregar archivos a las carpetas
Para que funcionen los flujos de trabajo del HR Agent, archivos específicos deben colocarse en las carpetas correspondientes de BambooHR. El paquete 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 debe aplicarse consistentemente en todas las otras partes del proyecto donde se hace referencia al nombre del archivo, ya que estos archivos son esenciales para la operación de los flujos de trabajo.
Cargar documentos de capacitación
El paquete HR Agent incluye un archivo CSV de ejemplo llamado TEMPLATE - HR Agent Onboarding Courses - Job Role.csv. Este archivo lista los cursos obligatorios asignados a cada departamento.
-
Abre
TEMPLATE - HR Agent Onboarding Courses - Job Role.csvdesde el paquete HR Agent. -
Actualiza el archivo con la información de cursos específica de tu empresa. Mantén la estructura de columnas e intacto el formato.
-
Guarda el archivo actualizado.
-
Inicia sesión en BambooHR.
-
Desde el menú izquierdo, selecciona Files.
-
Haz clic en la carpeta Training Documents.
-
Haz clic en Upload.
-
Selecciona tu archivo CSV actualizado y haz clic en Open.
Cargar documentos de TI
El paquete HR Agent incluye tres archivos CSV de ejemplo para el flujo de trabajo de creación de ticket de incorporación de TI (Pre Onboarding | ITSM Request). Carga solo los archivos que aplican al proceso de incorporación de TI de tu empresa:
TEMPLATE - IT_Apps_JobRole.csv: Lista las aplicaciones a las que cada departamento puede acceder.TEMPLATE - IT_G-Suite Groups.csv: Lista los grupos de Google Workspace a los que cada departamento puede acceder.TEMPLATE - IT_LaptopChoice_JobRole.csv: Lista el tipo de computadora portátil asignado a cada departamento.
Sigue estos pasos para cargar los documentos de TI:
-
Abre cada archivo CSV que necesites del paquete HR Agent.
-
Reemplaza los datos de ejemplo con los departamentos y recursos de TI de tu empresa. No modifiques los encabezados de columna ni la estructura del archivo.
-
Guarda cada archivo actualizado.
-
En BambooHR, ve a Files.
-
Haz clic en la carpeta IT Documents para abrirla.
-
Haz clic en Upload.
-
Selecciona uno o más de tus archivos CSV actualizados y haz clic en Open.
Cargar documentos de incorporación
Carga documentos como guías de cultura empresarial, descripción general 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 cargar archivos en esta carpeta:
-
Reúne los documentos de incorporación que deseas enviar a los nuevos empleados.
-
En BambooHR, ve a Files desde el menú izquierdo.
-
Haz clic en la carpeta Onboarding Documents (ALL) para abrirla.
-
Haz clic en Upload.
-
Selecciona uno o más archivos de tu computadora y haz clic en Open.
Crear reportes personalizados en BambooHR
Debes crear dos reportes personalizados en BambooHR para que el HR Agent los recupere:
- Una lista exhaustiva que detalla todos los empleados actuales.
- Una lista para cada empleado que detalla todas las tareas de HR incompletas, ya sea asignadas directamente al empleado o a su contacto de HR designado.
Crear reporte de empleados
Para generar los datos de empleados necesarios para el proyecto HR Agent, crea un reporte que incluya toda la información esencial del empleado:
-
Inicia sesión en tu panel de BambooHR.
-
En la barra de navegación superior, haz clic en Reports.
-
Haz clic en + New Report (generalmente en la esquina superior derecha).
-
Ingresa un nombre de reporte:
Employees Report. -
Agrega los siguientes campos al reporte:
-
Nombre
- Apellido
- Fecha de contratación
- País
- Correo electrónico de trabajo
- Correo electrónico personal
- Correo electrónico del supervisor
- Nombre del supervisor
- URL de LinkedIn
- Departamento
- Puesto de trabajo
- Reporta a
-
Región del usuario SRE
!!! note "Nota" `Región del usuario 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](https://www.bamboohr.com/product-updates/custom-field-builder).BambooHR solo pone a disposición ciertos campos de empleados después de la fecha de contratación del empleado. Para admitir los flujos de trabajo previos a la incorporación, debes crear y rellenar manualmente los siguientes campos personalizados al agregar un nuevo registro de empleado:
NewHireDepartmentNewHireJobTitleNewHireReportsTo
Para crear estos campos personalizados en BambooHR, sigue la documentación del generador de campos personalizados.
-
Los resultados del filtro deben ser Todos los empleados.
-
Haz clic en Guardar.
Crear un informe de tareas de empleados
Para generar las tareas de RR.HH. restantes necesarias para el empleado en el proyecto del Agente de RR.HH., utiliza el siguiente procedimiento para crear un informe que incluya todas las tareas de empleado esenciales requeridas por el proyecto:
-
Inicia sesión en tu panel de BambooHR.
-
En la barra de navegación superior, haz clic en Informes.
-
Haz clic en + Nuevo informe (generalmente en la esquina superior derecha).
-
Escribe un nombre para el informe:
Informe de tareas de empleados. -
Agrega los siguientes campos al informe:
- Tarea
- Categoría
- Lista de tareas
- Asignado a
- Fecha de vencimiento
- Fecha de finalización
- Completada
-
Los resultados del filtro deben ser Todos los empleados.
-
Haz clic en Guardar.
Crear una 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 que se cree 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éegalos al objeto Tarea:
- Nombre completo
- Reporta a
- Departamento
- Puesto de trabajo
- Región
Cada campo personalizado debe utilizar el tipo text.
Para obtener orientación sobre la creación de campos personalizados, consulta la documentación de Atlassian sobre cómo administrar 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 - Crear tarea en JIRA Request.
Después de completar todos los pasos hasta Probar conexiones, también debes actualizar la actividad de Problema de Jira. Consulta Actualizar la actividad de 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 del ticket de gestión de servicios de TI (Pre Onboarding | ITSM Request). Estos pasos se pueden omitir si se prefiere una alternativa a Formularios de Google. 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 activarse mediante tu formulario preferido.
Crear el formulario
-
Ve a Formularios de Google.
-
Crea un formulario en blanco.
-
Agrega los siguientes campos obligatorios:
-
Nombre completo (tipo de pregunta: Respuesta corta)
-
Dirección (tipo de pregunta: Párrafo)
-
Número de teléfono (tipo de pregunta: Respuesta corta)
-
Correo electrónico (tipo de pregunta: Respuesta corta, con validación de Correo electrónico habilitada)
-
Asigna un nombre a tu formulario:
Formulario de incorporación.
-
Vincular el formulario a una Hoja de Google
-
En el editor de formulario, haz clic en Responses.
-
Haz clic en el icono verde de Google Sheets en la esquina superior derecha.
-
Selecciona Create a new spreadsheet.
-
Ingresa el nombre de la hoja de cálculo:
Onboarding Form (Responses). -
Haz clic en Create para vincular el formulario a la hoja de cálculo.
La hoja de cálculo crea automáticamente columnas basadas en las 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
Si el orden de las columnas es diferente, es posible que las preguntas del formulario no coincidan con el orden esperado. Para solucionar esto, reordena las preguntas en tu formulario para que coincidan con la secuencia anterior.
Configura Apps Script
- En la hoja de Google vinculada, ve a Extensions > Apps Script.
- Se abre el editor de Apps Script. De forma predeterminada, el script se llama
Untitled project. - En la parte superior del editor, haz clic en Untitled project y cámbialo a
Onboarding Form (Responses). - En el editor de Apps Script, elimina cualquier código existente.
- Abre el archivo
googleForm_appScript.jsdel paquete de HR Agent. - Copia todo el código de
googleForm_appScript.jsy pégalo en el editor de Apps Script. - En el código pegado, deja
YOUR_ENDPOINT_HEREyYOUR_API_KEY_HEREcomo marcadores de posición. Actualizarás estos valores más adelante en Create the Jitterbit custom API. - Haz clic en Save.
Configura el disparador de envío de formulario
Configura el script para que se ejecute automáticamente cuando alguien envíe el formulario.
-
En el editor de Apps Script, haz clic en el icono Triggers en la barra lateral izquierda.
-
Haz clic en Add Trigger.
-
Configura los parámetros del disparador:
- 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.
-
Haz clic en Save.
Cuando un usuario envía el formulario, el script envía la respuesta a tu proyecto de HR Agent y activa la operación Create ITSM Request API.
Comparte el formulario
-
Ve a tus Google Forms en forms.google.com y abre tu formulario de incorporación.
-
Haz clic en Send.
-
Haz clic en el icono de enlace para obtener el enlace compartible.
-
En Get link, cambia la configuración de acceso a Anyone with the link.
-
Haz clic en Copy link para copiar la URL del formulario.
-
Comparte este enlace con los nuevos empleados para que puedan acceder y enviar el formulario.
Crea la aplicación de Slack
Para crear la interfaz de chat de Slack, sigue estos pasos:
-
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. Alternativamente, crea la aplicación desde cero. -
Si usas el archivo de manifiesto proporcionado, reemplaza los siguientes marcadores de posición con tus propios valores de configuración:
Placeholder Description {{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 del manifiesto. {{Replace with Jitterbit API URL}}La URL del servicio de la API personalizada de Jitterbit que creaste en Create the Slack bot API request handler. -
Instala la aplicación en tu área de trabajo de Slack.
-
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 de proyecto
slack.bot.user.token. -
Prueba la conexión de Slack y vuelve a implementar el proyecto.
Nota
Agrega tu Slackbot a tus canales de TI y Recursos Humanos. Completa los siguientes pasos:
- Navega al canal donde deseas que se una el bot. En el campo de entrada de mensajes, escribe
/invite @NombreDelBot, dondeNombreDelBotes el nombre de tu bot. - Repite este paso para cada canal donde quieras agregar el bot (TI y Recursos Humanos).
Preparar Jitterbit Cloud Datastore
Si aún no tienes un token de acceso a Cloud Datastore, consulta 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 con los nombres y tipos que se enumeran en la tabla a continuación.
candidate_welcome_emails
Este almacenamiento de claves contiene la lista de nombres de candidatos, correos electrónicos y contenidos personalizados de correos de bienvenida.
| 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-NombreApellido. 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 que se genera para el candidato. Contiene el contenido del correo personalizado. 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.
Para configurar las variables del 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
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 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 cursos. |
Jira
| Nombre de variable | Descripción |
|---|---|
jira.username |
Nombre de usuario para autenticación básica en Jira. |
jira.task.reporter |
ID interno en Jira del reportero. |
jira.task.assignee |
ID interno en Jira del asignado. |
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 obtener enlaces útiles que te ayuden a crear tu token de API. |
Confluence
| Nombre de variable | Descripción |
|---|---|
confluence.username |
Nombre de usuario para autenticación básica en Confluence. |
confluence.apiKey |
Contraseña para autenticación básica en Confluence. Para obtener más información sobre dónde conseguir tu clave de API, visita Administrar tokens de API. |
confluence.base.url |
La URL base para obtener documentación de incorporación de TI. |
Para obtener 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 configurada como SSL y puerto SMTP configurado en 465.
OpenAI
| Nombre de variable | Descripción |
|---|---|
openAI.apiKey |
Clave de API de OpenAI para autenticación. Para obtener más información, visita OpenAI. |
openAi.url.path |
Ruta de URL para llamadas a la API de OpenAI. Se asigna dinámicamente por la aplicación. Déjalo vacío. |
gpt.toolChoice |
Modo de selección de herramienta para llamadas de función de GPT. Se debe establecer 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 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 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 a 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 del organigrama de tu organización. |
Introduction.helpfulIT.url |
La URL de enlaces o información útil de TI. |
Introduction.companyContact.url |
La URL de los contactos esenciales de la empresa. |
hr.tasks.link |
Una URL que guía a los empleados a través de la finalización de las tareas de RRHH restantes. Si no existe una URL dedicada, proporciona la página principal de tu plataforma de RRHH. |
cloud.datastore.key |
Tu clave de Jitterbit Cloud Datastore. Para más detalles, consulta Preparar Jitterbit Cloud Datastore. |
resource.IT.page |
El ID de página de la página de incorporación de TI. El chatbot hace referencia a esta página al responder preguntas sobre incorporación de TI. |
Introduction.orgChart.url |
La URL del organigrama de tu organización. |
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 |
Establece 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
Prueba las configuraciones del endpoint para verificar la conectividad utilizando los valores de variables de proyecto definidos.
Para probar conexiones, dirígete a la pestaña Project endpoints and connectors de la paleta de componentes de diseño, coloca el cursor sobre cada endpoint y haz clic en Test.
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 problema de Jira
Debes actualizar la actividad de problema de Jira para incluir los campos personalizados creados en Preparar Jira:
- Dirígete a la operación
ITSM - Create Task in JIRA. - Abre la actividad de Problem de Jira.
- En Paso 2: Seleccionar un proyecto, haz clic en Refresh y selecciona tu proyecto.
- En Paso 3: Seleccionar un objeto, haz clic en Refresh y selecciona Task.
- Haz clic en Next y luego en Finished.
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ú de acciones de la operación en Settings > Schedules) o crear una nueva programación. Las operaciones que se enumeran a continuación deben tener una programación asociada:
Controller - Search Offer SignedController - Search New Hire - Week BeforeController - Search IntroductionsController - Search Write LI PostController - Search - Personalized Learning PathController - Search - Employee Remaining HR TasksController - Search - In-progress IT Tickets
Implementar el proyecto
-
Abre el flujo de trabajo Datastore Calls.
-
Localiza las siguientes tres actividades de endpoint de Cloud Datastore:
Insert Welcome EmailQuery Welcome EmailDelete Items
-
Haz clic en cada actividad de endpoint de Cloud Datastore y selecciona el almacenamiento llamado
candidate_welcome_emailsStudioque creaste en el paso Preparar Jitterbit Cloud Datastore. -
Haz clic en Next y luego en Finish.
-
Repite los pasos 3 y 4 para cada actividad de endpoint de Cloud Datastore.
-
Implementa el proyecto de Studio.
Para implementar el proyecto, utiliza el menú de acciones del proyecto para seleccionar Deploy.
Crear la API personalizada de Jitterbit
Crea una API personalizada usando API Manager para uno de los siguientes:
-
Controlador de solicitud de API de bot de Slack: Requerido si se utiliza la notificación de Slack incluida en el diseño de este agente de IA.
-
Controlador de solicitud de API de Formulario de Google: Requerido si se utiliza el Formulario de Google incluido en el diseño de este agente de IA.
Crear el controlador de solicitud de API de 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 a partir de
Jitterbit HR Agenten Marketplace - Operation to Trigger:
PlatformBot | Inbound Event - Method:
POST - Response Type:
System Variable
Conserva la URL de servicio de la API publicada para usarla al crear la aplicación de Slack. La URL de servicio se puede encontrar en el panel de detalles de la API en la pestaña Services pasando el cursor sobre la columna Actions del servicio y haciendo clic en Copy API service URL.
Crear el controlador de solicitud de la 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 parámetros:
- Nombre del servicio:
HR Agent - Create ITSM Request API - Proyecto: Selecciona el proyecto de Studio creado desde
Jitterbit HR Agenten 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: Recibirás una clave única. Cópiala por ahora. Esto es obligatorio para completar la configuración de Google Form.
- Haz clic en Save.
- Nombre del perfil:
Asegúrate de asignar el perfil de seguridad a la configuración de la API y guárdalo. Guarda la URL del servicio de la API publicada para usarla en Google Form. Puedes encontrar la URL del servicio en el panel de detalles de la API en la pestaña Services. Para copiar la URL, coloca el cursor sobre la columna Actions del servicio y haz clic en Copy API service URL. Después de tener tanto la clave de API como la URL del servicio, completa la configuración de Google Form en app script. Asegúrate de guardar el app script después de agregar la URL del servicio y la clave de API.
Revisar flujos de trabajo del proyecto
En el proyecto de Studio abierto, revisa los flujos de trabajo junto con las descripciones a continuación para entender qué hacen. Usa la tabla de 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 flujos de trabajo precedidos por un asterisco (*) indican flujos de trabajo principales que inician cadenas de acciones. Estos flujos de trabajo principales típicamente se programan o se activan por API y llaman a los flujos de trabajo de infraestructura principal 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 base | Manual | Ninguna |
| HR Calls | Infraestructura base | Llamada por otros flujos de trabajo | BambooHR |
| Platform Calls | Infraestructura base | Llamada por otros flujos de trabajo | Slack o alternativa |
| ITS Calls | Infraestructura base | Llamada por otros flujos de trabajo | Jira o alternativa |
| Emails | Infraestructura base | Llamada por otros flujos de trabajo | Configuración SMTP |
| Datastore Call | Infraestructura base | Llamada por otros flujos de trabajo | Cloud Datastore |
| Communication Platform Bot | Infraestructura base | API | Platform Calls, API personalizada |
| OpenAI - Function Calling | OpenAI | Llamada por flujos de trabajo programados | API de OpenAI |
| OpenAI - Code Interpreter | OpenAI | Llamada por otros flujos de trabajo | API de OpenAI |
| OpenAI - PDF Analysis | OpenAI | Llamada por otros flujos de trabajo | API de OpenAI |
| OpenAI - AskHR Router | OpenAI | Llamada por flujos de trabajo del chatbot | API de OpenAI |
| OpenAI - AskHR Function Calling | OpenAI | Llamada por chatbot | API de OpenAI, AskHR Router |
| AskHR - After Tool - Start | OpenAI | Llamada por AskHR Function Calling | Varía según la herramienta |
| Pre Onboarding - Offer Signed | Pre-incorporación | Programada | HR Calls, OpenAI Function Calling |
| Pre Onboarding - Week Before Documents | Pre-incorporación | Programada | HR Calls, Emails |
| Pre Onboarding - ITSM Request | Pre-incorporación | API | HR Calls, ITS Calls, API personalizada |
| First Day - Introductions | Primer día | Programada | HR Calls, Emails |
| First Day - Write LI Post | Primer día | Programada | HR Calls, OpenAI |
| First Week - Personalized Learning Path | Primera semana | Programada | HR Calls, OpenAI Code Interpreter |
| General - Employee Remaining HR Tasks | En curso | Programada | HR Calls |
| First Week - In-progress IT Tickets | En curso | Programada | 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. Se debe actualizar el script HTML Email Templates para alinearlo con las plantillas de correo electrónico de la empresa, asegurando que todas las variables existentes dentro de las plantillas se mantengan sin cambios o se modifiquen según sea necesario.
Llamadas de RRHH
Este flujo de trabajo centraliza las operaciones principales de RRHH para el proyecto. Estas operaciones fundamentales de RRHH se utilizan en flujos de trabajo individuales posteriores, con todas las respuestas estandarizadas y asignadas a esquemas comunes.
Llamadas de plataforma
Este flujo de trabajo consolida las operaciones fundamentales de la plataforma de comunicación elegida (por ejemplo, Slack). Estos operadores de plataforma estandarizados se utilizan en flujos de trabajo posteriores. Una función clave es capturar valores esenciales en variables o mover respuestas de operaciones en flujos de trabajo posteriores para estandarizarlos en esquemas comunes para uso consistente.
Llamadas de TI
Este flujo de trabajo consolida las operaciones fundamentales de la plataforma de servicio de TI elegida (por ejemplo, Jira). Estos operadores de servicio de TI estandarizados se utilizan en flujos de trabajo posteriores. Una función clave es capturar valores esenciales en variables o mover respuestas de operaciones en flujos de trabajo posteriores para estandarizarlos en esquemas comunes para 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 las 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 maneja las comunicaciones de correo electrónico requeridas del proyecto y se utiliza frecuentemente en todo el ciclo de vida del proyecto.
Llamada a almacén 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 es necesario para el proyecto.
- Elimina el registro una vez que ya no es necesario.
Bot de plataforma de comunicación
Nota
Si no utilizas Slack, puede 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 Create the Jitterbit custom API 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 - Function Calling
Este flujo de trabajo sirve como el mecanismo centralizado de llamada de 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 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 - Code Interpreter
Este flujo de trabajo realiza análisis bajo demanda de documentos CSV para identificar resultados coincidentes específicos para varios casos de uso. Por ejemplo, determina qué aplicaciones deben recibir acceso según el departamento del nuevo empleado.
OpenAI - PDF Analysis
Este flujo de trabajo analiza currículos en PDF para resumir su contenido, permitiendo al LLM generar correos electrónicos de bienvenida personalizados.
OpenAI - AskHR Router
Este flujo de trabajo sirve como punto de conexión intermediario dentro del uso general del chatbot AskHR, administrando la reformulación de diálogos, resumen de contenido y composición de respuestas.
OpenAI - AskHR Function Calling
Este flujo de trabajo sirve como el mecanismo centralizado de llamada de funciones 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 llamada de función 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 apropiada para ninguna de las herramientas disponibles actualmente.
Flujos de trabajo previos a la incorporación
Estos flujos de trabajo automatizan tareas antes del primer día del nuevo empleado.
Preincorporación - Oferta Firmada
Este flujo de trabajo verifica periódicamente si hay 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.
- Elabora 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 de la programación, consulta la sección Crear programaciones.
Preincorporación - Documentos de la Semana Anterior
Este flujo de trabajo se ejecuta según una programación para identificar 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, equipos de TI y recursos humanos.
- Envía un correo electrónico que contiene documentos esenciales de incorporación, como información sobre la cultura de la empresa y beneficios para empleados.
Preincorporación - Solicitud ITSM
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 contra varios documentos CSV.
- Crea un ticket de TI para el proceso de incorporación.
- Notifica a los equipos de recursos humanos 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 una programación para identificar automáticamente empleados cuya fecha de contratación (primer día de trabajo) es hoy, y luego realizar acciones específicas según se describe a continuación.
Primer Día - Presentaciones
Este flujo de trabajo realiza las siguientes acciones:
- Envía mensajes de alerta al gerente del nuevo empleado.
- Elabora un correo de presentación que contiene información esencial del primer día y enlaces de la empresa.
Primer Día - Escribir Publicación en LinkedIn
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 respalda a los nuevos empleados durante su primera semana.
Primera Semana - Ruta de Aprendizaje Personalizada
Este flujo de trabajo se ejecuta según una programación para identificar empleados cuya fecha de contratación 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 personalizado que proporciona orientación sobre la capacitación requerida.
Flujos de trabajo de operaciones continuas
Estos flujos de trabajo administran operaciones continuas de recursos humanos y TI a lo largo del ciclo de vida del empleado.
General - Tareas Pendientes de Recursos Humanos del Empleado
Este flujo de trabajo se ejecuta según una programación para automatizar recordatorios de tareas pendientes de recursos humanos. 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 recursos humanos, detallando las tareas específicas que cada parte es responsable de completar.
Primera Semana - Tickets de TI en Progreso
Este flujo de trabajo se ejecuta según una programación para administrar proactivamente tareas pendientes de incorporación de servicios de TI 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 recursos humanos 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 asistencia para garantizar que reciba el soporte de TI necesario.
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 usando la opción Ejecutar de la operación, que aparece cuando pasas el cursor sobre la operación:
Controller - Search Offer SignedController - Search New Hire - Week BeforeController - Search IntroductionsController - Search Write LI PostController - Search - Personalized Learning PathController - Search - Employee Remaining HR TasksController - 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 personalizadaHR Agent - PlatformBot | Inbound Event. El envío de un mensaje directo a la aplicación 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 personalizadaHR Agent - Create ITSM Request API. El envío de un formulario de ejemplo inicia el activador de la API personalizada.
Todos los demás flujos de trabajo se activan mediante otras operaciones y dependen de los que se enumeran arriba. No está previsto ejecutarlos por sí solos.
Solución de problemas
Si encuentras problemas, revisa los siguientes registros para obtener información detallada de solución de problemas:
Para obtener más ayuda, comunícate con el soporte de Jitterbit.
Uso de puntos finales diferentes
Si cambias el punto final utilizado en la plantilla, debes modificar varios componentes del proyecto. Esta sección describe las actualizaciones necesarias para cada flujo de trabajo que utiliza el punto final.
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 puntos finales.
Plataformas HRIS
Si tu empresa utiliza una plataforma de recursos humanos distinta a BambooHR, utiliza las instrucciones de 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. Dado que cada plataforma de recursos humanos tiene documentación de API y capacidades ú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 e inician 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:
- Abre la transformación Offer Signed Data to Common Model Employee Schema.
- Actualiza el esquema de origen.
- Completa las asignaciones de campos 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:
- Recuperar una lista de empleados.
- Recuperar tareas de recursos humanos pendientes.
Después de que la operación recupera los datos del informe, el agente llama a una operación posterior que asigna los datos de origen a un esquema común (common_schema_employeeInfo) y asigna las 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:
- Actualiza el esquema de origen para que coincida con tu plataforma HR.
- Completa los mapeos de campos para asignar las variables requeridas.
Nota
El workflow General | Employee Remaining HR Tasks usa GET Custom Report by ID para el informe de tareas HR restantes. Si no puedes usar la misma operación en este workflow, crea una nueva operación y llámala desde el controlador Controller - Search - Employee Remaining HR Tasks.
Recuperar datos de empleado por ID
La operación Get Employee by Id recupera datos de un solo empleado desde tu plataforma 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:
- Actualiza la operación
Get Employee by Idcon la llamada API de tu plataforma HR. - 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.
Descargar archivos desde tu plataforma HR
Las siguientes operaciones descargan archivos desde tu plataforma 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: Maneja la descarga de archivos a través de la API.
Configurar Get List of Files
- Actualiza la operación con la llamada API de tu plataforma HR para obtener una lista de carpetas.
- 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. - Abre la transformación Get List of Files - Filter for Folders v2 para actualizar el esquema de origen.
- 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 workflow cuando descargas un solo archivo de una carpeta.
Configurar 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.
Configurar 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 API de tu plataforma HR para manejar la descarga de archivos.
Recuperar 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 está fuera de la oficina mañana?".
Para configurar esta operación, completa los siguientes pasos:
- Actualiza la operación para llamar al endpoint de API de tu plataforma HR que recupera datos de fuera de la oficina.
-
Utiliza las siguientes variables para filtrar el rango de fechas en tu solicitud HTTP:
-
$llm_response_start_date: La fecha de inicio que genera el LLM basándose en la solicitud del usuario en una plataforma de comunicación como Slack. -
$llm_response_end_date: La fecha de fin que genera el LLM basándose en la solicitud del usuario en una plataforma de comunicación como Slack.
-
Plataformas ITSM
Si tu empresa utiliza una plataforma IT Service Management (ITSM) diferente a Jira, utiliza la orientación en esta sección para modificar tu proyecto.
Crear tickets de incorporación de TI
Para configurar estas operaciones en una plataforma ITSM diferente, completa los siguientes pasos:
-
Actualiza la operación
ITSM - Create Task in JIRApara usar el endpoint de API de tu plataforma ITSM. -
(Opcional.) Considera usar estas variables comunes en la operación para mantener la consistencia:
-
$it_laptopChoice_list: La opción de laptop elegida por el empleado nuevo. $it_application_list: La lista de aplicaciones a aprovisionar.$it_gSuite_list: La lista de servicios de Google Workspace a aprovisionar.$newHire_department: El departamento del empleado nuevo.-
$newHire_region: La región del empleado nuevo. -
Asegúrate de que tu operación complete la variable
$newHire_itTicketcon la URL del ticket de TI de 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, completa los siguientes pasos:
- Actualiza la operación
Search ITSM Issuepara usar el endpoint de API de tu plataforma ITSM para recuperar tickets de incorporación de TI en progreso. - Abre la transformación GET IT Newhire In-progress tickets - to Common Model IT Ticket Schema para actualizar el esquema de origen y completar las asignaciones de campos.
Plataformas de gestión del conocimiento
Si tu empresa utiliza una plataforma de gestión del conocimiento diferente a Confluence, usa las instrucciones de esta sección para modificar tu proyecto.
Recuperar contenido de incorporación de TI
La operación AskHr - Get IT Onboarding Content recupera contenido de 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 usa la variable de proyecto confluence.base.url.
Para configurar esta operación en una plataforma de gestión del conocimiento diferente, completa los siguientes pasos:
-
(Opcional) En la sección variables de proyecto, añade una variable para la URL base de tu plataforma.
-
Actualiza la operación
AskHr - Get IT Onboarding Contentpara usar el endpoint de API de tu plataforma. -
Actualiza la transformación de la operación para que coincida con el esquema de respuesta de tu plataforma.
-
Asegúrate de que tu operación complete la variable
$it_onboarding_contentcon 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 esencial 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 de 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 las aplicaciones a aprovisionar 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 las instrucciones de 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 a fin de usar una plataforma de formularios diferente, completa los siguientes pasos:
-
Configura tu formulario para enviar datos de usuario a la API personalizada de Jitterbit.
-
Abre la transformación Form Response to Common Employee Schema para actualizar el esquema de origen y completar las asignaciones de campos.
Plataformas de almacenamiento de datos
Si tu empresa utiliza una plataforma de almacenamiento de datos distinta 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 electrónicos de bienvenida y direcciones de correo electrónico de candidatos. El almacén de datos 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. Utiliza los nombres de las variables tal como están definidos.
Para configurar el agente de IA de modo que utilice una plataforma de almacenamiento de datos diferente, actualiza las siguientes operaciones:
Almacenar datos de correo electrónico 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 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 de registro | fullname = $offerSigned_name + $offerSigned_surName;fullname_cleaned = Replace(fullname, " ", "");"WE-" + fullname_cleaned |
Eliminar datos de correo electrónico de bienvenida
La operación Datastore | Delete Welcome Email elimina registros después de que se envía el correo electrónico al candidato o si el gerente rechaza el correo electrónico redactado.
Configura la operación para que acepte el identificador de registro interno de la variable $dataStore_item_id. La operación incluye sentencias de registro para hacer seguimiento de 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 distinta 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 el usuario.
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 e inicia la cadena de operaciones que procesan los mensajes del usuario.
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 |
Identificador del canal de notificaciones de TI |
slack.hrChannel.ID |
Identificador del canal de notificaciones de recursos humanos |
slack.bot.id |
Identificador de 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 |
Sugerencia
Puedes cambiar el nombre de estas variables para que coincidan con tu plataforma (por ejemplo, cambiar slack.itChannel.ID por teams.itChannel.ID). Cuando cambias el nombre de una variable, todas las referencias a esa variable se actualizan automáticamente en todo tu proyecto, incluidas secuencias de comandos 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 mismo, y extrae variables para su uso posterior.
Configura tu operación para rellenar las siguientes variables:
| Variable | Descripción | Valor |
|---|---|---|
$platform_bot_id_pass |
Validación de la fuente 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 mensaje nuevo 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 en el 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 rellena 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 de indicador de escritura (utilizada para su posterior eliminación) |
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 tu operación para utilizar 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 utilizando su ID de usuario.
Configura tu operación para utilizar 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 utilizando su nombre completo.
Configura tu operación para utilizar las siguientes variables:
-
Esquema de solicitud
Variable Descripción $slack.bot.user.tokenToken de autenticación -
Esquema de respuesta
La operación completa las siguientes variables:
Variable Descripción $platform_emailCorreo del usuario $platform_userIDID 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 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.