Manual de Sapius
De la carpeta del proyecto al bloque compilado. Todo lo que necesitas para arrancar por tu cuenta.
1. Qué es Sapius
Sapius es el compañero virtual del programador de PLC: lee el proyecto, escribe el código, lo lleva al entorno del fabricante, compila, corrige los errores y conserva resultados y pruebas. Tú describes el resultado; las decisiones son tuyas y quedan escritas en el proyecto. También puedes pedirle propuestas razonadas, por ejemplo cómo organizar los parámetros de un bloque.
En TIA Portal (V16–V20) trabaja sobre una copia verificada de tu proyecto: escribe los bloques en SCL, los importa, compila y corrige hasta llegar a cero errores. Crea UDT, DB y tags, lee el hardware, prepara pantallas y tags HMI de WinCC y las pruebas con PLCSIM Advanced. Para Rockwell, CODESYS, Schneider y TwinCAT, y para los HMI Optix y Weintek, genera y modifica el código fuente y los archivos de proyecto, listos para importar en el entorno del fabricante (capítulo 8).
Para el diagnóstico lee los valores del PLC con S7, Modbus TCP, OPC UA y EtherNet/IP. La marca del PLC, el entorno de ingeniería y el protocolo son elecciones distintas: las haces tú, proyecto a proyecto.
Cada escritura pasa por tu sí, o por el modo de consentimiento que elijas (capítulo 7). Sapius no carga nada en la CPU: la carga la haces tú desde TIA, cuando el trabajo te convence.
2. Instalación
Requisitos
Sapius funciona en Windows 10 de 64 bits (1809 o posterior) y en Windows 11, con WebView2. El motor del agente viene incluido en el instalador. Necesitas una cuenta en sapiusportal.it, como particular o como empresa, y la IA que prefieras: tu cuenta de IA, tu propia API compatible, la IA gestionada por Sapius o la IA local en tu PC. Para TIA Portal: V16–V20 con Openness, .NET Framework 4.8 y tu usuario de Windows en el grupo Siemens TIA Openness. Para las demás marcas, el software de ingeniería del fabricante con sus licencias.
Instalar Sapius
Descarga el instalador desde el área privada, sección Descargas. Si actualizas, cierra Sapius antes de ejecutarlo: proyectos, cuentas y preferencias siguen en su sitio. El programa se instala en C:\Program Files\Sapius; puedes añadir sapius al PATH. Los proyectos y los ajustes están en %LOCALAPPDATA%\SapiusV2 y la desinstalación los conserva.
Sapius_Setup_<versión>.exe /VERYSILENT /SUPPRESSMSGBOXES /NORESTART
Cuenta e IA
Entra con el email y la contraseña de tu cuenta de Sapius. Si usas tu cuenta de ChatGPT, pulsa Conectar ChatGPT y completa el acceso de OpenAI en el navegador: son dos accesos separados. Para cambiar de cuenta de Sapius usa Cerrar sesión; para cambiar de ChatGPT, desconéctalo desde el panel de la cuenta y vuelve a conectarlo. Los proyectos se quedan en el PC.
Actualizaciones y conocimiento
Cuando hay una actualización disponible aparece Actualizar ahora: Sapius verifica la descarga con la huella publicada y después inicia el instalador. Puedes aplazarla. En el primer inicio eliges si contribuyes al conocimiento técnico compartido: es opcional y lo cambias cuando quieras en los ajustes (capítulo 6).
Idioma de Sapius
Elige italiano, inglés, español, alemán o francés con el botón de idioma de la barra superior o en Ajustes → Idioma, también antes de iniciar sesión. La elección queda guardada en este PC y el cambio conserva borradores, adjuntos y trabajo en curso. En las conversaciones nuevas el asistente usa el idioma elegido, salvo que le pidas otro. El código PLC, los nombres de los tags, los documentos y los mensajes técnicos originales se quedan como están.
Iconos, columnas y ayuda
La barra usa iconos con descripciones al pasar el ratón: registro, libro del manual, idioma, ajustes y salida. El libro abre este manual en el idioma elegido. Arrastra el borde entre Proyectos y el chat, o entre el chat y los detalles, para cambiar los anchos, que se guardan en este PC. Con el teclado, selecciona el separador y usa las flechas; Mayús aumenta el paso, e Inicio o un doble clic restablecen el ancho inicial. En las ventanas estrechas los paneles se adaptan al espacio disponible.
Para un proyecto nuevo usa el + junto a Proyectos (Nuevo proyecto), rellena nombre, cliente y revisión y confirma. En cambio, con un proyecto abierto, el botón grande de arriba crea una conversación nueva. Puedes preguntar a Sapius cómo usar el programa: conoce la guía de la versión instalada y te explica los pasos.
3. Prueba, precios y licencias
La prueba de 7 días
Siete días en un proyecto, con Officina, sin tarjeta. Crea la cuenta, como particular o como empresa, verifica el email y acepta las condiciones de venta con el código que recibes por email (seis cifras, válido 15 minutos). En Sapius pulsa Activar la prueba de 7 días, o usa /prova. Durante la prueba usas tu cuenta de IA, tu propia API compatible o la IA local.
Cada cuenta y cada PC tienen derecho a una prueba. Al terminar, sin cargo automático: tus proyectos se quedan en el PC. Para continuar, activas la suscripción cuando quieras.
El precio
| Sapius, por puesto | Primer mes | Desde el segundo mes |
|---|---|---|
| Empresas y profesionales | 149 € + IVA | 299 € + IVA al mes |
| Particulares en Italia | 181,78 € IVA incluido | 364,78 € IVA incluido al mes |
El primer mes promocional se aplica a la primera activación de pago de la cuenta. La suscripción incluye todas las herramientas de Sapius, Officina, las actualizaciones y 10 € de saldo de IA por cada mes y puesto pagado. Siempre puedes usar tu cuenta, tu API o la IA local. El software y las licencias de los fabricantes se compran a cada fabricante.
Compras y renovaciones
En el área privada abre Acquisti (Compras), elige Sapius y paga en Stripe: el resumen muestra el importe y el IVA según tus datos de facturación. Con el pago confirmado, la licencia está en la página Licencias. Suscripciones y Facturas reúnen los documentos y la gestión de la cuenta.
La suscripción se renueva cada mes. La cancelas cuando quieras desde el área privada y sigue activa hasta el final del periodo pagado. Desde la gestión de pagos actualizas el método de pago. La factura electrónica se transmite aparte a través del SDI. Si compras como particular tienes 14 días para desistir: el botón está en la página Compras y el formulario, en la página Formulario de desistimiento.
Licencia del puesto
El panel de la cuenta y /licenza muestran el código de máquina de 24 caracteres. En la página Licencias del área privada pega el código, activa el puesto y descarga el archivo .licenza; después cárgalo en Sapius desde el panel de la cuenta (Cargar licencia) o con /licenza <file> en el terminal.
El código identifica el PC: se obtiene de la placa base o de la instalación de Windows, y por eso Sapius funciona también en máquina virtual. Si reinstalas Windows, anula la activación anterior desde la página Licencias y activa el código nuevo. Si tienes varias máquinas virtuales clonadas, da a cada una su propia instalación de Windows antes de activarla.
Puedes trasladar la licencia a otro PC hasta tres veces en 12 meses; volver a descargar la misma licencia no cuenta como traslado. Tus proyectos se quedan siempre en el PC.
4. IA, saldo y presupuesto
Cuatro formas de usar la IA
- Tu cuenta de IA: conectas ChatGPT y trabajas con los modelos de tu catálogo.
- Tu propia API compatible: indicas modelo y endpoint y trabajas con tu proveedor.
- IA gestionada por Sapius: usas el saldo incluido en la suscripción y las recargas; los modelos y las tarifas están en el catálogo.
- IA local: el modelo trabaja en tu PC y no consume API ni saldo.
Las herramientas de Sapius son las mismas en los cuatro casos. La elección vale para las conversaciones nuevas: las que ya están abiertas conservan modelo, conexión y perfil económico.
Con cuenta y API propias, los contenidos necesarios para el trabajo van al proveedor que has elegido. Con la IA gestionada pasan por el gateway de Sapius al proveedor indicado en el catálogo. Con la IA local se procesan en tu PC. El conocimiento compartido es otra cosa: el consentimiento para las fichas técnicas no afecta a chats ni proyectos. Consulta privacidad y condiciones.
Configurar la IA
- Abre Ajustes → IA y consumo.
- Elige tu cuenta de ChatGPT, tu propia API, la IA gestionada por Sapius o la IA local.
- Con la IA gestionada eliges un modelo del catálogo y el presupuesto máximo en euros para el trabajo. Para tu propia API indica el modelo, el endpoint Responses compatible y el nombre de la variable de entorno que contiene la clave: el secreto se queda fuera de Sapius. Un endpoint local sin autenticación puede prescindir de la variable.
- En el portal abre IA y saldo para ver disponibilidad, saldo incluido y comprado, reservas, movimientos y tarifas.
Para las conversaciones nuevas con la IA gestionada o con una API compatible se recomienda GPT 6.1 Sol (gpt-6.1-sol), con los cinco niveles de intensidad low, medium, high, xhigh y max. Con tu cuenta encuentras los modelos de su catálogo.
Saldo, recargas y presupuesto
Cada mes pagado incluye 10 € de saldo de IA por puesto, para usar dentro del periodo indicado en el portal. Las recargas opcionales son de 20, 50 y 100 € + IVA (para particulares en Italia, 24,40 €, 61,00 € y 122,00 € IVA incluido): no se renuevan automáticamente y siguen disponibles al cambiar de mes. Antes del pago, Stripe muestra el total. Las tarifas por modelo están en la página IA y saldo, separadas por entrada, caché y salida; se contabiliza el consumo real.
Al llegar al límite de saldo o de presupuesto, el trabajo se pone en pausa y conserva los resultados: tú decides si subes el límite, recargas o cambias de modalidad. Ninguna recarga y ningún cambio de modelo se hacen solos. Para cambiar el límite de una conversación ya abierta, pulsa el botón de presupuesto junto a la intensidad cuando el trabajo esté en pausa o terminado: el nuevo límite incluye también lo ya consumido.
IA local
Abre Ajustes de IA → Instalar IA local → Instalar e iniciar y después elige IA local para una conversación nueva. Hacen falta Windows x64, al menos 16 GB de RAM instalada, 8 GB libres y 8 GB de disco. El modelo, de unos 2,76 GB, se descarga en el primer inicio y trabaja en la CPU de tu PC.
5. El primer proyecto
Crear el proyecto
Pulsa Nuevo proyecto, indica nombre, cliente y revisión y abre una conversación. Escribe el objetivo y las restricciones del trabajo. Elige el perfil de ingeniería del proyecto: Siemens, Rockwell, Schneider Machine Expert o Control Expert, CODESYS o Beckhoff.
Elegir la carpeta
Abre los tres puntos junto al título del proyecto y después Carpeta del proyecto. Navegas por las carpetas del PC sin escribir la ruta. Confirma la revisión; con Actualizar importas los archivos que han cambiado. Los archivos importados se copian en el proyecto de Sapius, con origen y revisión.
Importar documentos en las fuentes
Desde los mismos tres puntos abre Fuentes → Importar. En el selector de archivos habitual elige uno o varios archivos y ábrelos. Sapius usa la revisión actual del proyecto, da un resultado por cada archivo y reconoce los que ya están importados, sin duplicar las fuentes.
Las fuentes se quedan en el proyecto con origen y revisión y están disponibles en todas sus conversaciones, también después de reiniciar. Son distintas de los adjuntos del mensaje, que añades con el + en el cuadro de mensaje.
Puedes importar hasta 20 MB por archivo: PDF, Word .docx, Excel .xlsx/.xlsm, Markdown, CSV, XML, JSON, texto y código fuente PLC. El resumen muestra el resultado archivo por archivo. Si un PDF está escaneado, prepara una versión con texto seleccionable: Sapius conserva igualmente el original entre las fuentes.
PLC / Comunicación
En el panel del proyecto abre PLC / Comunicación. Elige marca o entorno, familia o modelo y protocolo. En el segundo paso configura los parámetros: S7 usa host, puerto, rack y slot; Modbus TCP, Unit ID, base y orden de las palabras; OPC UA, URL y seguridad; EtherNet/IP, familia CIP y ruta. Confirmar guarda la configuración para los próximos inicios; Cancelar lo deja todo como estaba.
La conexión de ingeniería con el proyecto y la comunicación con el PLC tienen estados separados: cambias la marca sin tocar el protocolo, y viceversa.
Probar la comunicación
Pulsa Prueba de comunicación para una comprobación inmediata. S7 comprueba la negociación del protocolo. Para Modbus TCP, OPC UA y EtherNet/IP indicas la dirección o el tag y el tipo que quieres leer. La prueba solo lee: ningún valor escrito, ningún comando a la CPU. Con el resultado a la vista, pulsa Confirmar para guardar la configuración.
OPC UA mantiene las verificaciones de los certificados; el formulario configura el acceso anónimo.
6. Trabajar con el agente
Conversaciones y paneles
Escribe el resultado que quieres, adjunta las fuentes con + y deja al agente el ciclo de lectura, modificación y verificación. En la barra eliges la intensidad del trabajo. El registro muestra la actividad; Cerrar o Esc cierra los paneles. Cerrar sesión permite cambiar de cuenta.
Mientras Sapius trabaja, el chat muestra actualizaciones y actividades con iconos y detalles desplegables, separadas de la respuesta final, y el plan cuando el motor lo comunica. El desplazamiento sigue el trabajo cuando estás cerca del final; si subes para leer, mantiene tu posición, y Últimas actualizaciones te devuelve al presente. La respuesta final usa Markdown para listas, código y enlaces.
Intro envía el mensaje; Shift+Intro (Mayús+Intro) inserta un salto de línea. Ctrl+Intro también envía. Si el agente está trabajando, el mensaje va a la cola, como se describe más abajo; Stop es el comando aparte para detener el turno.
Para adjuntar usa +, arrastra un archivo al cuadro de mensaje o pega una captura de pantalla. Cada adjunto puede llegar a 25 MB. Espera a que termine la carga antes de enviar; quita un adjunto del próximo mensaje con la cruz de su tarjeta.
Haz clic en un adjunto o un artefacto para abrir la vista previa: las imágenes y los PDF se muestran en el panel; los textos y el código fuente, incluido Markdown, se leen como texto. Los demás formatos los abres desde la carpeta del proyecto. Puedes ampliar el panel, arrastrar su borde o cerrarlo; en las ventanas estrechas se abre encima del chat y también se cierra con Esc.
Con el botón i abres la información y Apariencia: aquí eliges el tema claro, oscuro o como Windows, que se recuerda en el puesto. El menú ··· junto al título del proyecto abre sus opciones, la carpeta y la comunicación PLC.
Cola y Redirigir
Puedes enviar más mensajes mientras el agente trabaja: se quedan en la cola de la conversación y se procesan en orden. Redirigir envía la aclaración al turno en curso, sin reiniciarlo: úsalo para corregir una hipótesis o añadir una restricción. Las autorizaciones siguen siendo las que has elegido.
Después de un Stop, un error o un reinicio, la cola queda en pausa, a tu disposición: revísala y reanuda. Un envío de resultado incierto no se repite solo: decides tú.
Resultados y memoria del proyecto
Artefactos, hechos con su fuente, decisiones y preguntas abiertas se quedan en el proyecto. Un código fuente propuesto, un bloque compilado, una prueba en simulación y una verificación en campo son resultados distintos, y Sapius los mantiene separados: pide siempre el resultado de la compilación y las pruebas realizadas, junto con el archivo.
El agente puede proponer la organización de los DB de parámetros, la llamada a los bloques, el diagnóstico o unas pruebas adecuadas al contexto. Las decisiones que ya has tomado siguen siendo la referencia.
Conocimiento compartido
En el primer inicio o en los ajustes puedes aceptar compartir fichas técnicas generales estructuradas. Con la adhesión activa, Sapius las envía a la revisión del titular, que decide su publicación. Chats, documentos, código fuente y datos del proyecto se quedan fuera.
Los borradores de texto libre piden tu confirmación cada vez. Puedes revocar la adhesión desde los ajustes cuando quieras. Preferencias personales, hechos del proyecto y lecciones compartidas son tres memorias distintas.
Después de una corrección, Sapius vincula el error, el cambio y la verificación superada, y conserva síntoma, causa propuesta, solución y condiciones de aplicación. La búsqueda reconoce también los sinónimos técnicos en italiano y en inglés, y los resultados de la reutilización ayudan a valorar las lecciones.
7. Autorizaciones, Todo y Officina
El consentimiento en el servicio
El servicio comprueba los permisos en el momento en que ejecuta la herramienta: decides tú, y solo tú. Análisis, escritura de archivos, ingeniería offline, importación en el proyecto y lecturas del PLC son operaciones distintas, y cada una conserva parámetros, resultado y origen.
Elegir el modo
- Manual: pide tu consentimiento para cada operación que vaya más allá del puro análisis.
- Cambios en los archivos: permite archivos de trabajo, ingeniería offline y comandos locales; pide consentimiento para las clases siguientes.
- Automático: incluye también las lecturas del PLC en el destino declarado.
- Todo: incluye las importaciones TIA en la copia de trabajo, con FB, FC, nuevos DB, UDT y Main, sin un clic por cada bloque. El servicio registra el consentimiento para cada intento y contenido.
- Officina: un consentimiento sobre un FB o FC cubre las correcciones de ese bloque durante ocho horas, en la misma copia y CPU; los demás bloques siguen su propia autorización.
Copias, controles y reanudación
El modo Todo trabaja sobre la copia: el original se queda como está, y la carga y las maniobras en el PLC quedan en tus manos. Siguen activos los controles de la copia, el archivado y las protecciones. La sustitución de un DB existente sigue un recorrido propio: análisis, copia aislada, compilación y verificación.
Cuando se te pida un consentimiento, revisa destino y parámetros. También una denegación queda registrada. Al reanudar, una operación de resultado incierto espera tu decisión. Los comandos locales pueden usar archivos y recursos del PC: elige el modo según el trabajo que quieras encargar.
8. TIA Portal y otros entornos
Preparar y conectar TIA
Configura la versión de TIA y la carpeta de las copias de trabajo. El agente prepara la copia mediante archivado y reapertura, y después identifica sesión y ruta antes de conectarse. Usa la versión del proyecto: así evitas conversiones involuntarias. Cuando TIA muestre el consentimiento de Openness, acéptalo en la aplicación de Siemens; TIA puede volver a pedirlo después de una actualización.
Programa y hardware
Sapius explora CPU, bloques, tablas de tags y configuración de hardware, y trabaja sobre la copia. Escribe e importa SCL y SimaticML, organiza FB, FC, DB y UDT, llama al trabajo desde Main, compila, lee los errores, corrige y guarda, hasta llegar a cero errores. Para añadir un módulo comprueba catálogo, compatibilidad y configuración existente.
Con Todo, el ciclo continúa con el consentimiento que ya has dado sobre la copia. Para los DB existentes, Sapius analiza los efectos, prueba la sustitución en una copia aislada y conserva las evidencias antes de adoptarla. Los bloques con protección de know-how y el programa de seguridad se quedan como están.
WinCC y PLCSIM
Las herramientas HMI de WinCC trabajan dentro de TIA con pantallas, tags y listas de textos, siempre sobre la copia; las plantillas se pueden inventariar y exportar. Si el panel usa una conexión integrada, la encuentras en los tags aunque la lista Connections esté vacía: no hace falta crear otra. Con PLCSIM Advanced, Sapius prueba el programa en una instancia de simulación dedicada, separada de tu sesión de trabajo.
La entrega distingue la compilación del software PLC, del hardware y del HMI. Tras comparar las exportaciones, Sapius guarda y puede crear un archivo completo del proyecto, con tamaño y SHA-256.
Otros PLC y HMI
| Entorno | Qué hace Sapius y cómo continúas |
|---|---|
| Rockwell / Studio 5000 | Lee las exportaciones L5X, hace su inventario y genera o modifica rutinas ST, tags y tipos de datos en una copia. Importas el archivo en Studio 5000 y compilas allí. |
| CODESYS / Schneider Machine Expert | Genera código fuente ST y visualizaciones (Visualization XML) a partir de una especificación, con un catálogo de nueve componentes, y lee las exportaciones. Importas los archivos en tu IDE CODESYS o Machine Expert. |
| Schneider Control Expert | Genera y valida secciones ST .XST y nuevas variables .XSY, usando si quieres una exportación de tu proyecto como plantilla. En Control Expert importas primero las variables y después la sección, analizas y compilas; si el IDE indica errores, se los pasas a Sapius y los corrige. |
| Beckhoff TwinCAT | Lee proyectos y objetos PLC y modifica los POU en ST sobre una copia, con archivado. Abres la copia en XAE para compilar y activar. |
| Weintek EasyBuilder Pro | Genera los CSV de tags y las macros tipadas GetData/SetData a partir de una especificación, listos para importar en EasyBuilder Pro. |
| FactoryTalk Optix | Genera NetLogic C# y nodos YAML para paneles, variables y widgets, también en una copia del proyecto. Abres el proyecto en FactoryTalk Optix y llamas al método Build. |
Para cada marca, Sapius comprueba el formato de los archivos que genera y trabaja siempre sobre copias: el original se queda como está. Para importar y compilar usas el software del fabricante, con sus licencias.
Terminar el trabajo
Pide una entrega con archivos, resultado de la compilación, pruebas y puntos abiertos. El paso al proyecto definitivo y al PLC lo decides tú: copias el bloque en TIA de un proyecto a otro, o importas el código fuente, que se queda entre los archivos del proyecto.
9. El terminal
Ejecuta sapius; sapius --aiuto muestra las opciones. El terminal comparte proyectos, fuentes y controles con la ventana. Aquí el agente usa tu propia API: pasa la clave con OPENAI_API_KEY o ANTHROPIC_API_KEY.
/progetti, /nuovo, /conversazioni, /nuova, /fonti y /importa gestionan el trabajo. /costruttore elige el perfil de ingeniería. /plc muestra la comunicación; /plc configura file.json la guarda, /plc test file.json [indirizzo tipo] ejecuta una prueba y /plc rimuovi la elimina. /cpu sigue disponible para S7.
/accedi esci cierra la sesión de la cuenta; /licenza, /prova, /aggiornamenti, /registro, /riprendi y /aiuto completan los comandos principales. Cuando se pide un consentimiento hace falta tu respuesta explícita: cerrar el terminal no vale como sí.
10. Si algo no funciona
Acceso, cuota y actualización
Comprueba primero qué cuenta de Sapius y qué cuenta de IA están conectadas. Si la cuota de tu cuenta de OpenAI está agotada, consulta tu cuenta de OpenAI o pasa a otra conexión de IA desde los ajustes. Si falta la licencia, actívala desde el área privada. Si una actualización no aparece, comprueba la conexión y usa la búsqueda de actualizaciones.
Conexión con el PLC o con TIA
Revisa marca, protocolo, destino y parámetros. Para S7 comprueba rack, slot y configuración de acceso: las lecturas S7 necesitan PUT/GET y DB de acceso estándar. Para los demás protocolos revisa la dirección de prueba, el tipo y los ajustes de seguridad. Para TIA comprueba versión, grupo Openness y cuadros de diálogo en espera.
Retomar el trabajo
Cierra los paneles con Cerrar o Esc. Después de un Stop, vuelve a abrir la conversación, revisa la cola y reanuda. Ante una operación de resultado incierto, consulta el registro y el destino, y después decide si la repites. Si necesitas ayuda, escribe a support@sapiusportal.it: te responde un programador de PLC.
11. Glosario
Proyecto: un trabajo con sus fuentes, revisiones y decisiones. Artefacto: archivo generado y conservado. Copia de trabajo: la copia del proyecto sobre la que escribe Sapius. Protocolo: comunicación con el dispositivo, que se elige aparte del IDE. Muestra: valor leído del PLC, con calidad, instante y origen. Compilado: aceptado por el compilador. Simulado: ejecutado en un entorno de simulación. Verificado en campo: comprobado en la planta, con evidencias. Officina: modo en el que un consentimiento cubre las correcciones del mismo bloque durante ocho horas. IA gestionada: IA que proporciona Sapius, con cargo al saldo.
SAPIUS