コネクター

コネクターは、エージェントが外部の世界に対してアクションを実行するために呼び出せるツールです。各コネクターは、MQTTメッセージのパブリッシュや時系列テーブルのクエリなど、型付けされた一連のアクションを提供する外部サービスへの設定済み接続であり、エージェントやチャットは実行時にこれらを利用できます。

EMQXエージェントは現在、以下の2種類のコネクターをサポートしています。

種類	説明
EMQX Broker	MQTTトピックをイベントトリガーとしてサブスクライブし、メッセージをアクションとしてパブリッシュします。
EMQX Tables	SQLを通じて時系列データのクエリおよび書き込みを行います。

コネクターはデプロイメント単位で設定され、複数のエージェントやチャットで再利用可能です。

コネクターの表示

デプロイメントの左メニューから Connectors をクリックすると、コネクター一覧ページが開きます。リストには設定済みのコネクターが以下の列で表示されます。

列	説明
Name	コネクターに割り当てられた表示名。
Type	コネクターの種類：EMQX Broker または EMQX Tables。
Description	接続内容の概要（ホストアドレスやデータベース名など）。
Updated At	最終更新日時。
Actions	コネクターの編集または削除。

コネクターの追加

1. 左メニューの Connectors をクリックします。
2. + Add Connector をクリックします。
3. Add Connector パネルでコネクターの種類を選択し、必要な項目を入力します。
4. Confirm をクリックします。

EMQX Broker

このコネクタータイプは、EMQX Brokerデプロイメント上でMQTTトピックをサブスクライブし、メッセージをパブリッシュするために使用します。

項目	必須	説明
Type	はい	EMQX Broker が自動入力されます。
Name	はい	コネクターの表示名（例：factory-broker）。先頭は英字で、英数字、ハイフン、アンダースコアを含めて最大64文字まで使用可能です。
Address	はい	host:port 形式のブローカーアドレス。必ずポート番号を含めます。例：暗号化なしMQTTは broker.example.com:1883、TLSは broker.example.com:8883。EMQX Brokerデプロイメントの概要ページの MQTT Connection Information セクションで確認できます。
Username	いいえ	ブローカー認証用のユーザー名。資格情報はEMQX Brokerデプロイメントの Access Control -> Authentication で設定します。
Password	いいえ	ブローカー認証用のパスワード。
Client ID Prefix	いいえ	このコネクターが使用するMQTTクライアントIDに付与するプレフィックス。ブローカーのログでエージェント接続を識別するのに便利です。
Enable TLS/SSL	いいえ	接続にTLSを有効化します。デフォルトは無効です。
Default QoS	いいえ	サブスクライブおよびパブリッシュ時のデフォルトMQTT QoSレベル。選択肢は 0、1、2。デフォルトは 1。

EMQX Tables

このコネクタータイプは、EMQX Tablesデプロイメントのデータをクエリおよび書き込みするために使用します。

項目	必須	説明
Type	はい	EMQX Tables が自動入力されます。
Name	はい	コネクターの表示名（例：factory-tables）。
Address	はい	host:port 形式のTablesサービスアドレス。デフォルトポートは 4000。ポート番号が省略された場合は 4000 が使用されます。EMQX Tablesデプロイメントの概要ページの Connection Info セクションで確認できます。
Username	いいえ	Tablesサービス認証用のユーザー名。EMQX Tablesデプロイメントの Connection Info セクションで確認できます。
Password	いいえ	Tablesサービス認証用のパスワード。EMQX Tablesデプロイメントの Connection Info セクションで確認できます。
Database Name	いいえ	接続先データベース名。デフォルトは public。
Enable TLS/SSL	いいえ	接続にTLSを有効化します。デフォルトは無効です。

コネクターの編集

1. Connectors ページで、更新したいコネクターの Actions 列にある編集アイコンをクリックします。
2. Edit Connector パネルで必要な項目を更新します。
3. Confirm をクリックします。

重要なお知らせ

稼働中のエージェントが使用しているコネクターを編集すると、変更は即時反映されます。更新した認証情報やアドレスが誤っている場合、エージェントの次回実行は失敗します。

コネクターの削除

1. Connectors ページで、削除したいコネクターの Actions 列にある削除アイコンをクリックします。
2. 削除を確認します。

重要なお知らせ

デプロイ済みのエージェントが使用中のコネクターは削除できません。まずエージェントを停止または削除してから、コネクターを削除してください。

チャットでのコネクターの使用

チャット開始時に、LLMがアクセス可能なコネクターを選択できます。これにより、LLMはエージェント定義を生成する際に適切なコネクターを参照できます。

チャットセッションで使用するコネクターを選択するには：

1. 入力欄左下のコネクターアイコンをクリックします。Connectors パネルが表示され、設定済みコネクターが一覧で表示されます。
2. このセッションで利用可能にしたいコネクターにチェックを入れます。
3. 新しいコネクターを追加する場合は、パネル右上の + をクリックします。チャットを離れることなくAdd Connectorフォームが開きます。

選択されたコネクターは、LLMが生成するエージェント定義内のトリガーやツールの設定に使用されます。例えば、EMQX Brokerコネクターを選択すると、LLMはそれをMQTTトリガーソースおよび mqtt.publish アクションのターゲットとして設定できます。

次のステップ

• チャットの開始
• エージェントの管理