Integração de agente híbrido

Num relance

Conecte seu Workspace do Altium 365 a um sistema PLM local sem expô-lo à internet nem abrir portas para tráfego de entrada. Este artigo explica como o Hybrid Agent retransmite informações por meio de conexões HTTPS de saída e apresenta os requisitos e as etapas de instalação e configuração, incluindo a execução do agente como um serviço do Windows. Continue lendo para dar o próximo passo na configuração da sua integração híbrida com o PLM.

- Entenda os requisitos de licenciamento, Java e rede do Hybrid Agent.
- Saiba como gerar uma chave de API, iniciar o agente e configurar a conexão com o PLM no seu Workspace.
- Encontre orientações sobre como executar o agente como um serviço do Windows e atualizá-lo para usar uma nova chave de API.
Aprofunde-se com a IA:

A Integração Híbrida se aplica à situação em que uma empresa que utiliza o Altium 365 deseja integrar seu Workspace a um sistema PLM hospedado localmente, dentro da rede da empresa, que não possui um endereço IP público — ou seja, não está exposto à internet.

Para isso, um pequeno programa chamado Hybrid Agent é executado dentro da rede da empresa. Esse programa se comunica com o Altium 365, transmitindo informações entre o Workspace do Altium 365 e o sistema PLM dentro da rede fechada. A comunicação com o Agente Híbrido é feita por HTTPS, e não é necessário abrir nenhuma porta de rede para tráfego de entrada da internet. A porta HTTPS padrão 443 é necessária apenas para tráfego de saída.

Note:

Configurar a Integração Híbrida

Baixe o arquivo compactado do Agente () e extraia seu conteúdo para um local conhecido. Ele contém um aplicativo Java (hybrid-agent.jar) que precisa ser executado em uma máquina dentro da rede da empresa, a partir da qual seja possível acessar o sistema PLM local e o Altium 365.

Essa máquina not precisa estar acessível publicamente pela internet, mas precisa ser capaz de se conectar ao ambiente do Altium 365 utilizado pela sua empresa.

  • Observe que o Agente Híbrido not precisa ser executado na máquina que hospeda o sistema PLM, embora essa configuração não deva causar problemas.
  • O aplicativo Agente Híbrido inclui arquivos de script de shell equivalentes (como agent.sh) para sistemas baseados em Linux — use-os no lugar dos arquivos *.bat do Windows nas instruções de configuração do agente abaixo.

As versões 5 e anteriores do Agente Híbrido exigem o Java Development Kit (JDK) versão 11 ou posterior. A partir da versão 6 (lançada em 6 de julho de 2026), o Agente Híbrido exige o JDK versão 17 ou posterior.

Os Workspaces do Altium 365 são compatíveis com as versões 5 e 6 do Agente Híbrido. Portanto, se você já tiver a versão 5 do Agente Híbrido instalada, não será necessário atualizar para a versão 6.

Quando o aplicativo Agente Híbrido estiver no local:

  1. Gere a chave de API na página Hybrid Agent do Workspace do Altium 365 ().
  2. Crie uma variável de ambiente HYBRID_AGENT_API_KEY com a chave de API como valor.
  3. Execute agent.bat usando o seguinte contexto de comando, em que o argumento do parâmetro URL deve ser o do seu Workspace do Altium 365:
    agent.bat https://acme.365.altium.com

Quando estiver ativo, o Agente Híbrido gerará um arquivo de log na pasta hybrid-agent\logs do aplicativo.

Observe que o Workspace tem apenas uma chave de API válida por vez, e apenas uma única instância do Agente Híbrido pode estar em execução. O Agente oferecerá suporte a mais de uma instância de configuração de PLM se ambos os sistemas PLM estiverem hospedados na mesma rede fechada.

É altamente recomendável executar o Agente Híbrido como um serviço do Windows no ambiente de produção, em vez de diretamente no terminal, embora esta última opção possa ser usada para testes.

Um exemplo de como executar o Agente Híbrido como um serviço do Windows usando o gerenciador de serviços NSSM:

  1. Execute o comando: nssm install HybridAgent.
  2. Na caixa de diálogo do NSSM (na guia Application), insira o caminho do arquivo agent.bat no campo Path e a URL do seu Workspace no campo Arguments e clique em Install service.
    1. Você pode definir o comportamento de inicialização do serviço com a opção Startup type na guia Details da caixa de diálogo do NSSM. Se necessário, execute nssm edit HybridAgent para fazer essas alterações.
    2. Como alternativa à criação das variáveis de ambiente padrão PATH e JAVA_HOME para Java, elas podem ser adicionadas na guia Environment do NSSM. Com essa abordagem, as variáveis ficarão ativas apenas enquanto o serviço HybridAgent estiver em execução.
    3. Da mesma forma, a variável HYBRID_AGENT_API_KEY também pode ser movida para a configuração de ambiente do NSSM, para que fique ativa enquanto o serviço estiver em execução.

  3. Inicie o serviço HybridAgent com a ferramenta de gerenciamento Services do Windows ou com o comando do NSSM: nssm start HybridAgent. Isso não será necessário (após reiniciar o PC) se o serviço estiver configurado para inicialização automática.
  4. Verifique se o serviço HybridAgent está em execução na ferramenta de gerenciamento Services do Windows ou com o comando do NSSM: nssm status HybridAgent.

Depois que o Agente Híbrido se conectar ao seu Workspace do Altium 365 (atualize a janela do navegador para verificar o status), você poderá prosseguir com a configuração da Integração com PLM no Workspace do Altium 365. Na página Add Configuration, habilite a opção de conexão Hybrid Agent e insira a URL do seu PLM local, conforme acessível dentro da sua rede fechada, no campo URL.

 

A chave de API atual pode ser cancelada usando o comando Revoke associado a ela. Nesse caso, será necessário gerar uma nova chave de API e atualizar a variável de ambiente HYBRID_AGENT_API_KEY com o valor da nova chave.

Reinicie o Agente Híbrido para usar a nova chave — com o NSSM, use o comando nssm restart HybridAgent ou pare/inicie o serviço HybridAgent em Services do Windows.

AI-LocalizedLocalizado por IA
Caso encontre um problema, selecione o texto/imagem e primaCtrl + Enterpara nos enviar o seu feedback.
Contents
Disponibilidade de Recursos

Os recursos disponíveis para você dependem de qual solução Altium você possui – Altium Develop, Altium Agile Teams, Altium Agile Enterprise ou Altium Designer (com assinatura ativa).

Se você não vir um recurso documentado no software que está usando no momento, entre em contato com a equipe de vendas da Altium para saber mais.