Skip to content

EMQX Agents ​

EMQX Agentsは、EMQX Cloud上で提供されるホステッドサービスで、MQTTおよび時系列データを基盤にしたイベント駆動型AIエージェントの構築と実行を可能にします。カスタムの自動化コードを書く代わりに、エージェントに行ってほしいことを自然言語で記述すると、プラットフォームがそれを構築しデプロイします。

エージェントはMQTTメッセージに反応し、時系列データをクエリし、デバイスへアクションをパブリッシュします。追加のミドルウェアや長時間実行されるサービスループを管理する必要はありません。

EMQX Agents in EMQX Cloud ​

EMQX AgentsはEMQX Cloudプラットフォームの自動化レイヤーです:

サービス役割タグ
EMQX BrokerMQTTメッセージの輸送CONNECT
EMQX Tables時系列データのストレージSTORE
EMQX Fleetsデバイスレジストリおよび状態管理MANAGE
EMQX Agentsイベント駆動型AI自動化AUTOMATE

EMQX AgentsはEMQX BrokerおよびEMQX Tablesとコネクターを介して連携します。Agentsのデプロイは他のサービスの前後どちらでも作成可能です。デプロイ作成時に、EMQX Broker、EMQX Tables、またはEMQX Fleetsのデプロイメントで使用されている互換性のあるネットワークを選択すると、同じVPC内にサービスを配置してプライベート接続が可能です。異なるネットワークのサービス間はパブリックアドレスを通じて通信します。

コアコンセプト ​

チャット ​

チャットは内蔵のLLMとの対話で、エージェントにやってほしいことを記述します。LLMがリクエストを解釈し、エージェントの指示やスキルを作成し、デプロイ可能なエージェント定義を組み立てます。サポートされている画像やUTF-8テキストファイルを添付して追加コンテキストを提供できます。チャット内で動作の調整、トリガートピックの変更、ロジックのテストを繰り返し行い、デプロイにコミットできます。

チャットは継続的に実行する必要のない一時的なタスク(例えば、最近のデバイスデータのクエリや運用インシデントの要約)にも便利です。

テンプレート ​

テンプレートは一般的なエージェントシナリオの再利用可能な組み込みの出発点です。テンプレートには指示、トリガー、ツール、サポート用のワークスペースファイルが含まれます。テンプレートをそのまま使うか、チャット開始時に指示や変数、コネクターの選択をカスタマイズできます。

テンプレートは読み取り専用で、作成・編集・削除はできません。テンプレートのカスタマイズは新しいチャットとワークスペースを作成し、元のテンプレートは変更されません。

エージェント ​

エージェントはデプロイされた長時間実行されるプロセスで、イベントに反応してインフラ上で動作します。各エージェントはチャットセッションから生成されたエージェント定義に基づき、隔離されたサンドボックス内で実行されます。トリガーとなるMQTTメッセージが到着すると、エージェントは実行を開始し、指示やスキルを読み込み、必要なツールを呼び出してタスクを完了します。

エージェントには名前、説明、指示、トリガー、ツール、スキルがあります。デプロイ済みの設定やワークスペースファイルはエージェント詳細ページで確認可能です。

コネクター ​

コネクターはエージェントやチャットが利用できる外部サービスへの設定済み接続です。各コネクターはエージェントが呼び出せる型付けされたアクションセットを公開します。EMQX Agentsは以下のコネクタータイプをサポートします:

  • EMQX Broker:MQTTトピックをトリガーとしてサブスクライブし、アクションとしてメッセージをパブリッシュします。
  • EMQX Tables:SQLを通じて時系列データのクエリおよび書き込みを行います。
  • EMQX Fleets:EMQX Fleetsのデバイスレジストリおよび関連するデバイス管理機能を操作します。
  • MCPコネクター:Model Context Protocol(MCP)を介してGmailやSlackなどの外部ツールと接続します。MCPコネクターは作成時にコネクター名のみが必要で、作成後にEMQX Agentsが自動的に認可フローを開始します。

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

実行(Run) ​

実行は1回のインバウンドイベントによってトリガーされるエージェントの単一実行です。各実行にはステータス、実行時間、クレジット使用量、エージェントが実行した内容(呼び出したツール、受け取った応答、最終結果)を示すイベントタイムラインがあります。

実行ステータスは以下の通りです:

ステータス意味
Queued実行キューで待機中です。
Running実行中です。
Succeeded実行が正常に完了しました。
Dropped実行キューが満杯のため開始されませんでした。
Failed実行エラーにより終了しました。
Timeout実行時間制限を超過しました。

スキル ​

スキルはエージェントの作成と実行を2つのコンテキストでサポートします:

  • デプロイメントレベルのスキルは、EMQX Agentsデプロイメント向けにアップロード・管理する再利用可能なパッケージです。各パッケージはルートレベルのSKILL.mdファイルを含み、スクリプト、リファレンス、アセット、その他のファイルを含むことができます。チャット内でスキルを参照すると、異なるトピックや設定、出力要件で類似のエージェント作成をガイドします。EMQX Agentsはチャット実行中に選択されたパッケージを利用可能にしますが、デプロイ済みエージェントには追加しません。詳細はManage EMQX Agents Skillsを参照してください。
  • バンドルされたエージェントスキルはエージェントワークスペース内の再利用可能な機能で、ドメイン固有のロジック(例:デバイスごとの温度読み取りのローリング平均維持)をカプセル化し、エージェントが実行ごとに一貫して呼び出せるようにします。Builderはチャット中にこれらのスキルを生成したり、テンプレートから継承したスキルを更新したりできます。エージェント詳細ページのSkillsタブで確認可能です。

仕組み ​

  1. コネクターを追加します。 EMQX Broker、EMQX Tables、EMQX Fleets、またはMCPサービスを接続し、エージェントがデータ、メッセージング基盤、デバイスレジストリ、外部ツールにアクセスできるようにします。

  2. 作成方法を選択します。 チャットを開始して自然言語で自動化内容を記述するか、組み込みテンプレートを選択して指示をカスタマイズします。チャット内でアップロード済みのデプロイメントレベルスキルを参照し、エージェントの要件の違いを説明することも可能です。

  3. ワークスペースを確認・調整します。 Builderがエージェントの指示、トリガー、ツール、スキル、スクリプト、アセットを作成・更新します。チャットを続けて不足している変数やコネクターを提供し、動作を調整します。

  4. エージェントをデプロイします。 エージェント定義が検証を通過したら、チャット内のDeploy Agentをクリックして生成された定義から実行中のエージェントを作成します。

  5. イベントが実行をトリガーします。 トリガートピックにMQTTメッセージが到着するたびにエージェントが実行されます。ロジックを適用し、mqtt.publish、tables.sql、またはMCPコネクターで公開されているツールを呼び出してタスクを完了します。

  6. 監視と反復を行います。 エージェント詳細ページで実行履歴、成功率、クレジット使用量、実行ごとのタイムラインを確認します。動作を変更したい場合はチャットに戻って再デプロイします。

主なユースケース ​

  • 異常検知:デバイスのテレメトリを監視し、ローリング平均が閾値を超えた場合にアラートをパブリッシュします。
  • インシデント要約:最近のMQTTイベントを集約し、要求に応じて人間が読みやすい要約を生成します。
  • 条件付きアクション:センサーデータが定義された条件を満たしたときにデバイストピックにコマンドをパブリッシュします。
  • データ強化:MQTTイベントに応じてEMQX Tablesをクエリし、その結果をブローカーにパブリッシュします。
  • 外部ワークフロー自動化:MCPコネクターを使ってGmailやSlackなどのサービスと連携します。
  • 運用通知:停止したデバイスやハートビートの欠如を検知し、オンコールチームに通知します。

プランと利用可能性 ​

EMQX AgentsはGoogle Cloud上のStarterプランで商用利用可能です。EMQX Cloudコンソールから直接Agentsのデプロイメントを作成できます。Starterサブスクリプションは月額課金制です。料金、トライアル資格、支払い、請求書、サブスクリプションなしでのデプロイメントについてはEMQX Agents Subscriptions and Invoicesをご覧ください。

次のステップ ​