Cómo funciona el Asistente IA

Esta página explica la arquitectura técnica y el funcionamiento interno del Asistente IA de Gestiono. Si eres desarrollador o quieres entender cómo el asistente procesa tus consultas, esta es la documentación para ti.

Arquitectura general

El Asistente IA está construido sobre una arquitectura de agente inteligente que combina modelos de lenguaje con herramientas especializadas para interactuar con los datos de Gestiono.

Flujo de procesamiento:

1. Usuario envía mensaje
2. Conversión a mensajes del modelo
3. Agente IA procesa con herramientas
4. Múltiples llamadas a herramientas si es necesario
5. Generación de respuesta
6. Generación de sugerencias de seguimiento
7. Respuesta al usuario

Modelo de lenguaje

El asistente utiliza GPT-4o-mini de OpenAI como modelo base. Este modelo está optimizado para tareas de razonamiento y uso de herramientas, permitiendo que el asistente entienda consultas en lenguaje natural, decida qué herramientas usar, procese múltiples herramientas en secuencia y genere respuestas contextualizadas.

Límites de procesamiento: hasta 25 pasos por turno; respuestas en streaming en tiempo real.

Herramientas disponibles

El asistente tiene acceso a un conjunto completo de herramientas para consultar datos (ventas, compras, contactos, recursos, cuentas, divisiones, tareas, canales, bots, eventos, formularios), modificar datos (crear contactos, aplicar pagos) y navegar (buscar en el mapa del sitio del dashboard).

Procesamiento de solicitudes

1. Recepción del mensaje — Se convierte el mensaje UI a formato del modelo, se incluye el contexto de la página actual y se prepara el historial.
2. Ejecución del agente — Análisis, planificación, ejecución de herramientas, síntesis y respuesta.
3. Streaming de respuesta — La respuesta se transmite en tiempo real.
4. Sugerencias de seguimiento — Se generan 3 sugerencias de preguntas relacionadas en español.

Contexto de página

El asistente puede recibir información sobre la página que estás viendo (URL, título, descripción, ruta de navegación, templateValues). Este contexto permite que entienda referencias como “este producto” o “esta factura” sin necesidad de IDs explícitos.

Seguridad y permisos

• Aislamiento por organización: Todas las herramientas respetan el aislamiento de datos por organización.
• Permisos de usuario: Las operaciones respetan los permisos del usuario.
• Validación de datos: Las herramientas validan los datos de entrada con esquemas antes de ejecutarse.

Integración técnica

• Backend: POST /v1/automation/assistant — Acepta historial de mensajes, contexto de página opcional e ID de organización.
• Frontend: Panel del asistente con hook de conversación, transporte personalizado que incluye contexto de página y streaming en tiempo real.

Próximos pasos

1. Volver a la documentación del Asistente IA
2. Referencia de API — Endpoints que el asistente utiliza
3. Eventos — Sistema de eventos que el asistente consulta