Search In: Doc:Documentation: Altium 365
Altium DesignerAltium 365Altium MCAD CoDesignerAltium On-Prem Enterprise ServerCompany DashboardAltium Infrastructure ServerAltium Developer Center
Close
検索 Search on Documentation

ハイブリッドエージェント統合

Updated: 7月 08, 2026

Hybrid Integration は、Altium 365 を使用している企業が、自社ネットワーク内のオンプレミス環境でホストされている PLM システムと Workspace を統合したい場合に適用されます。この PLM システムにはパブリック IP アドレスがなく、インターネットには公開されていません。

これを実現するために、Hybrid Agent と呼ばれる小規模なプログラムを企業ネットワーク内で実行します。このプログラムは Altium 365 と通信し、Altium 365 Workspace と、閉域ネットワーク内の PLM システムとの間で情報を中継します。Hybrid Agent との通信は HTTPS 経由で行われるため、インターネットからの受信トラフィック向けにネットワークポートを開放する必要はありません。必要なのは、送信トラフィック専用の標準 HTTPS ポート 443 のみです。

Note:

Hybrid Integration のセットアップ

Agent アーカイブ（）をダウンロードし、その内容を分かりやすい場所に展開します。アーカイブには Java アプリケーション（hybrid-agent.jar）が含まれており、これは企業ネットワーク内のマシン上で実行する必要があります。そのマシンから、オンプレミスの PLM システムと Altium 365 の両方にアクセスできなければなりません。

そのマシンはnot インターネットから公開アクセス可能である必要はありませんが、企業で使用している Altium 365 環境に接続できる必要があります。

  • Hybrid Agent は、PLM システムをホストしているマシン上で実行するnot必要はありませんが、そのような構成でも問題は発生しないはずです。
  • Hybrid Agent アプリケーションには、Linux ベースのシステム向けに同等のシェルスクリプトファイル（agent.sh など）が含まれています。以下の Agent セットアップ手順では、Windows の *.bat ファイルの代わりにこれらを使用してください。

Hybrid Agent バージョン 5 以前では、Java Development Kit（JDK）バージョン 11 以降が必要です。バージョン 6（2026 年 7 月 6 日リリース）以降では、Hybrid Agent に JDK バージョン 17 以降が必要です。

Altium 365 Workspaces は Hybrid Agent バージョン 5 と 6 の両方をサポートしています。そのため、すでに Hybrid Agent バージョン 5 がインストールされている場合は、バージョン 6 へアップグレードする必要はありません。

Hybrid Agent アプリケーションの配置が完了したら、次を実行します。

  1. Altium 365 Workspace の Hybrid Agent ページ（）で API キーを生成します。
  2. API キーを値として持つ HYBRID_AGENT_API_KEY 環境変数を作成します。

  3. 以下のコマンドコンテキストで agent.bat を実行します。URL パラメーター引数には、使用している Altium 365 Workspace の URL を指定してください。
    agent.bat https://acme.365.altium.com

アクティブになると、Hybrid Agent はアプリケーションの hybrid-agent\logs フォルダー内にログファイルを生成します。

Workspace では、同時点で有効な API キーは 1 つだけであり、実行できる Hybrid Agent インスタンスも 1 つだけであることに注意してください。両方の PLM システムが同じ閉域ネットワーク内でホストされている場合、Agent は複数の PLM 構成インスタンスをサポートできます。

本番環境では、Hybrid Agent をターミナルから直接実行するのではなく、Windows サービスとして実行することを強く推奨します。ただし、後者はテスト目的で使用できます。

NSSM サービスマネージャーを使用して Hybrid Agent を Windows サービスとして実行する方法の一例を以下に示します。

  1. 次のコマンドを実行します: nssm install HybridAgent。
  2. NSSM ダイアログウィンドウの Application タブで、Path フィールドに agent.bat ファイルパスを入力し、Arguments フィールドに Workspace URL を入力して、Install service をクリックします。
    1. NSSM ダイアログの Details タブにある Startup type オプションで、サービスの起動動作を設定できます。必要に応じて、変更を行うために nssm edit HybridAgent を実行してください。
    2. Java 用の標準的な PATH および JAVA_HOME 環境変数を作成する代わりに、それらを NSSM の Environment タブで追加することもできます。この方法では、変数は HybridAgent サービスの実行中のみ有効になります。

    3. 同様に、HYBRID_AGENT_API_KEY 変数も NSSM の環境設定に移動でき、サービスの実行中に有効になります。

  3. HybridAgent サービスを Windows の Services 管理ツールから、または NSSM コマンド nssm start HybridAgent で開始します。サービスが自動起動に設定されている場合は、（PC 再起動後に）この操作は不要です。
  4. Windows の Services 管理ツール、または NSSM コマンド nssm status HybridAgent を使用して、HybridAgent サービスが実行中であることを確認します。

Hybrid Agent が Altium 365 Workspace に接続したら（ステータス確認のためブラウザーウィンドウを更新してください）、Altium 365 Workspace で PLM Integration の設定に進むことができます。Add Configuration ページで、Hybrid Agent 接続オプションを有効にし、閉域ネットワーク内から見たオンプレミス PLM の URL を URL フィールドに入力します。

 

現在の API キーは、関連付けられた Revoke コマンドを使用して取り消すことができます。その場合は、新しい API キーを生成し、HYBRID_AGENT_API_KEY 環境変数を新しいキーの値で更新する必要があります。

新しいキーを使用するには Hybrid Agent を再起動します。NSSM を使用している場合は nssm restart HybridAgent コマンドを使用するか、Windows の Services で HybridAgent サービスを停止/開始してください。

AI-LocalizedAI で翻訳
問題が見つかった場合、文字/画像を選択し、Ctrl + Enter キーを押してフィードバックをお送りください。
機能の可用性

利用できる機能は、所有する Altium ソリューション (Altium Develop、Altium Agile のエディション (Agile Teams、または Agile Enterprise)、または Altium Designer (有効な期間)) によって異なります。

説明されている機能がお使いのソフトウェアに表示されない場合、Altium の営業担当者にお問い合わせください。