Asistentes Inteligentes

Los Asistentes Inteligentes de Heptora son herramientas impulsadas por inteligencia artificial que transforman la manera en que diseñas, desarrollas y mantienes tus automatizaciones. Desde la construcción visual de procesos hasta el diagnóstico inteligente de errores, estos asistentes te acompañan en cada etapa del ciclo de vida de tus automatizaciones.

Visión General

Heptora integra cuatro asistentes especializados, cada uno diseñado para resolver desafíos específicos en el desarrollo de automatizaciones:

1. Asistente de Construcción de Procesos: Diseño visual sin código
2. Asistente de IA para Bloques Avanzados: Generación automática de código Python
3. Asistente de IA para Diagnóstico de Errores: Análisis inteligente de fallos
4. Asistente de IA para Onboarding: Guía interactiva para nuevos usuarios

Inteligencia al Servicio de la Productividad

Los asistentes de IA de Heptora no solo automatizan tareas repetitivas, sino que aprenden de cada interacción para ofrecer recomendaciones cada vez más precisas y contextuales.

Asistente de Construcción de Procesos

El Asistente de Construcción de Procesos democratiza la automatización mediante una interfaz visual intuitiva que permite a cualquier usuario, sin conocimientos de programación, diseñar flujos de trabajo complejos.

Características Principales

Interfaz Drag-and-Drop

Crea secuencias de acciones arrastrando y soltando bloques en un lienzo visual:

• Diseño visual: Representa tu proceso como un flujo gráfico de acciones conectadas
• Conexiones intuitivas: Une bloques mediante conectores visuales para definir el flujo de ejecución
• Reorganización flexible: Reordena bloques fácilmente para ajustar la lógica del proceso
• Vista panorámica: Visualiza todo tu proceso de principio a fin en una sola pantalla

Sin código requerido

El asistente traduce automáticamente tus diseños visuales en código ejecutable, eliminando la barrera técnica de la programación.

Biblioteca de Bloques Predefinidos

Accede a una colección completa de bloques listos para usar:

Bloques de Aplicaciones:

• Interacción con navegadores web (Selenium, Playwright)
• Automatización de escritorio (Windows, macOS)
• Integración con Office (Excel, Word, Outlook)
• Conexión con bases de datos (SQL, MongoDB)
• APIs y servicios web

Bloques de Control de Flujo:

• Condicionales (if/else)
• Bucles (for, while)
• Manejo de excepciones
• Esperas y temporizadores

Bloques de Datos:

• Lectura y escritura de archivos
• Transformación de datos
• Validación y limpieza
• Extracción de información

Bloques de Comunicación:

• Envío de emails
• Notificaciones
• Webhooks
• Mensajería instantánea

Vista de Flujo Visual

El asistente proporciona diferentes vistas para comprender tu proceso:

Vista de Diagrama:

┌─────────────┐
│  Inicio     │
└──────┬──────┘
       │
┌──────▼──────┐
│  Leer Excel │
└──────┬──────┘
       │
┌──────▼──────────┐     ┌──────────────┐
│  Validar Datos  ├─────►  Error       │
└──────┬──────────┘     └──────────────┘
       │
┌──────▼──────────┐
│  Procesar Fila  │◄──┐
└──────┬──────────┘   │
       │               │
┌──────▼──────────┐   │
│  ¿Más filas?    ├───┘ (Sí)
└──────┬──────────┘
       │ (No)
┌──────▼──────┐
│  Fin        │
└─────────────┘

Vista de Lista:

• Secuencia numerada de acciones
• Parámetros de cada bloque
• Comentarios y anotaciones

Vista de Código:

• Código Python generado automáticamente
• Correspondencia entre bloques visuales y código
• Modo de solo lectura para verificación

Validación en Tiempo Real

El asistente verifica constantemente la lógica de tu proceso:

• Detección de errores de flujo: Identifica bloques sin conectar o rutas incompletas
• Validación de parámetros: Verifica que todos los bloques tengan configuración válida
• Comprobación de dependencias: Asegura que las variables estén definidas antes de usarse
• Alertas de mejores prácticas: Sugiere optimizaciones y patrones recomendados

Feedback Inmediato

Los errores se señalan visualmente con iconos y colores, permitiendo correcciones inmediatas antes de la ejecución.

Casos de Uso

Automatización de Informes

Diseña un proceso que:

1. Extrae datos de múltiples fuentes
2. Consolida la información en un formato único
3. Genera gráficos y visualizaciones
4. Envía el informe por email a los interesados

Procesamiento de Facturas

Crea un flujo que:

1. Lee facturas desde un buzón de correo
2. Extrae información clave (proveedor, importe, fecha)
3. Valida los datos contra catálogos
4. Registra la información en el ERP
5. Archiva los documentos procesados

Onboarding de Empleados

Automatiza el proceso de:

1. Crear cuentas en múltiples sistemas
2. Asignar permisos y licencias
3. Enviar credenciales de forma segura
4. Programar sesiones de capacitación
5. Notificar al equipo correspondiente

Mejores Prácticas

Organización del Proceso

1. Divide en secciones lógicas

   • Agrupa bloques relacionados
   • Usa comentarios para separar fases del proceso
   • Nombra cada sección descriptivamente

2. Manejo de errores robusto

   • Incluye bloques de captura de excepciones
   • Define acciones alternativas para fallos previsibles
   • Implementa reintentos cuando sea apropiado

3. Reutilización de lógica

   • Identifica patrones repetitivos
   • Crea sub-procesos para lógica común
   • Parametriza bloques para mayor flexibilidad

Nomenclatura Clara

• Nombres de variables: cliente_actual, total_facturas, ruta_archivo_salida
• Nombres de bloques: “Validar Email del Cliente”, “Calcular Total con IVA”
• Comentarios explicativos: Documenta decisiones de diseño importantes

Optimización del Rendimiento

1. Minimiza operaciones costosas

   • Agrupa lecturas de archivos
   • Reduce consultas a bases de datos
   • Reutiliza conexiones

2. Paralelización cuando sea posible

   • Identifica tareas independientes
   • Usa bloques de ejecución paralela
   • Sincroniza resultados apropiadamente

Asistente de IA para Bloques Avanzados

Cuando los bloques predefinidos no son suficientes, el Asistente de IA para Bloques Avanzados genera código Python personalizado basándose en descripciones en lenguaje natural.

Funcionamiento

Entrada: Descripción Natural

Describe lo que necesitas en lenguaje cotidiano:

Ejemplos de descripciones:

"Necesito extraer todas las direcciones de email de un texto que
pueden estar en formato nombre@dominio.com o nombre@dominio.co.uk"

"Quiero calcular el valor presente neto de una serie de flujos de
caja con una tasa de descuento del 10% anual"

"Debo convertir un archivo XML con estructura anidada a un DataFrame
de pandas aplanando todos los niveles"

"Necesito conectarme a una API REST con autenticación OAuth2,
obtener datos paginados y combinarlos en un único conjunto"

Procesamiento Inteligente

El asistente analiza tu descripción para:

1. Identificar requisitos funcionales: Qué debe hacer el código
2. Detectar tecnologías necesarias: Librerías y herramientas requeridas
3. Reconocer patrones comunes: Soluciones estándar aplicables
4. Evaluar complejidad: Estimación de esfuerzo y viabilidad

Contexto del Proceso

El asistente considera el contexto de tu proceso existente, incluyendo variables disponibles, librerías ya importadas y bloques previos.

Salida: Código Python Optimizado

El asistente genera código que incluye:

Código funcional:

import re
from typing import List

def extraer_emails(texto: str) -> List[str]:
    """
    Extrae todas las direcciones de email válidas de un texto.

    Args:
        texto: Cadena de texto que puede contener emails

    Returns:
        Lista de emails únicos encontrados
    """
    # Patrón regex para emails con dominios de múltiples niveles
    patron = r'\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Z|a-z]{2,}\b'

    # Extraer todos los matches
    emails = re.findall(patron, texto)

    # Eliminar duplicados manteniendo el orden
    return list(dict.fromkeys(emails))

# Uso en el contexto del proceso
emails_encontrados = extraer_emails(texto_entrada)
print(f"Se encontraron {len(emails_encontrados)} emails únicos")

Características del código generado:

• Documentación completa: Docstrings explicativos
• Type hints: Anotaciones de tipo para claridad
• Manejo de errores: Try-except donde sea apropiado
• Comentarios útiles: Explicaciones de lógica compleja
• Código idiomático: Siguiendo convenciones de Python (PEP 8)
• Optimización: Algoritmos eficientes y uso correcto de estructuras de datos

Iteración y Refinamiento

El asistente permite ajustes iterativos:

1. Revisión del código: Examina el código generado
2. Solicitud de cambios: “Añade validación de dominios permitidos”
3. Regeneración: El asistente modifica el código según tus indicaciones
4. Prueba: Ejecuta el código en un entorno de prueba
5. Integración: Incorpora el bloque al proceso principal

Aprendizaje Continuo

El asistente aprende de tus correcciones y preferencias, mejorando las generaciones futuras para tu organización.

Casos de Uso

Transformaciones de Datos Complejas

Escenario: Normalización de datos de múltiples fuentes con formatos inconsistentes.

Descripción para el asistente:

"Tengo datos de ventas de 3 sistemas diferentes. Cada uno usa
formatos distintos para fechas, monedas y nombres de productos.
Necesito normalizar todo a un formato estándar donde las fechas
sean ISO 8601, las monedas en EUR, y los nombres de productos
coincidan con nuestro catálogo maestro."

Resultado: Función que maneja múltiples formatos de entrada y aplica reglas de normalización específicas de tu negocio.

Integraciones Personalizadas

Escenario: Conexión con una API propietaria sin librería oficial.

Descripción para el asistente:

"Necesito conectarme a la API interna de nuestro sistema CRM legacy.
Usa autenticación por token en el header 'X-Auth-Token', los
endpoints están en /api/v2/, y responde con XML. Quiero obtener
todos los clientes activos y convertir la respuesta a JSON."

Resultado: Cliente API completo con manejo de autenticación, conversión de formatos y gestión de errores.

Lógica de Negocio Específica

Escenario: Cálculos complejos según reglas de negocio únicas.

Descripción para el asistente:

"Debo calcular el descuento aplicable a un pedido según estas reglas:
- 5% si el total supera 1000€
- 10% adicional si es cliente premium
- 15% adicional si es temporada baja (enero-marzo, julio-agosto)
- Los descuentos son acumulativos pero no pueden superar 30%
- Si hay productos en promoción, no se aplica descuento general"

Resultado: Función que implementa todas las reglas con lógica clara y testeable.

Análisis y Reportes Avanzados

Escenario: Generación de métricas y visualizaciones personalizadas.

Descripción para el asistente:

"Necesito analizar datos de ventas y generar un informe con:
- Tendencia mensual con predicción para próximos 3 meses
- Productos con mayor crecimiento
- Análisis de estacionalidad
- Gráfico de barras apiladas por categoría
- Exportar resultados a Excel con formato condicional"

Resultado: Pipeline completo de análisis con visualizaciones y exportación formateada.

Ventajas

Aceleración del Desarrollo

• Reduce tiempo de codificación: De horas a minutos
• Elimina búsqueda de documentación: El asistente conoce las librerías
• Evita errores comunes: Código probado y validado
• Prototipado rápido: Itera ideas rápidamente

Democratización del Desarrollo

• Usuarios no técnicos: Pueden crear lógica compleja describiendo necesidades
• Desarrolladores junior: Aprenden patrones y mejores prácticas del código generado
• Expertos en negocio: Traducen requisitos directamente a código funcional

Calidad Consistente

• Estándares de código: Siempre sigue mejores prácticas
• Documentación automática: Todo el código está documentado
• Manejo de errores: Incluye gestión robusta de excepciones
• Seguridad: Evita anti-patrones y vulnerabilidades comunes

Limitaciones y Consideraciones

Complejidad del Código

El asistente funciona mejor con:

• Funciones individuales o módulos pequeños (< 100 líneas)
• Lógica bien definida y con requisitos claros
• Problemas con soluciones conocidas o estándar

Puede tener dificultades con:

• Arquitecturas complejas multi-módulo
• Requisitos ambiguos o contradictorios
• Optimizaciones de rendimiento extremas

Revisión Requerida

Aunque el código generado es funcional, siempre debes revisarlo antes de usarlo en producción, especialmente para operaciones críticas o manejo de datos sensibles.

Dependencias Externas

• El código puede requerir librerías adicionales que deben instalarse
• Algunas integraciones pueden necesitar configuración adicional
• Considera las implicaciones de agregar nuevas dependencias al proyecto

Rendimiento

• El código generado prioriza claridad y corrección sobre optimización extrema
• Para casos con requisitos de rendimiento críticos, puede ser necesario optimizar manualmente
• Siempre prueba con volúmenes de datos reales antes de producción

Asistente de IA para Diagnóstico de Errores

El Asistente de IA para Diagnóstico de Errores transforma la frustración de depurar fallos en una experiencia guiada y educativa, analizando automáticamente errores y proporcionando soluciones contextuales.

Capacidades de Análisis

Análisis de Logs

Cuando un proceso falla, el asistente examina:

Logs de aplicación:

• Mensajes de error y excepciones
• Trazas de stack completas
• Valores de variables en el momento del fallo
• Estado del sistema durante la ejecución

Logs del sistema:

• Recursos disponibles (memoria, CPU, disco)
• Conexiones de red activas
• Procesos en ejecución
• Eventos del sistema operativo

Contexto del proceso:

• Configuración del proceso
• Variables de entrada
• Historial de ejecuciones previas
• Cambios recientes en el proceso

Análisis Inteligente

El asistente no solo lee logs, sino que comprende el contexto y las relaciones entre diferentes elementos del error.

Interpretación Automática

El asistente traduce errores técnicos a explicaciones comprensibles:

Ejemplo de error técnico:

ConnectionError: HTTPSConnectionPool(host='api.example.com', port=443):
Max retries exceeded with url: /v1/users
(Caused by SSLError(SSLCertVerificationError(1,
'[SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed:
certificate has expired (_ssl.c:1129)')))

Interpretación del asistente:

El proceso no pudo conectarse a la API de Example porque el
certificado SSL del servidor ha expirado. Esto es un problema
del proveedor del servicio, no de tu proceso.

Posibles impactos:
- El proceso no puede obtener datos de usuarios
- Las operaciones que dependen de esta API fallarán

Estado del servicio:
- Verificando disponibilidad del servicio... ✓
- El servicio está activo pero con certificado no válido

Categorización de Errores

El asistente clasifica errores por tipo y gravedad:

Tipos de errores:

• Configuración: Credenciales incorrectas, rutas inválidas
• Datos: Formato inesperado, valores faltantes
• Red: Timeouts, conexiones rechazadas
• Lógica: Condiciones no manejadas, divisiones por cero
• Recursos: Memoria insuficiente, disco lleno
• Externos: APIs caídas, servicios no disponibles

Niveles de gravedad:

• Crítico: Proceso completamente bloqueado
• Alto: Funcionalidad principal afectada
• Medio: Funcionalidad secundaria afectada
• Bajo: Advertencias o problemas menores

Sugerencias Contextuales

El asistente proporciona recomendaciones específicas basadas en:

Tipo de Error

Error de credenciales:

Diagnóstico: Las credenciales para acceder a SAP son incorrectas.

Recomendaciones:
1. Verifica que el usuario 'SAP_USER' existe y está activo
2. Confirma que la contraseña no ha expirado
3. Comprueba que el usuario tiene permisos suficientes
4. Actualiza el secreto 'SAP_PASSWORD' en el robot local

Pasos para resolver:
→ Abrir gestión de secretos del robot
→ Localizar secreto 'SAP_PASSWORD'
→ Actualizar con la contraseña correcta
→ Reintentar el proceso

Error de formato de datos:

Diagnóstico: El archivo Excel tiene una estructura diferente a la esperada.

Detalles:
- Esperado: columna 'Nombre Cliente' en posición 1
- Encontrado: columna 'NombreCliente' en posición 2

Recomendaciones:
1. Verificar que se está usando la plantilla correcta
2. Actualizar el proceso para manejar ambos formatos
3. Implementar validación de estructura antes de procesar

Sugerencia de código:
# Mapeo flexible de columnas
columnas_esperadas = {'Nombre Cliente', 'NombreCliente', 'nombre_cliente'}
columna_nombre = next((col for col in df.columns if col in columnas_esperadas), None)

Historial del Proceso

El asistente compara con ejecuciones previas:

Análisis de historial:
- Últimas 10 ejecuciones: 9 exitosas, 1 fallida (actual)
- El proceso falló por primera vez hoy a las 14:30
- Cambio detectado: Archivo de entrada con 50% más registros que lo habitual
- Posible causa: Timeout debido a volumen mayor de datos

Recomendación:
Incrementar el timeout de 60s a 120s o implementar procesamiento
por lotes para archivos grandes.

Mejores Prácticas

Observación: El proceso no implementa reintentos para llamadas a la API.

Mejores prácticas no aplicadas:
- No hay reintentos automáticos para errores transitorios
- No se registra el detalle completo del error
- No hay notificación proactiva de fallos

Recomendaciones de mejora:
1. Implementar estrategia de reintentos exponenciales
2. Agregar logging detallado de requests/responses
3. Configurar alertas por email para errores críticos

¿Quieres que el asistente genere el código para estas mejoras?

Pasos Siguientes

El asistente proporciona una guía paso a paso para resolver el problema:

Resolución Guiada

Paso 1: Verificación

✓ Identifica el componente afectado
→ Verifica el estado del componente
→ Confirma la existencia del problema

Paso 2: Corrección

→ Aplica la solución recomendada
→ Documenta el cambio realizado
→ Ejecuta validación de la corrección

Paso 3: Validación

→ Reintenta la operación fallida
→ Verifica que el error no se repite
→ Comprueba que la funcionalidad es completa

Paso 4: Prevención

→ Implementa monitoreo para detección temprana
→ Actualiza documentación con el problema y solución
→ Considera mejoras para evitar recurrencia

Acciones Automáticas

En algunos casos, el asistente puede:

• Auto-corregir errores menores: Ajustes de configuración simples
• Reiniciar componentes: Servicios o conexiones problemáticas
• Actualizar configuración: Parámetros optimizados automáticamente
• Notificar stakeholders: Alertas automáticas según severidad

Confirmación Requerida

Las acciones automáticas requieren confirmación del usuario excepto para errores conocidos con soluciones seguras probadas.

Aprendizaje Continuo

El asistente mejora con cada error diagnosticado:

Base de Conocimiento

• Errores únicos: Se catalogan para referencia futura
• Soluciones efectivas: Se priorizan en futuras recomendaciones
• Patrones comunes: Se identifican y documentan
• Falsos positivos: Se ajustan para mejorar precisión

Personalización Organizacional

El asistente aprende características específicas de tu entorno:

• Sistemas y aplicaciones usadas frecuentemente
• Patrones de configuración corporativos
• Errores recurrentes y sus soluciones
• Tiempos de respuesta típicos de servicios externos

Métricas y Tendencias

El asistente genera insights sobre:

Informe de Errores - Último Mes

Errores más frecuentes:
1. Timeout en API de CRM (15 ocurrencias)
   → Recomendación: Revisar capacidad del servidor CRM

2. Archivo no encontrado (8 ocurrencias)
   → Patrón: Siempre el mismo proceso, diferentes archivos
   → Recomendación: Implementar validación de existencia previa

3. Formato de fecha inválido (5 ocurrencias)
   → Patrón: Datos de sistema externo sin normalizar
   → Recomendación: Agregar bloque de normalización de fechas

Tiempo promedio de resolución: 12 minutos
Resoluciones automáticas: 45%
Resoluciones guiadas: 55%

Integración con el Flujo de Trabajo

Notificaciones Proactivas

Cuando ocurre un error:

1. Notificación inmediata al usuario responsable
2. Resumen del diagnóstico en la notificación
3. Link directo al asistente con contexto cargado
4. Sugerencias iniciales sin necesidad de abrir la plataforma

Panel de Diagnóstico

Interfaz centralizada que muestra:

• Errores activos que requieren atención
• Errores en proceso de resolución
• Errores resueltos recientemente
• Tendencias y patrones identificados
• Recomendaciones proactivas de mejora

Documentación Automática

El asistente genera documentación de:

• Errores y sus soluciones
• Decisiones tomadas durante la resolución
• Cambios aplicados al proceso
• Lecciones aprendidas

Asistente de IA para Onboarding

El Asistente de IA para Onboarding transforma la experiencia de los nuevos usuarios, guiándolos desde el primer contacto con la plataforma hasta la creación de sus primeras automatizaciones exitosas.

Evaluación Inicial

El asistente comienza conociendo al usuario:

Perfil del Usuario

Preguntas de evaluación:

Bienvenido a Heptora. Para personalizar tu experiencia,
cuéntame un poco sobre ti:

1. ¿Cuál es tu rol principal?
   [ ] Desarrollador / Técnico
   [ ] Analista de Negocio
   [ ] Manager / Director
   [ ] Usuario Final

2. ¿Cuánta experiencia tienes con automatización?
   [ ] Ninguna - Soy nuevo en esto
   [ ] Básica - He usado herramientas simples
   [ ] Intermedia - He creado algunos procesos
   [ ] Avanzada - Soy experto en RPA/automatización

3. ¿Cuánto conoces sobre programación?
   [ ] Nada - No he programado nunca
   [ ] Básico - Entiendo conceptos simples
   [ ] Intermedio - Puedo escribir scripts
   [ ] Avanzado - Soy desarrollador profesional

4. ¿Qué tipo de tareas necesitas automatizar?
   [ ] Procesamiento de documentos
   [ ] Integración entre sistemas
   [ ] Análisis y reportes
   [ ] Tareas repetitivas de oficina
   [ ] Otro: _____________

Análisis de Necesidades

Basándose en las respuestas, el asistente determina:

• Nivel de asistencia: Guía paso a paso vs. referencias rápidas
• Complejidad inicial: Procesos simples vs. casos avanzados
• Enfoque: Visual/sin código vs. código personalizado
• Recursos: Tutoriales detallados vs. documentación técnica

Experiencia Personalizada

Dos usuarios diferentes verán recorridos completamente distintos adaptados a su perfil y necesidades específicas.

Recomendación de Procesos

El asistente sugiere casos de uso relevantes:

Plantillas Recomendadas

Para un Analista de Finanzas:

Basándome en tu perfil, estas plantillas pueden ser útiles:

1. 📊 Consolidación Automática de Informes Financieros
   Dificultad: ⭐⭐ Básica
   Tiempo: 10 minutos de configuración

   Este proceso te ayudará a:
   - Recopilar datos de múltiples hojas de Excel
   - Consolidar en un informe maestro
   - Generar gráficos automáticos
   - Enviar por email a stakeholders

   [Usar esta plantilla]

2. 💰 Validación de Facturas vs Órdenes de Compra
   Dificultad: ⭐⭐⭐ Intermedia
   Tiempo: 20 minutos de configuración

   Este proceso automatiza:
   - Lectura de facturas PDF
   - Extracción de datos clave
   - Comparación con órdenes de compra
   - Marcado de discrepancias

   [Usar esta plantilla]

3. 📈 Dashboard Ejecutivo Automático
   Dificultad: ⭐⭐⭐⭐ Avanzada
   Tiempo: 30 minutos de configuración

   Genera automáticamente:
   - KPIs financieros actualizados
   - Gráficos de tendencias
   - Comparativas período anterior
   - Alertas de métricas fuera de rango

   [Usar esta plantilla]

Para un Administrador de IT:

Procesos recomendados para tu rol:

1. 🔧 Provisionamiento de Usuarios
   Automatiza la creación de cuentas en múltiples sistemas

2. 🔐 Auditoría de Permisos
   Revisa y reporta accesos de usuarios periódicamente

3. 📦 Gestión de Actualizaciones
   Descarga, prueba y despliega actualizaciones de software

Casos de Uso Personalizados

Si no hay una plantilla exacta, el asistente propone:

No encontré una plantilla exacta para "sincronización de inventario
entre ERP y e-commerce", pero puedo ayudarte a crear un proceso
personalizado.

Proceso propuesto:

Fase 1: Extracción de Datos
- Conectar con tu ERP (SAP/Oracle/Odoo)
- Obtener inventario actualizado
- Filtrar productos activos para venta online

Fase 2: Transformación
- Mapear campos del ERP a formato del e-commerce
- Aplicar reglas de negocio (precios, disponibilidad)
- Validar datos antes de enviar

Fase 3: Carga
- Conectar con API de tu e-commerce (Shopify/WooCommerce/Magento)
- Actualizar inventario y precios
- Manejar errores y discrepancias

Fase 4: Monitoreo
- Registrar sincronización exitosa
- Alertar sobre productos no sincronizados
- Generar reporte de cambios

¿Quieres que te guíe para crear este proceso?
[Sí, empecemos] [Ver otros ejemplos]

Tutorial Personalizado

El asistente crea rutas de aprendizaje adaptadas:

Ruta para Usuarios No Técnicos

Módulo 1: Conceptos Básicos (10 minutos)

Lección 1.1: ¿Qué es un Proceso?
- Video explicativo (2 min)
- Diagrama interactivo
- Quiz de verificación

Lección 1.2: Bloques y Acciones
- Explorador de bloques disponibles
- Ejemplos de uso común
- Ejercicio práctico: Arrastrar y soltar

Lección 1.3: Variables y Datos
- ¿Qué son las variables?
- Cómo usar datos entre bloques
- Ejemplos visuales

Módulo 2: Tu Primer Proceso (20 minutos)

Proyecto Guiado: Leer un Excel y enviar resumen por email

Paso 1: Crear el proceso
→ El asistente crea la estructura base
→ Tú añades el bloque de lectura de Excel
✓ Verificación automática

Paso 2: Configurar el archivo
→ Selecciona tu archivo Excel
→ Elige las columnas importantes
✓ Vista previa de datos

Paso 3: Procesar información
→ Bloque de resumen automático
→ Visualización del resultado
✓ Datos procesados correctamente

Paso 4: Enviar por email
→ Configurar destinatarios
→ Personalizar mensaje
→ Ejecutar y verificar
✓ ¡Proceso completado!

Módulo 3: Mejoras y Optimización (15 minutos)

Lección 3.1: Manejo de Errores
- ¿Qué puede salir mal?
- Cómo agregar bloques de seguridad
- Práctica: Añadir validación a tu proceso

Lección 3.2: Programación de Ejecuciones
- Ejecutar automáticamente cada día/semana/mes
- Configurar horarios
- Práctica: Programa tu proceso

Lección 3.3: Siguientes Pasos
- Explorar más plantillas
- Unirte a la comunidad
- Recursos adicionales

Ruta para Desarrolladores

Módulo 1: Arquitectura y Conceptos (15 minutos)

- Arquitectura híbrida cloud-local
- APIs y SDKs disponibles
- Modelo de ejecución y lifecycle
- Variables, secretos y configuración
- Integración con Git y CI/CD

Módulo 2: Desarrollo Avanzado (30 minutos)

- Uso del asistente de bloques avanzados
- Integración de código Python personalizado
- Manejo de dependencias y entornos
- Testing y debugging de procesos
- Patrones de diseño recomendados

Módulo 3: Best Practices (20 minutos)

- Optimización de rendimiento
- Seguridad y manejo de credenciales
- Logging y monitoreo
- Versionado y deployment
- Escalabilidad y mantenimiento

Configuración Guiada

El asistente ayuda con la configuración inicial:

Variables y Parámetros

Para que tu proceso funcione, necesitamos configurar algunas variables:

Variable: EMAIL_DESTINATARIO
Descripción: Email donde se enviará el informe
Valor sugerido: tu_email@empresa.com
[ Ingresar valor: _________________ ]

Variable: RUTA_ARCHIVOS
Descripción: Carpeta donde se encuentran los archivos a procesar
Valor sugerido: C:\Users\TuUsuario\Documents\Informes
[ Seleccionar carpeta 📁 ]

Variable: FRECUENCIA_EJECUCION
Descripción: ¿Con qué frecuencia debe ejecutarse?
[ ] Diaria
[ ] Semanal (Lunes)
[X] Mensual (primer día del mes)

¿Todo listo? [Guardar configuración]

Secretos y Credenciales

Tu proceso necesita acceder a sistemas externos.
Configuremos las credenciales de forma segura:

🔐 Secreto: SAP_USER
Para: Acceso al sistema SAP
Se guardará: Encriptado en tu robot local
[ Configurar ahora ] [ Configurar después ]

💡 Tip: Los secretos nunca se almacenan en la nube.
Solo tu robot local conoce los valores.

¿Necesitas ayuda para crear un usuario de servicio?
[Ver guía de mejores prácticas]

Conexiones Externas

Vamos a configurar la conexión con tu e-commerce:

Plataforma detectada: Shopify
URL de tu tienda: ejemplo.myshopify.com

Necesitarás:
1. API Key de Shopify
   [ ] Ya la tengo
   [X] Necesito crearla

Si necesitas crearla:
→ Paso 1: Ve a tu panel de Shopify
→ Paso 2: Settings > Apps and sales channels
→ Paso 3: Develop apps > Create an app
→ Paso 4: Copia la API Key
→ Paso 5: Pégala aquí: _______________

[Video tutorial: Cómo obtener API Key de Shopify] (2:30)

¿Lista la API Key? [Probar conexión]

Primeros Procesos

El asistente guía la creación paso a paso:

Enfoque Interactivo

¡Creemos tu primer proceso juntos!

Elegiste: Consolidación de Informes Excel

Yo me encargaré de:
✓ Crear la estructura del proceso
✓ Configurar los bloques necesarios
✓ Establecer las conexiones entre pasos

Tú solo necesitas:
→ Responder algunas preguntas
→ Proporcionar archivos de ejemplo
→ Verificar que los resultados sean correctos

¿Listo? [¡Empecemos!]

Asistencia Contextual

Durante la creación, el asistente ofrece:

Ayuda Inline:

Estás añadiendo un bloque "Leer Excel"

Este bloque lee datos de archivos Excel (.xlsx, .xls)
y los convierte en una tabla que puedes procesar.

Parámetros:
- Ruta del archivo: ¿Dónde está tu archivo?
  [ ] Ruta fija: C:\...\archivo.xlsx
  [ ] Usar variable: ruta_archivo
  [Ayuda: ¿Cuándo usar cada opción?]

- Hoja a leer: ¿Qué hoja del Excel?
  [ ] Primera hoja
  [ ] Hoja específica: [nombre___________]
  [ ] Todas las hojas

- ¿El archivo tiene encabezados en la primera fila?
  [X] Sí [ ] No

[Vista previa de datos] [Continuar]

Validación en Tiempo Real:

⚠️ Advertencia detectada

Has seleccionado "Todas las hojas" pero el siguiente bloque
espera una sola tabla de datos.

Sugerencias:
1. Selecciona una hoja específica
2. Añade un bloque para combinar múltiples hojas
3. Procesa cada hoja por separado en un bucle

¿Qué prefieres hacer?
[Opción 1] [Opción 2] [Opción 3] [Explicar más]

Celebración de Hitos:

🎉 ¡Excelente!

Has completado la configuración de la lectura de datos.

Progreso del proceso:
[████████░░░░░░░░░░░░] 40%

✅ Lectura de datos
🔄 Procesamiento de información <- Estás aquí
⏳ Generación de informe
⏳ Envío por email

Siguiente paso: Configurar el procesamiento de información
[Continuar] [Hacer una pausa]

Mejores Prácticas

El asistente recomienda patrones y optimizaciones:

Recomendaciones Contextuales

💡 Sugerencia: Manejo de Errores

He notado que tu proceso no tiene manejo de errores.
¿Qué pasa si el archivo Excel no existe o está corrupto?

Te recomiendo agregar:
1. Bloque de validación de archivo antes de leer
2. Bloque de captura de excepciones
3. Notificación en caso de error

¿Quieres que añada esto automáticamente?
[Sí, añadir protección] [No, por ahora no] [Explicar más]

Patrones de Diseño

Patrón Detectado: Procesamiento de Múltiples Archivos

Veo que tu proceso maneja varios archivos Excel similares.
Este es un patrón común. Te recomiendo:

Patrón "Batch Processing":
┌─────────────────────┐
│  Listar Archivos    │
└──────────┬──────────┘
           │
┌──────────▼──────────┐
│  Para cada archivo: │ ◄──┐
│   - Leer            │    │
│   - Procesar        │    │
│   - Registrar       │    │
└──────────┬──────────┘    │
           │                │
           └────────────────┘

Ventajas:
- Procesa todos los archivos automáticamente
- Maneja archivos nuevos sin modificar el proceso
- Registra progreso de cada archivo
- Continúa si un archivo falla

[Aplicar este patrón] [Ver otros patrones]

Optimizaciones

🚀 Oportunidad de Optimización

Tu proceso lee el mismo archivo varias veces.
Esto es lento e innecesario.

Optimización sugerida:
- Leer el archivo una sola vez al inicio
- Guardar los datos en una variable
- Reutilizar la variable en los siguientes pasos

Mejora de rendimiento estimada: 60% más rápido

[Aplicar optimización] [Explicar en detalle]

Progreso Adaptativo

El asistente ajusta según la experiencia del usuario:

Reducción Gradual de Asistencia

Primera vez:

Paso 1: Añadir un bloque de email
→ Haz clic en el botón "+" en el flujo
→ Selecciona "Comunicación" en el menú
→ Elige "Enviar Email"
→ Arrastra el bloque al lienzo
✓ ¡Perfecto! Ahora configúralo...

Quinta vez:

Paso 1: Añadir un bloque de email
[Ya sabes cómo hacer esto]

¿Necesitas ayuda? [Mostrar instrucciones detalladas]

Décima vez:

💡 Tip rápido: Atajo de teclado 'E' para agregar email

Introducción de Conceptos Avanzados

🎓 Estás listo para el siguiente nivel

Has creado exitosamente 5 procesos básicos.
Es momento de aprender conceptos más avanzados:

1. ⚡ Sub-procesos y Reutilización
   Cómo crear bloques reutilizables

2. 🔄 Manejo Avanzado de Errores
   Reintentos, fallbacks y recuperación

3. 🎯 Optimización de Rendimiento
   Ejecución paralela y eficiencia

4. 🐍 Código Python Personalizado
   Ir más allá de los bloques predefinidos

¿Qué te gustaría aprender primero?
[Sub-procesos] [Errores] [Rendimiento] [Python] [Después]

Certificación de Habilidades

🏆 Logros Desbloqueados

✓ Primer Proceso Creado
✓ 10 Procesos en Producción
✓ Uso de Bloques Avanzados
✓ Configuración de Secretos
✓ Manejo de Errores Implementado

Próximos logros:
⏳ Crear un Sub-proceso (5/10 pasos)
⏳ Experto en Optimización (0/5 optimizaciones)
⏳ Maestro de Integraciones (2/10 APIs conectadas)

Progreso general: Nivel 3 - Usuario Competente
[Ver todos los logros] [Compartir progreso]

Integración entre Asistentes

Los cuatro asistentes trabajan de forma coordinada:

Flujo Integrado

Nuevo Usuario → Asistente Onboarding
                 ↓
              Crear Proceso → Asistente Construcción
                              ↓
                           Necesita Lógica Compleja → Asistente Bloques Avanzados
                                                       ↓
                                                    Proceso Falla → Asistente Diagnóstico
                                                                     ↓
                                                                  Solución → Aprendizaje
                                                                             ↓
                                                                          Mejora Continua

Ejemplo de Interacción

Usuario: "Quiero automatizar la extracción de datos de PDFs"

Asistente Onboarding:
"Veo que necesitas extraer datos de PDFs. Te recomiendo la plantilla
'Procesamiento de Facturas'. ¿Quieres que la configuremos?"

[Usuario acepta]

Asistente Construcción:
"He creado el proceso base. Ahora añade un bloque de 'Leer PDF'..."

[Usuario configura bloque]

Usuario: "Necesito extraer campos específicos con formato complejo"

Asistente Bloques Avanzados:
"Puedo generar código Python para extraer esos campos. Descríbeme
el formato exacto que necesitas..."

[Genera código personalizado]

[Durante ejecución, ocurre un error]

Asistente Diagnóstico:
"El PDF tiene una estructura protegida. Te recomiendo usar el
parámetro 'ignore_security=True' en el bloque de lectura..."

[Usuario aplica solución]

Asistente Onboarding:
"¡Proceso completado exitosamente! Has aprendido sobre:
- Lectura de PDFs
- Código Python personalizado
- Resolución de errores

¿Quieres aprender sobre OCR para PDFs escaneados?"

Mejores Prácticas Generales

Aprovecha al Máximo los Asistentes

1. Sé específico en tus descripciones

   • Cuanto más detallada sea tu solicitud, mejor será el resultado
   • Incluye ejemplos de entradas y salidas esperadas
   • Menciona restricciones o requisitos especiales

2. Itera y refina

   • Los asistentes aprenden de tus correcciones
   • No dudes en pedir ajustes y mejoras
   • Prueba diferentes enfoques

3. Documenta tus procesos

   • Los asistentes ayudan con la documentación automática
   • Añade comentarios explicativos en puntos clave
   • Mantén un registro de decisiones importantes

4. Comparte conocimiento

   • Las soluciones exitosas benefician a toda tu organización
   • Los patrones identificados se reutilizan en futuros procesos
   • Contribuye a la base de conocimiento colectiva

Seguridad y Privacidad

1. Revisa el código generado

   • Especialmente para operaciones con datos sensibles
   • Verifica que no se expongan credenciales
   • Confirma el cumplimiento de políticas corporativas

2. Limita permisos

   • Usa credenciales con mínimos privilegios necesarios
   • No compartas secretos entre procesos innecesariamente
   • Revisa permisos periódicamente

3. Auditoría y logging

   • Activa logging detallado en procesos críticos
   • Revisa logs regularmente
   • Configura alertas para actividades sospechosas

Solución de Problemas

Los asistentes no responden o son lentos

Posibles causas:

• Alta carga del sistema
• Conexión a internet inestable
• Proceso muy complejo

Solución:

1. Verifica tu conexión a internet
2. Intenta con una descripción más simple
3. Divide tareas complejas en pasos más pequeños
4. Si el problema persiste, contacta soporte

Las sugerencias no son relevantes

Posibles causas:

• Descripción ambigua o incompleta
• Contexto insuficiente
• Asistente necesita más información

Solución:

1. Proporciona más detalles sobre tu caso de uso
2. Incluye ejemplos concretos
3. Especifica requisitos y restricciones
4. Usa el feedback para mejorar las sugerencias

El código generado no funciona

Posibles causas:

• Dependencias faltantes
• Configuración incorrecta del entorno
• Descripción del problema no coincide con el código

Solución:

1. Verifica que todas las librerías estén instaladas
2. Revisa los mensajes de error específicos
3. Usa el Asistente de Diagnóstico para análisis
4. Proporciona el error al asistente para corrección

El Asistente de Onboarding no progresa

Posibles causas:

• Pasos no completados correctamente
• Problemas de sincronización
• Configuración incompleta

Solución:

1. Revisa que hayas completado todos los pasos requeridos
2. Recarga la interfaz del asistente
3. Verifica tu progreso en el panel de logros
4. Contacta soporte si el problema persiste

Preguntas Frecuentes

¿Los asistentes funcionan sin conexión a internet?

El Asistente de Construcción de Procesos funciona localmente, pero los asistentes de IA (Bloques Avanzados, Diagnóstico, Onboarding) requieren conexión a internet para acceder a los modelos de inteligencia artificial.

¿Puedo desactivar los asistentes?

Sí, puedes configurar el nivel de asistencia en las preferencias. Puedes optar por:

• Asistencia completa (recomendado para nuevos usuarios)
• Sugerencias ocasionales
• Solo bajo demanda
• Desactivado (solo para usuarios avanzados)

¿Los asistentes aprenden de mis procesos?

Los asistentes aprenden patrones generales y mejores prácticas, pero tus procesos específicos y datos permanecen privados. El aprendizaje se realiza de forma agregada y anónima.

¿Qué datos se envían a los asistentes de IA?

Solo se envían:

• Descripciones de funcionalidad solicitada
• Estructura de procesos (sin datos sensibles)
• Tipos de errores y contexto técnico (sin credenciales)
• Métricas de uso agregadas

Nunca se envían:

• Valores de secretos o credenciales
• Datos de negocio procesados
• Información personal identificable
• Contenido de archivos procesados

¿Puedo usar los asistentes en múltiples idiomas?

Sí, los asistentes soportan múltiples idiomas incluyendo español, inglés, francés, alemán, portugués e italiano. El idioma se detecta automáticamente o puede configurarse manualmente.

¿Hay límites en el uso de los asistentes?

Los límites dependen de tu plan de Heptora:

• Plan Free: Uso limitado de asistentes de IA
• Plan Professional: Uso generoso con límites altos
• Plan Enterprise: Sin límites, con prioridad en respuestas

¿Puedo compartir código generado por los asistentes?

Sí, el código generado por los asistentes es tuyo. Puedes compartirlo, modificarlo y reutilizarlo libremente. Te recomendamos revisar y adaptar el código a tus necesidades específicas antes de compartirlo ampliamente.

¿Los asistentes reemplazan la necesidad de desarrolladores?

No, los asistentes complementan las habilidades de los equipos. Aceleran el desarrollo para usuarios técnicos y permiten que usuarios no técnicos creen automatizaciones simples, pero procesos complejos o críticos aún se benefician de la experiencia de desarrolladores profesionales.

¿Necesitas más ayuda?

Si esta guía no resolvió tu problema o encontraste algún error en la documentación:

• Soporte técnico: help@heptora.com
• Comunidad: community.heptora.com
• Chat en vivo: Disponible en la plataforma web
• Describe claramente el problema que encontraste
• Incluye capturas de pantalla si es posible
• Indica qué asistente estabas usando y qué intentabas hacer

Nuestro equipo de soporte te ayudará a aprovechar al máximo los asistentes inteligentes de Heptora.

Recursos Relacionados

• Construcción de Procesos - Guía detallada sobre diseño de procesos
• Python en Heptora - Documentación sobre código personalizado (próximamente)
• Gestión de Secretos - Cómo manejar credenciales de forma segura
• Arquitectura Híbrida - Comprende el modelo cloud-local (próximamente)
• API Reference - Documentación técnica de APIs (próximamente)
• Mejores Prácticas - Patrones y recomendaciones (próximamente)