Introducción #
Los workflows de IA permiten automatizar tratamientos inteligentes sobre los registros de Kafinea. Al añadir una tarea de tipo Prompt de IA en un workflow, puede hacer que un modelo de inteligencia artificial analice, resuma, traduzca o clasifique automáticamente datos.
1. Crear un workflow con una tarea de IA #
- Acceda a Ajustes > Automatización y comunicación > Workflows
- Cree un nuevo workflow o modifique un workflow existente
- Elija el módulo de destino (Contactos, Facturas, Presupuestos, etc.)
- Defina las condiciones de activación
- Añada una tarea de tipo Prompt de IA
2. Configurar la tarea Prompt de IA #
La tarea Prompt de IA consta de dos partes:
El prompt (instrucción) #
Es la instrucción textual enviada al modelo de IA. Puede incluir variables del módulo para personalizar la solicitud.
Ejemplo de prompt:
Résume en 2 phrases le contenu de la description suivante : $description
Classifie le niveau d'urgence du ticket parmi : faible, moyen, élevé, critique.
El mapeo de los campos de retorno #
Para cada campo que la IA deba rellenar, configure:
- El campo de destino: el campo del registro que se va a actualizar
- La instrucción específica: lo que la IA debe generar para ese campo
Importante: Se espera la respuesta de la IA en formato JSON, con los nombres de los campos como claves. El sistema gestiona automáticamente la extracción incluso si la respuesta contiene texto alrededor del JSON.
3. Datos contextuales transmitidos a la IA #
La tarea de IA transmite automáticamente al modelo:
| Dato | Descripción |
|---|---|
| Datos del registro | Todos los campos del registro actual |
| Registros padre | Los datos de los registros vinculados (contacto, cuenta, etc.) |
| Descripción de los módulos | Nombres y tipos de los campos, valores de las listas de selección |
| Líneas de detalle | Para los módulos de tipo inventario (facturas, presupuestos, pedidos) |
| Datos de la organización | Información de la empresa vinculada al registro |
| Contenido del documento | Si el módulo es Documentos, el contenido del archivo adjunto |
4. Ejemplos de uso #
Resumen automático de tickets #
- Módulo: HelpDesk
- Activador: Al crear
- Prompt: “Resume este ticket de soporte en una frase concisa.”
- Campo de destino:
cf_summary← instrucción: “Una frase que resuma el problema”
Clasificación de contactos #
- Módulo: Contactos
- Activador: Al guardar
- Prompt: “Analice la información de este contacto y sugiera un segmento comercial.”
- Campo de destino:
cf_segment← instrucción: “El segmento entre: PYME, ETI, Gran Empresa, Particular”
Traducción de la descripción del producto #
- Módulo: Products
- Activador: Al guardar
- Prompt: “Traduzca la descripción del producto al inglés.”
- Campo de destino:
cf_description_en← instrucción: “La traducción al inglés de la descripción”
5. Gestión de errores #
Si la IA no devuelve una respuesta válida, el workflow continúa sin actualizar los campos. Los errores se registran en los logs del servidor:
- Falta la clave de API: verifique la configuración de la pasarela de IA
- Respuesta vacía: el prompt quizá sea demasiado vago o los datos sean insuficientes
- Error de parsing JSON: el sistema intenta automáticamente varias estrategias de extracción
Consejo: Consulte los logs de PHP (
error_log) para diagnosticar los problemas de ejecución de los workflows de IA.
6. Límites #
- El tamaño del prompt está limitado por el modelo de IA utilizado (normalmente 4.096 tokens de respuesta máx.).
- Los archivos de imagen voluminosos o los documentos muy largos pueden truncarse.
- El workflow se ejecuta de forma síncrona: una llamada de IA lenta puede ralentizar el procesamiento.