チャット
チャットは、組み込みのLLMと会話を行い、エージェントに実行してほしい内容を記述する機能です。LLMはリクエストを解釈し、エージェントの指示やスキルを生成し、デプロイ可能な完全なエージェント定義を組み立てます。
チャットには以下の2つの目的があります。
- 単発タスク:最近のデバイスデータの照会、インシデントの要約、MQTTイベントの分析などを、永続的なエージェントを作成せずにLLMに依頼する。
- エージェント作成:自動化の目標を記述し、フォローアップメッセージで動作を反復的に調整し、その結果を長時間稼働するエージェントとしてデプロイする。
エージェント作成チャットは、ゼロから開始することも、組み込みテンプレートから開始することもできます。テンプレートベースのチャットは、あらかじめ定義された指示、トリガー、ツール、およびサポート用のワークスペースファイルから始まります。
チャットの表示
左メニューの Chats をクリックするとチャットページが開きます。リストにはこのデプロイメント内のすべてのチャットが以下の列で表示されます。
| 列 | 説明 |
|---|---|
| タイトル | チャットのタイトル。最初のメッセージから自動生成されます。クリックするとチャットが開きます。 |
| デプロイ済みエージェント | このチャットからデプロイされたエージェント(ある場合) |
| 最終更新日時 | チャットが最後にアクティブだった日時 |
| 操作 | チャットの名前変更または削除 |

新しいチャットの開始
- 左メニューの Chats をクリックします。
- + New Chat をクリックします。
- 必要に応じて、このセッションで使用可能にするコネクターを選択します(コネクターの選択参照)。
- [任意] 入力エリア左下の Add File アイコンをクリックして、チャットにコンテキストを提供する画像やテキストファイルを添付します(添付ファイルの追加参照)。
- [任意] EMQX Agentsがツールを実行する前に承認を求める方法を選択します(ツール承認モードの選択参照)。
- [任意] このリクエストで使用するモデルと推論レベルを選択します(モデルと推論レベルの選択参照)。
- 入力フィールドにリクエストを入力し、送信ボタンをクリックします。
入力フィールドのプレースホルダーには、以下のような例文が表示され、開始の参考になります。
- EMQX Tablesから最近の電力消費を照会し、ライン3のモーター使用状況を要約する
- MQTTトピックからロボットアームのテレメトリの停止を検出し、オンコールチームに通知する
あくまで例です。ご自身のユースケースを自然な言葉で記述してください。
デプロイメントレベルのスキルの利用
デプロイメントレベルのスキルは、類似したエージェントを作成するための再利用可能な指示を提供します。メッセージの先頭またはスペースの後に / とスキル名の一部を入力し、候補リストからスキルを選択します。たとえば、異なるMQTTトピック、しきい値、出力形式などの要件を記述してメッセージを送信します。
EMQX Agentsは、そのメッセージから作成されたチャット実行に選択したスキルを読み込みます。スキルは次のメッセージには自動適用されず、デプロイ済みエージェントも自動的には変更されません。デプロイまたは再デプロイ前に生成された定義を必ず確認してください。
スキルの準備、アップロード、選択、トラブルシューティングについては、EMQX Agentsスキルの管理を参照してください。
テンプレートからチャットを開始する
あらかじめ定義されたエージェントシナリオから開始するには、左ナビゲーションメニューの Templates をクリックし、組み込みテンプレートを選択して Use Template をクリックします。指示のカスタマイズ、テンプレート変数の入力、コネクターの選択が可能で、完了したら Start Chat をクリックします。
生成されたチャットは独立したワークスペースを持ちます。チャット内の変更は元のテンプレートを変更しません。ワークフローの詳細は、EMQX Agentsテンプレートの利用を参照してください。
コネクターの選択
チャットの開始前または実行中に、LLMがアクセス可能なコネクターを選択できます。LLMはエージェント定義生成時に選択されたコネクターを使用し、たとえばMQTTトリガートピックの設定、mqtt.publish アクションのターゲット、GmailやSlackなどMCPコネクターが提供するツールの指定に利用します。
コネクターを選択するには:
- 入力エリア左下のコネクターアイコンをクリックします。Connectors パネルが表示され、設定済みのコネクターが一覧表示されます。
- このセッションで使用可能にしたい承認済みコネクターにチェックを入れます。Unauthorized、Expired、Error 状態のMCPコネクターはリストに表示されますが選択できません。
- 新しいコネクターを追加するには、パネル右上の + をクリックします。チャットを離れずにコネクター追加フォームが開きます。
コネクターを選択しない場合でも、LLMは一般的な質問に回答できますが、特定のブローカー、Tablesインスタンス、Fleetsデプロイメント、MCPサービスを参照するエージェント定義は生成できません。

添付ファイルの追加
チャットメッセージに、スクリーンショット、デバイスログの抜粋、サンプルペイロード、短い設定ファイルなど、追加のコンテキストを提供するファイルを添付できます。
添付ファイルを追加するには:
- 入力エリア左下の Add File アイコンをクリックします。
- 現在のチャットメッセージに添付する最大3つのファイルを選択します。
- リクエストとともにメッセージを送信します。
1つのチャットメッセージには最大3つの添付ファイルを含められます。各添付ファイルのサイズは最大 2 MiB です。
サポートされる添付ファイル形式は以下の通りです。
- JPEG、JPG、PNG画像
- UTF-8エンコードのテキストファイル
ツール承認モードの選択
ツール承認モードは、チャット内でEMQX Agentsがツールを実行する前に承認を求めるタイミングを制御します。入力エリア左下の承認セレクターをクリックし、以下のモードから選択してください。
| モード | 動作内容 |
|---|---|
| 常に確認 | 低リスクのアクションは自由に実行し、承認が必要なアクションは事前に確認を求めます。 |
| 自動承認 | 低・中リスクのツールは自動実行し、高リスクまたは不明な場合にのみ確認を求めます。 |
| フルアクセス | 承認済みアクションを確認なしで実行します。自律的に動作させたいチャットに適しています。 |
自動ツールコールのリスクレビューに使用されるモデル呼び出しもクレジットを消費し、Chats の利用にカウントされます。レビュー用モデルは会話用モデルと異なる場合があり、チャットは複数モデルの消費を持つことがあります。消費状況の詳細は クレジット使用状況の確認を参照してください。
選択したモードは、エージェントのデプロイまたは再デプロイ時の追加確認の要否にも影響します。
- 常に確認 の場合、Deploy Agent または Redeploy Agent をクリック後に表示される Confirm deployment? ダイアログで Confirm をクリックする必要があります。
- 自動承認 または フルアクセス の場合、追加の確認なしにデプロイが開始されます。
モデルと推論レベルの選択
入力エリア右下に選択中のモデルと推論レベルが表示されます。利用可能なモデル、デフォルト選択、推論レベルはEMQX Agentsデプロイメントのモデルカタログによって提供されます。モデルによって対応する推論レベルが異なります。
選択中のモデルの推論レベルを調整するには:
- モデルと推論レベルのセレクターをクリックします。
- スケール上の推論レベルから1つ選択します。送信または再生成時に選択が反映されます。

別のモデルを選択するには:
- セレクターを開き、パネル上部のモデル名をクリックします。
- Select model リストからモデルを選択します。パネルは選択モデルの推論レベルスケールに戻ります。
- デプロイメント推奨のモデルと推論レベルに戻すには Default を選択します。
前のモデルで選択した推論レベルが新モデルでサポートされない場合、Consoleは新モデルでサポートされる推論レベルを自動選択します。

選択の適用範囲は以下の通りです。
- メッセージ送信、編集、再生成、テンプレートドラフト生成は、リクエスト開始時のモデルと推論レベルを使用します。
- 最新のモデルと推論レベルはチャットセッションごとに保存され、チャットのリフレッシュや再オープン時に復元されます。新規チャットは他セッションの選択を引き継ぎません。
- デプロイ済みエージェントは独自のモデルと推論レベルを持ちます。デプロイ前にエージェントプレビューで設定を確認してください。
モデルカタログが読み込めない場合、EMQX Agentsはフォールバックリストを作成しません。保存済みのモデルや推論レベルが利用不可の場合、Consoleはカタログの現在のデフォルト組み合わせを使用します。失敗したリクエストを再試行する前にページをリロードして最新カタログを取得してください。
エージェント定義の調整
LLMの応答後も会話を続けてエージェントを調整できます。
- トリガートピックの変更、しきい値の調整、新しいツールの追加を依頼する。
- 別のスキル実装やより保守的なアラート条件を要求する。
- デプロイ前に生成内容の説明を求める。
各フォローアップメッセージはワークスペース内のエージェント定義を更新します。LLMは同一チャット内のすべてのメッセージのコンテキストを保持します。
テンプレートから作成されたチャットの場合、Builderは関連するスキル、スクリプト、アセットも更新します。必要な変数やコネクターが不足している場合は、検証前に入力を求められます。
チャットからエージェントをデプロイする
Builderがエージェント定義を生成・検証すると、チャット下部に Review Agent が表示されます。
- 生成された定義を確認します。デプロイ前にフォローアップ質問や変更依頼も可能です。
- Review Agent をクリックして右側のレビューパネルを開きます。新規エージェントの場合、チャットで選択されたモデルと推論レベルが初期設定されます。
- 必須の Agent Name、任意の Description、Model and reasoning、Trigger、Instructions、Tools を確認します。名前は生成定義から自動入力され、デプロイ前に編集可能です。
- Deploy Agent をクリックします。
- チャットが 常に確認 モードの場合は、Confirm deployment? ダイアログで Confirm をクリックします。その他のモードは追加確認不要です。
- エージェント詳細ページが開きます。エージェントが Running 状態になるまで数分かかる場合があります。
レビューパネルでモデルや推論レベルを変更しても、チャット内の選択は変わりません。レビューパネルの選択がデプロイ済みエージェントに適用されます。

TIP
チャットからエージェントをデプロイしてもチャットは閉じたりアーカイブされません。後で同じチャットに戻ったり、エージェント詳細ページの Edit Agent in Chat をクリックして動作を更新し再デプロイできます。
チャットから再デプロイする
エージェントを更新または再デプロイするには:
エージェント詳細ページを開き、右上の Edit Agent in Chat をクリックします。元のチャットが存在する場合は、Chats リストからも開けます。

開いたチャットを確認します。
- 元のチャットが存在すれば、過去の会話履歴が利用可能です。
- チャットが削除されていれば、会話履歴なしで編集ページが開きます。
エージェントの変更内容を記述します。過去の会話履歴があり動作を変えたくなければ、このステップは省略可能です。
変更を依頼した場合、Builderがエージェント定義を更新・検証するのを待ちます。
Review Changes をクリックしてレビューパネルを開きます。パネルにはエージェントに保存されたモデルと推論レベルが表示されます。
名前、説明、モデルと推論レベル、トリガー、指示、ツールを確認し、必要に応じて更新します。
Redeploy Agent をクリックします。
チャットが 常に確認 モードの場合は、Confirm deployment? ダイアログで Confirm をクリックします。その他のモードは追加確認不要です。
再デプロイにより、レビューパネルの定義、モデル、推論レベルで稼働中のエージェントが更新されます。更新されたモデルと推論レベルは再デプロイ成功後に反映されます。過去の実行履歴は保持されます。

チャットの名前変更
- Chats リストページで、操作 列の編集アイコンをクリックします。
- 新しいタイトルを入力して確定します。
チャットの削除
- Chats リストページで、操作 列の削除アイコンをクリックします。
- 削除を確認します。
チャットを削除しても、そのチャットからデプロイされたエージェントには影響しません。エージェントは独立して稼働し続けます。後でそのエージェントの Edit Agent in Chat をクリックすると、削除済みチャットの会話履歴なしで編集ページが開きます。新しいリクエストを入力し、Review Changes をクリックして確認・再デプロイしてください。