# Crear un tipo de trabajo [← Índice](readme.md) Accede al formulario desde el botón **Nuevo tipo** en la lista de tipos de trabajo. Todos los campos marcados con asterisco son obligatorios. --- ## Sección: Identificación ### Nombre Nombre descriptivo del tipo de trabajo. Aparece en la lista y en la app operativa. Elige un nombre que el operador pueda reconocer fácilmente. > Ejemplo: `Cobros vencidos`, `Confirmación de citas`, `Encuesta post-servicio` ### Descripción Texto libre que explica el propósito del tipo de trabajo. Aparece debajo del nombre en las tarjetas. Ayuda a los operadores a entender qué hace antes de lanzarlo. ### Agent ID Identificador único del Agente IAE que procesará cada elemento de la lista. Lo encuentras en la configuración del agente dentro de la plataforma IAE. > Es un código hexadecimal de 32 caracteres, por ejemplo: `f9e8d7c6b5a4321098765432` ### Token de seguridad del agente Credencial con la que el sistema se autenticará contra el webservice del agente en cada llamada. La encuentras en la configuración de seguridad del agente IAE. Este token nunca es visible para los operadores ni sale de los servidores del sistema. ### Token de encolamiento Credencial que protege el inicio de trabajos para este tipo de trabajo. Quien quiera lanzar un trabajo de este tipo — ya sea desde la app operativa, un conector o un sistema externo — necesita este token. Genera un valor seguro y guárdalo en un lugar seguro. Si lo pierdes deberás regenerarlo editando el tipo de trabajo. > **Tip:** Usa un generador de tokens aleatorios. Un UUID sin guiones es una buena opción. --- ## Sección: Contexto del agente Estos campos permiten que el agente reciba contexto adicional por encima de lo que ya tiene configurado en su prompt base. ### Canal Identificador lógico que se envía en cada llamada al agente. Sirve para agrupar y filtrar las conversaciones generadas por este tipo de trabajo en la auditoría de conversaciones del agente IAE. > Ejemplo: si pones `cobros`, podrás filtrar en la auditoría todas las conversaciones generadas por este tipo de trabajo buscando por canal `cobros`. No confundir con el canal de mensajería (WhatsApp, webchat). Este es un identificador libre que tú defines. ### Tema (chat_topic) El agente usa este valor para cargar contexto estático preconfigurado. Si el agente tiene instrucciones o comportamientos específicos asociados a un tema, los activará al recibir este valor. El mismo tema se envía para todos los elementos del lote. > Ejemplo: si el agente tiene configurado un tema `cobranza` con instrucciones específicas sobre tono y ofertas de pago, ponlo aquí. ### Campo de contexto variable Nombre de un campo del elemento JSON cuyo **valor** se enviará al agente como identificador de contexto variable. El agente usa ese valor para consultar información adicional en tiempo real desde un endpoint configurado. > Ejemplo: si los elementos de tu lista tienen un campo `clave_cliente` y el agente tiene configurado un endpoint que consulta el estado de cuenta dado una clave de cliente, pon `clave_cliente` aquí. El agente recibirá el valor concreto de ese campo para cada elemento y podrá consultar su estado de cuenta. Deja este campo vacío si el agente no necesita consultar información adicional por elemento. --- ## Sección: Payload por elemento Define cómo se construye el mensaje que el sistema envía al agente por cada elemento de la lista. ### Destino de los datos Define en qué campo del payload del agente se envía el contenido del elemento: - **message (rol user)** — el elemento llega al agente como si fuera un mensaje del usuario. Es el valor más habitual para casos de contacto y procesamiento conversacional. - **context (rol system)** — el elemento llega como instrucción al sistema. Útil cuando los datos son contexto técnico, no un mensaje natural. ### Destino de instrucciones Si escribiste instrucciones adicionales, define dónde van: - **Sin instrucciones** — no se envían instrucciones adicionales - **message (rol user)** — las instrucciones se añaden al mensaje del usuario - **context (rol system)** — las instrucciones se añaden al contexto del sistema > **Regla de concatenación:** si el destino de los datos y el de las instrucciones son el mismo campo, ambos se concatenan en ese campo. Si son distintos, cada uno va a su campo correspondiente. La **vista previa del payload** muestra cómo quedarán `message` y `context` según tu configuración, con el rol correspondiente a cada uno. ### Instrucciones adicionales Texto libre que amplía lo que el agente ya sabe. Úsalo para dar indicaciones específicas para este tipo de trabajo que no están en el prompt base del agente. > Ejemplo: `Sé cordial y ofrece facilidades de pago si el cliente lo solicita. No menciones el nombre del ejecutivo asignado.` --- ## Sección: Estado ### Activo Controla si este tipo de trabajo aparece disponible en la app operativa y puede recibir nuevos trabajos. - **Activo** — visible y disponible para lanzar trabajos - **Inactivo** — oculto en la app operativa. Los trabajos ya ejecutados no se ven afectados Puedes desactivar un tipo de trabajo temporalmente sin eliminarlo, por ejemplo durante una revisión del agente o una pausa operativa. --- ## Guardar Pulsa **Guardar** para crear el tipo de trabajo. El sistema valida que los campos obligatorios estén completos. Si hay algún error de validación, los campos afectados se marcan en rojo. Tras guardar exitosamente vuelves a la lista de tipos de trabajo donde aparecerá el nuevo tipo. --- [← Lista de tipos de trabajo](02-lista.md) · [Editar un tipo de trabajo →](04-editar.md)