• AsistenteIAFS: documentación, instalación y uso

AsistenteIAFS: documentación, instalación y uso

AsistenteIAFS — Manual de uso

Asistente de inteligencia artificial integrado en FacturaScripts. Pregunta en lenguaje natural sobre tus datos, analiza documentos e imágenes y navega al ERP, con un motor de consultas de solo lectura y tus claves de API cifradas.

1. Requisitos e instalación

1. FacturaScripts 2025+ y PHP 8.1+.
2. Panel de control → Plugins → Añadir, sube el ZIP y pulsa Activar. Reconstruye si se solicita.
3. Necesitas una clave de API de uno de estos proveedores: Anthropic (Claude), OpenAI o Google Gemini.

2. Configuración (paso a paso)

1. Entra en AsistenteIAFS → Configuración.
2. Elige el proveedor (Anthropic, OpenAI o Gemini) y el modelo.
3. Pega tu clave de API: se guarda cifrada (AES-256-GCM); el plugin nunca la muestra en claro.
4. Ajusta el límite de tokens de respuesta (por defecto 2048) y demás opciones.
5. Guarda. Ya puedes usar el asistente.

3. El chat a pantalla completa

AsistenteIAFS → Chat.

1. Escribe tu pregunta en lenguaje natural (p. ej. "¿cuáles son mis 10 mejores clientes por facturación este año?").
2. El asistente genera la consulta, la ejecuta de forma segura (solo lectura) y te muestra la respuesta.
3. Cada resultado incluye enlaces directos a las fichas y listados del ERP (clientes, facturas, productos…).

4. Conversaciones: continuar, recuperar o empezar de nuevo

• El historial se guarda por sesión.
• Puedes continuar la conversación actual, recuperar una conversación anterior desde el listado de sesiones, o pulsar Nueva para empezar de cero.

5. Widget flotante global

El asistente está disponible en todas las pantallas mediante un botón flotante. Ábrelo desde cualquier ficha para preguntar sin salir de donde estás; mantiene el mismo historial que el chat completo.

6. Análisis de documentos e imágenes

Adjunta un PDF o una imagen (por ejemplo, una factura o un ticket fotografiado) y pide al asistente que la lea, la resuma o extraiga sus datos. Compatible con los modelos de visión de los tres proveedores.

7. Seguridad y privacidad

• Motor de consultas blindado: solo lectura; no puede modificar ni borrar datos.
• Validación de consultas antes de ejecutarlas.
• Claves cifradas (AES-256-GCM) en la base de datos.
• Control de uso para evitar consumos excesivos.
• Tú eliges el proveedor de IA; los datos solo salen hacia el proveedor que configures.

8. Consejos de uso

• Sé específico (rango de fechas, cliente, importe) para mejores respuestas.
• Usa los enlaces de la respuesta para llegar directo a la ficha o al listado filtrado.

9. Aviso importante

La IA puede cometer errores. Revisa siempre la información antes de tomar decisiones.

10. Soporte

soporte@adelantia.com — YAST TELECOM SL.