Introducción
Los flujos de trabajo de IA permiten automatizar procesos inteligentes en los registros de Kafinea. Al añadir una tarea de tipo «Prompt IA» a un flujo de trabajo, puedes hacer que un modelo de inteligencia artificial analice, resuma, traduzca o clasifique datos de forma automática.
1. Crear un flujo de trabajo con una tarea de IA #
- Ve a Ajustes > Automatización y comunicación > Flujos de trabajo
- Crea un nuevo flujo de trabajo o modifica uno ya existente
- Seleccione el módulo de destino (Contactos, Facturas, Presupuestos, etc.)
- Defina las condiciones de activación
- Añade una tarea de tipo «Prompt IA»
2. Configurar la tarea Prompt IA #
La tarea Prompt IA consta de dos partes:
El indicador (instrucción) #
Esta es la instrucción textual que se envía al modelo de IA. Puedes incluir variables del módulo para personalizar la consulta.
Ejemplo de indicación:
Résume en 2 phrases le contenu de la description suivante : $description
Classifie le niveau d'urgence du ticket parmi : faible, moyen, élevé, critique.
Asignación de campos de retorno #
Para cada campo que debe rellenar la IA, debes configurar:
- 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 este campo
Importante: La respuesta de la IA debe estar 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 envía automáticamente al modelo:
| Dato | Descripción |
|---|---|
| Datos del registro | Todos los campos del registro actual |
| Registros de los padres | Los datos de los registros relacionados (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 relacionada con el 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: Servicio de asistencia técnica
- Motivo: En el momento de la creación
- Indicación: «Resume este ticket de asistencia en una frase concisa».
- Ámbito de aplicación :
cf_summary← Instrucción: «Una frase que resuma el problema»
Clasificación de contactos #
- Módulo: Contactos
- Desencadenante: Al guardar
- Indicación: «Analiza la información de este contacto y sugiere un segmento comercial».
- Ámbito de aplicación :
cf_segment← instrucción: «El segmento entre: pymes, empresas de tamaño intermedio, grandes empresas, particulares»
Traducción de la descripción del producto #
- Módulo: Productos
- Desencadenante: Al guardar
- Indicación: «Traduce la descripción del producto al inglés».
- Ámbito de aplicación :
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 flujo de trabajo continúa sin actualizar los campos. Los errores se registran en los registros del servidor:
- Falta la clave API: comprueba la configuración de la pasarela de IA
- Respuesta vacía: es posible que la indicación sea demasiado imprecisa o que los datos sean insuficientes
- Error al analizar JSON: el sistema prueba automáticamente varias estrategias de extracción
Consejo: Consulte los registros de PHP (
error_log) para diagnosticar problemas en la ejecución de los flujos de trabajo de IA.
6. Límites #
- El tamaño del prompt está limitado por el modelo de IA utilizado (por lo general, un máximo de 4096 tokens de respuesta).
- Los archivos de imagen de gran tamaño o los documentos muy largos pueden aparecer truncados.
- El flujo de trabajo se ejecuta de forma sincrónica: una llamada a la IA que tarde mucho en completarse puede ralentizar el procesamiento.