Integración de agentes híbridos

De un vistazo

Conecta tu espacio de trabajo de Altium 365 a un sistema PLM local sin exponerlo a Internet ni abrir puertos para el tráfico entrante. Este artículo explica cómo el agente híbrido transmite información mediante conexiones HTTPS salientes y detalla los requisitos, la instalación y la configuración, incluida la ejecución del agente como servicio de Windows. Sigue leyendo para dar el siguiente paso hacia la configuración de tu integración híbrida con PLM.

- Conoce los requisitos de licencia, Java y red del agente híbrido.
- Aprende a generar una clave de API, iniciar el agente y configurar la conexión con el sistema PLM en tu espacio de trabajo.
- Consulta las instrucciones para ejecutar el agente como servicio de Windows y actualizarlo para que utilice una nueva clave de API.
Profundiza con IA:

La integración híbrida se aplica cuando una empresa que utiliza Altium 365 desea integrar su espacio de trabajo con un sistema PLM alojado localmente, dentro de la red de la empresa, que no dispone de una dirección IP pública; es decir, no está expuesto a Internet.

Para ello, se ejecuta un pequeño programa llamado Hybrid Agent dentro de la red de la empresa. Este programa se comunica con Altium 365 y transmite información entre el espacio de trabajo de Altium 365 y el sistema PLM dentro de la red cerrada. La comunicación con Hybrid Agent se realiza mediante HTTPS y no es necesario abrir ningún puerto de red para el tráfico entrante desde Internet. El puerto HTTPS estándar 443 solo es necesario para el tráfico saliente.

Note:

Configurar la integración híbrida

Descargue el archivo comprimido del agente () y extraiga su contenido en una ubicación conocida. Contiene una aplicación Java (hybrid-agent.jar) que debe ejecutarse en un equipo dentro de la red de la empresa, desde el que se pueda acceder tanto al sistema PLM local como a Altium 365.

No es not necesario que ese equipo sea accesible públicamente desde Internet, pero sí debe poder conectarse al entorno de Altium 365 que utiliza su empresa.

  • Tenga en cuenta que no es not necesario ejecutar Hybrid Agent en el equipo que aloja el sistema PLM, aunque esta configuración no debería causar problemas.
  • La aplicación Hybrid Agent incluye archivos de script de shell equivalentes (como agent.sh) para sistemas basados en Linux; utilícelos en lugar de los archivos *.bat de Windows en las instrucciones de configuración del agente que se indican a continuación.

Las versiones 5 y anteriores de Hybrid Agent requieren Java Development Kit (JDK) versión 11 o posterior. A partir de la versión 6 (publicada el 6 de julio de 2026), Hybrid Agent requiere JDK versión 17 o posterior.

Los espacios de trabajo de Altium 365 admiten las versiones 5 y 6 de Hybrid Agent. Por lo tanto, si ya tiene instalada la versión 5 de Hybrid Agent, no es necesario actualizar a la versión 6.

Una vez instalada la aplicación Hybrid Agent:

  1. Genere la clave de API en la página Hybrid Agent del espacio de trabajo de Altium 365 ().
  2. Cree una variable de entorno HYBRID_AGENT_API_KEY cuyo valor sea la clave de API.
  3. Ejecute agent.bat con la siguiente sintaxis de comando, donde el argumento del parámetro URL debe ser la URL de su espacio de trabajo de Altium 365:
    agent.bat https://acme.365.altium.com

Cuando esté activo, Hybrid Agent generará un archivo de registro en la carpeta hybrid-agent\logs de la aplicación.

Tenga en cuenta que el espacio de trabajo solo puede tener una clave de API válida a la vez y que solo puede ejecutarse una instancia de Hybrid Agent. El agente admitirá más de una instancia de configuración de PLM si ambos sistemas PLM están alojados dentro de la misma red cerrada.

Se recomienda encarecidamente ejecutar Hybrid Agent como un servicio de Windows en el entorno de producción, en lugar de hacerlo directamente en el terminal, aunque esta última opción puede utilizarse para realizar pruebas.

Ejemplo de cómo ejecutar Hybrid Agent como servicio de Windows mediante el administrador de servicios NSSM:

  1. Ejecute el comando: nssm install HybridAgent.
  2. En el cuadro de diálogo de NSSM (en la pestaña Application), introduzca la ruta del archivo agent.bat en el campo Path y la URL de su espacio de trabajo en el campo Arguments, y haga clic en Install service.
    1. Puede configurar el comportamiento de inicio del servicio con la opción Startup type de la pestaña Details del cuadro de diálogo de NSSM. Si es necesario, ejecute nssm edit HybridAgent para realizar estos cambios.
    2. Como alternativa a la creación de las variables de entorno estándar PATH y JAVA_HOME para Java, puede añadirlas en la pestaña Environment de NSSM. Con este método, las variables solo estarán activas mientras se ejecute el servicio HybridAgent.
    3. Del mismo modo, también puede trasladar la variable HYBRID_AGENT_API_KEY a la configuración del entorno de NSSM para que esté activa mientras se ejecute el servicio.

  3. Inicie el servicio HybridAgent con la herramienta de administración Services de Windows o con el comando de NSSM: nssm start HybridAgent. Esto no será necesario (tras reiniciar el PC) si el servicio está configurado para iniciarse automáticamente.
  4. Compruebe que el servicio HybridAgent esté en ejecución mediante la herramienta de administración Services de Windows o con el comando de NSSM: nssm status HybridAgent.

Una vez que Hybrid Agent se haya conectado a su espacio de trabajo de Altium 365 (actualice la ventana del navegador para comprobar su estado), puede continuar con la configuración de la integración con PLM en el espacio de trabajo de Altium 365. En la página Add Configuration, habilite la opción de conexión Hybrid Agent e introduzca en el campo URL la URL de su PLM local, tal como se accede a ella desde su red cerrada.

 

La clave de API actual se puede anular mediante su comando Revoke asociado. En ese caso, deberá generar una nueva clave de API y actualizar la variable de entorno HYBRID_AGENT_API_KEY con el valor de la nueva clave.

Reinicie Hybrid Agent para utilizar la nueva clave: con NSSM, utilice el comando nssm restart HybridAgent, o detenga e inicie el servicio HybridAgent en Services de Windows.

AI-LocalizedLocalizado por IA
Si encuentra un problema, seleccione el texto/imagen y presioneCtrl + Enterpara enviarnos sus comentarios.
Contents
Disponibilidad de funciones

Las funciones disponibles para usted dependen de qué solución de Altium tenga: Altium Develop, Altium Agile Teams, Altium Agile Enterprise o Altium Designer (con suscripción activa).

Si no ve una función documentada en su software actual, contacte con Ventas de Altium para obtener más información.