Skip to content

最初のエージェントの構築とデプロイ ​

このガイドでは、EMQX Agents を使ってイベント駆動型のエージェントを作成する手順を説明します。工場のデバイスからの MQTT メッセージを監視し、各読み取り値をローリング平均と比較して、デバイスの平均温度が閾値を超えた場合にアラートをパブリッシュする温度異常監視エージェントを構築します。

このガイドの最後には、以下を実現できます。

  • EMQX Agents のデプロイメントが稼働し、EMQX ブローカーに接続されている
  • ブローカー用のコネクターが設定されている
  • ライブの MQTT イベントに反応するエージェントがデプロイされている

前提条件 ​

  • 有効なプロジェクトを持つ EMQX Cloud アカウント
  • コンソールで直接サブスクリプションを作成する場合は、無料トライアル開始時も含めてクレジットカードがリンクされていること。その他の課金方法については サブスクリプション前の準備 を参照してください。
  • Running 状態の EMQX ブローカーのデプロイメント
  • テストメッセージをパブリッシュするための MQTT クライアント(例:MQTTX)

ステップ 1: EMQX Agents デプロイメントの作成 ​

デプロイメント作成の前に、作成の前提条件 と サブスクリプションおよびトライアル条件 を確認してください。

  1. EMQX Cloud コンソールにログインし、プロジェクトを開きます。

  2. EMQX Agents カードで + New をクリックします。

    プロジェクトページから EMQX Agents デプロイメントを作成

  3. Agents デプロイメントのリージョンを選択します。Google Cloud のみがサポートされているクラウドプロバイダーです。

  4. [任意] このガイドでブローカーとのプライベート接続を使用する場合は、Network Association (Optional) でブローカーネットワークを選択します。ネットワークの関連付けは、コネクターが使用するブローカーのアドレスには影響しません。

  5. サブスクリプションの概要と支払い方法を確認します。カード設定が求められた場合は完了させてください。

  6. Subscribe & Deploy が表示されたらクリックし、コンソールからの利用規約の確認やカード発行会社の認証を完了します。代わりに Contact Us が表示された場合は、サポートルート に従ってください。

デプロイメント作成後はネットワークの変更はできません。フィールドの詳細説明やネットワークオプションについては EMQX Agents デプロイメントの作成 を参照してください。

デプロイメントカードが Running になったら、カードをクリックしてデプロイメントを開きます。

ステップ 2: コネクターの追加 ​

エージェントが MQTT トピックをサブスクライブしたりメッセージをパブリッシュしたりするには、EMQX ブローカーを指すコネクターを設定する必要があります。

  1. EMQX Agents デプロイメントで、左メニューの Connectors をクリックします。

  2. Available タブで EMQX Broker を見つけて Add をクリックします。

  3. Add Connector パネルで以下を入力します:

    • Type: EMQX Broker が自動入力されます。
    • Name: 例として factory-broker など任意の名前を入力します。
    • Address: ブローカーのアドレスを host:port 形式で入力します。必ずポート番号を含めてください。例:非暗号化 MQTT は broker.example.com:1883、TLS は broker.example.com:8883。アドレスは EMQX ブローカーのデプロイメント概要ページの MQTT Connection Information セクションで確認できます。
    • Username と Password: EMQX ブローカーの Access Control -> Authentication で設定した認証情報を入力します。
    • Client ID Prefix: 空欄のままにします。システムが自動でクライアントIDを生成します。
    • このガイドでは Enable TLS/SSL はオフ、Default QoS は 1 のままにします。
  4. Confirm をクリックします。

コネクターは Added タブに表示され、Description 列にアドレスが表示されます。

コネクター追加画面

ステップ 3: チャットを開始してエージェントを説明 ​

エージェントは対話によって構築されます。やりたいことを説明すると、LLM がエージェント定義を生成します。

  1. 左メニューの Chats をクリックし、+ New Chat をクリックします。

  2. 入力欄の左下にあるコネクターアイコンをクリックします。Connectors パネルが表示され、設定済みのコネクターが一覧表示されます。factory-broker にチェックを入れて、このセッションで使用可能にします。

    チャットで EMQX ブローカーコネクターを選択

  3. 左下のツール承認モードセレクターから Always ask を選択します。このモードでは、デプロイ前やツール操作で承認が必要な場合に都度確認が求められます。利用可能なモードの詳細は ツール承認モードの選択 を参照してください。

  4. 入力欄にエージェントにやってほしいことを記述します。このガイドでは以下を入力してください。

    I want to monitor MQTT temperature events on the topic factory/+/+/temperature.
    Each message payload is JSON, for example: {"device_id": "dev-0042", "temp": 95.4}
    The agent should track the last 3 readings per device. If the rolling average
    exceeds 70, publish an alert to alerts/anomaly.
  5. [任意] Add File アイコンをクリックしてスクリーンショット、サンプルペイロード、UTF-8 テキストファイルなどを添付し、LLM に追加のコンテキストを提供できます。1つのチャットメッセージにつき最大3つの添付ファイル、各ファイルは最大 2 MiB までです。詳細は 添付ファイルの追加 を参照してください。

  6. [任意] 右下のセレクターからこのリクエストに使用するモデルと推論努力レベルを選択できます。詳細は モデルと推論努力の選択 を参照してください。

  7. 送信ボタンをクリックします。

LLM がリクエストを処理し、エージェントの指示を生成し、ローリング温度履歴を維持するスキルを作成し、MQTT トリガーとパブリッシュツールが設定された完全なエージェント定義を組み立てます。

ステップ 4: エージェントのデプロイ ​

ビルダーがエージェント定義を生成・検証すると、チャット下部に Review Agent が表示されます。

  1. 生成された定義を確認します。トリガー、閾値、アラートトピック、生成されたスキルが要件に合わない場合は、質問や変更依頼を行ってください。

  2. Review Agent をクリックして右側のレビューパネルを開きます。

  3. 必須の Agent Name、任意の Description、Model and reasoning、Trigger、Instructions、Tools を確認します。パネルは初期状態でチャットで選択したモデルと推論努力レベルを使用します。必要に応じて設定を編集してください。

    温度異常監視エージェントのデプロイ前レビュー

  4. Deploy Agent をクリックします。

  5. Confirm deployment? ダイアログで Confirm をクリックします。チャットで Always ask を選択しているため、この追加確認が表示されます。

  6. エージェントの作成が開始され、エージェント詳細ページが開きます。

数分後にエージェントのステータスが Running になるのを確認できます。4つのタブ(Overview, Runs, Configuration, Skills)でデプロイ済みエージェントとそのワークスペースを表示します。

  • Configuration: エージェントの指示、MQTT トリガー、mqtt.publish ツールが生成されています。トリガーはトピックフィルター factory/+/+/temperature、QoS 1、factory-broker コネクターを使用します。パブリッシュツールは alerts/anomaly に制限されています。
  • Skills: このデプロイ済みエージェントにバンドルされた生成スキルと関連ファイルです。ローリング温度履歴を維持し、アラートをパブリッシュするタイミングを判断します。これらのファイルは左ナビゲーションメニューの Skills から管理する デプロイメントレベルのスキル とは別です。

デプロイ済みエージェントの設定を確認

ステップ 5: エージェントのテスト ​

エージェントをトリガーするためにテストメッセージを複数パブリッシュし、動作を検証します。

  1. MQTT クライアントを開き、同じ EMQX ブローカーに同じ認証情報で接続します。

  2. factory/+/+/temperature にマッチするトピック(例:factory/plant-a/line-3/temperature)に複数のメッセージをパブリッシュします。JSON ペイロードを使用してください。

    json
    {"device_id": "dev-0022", "temp": 75.1}

    70 を超える温度で少なくとも3回パブリッシュします(例:75.1、78.3、80.0)。これにより、エージェントは閾値を超えるローリング平均を計算できます。

  3. EMQX Agents デプロイメントに戻り、エージェントの Runs タブを開きます。

    トリガートピックにマッチした各メッセージで1つの実行が作成されます。完了した実行は Succeeded ステータスを表示します。

  4. 実行 ID をクリックして実行詳細ページを開きます。Timeline にその実行のイベントシーケンスが表示されます。

    イベント説明
    TRIGGER実行を開始した MQTT メッセージ(トピック含む)
    BUNDLE LOADEDエージェントのスキルと設定がロードされた
    CONTEXT LOADED会話コンテキストが準備された
    TOOLS RESOLVED実行で利用可能なツールが解決された
    SYSTEM INITエージェントの指示が適用された
    TOOL RESULTエージェントが呼び出した各ツール(例:read、run_script、mqtt.publish)
    LLM CALLLLM の呼び出し(入力・出力トークン数含む)
    RESPONSE実行の最終レスポンス
    RUN END実行の終了ステータス

    ローリング平均が閾値を超えた場合、mqtt.publish ツールの結果がタイムラインに表示され、Response イベントでアラートがパブリッシュされたことが確認できます。

エージェント実行のタイムライン

オプション: MCP コネクターを使ったエージェントの構築 ​

MCP コネクターを使うと、Model Context Protocol (MCP) を通じて外部サービスをエージェントやチャットで利用できます。

Slack などの外部サービスを利用するエージェントを作りたい場合は、このオプションのフローを使います。メインのチュートリアルの MQTT 温度監視とは異なるリクエストのため、別のチャットを使用します。

ステップ 1: MCP コネクターの追加 ​

  1. EMQX Agents デプロイメントで、左メニューの Connectors をクリックします。

  2. Available タブで MCP コネクターサービスの Slack を見つけます。

  3. コネクターカードの Add をクリックします。

  4. Add Connector パネルで、コネクターの Name(例:ops-slack)を入力します。Type は選択したサービスで自動入力され、他の設定項目は不要です。

  5. Confirm をクリックします。

MCP コネクター追加画面

コネクターは Unauthorized ステータスで追加され、EMQX Agents が選択したサービスの認可ダイアログを開きます。外部認可フローを完了してください。認可成功後、Added タブでコネクターのステータスが Authorized に変わります。

ダイアログを閉じるか認可に失敗した場合は、Added タブでコネクターの認可再試行アクションをクリックしてください。

ステップ 2: MCP コネクターを使ったチャットの開始 ​

  1. 左メニューの Chats をクリックし、+ New Chat をクリックします。

  2. 入力欄の左下にあるコネクターアイコンをクリックします。

  3. Connectors パネルで作成した MCP コネクターを選択します。

    例では MQTT イベントと Slack 通知を使うため、factory-broker と認可済みの Slack コネクターの両方を選択します。

    Authorized な MCP コネクターのみ選択可能です。コネクターが表示されているが無効化されている場合は、Connectors ページに戻り認可を完了または再試行してください。

    MCP コネクターを選択したチャットパネル

  4. 以下のリクエストを入力します。

    Listen to MQTT topic /devices/#. If the temperature in the MQTT message
    is above 30, please send a warning message to Slack. Channel: <channel-name>.

    <channel-name> は通知したい Slack チャンネル名に置き換えてください。

  5. ツール承認モードを選択します。ガイド付きデプロイフローには Always ask を推奨します。

  6. [任意] 使用するモデルと推論努力レベルを選択します。

  7. 送信ボタンをクリックします。

LLM が選択した MCP コネクターで公開されているツールを含むエージェント定義を生成します。

ステップ 3: MCP エージェントのデプロイ ​

  1. 生成された定義が準備できたら Review Agent をクリックします。

  2. レビューパネルで Agent Name、Description、Model and reasoning、Trigger、Instructions、Tools を確認し、必要に応じて設定を更新します。

  3. Deploy Agent をクリックします。

  4. チャットで Always ask を使用している場合は、Confirm deployment? ダイアログで Confirm をクリックします。

  5. エージェント詳細ページを開き、Configuration と Skills タブで生成されたエージェントが選択した MCP コネクターを使用し、要求された動作を実装していることを確認します。

ステップ 4: MCP エージェントのテスト ​

チャットリクエストで指定した MQTT トピックと Slack アクションに従って MCP エージェントをテストします。このテストフローはメインの温度異常監視とは異なります。

  1. MQTT クライアントを使い、/devices/# にマッチするトピック(例:/devices/device-001)にテストメッセージをパブリッシュします。

    json
    {"device_id": "device-001", "temperature": 31}
  2. リクエストで指定した Slack チャンネルに警告メッセージが届いていることを確認します。

  3. EMQX Agents に戻り、実行詳細ページを開きます。MCP コネクター呼び出しは実行タイムラインのツール結果として表示され、最終 Response イベントで結果が要約されます。

次にやること ​