AsistenteIAFS: documentación, instalación y uso

Guía de uso de AsistenteIAFS

AsistenteIAFS es un asistente de inteligencia artificial para FacturaScripts que te permite consultar los datos de tu negocio en lenguaje natural, sin saber SQL. Preguntas por impagados, ventas, márgenes, stock o comparativas y recibes la respuesta explicada, con tablas, gráficos y exportación a CSV. Es compatible con Claude (Anthropic), ChatGPT (OpenAI) y Gemini (Google).

1. Instalación

Descarga el ZIP de AsistenteIAFS.
En FacturaScripts, ve a Administración → Plugins, pulsa Añadir y sube el ZIP.
Actívalo y pulsa Reconstruir. Al hacerlo se crean las tablas, se genera la clave de cifrado de las API keys y se cargan los ajustes por defecto.

Requisitos: FacturaScripts 2026 o superior y PHP 8.1+. Necesitas además una API key de al menos un proveedor de IA (Claude, ChatGPT o Gemini), que se contrata aparte con cada proveedor.

Las opciones del plugin están en el menú Informes. Además, un botón flotante del asistente aparece en todas las pantallas del programa.

2. Configuración inicial

Ruta de menú: Informes → Configuración del Asistente IA.

Proveedor activo

Selecciona el proveedor que quieres usar: Claude (Anthropic), ChatGPT (OpenAI) o Gemini (Google). Puedes tener varias claves configuradas, pero solo se usa el proveedor marcado como activo.

Claves y modelo por proveedor

Para cada proveedor rellena:

API Key: se guarda cifrada. Si ya hay una configurada, déjala en blanco para conservarla.
Modelo: elige uno de la lista o escribe el identificador exacto de otro modelo.
Botón Probar conexión: comprueba que la clave y el modelo funcionan y muestra el resultado.

Límites, coste y privacidad

Max tokens / respuesta: longitud máxima de cada respuesta.
Turnos de historial: cuántos mensajes previos recuerda el asistente.
Días de retención: días que se conservan las conversaciones (luego se borran solas).
Max filas por consulta: límite de filas devueltas.
Tope tokens / día: consumo máximo diario (0 = sin límite).
Coste EUR / 1M tokens de entrada y de salida: para estimar el gasto que se muestra al usuario.
Mostrar el SQL ejecutado: enseña la consulta que ha generado la IA.
Anonimizar datos personales antes de enviarlos a la IA (RGPD): enmascara nombres, emails, NIF, teléfonos y direcciones.
Permitir acciones que modifican datos (con confirmación): activa las acciones de escritura (ver sección 4). Está desactivado por defecto.

Conexión de base de datos de solo lectura (opcional)

Si indicas Host, Base de datos, Usuario y Contraseña de un usuario de base de datos con permiso únicamente de lectura, las consultas se ejecutarán con ese usuario, que es la protección más robusta. Si lo dejas vacío, se usa la conexión del núcleo con una transacción que se revierte siempre.

Pulsa Guardar al terminar.

3. Consultar datos con el Asistente IA

Ruta de menú: Informes → Asistente IA (o el botón flotante presente en cualquier pantalla).

Escribe tu pregunta en lenguaje natural en la caja "Pregunta algo sobre tu negocio..." y pulsa Enviar.
El asistente genera la consulta, la ejecuta de forma segura y te devuelve una respuesta explicada en español, una tabla con los datos, un gráfico cuando procede, enlaces directos a las fichas del ERP relacionadas y un botón para exportar a CSV. Si lo has activado, también el SQL ejecutado, los tokens consumidos y el coste estimado.

Junto a la caja de texto tienes preguntas frecuentes sugeridas que puedes pulsar directamente (impagados, ventas del mes por familia, albaranes pendientes de facturar, top productos, stock bajo mínimo…). Con Nueva conversación empiezas un chat en blanco. Puedes adjuntar archivos (por ejemplo una factura) si el proveedor/modelo activo admite archivos (Claude o Gemini, o un modelo con visión).

Seguridad: las consultas son de solo lectura y blindadas (transacción de solo lectura, validación estricta y tablas sensibles bloqueadas). El asistente no puede modificar datos salvo mediante las acciones asistidas de la sección 4.

4. Acciones que escriben (asistidas)

Si en la configuración has activado Permitir acciones que modifican datos y tienes permiso de modificación, el asistente puede proponer acciones como marcar recibos pagados o crear notas/documentos. Nunca se ejecutan solas: aparecen como propuesta y debes confirmarlas explícitamente, y quedan registradas en la auditoría. Cuando prepara un documento, muestra los datos para que los revises antes de crearlo.

5. Historial y auditoría

Ruta de menú: Informes → Historial del Asistente IA.

Tiene dos listados: Historial del Asistente IA (todas las conversaciones: fecha, usuario, contenido; con búsqueda) y Acciones del Asistente IA (auditoría de las acciones de escritura: tipo, descripción, usuario, estado y resultado). Las conversaciones se eliminan solas pasados los días de retención configurados.

Preguntas frecuentes

No veo el menú del plugin. Ve a Administración → Plugins y pulsa Reconstruir.
Me dice que no hay API key configurada. Ve a Informes → Configuración del Asistente IA, introduce la clave del proveedor activo y usa "Probar conexión".
Error al conectar con el proveedor de IA. La API key puede ser incorrecta o no tener saldo; compruébalo con "Probar conexión".
Se ha alcanzado el límite de consumo diario. Has llegado al Tope tokens / día. Súbelo o espera al día siguiente.
¿Puede el asistente borrar o cambiar mis datos por error? No: las consultas son de solo lectura; cualquier acción que escriba requiere activar el modo y tu confirmación.
¿Se envían datos personales a la IA? Solo los necesarios. Activa "Anonimizar datos personales" para enmascararlos antes del envío.

Soporte: soporte@adelantia.com