チャット

チャットとは、組み込みのLLMと対話し、エージェントに実行してほしい内容を記述する会話のことです。LLMはリクエストを解釈し、エージェントの指示やスキルを生成し、デプロイ可能な完全なエージェント定義を組み立てます。

チャットには以下の2つの目的があります。

• 単発タスク：最近のデバイスデータをクエリしたり、インシデントを要約したり、MQTTイベントのセットを分析したりするために、永続的なエージェントを作成せずにLLMに依頼します。
• エージェント作成：自動化の目標を記述し、フォローアップメッセージで動作を反復し、その結果を長期間稼働するエージェントとしてデプロイします。

エージェント作成チャットは、ゼロから開始することも、組み込みのテンプレートから開始することもできます。テンプレートベースのチャットは、あらかじめ定義された指示、トリガー、ツール、およびサポート用のワークスペースファイルから始まります。

チャットの表示

左メニューの Chats をクリックするとチャットページが開きます。リストにはこのデプロイメント内のすべてのチャットが以下の列で表示されます。

列	説明
タイトル	チャットのタイトル。最初のメッセージから自動生成されます。クリックするとチャットを開きます。
デプロイ済みエージェント	このチャットからデプロイされたエージェント（ある場合）。
最終更新日時	チャットが最後にアクティブだった日時。
操作	チャットの名前変更または削除が可能です。

新しいチャットの開始

1. 左メニューの Chats をクリックします。
2. + New Chat をクリックします。
3. 必要に応じて、このセッションで利用可能にするコネクターを選択します（コネクターの選択参照）。
4. [任意] 入力エリア左下の Add File アイコンをクリックして、チャットにコンテキストを提供する画像やテキストファイルを添付します（添付ファイルの追加参照）。
5. [任意] EMQX Agentsがツール実行前に承認を求めるモードを選択します（ツール承認モードの選択参照）。
6. [任意] このリクエストで使用するモデルと推論レベルを選択します（モデルと推論レベルの選択参照）。
7. 入力欄にリクエストを入力し、送信ボタンをクリックします。

入力欄のプレースホルダーには、以下のような例が表示され、開始の参考になります。

• EMQX Tablesから最近の電力消費をクエリし、ライン3のモーター使用状況を要約してください
• MQTTトピックからロボットアームのテレメトリが停止しているか検出し、オンコールチームに通知してください

これらはあくまで例です。ご自身のユースケースをわかりやすい言葉で記述してください。

デプロイメントレベルのスキルの利用

デプロイメントレベルのスキルは、類似のエージェント作成に再利用できる指示を提供します。メッセージの先頭または空白の後に / とスキル名の一部を入力すると候補リストが表示されます。そこからスキルを選択し、異なるMQTTトピックや閾値、出力形式などの要件を記述してメッセージを送信してください。

EMQX Agentsは、そのメッセージから作成されるチャット実行用に選択したスキルを読み込みます。スキルは次のメッセージには自動適用されず、デプロイ済みエージェントも自動的には変更されません。デプロイまたは再デプロイ前に生成された定義を必ず確認してください。

スキルの準備、アップロード、選択、トラブルシューティングについては、EMQX Agentsスキルの管理をご覧ください。

テンプレートからチャットを開始する

あらかじめ定義されたエージェントシナリオから開始するには、左ナビゲーションメニューの Templates をクリックし、組み込みテンプレートを選択して Use Template をクリックします。指示をカスタマイズし、テンプレート変数を入力し、コネクターを選択してから Start Chat をクリックします。

生成されたチャットは独立したワークスペースを持ちます。チャット内での変更は元のテンプレートを変更しません。ワークフローの詳細はEMQX Agentsテンプレートの利用をご覧ください。

コネクターの選択

チャットの開始前または実行中に、LLMがアクセスできるコネクターを選択できます。LLMはエージェント定義を生成する際に選択されたコネクターを使用します。例えば、MQTTトリガートピックの設定や mqtt.publish アクションのターゲット、GmailやSlackなどのMCPコネクターが提供するツールの設定に使われます。

コネクターを選択するには：

1. 入力エリア左下のコネクターアイコンをクリックします。Connectors パネルが表示され、設定済みのコネクターが一覧表示されます。
2. このセッションで利用可能にしたい認可済みコネクターにチェックを入れます。Unauthorized、Expired、Error 状態のMCPコネクターはリストに表示されますが選択できません。
3. 新しいコネクターを追加するには、パネル右上の + をクリックします。チャットを離れずにコネクター追加フォームが開きます。

コネクターを選択しない場合でも、LLMは一般的な質問には回答できますが、特定のブローカー、Tablesインスタンス、Fleetsデプロイメント、MCPサービスを参照するエージェント定義は生成できません。

添付ファイルの追加

スクリーンショット、デバイスログの抜粋、サンプルペイロード、短い設定ファイルなど、LLMが追加のコンテキストを必要とする場合にファイルをチャットメッセージに添付できます。

添付ファイルを追加するには：

1. 入力エリア左下の Add File アイコンをクリックします。
2. 現在のチャットメッセージに添付するファイルを最大3つまで選択します。
3. リクエストとともにメッセージを送信します。

1つのチャットメッセージには最大3つの添付ファイルが含められます。各添付ファイルのサイズは最大 2 MiB です。

対応する添付ファイルの種類は以下の通りです。

• JPEG、JPG、PNG画像
• UTF-8エンコードのテキストファイル

ツール承認モードの選択

ツール承認モードは、チャット内でツールを実行する前にEMQX Agentsが承認を求めるタイミングを制御します。入力エリア左下の承認セレクターをクリックし、以下のモードから選択してください。

モード	動作
常に確認	低リスクのアクションは自由に実行します。承認が必要なアクションは実行前に確認を求めます。
自動承認	低リスクまたは中リスクのツールは自動実行します。高リスクまたは不明な場合は確認を求めます。
フルアクセス	承認済みアクションを確認なしで実行します。自律的に動作させるチャットに適しています。

選択したモードは、エージェントのデプロイまたは再デプロイ時に追加の確認が必要かどうかにも影響します。

• 常に確認 では、Deploy Agent または Redeploy Agent をクリック後、Confirm deployment? ダイアログで Confirm をクリックする必要があります。
• 自動承認 または フルアクセス では、追加の確認なしにデプロイが開始されます。

モデルと推論レベルの選択

入力エリアの右下に選択中のモデルと推論レベルが表示されます。利用可能なモデル、デフォルト選択、推論レベルはEMQX Agentsデプロイメントのモデルカタログによって提供されます。モデルによって対応する推論レベルは異なります。

選択中のモデルの推論レベルを調整するには：

1. モデルと推論レベルのセレクターをクリックします。
2. スケール上に表示される推論レベルから1つ選択します。メッセージ送信または再生成時に更新された選択が使用されます。

別のモデルを選択するには：

1. セレクターを開き、パネル上部のモデル名をクリックします。
2. Select model リストからモデルを選択します。パネルは選択したモデルの推論レベルスケールに戻ります。
3. デプロイメント推奨のモデルと推論レベルに戻すには Default を選択します。

前のモデルで選択していた推論レベルが新しいモデルでサポートされていない場合、Consoleは新モデルでサポートされる推論レベルを自動選択します。

選択の範囲は以下の通りです。

• メッセージ送信、編集、再生成、テンプレートドラフト生成は、リクエスト開始時に選択されたモデルと推論レベルを使用します。
• 最新のモデルと推論レベルはチャットセッションごとに保存され、チャットの更新や再オープン時に復元されます。新規チャットは他のセッションの選択を継承しません。
• デプロイ済みエージェントは独自のモデルと推論レベルを持ちます。デプロイまたは再デプロイ前にエージェントプレビューで設定を確認してください。

モデルカタログが読み込めない場合、EMQX Agentsはフォールバックリストを作成しません。保存済みのモデルや推論レベルが利用できない場合、Consoleはカタログの現在のデフォルト組み合わせを使用します。失敗したリクエストを再試行する前にページをリロードして最新カタログを取得してください。

エージェント定義の調整

LLMの応答後も会話を継続してエージェントを調整できます。

• トリガートピックの変更、閾値の調整、新しいツールの追加を依頼できます。
• 別のスキル実装やより保守的なアラート条件をリクエストできます。
• デプロイ前に生成内容の説明を求めることも可能です。

フォローアップメッセージごとにワークスペース内のエージェント定義が更新されます。LLMは同一チャット内の全メッセージのコンテキストを保持します。

テンプレートから作成したチャットの場合、Builderは関連するスキル、スクリプト、アセットも更新します。これらのファイルが変更要求に影響を受ける動作を実装している場合です。必要な変数やコネクターが不足している場合は、検証前に入力を求められます。

チャットからエージェントをデプロイする

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

1. 生成された定義を確認します。デプロイ前にフォローアップ質問や変更依頼が可能です。
2. Review Agent をクリックすると右側にレビューパネルが開きます。新規エージェントの場合、チャットで選択したモデルと推論レベルが初期設定されます。
3. 必須の Agent Name、任意の Description、Model and reasoning、Trigger、Instructions、Tools を確認します。名前は生成定義から自動入力され、デプロイ前に編集可能です。
4. Deploy Agent をクリックします。
5. チャットが 常に確認 モードの場合、Confirm deployment? ダイアログで Confirm をクリックします。他の承認モードでは追加確認は不要です。
6. エージェント詳細ページが開きます。エージェントが Running 状態になるまで数分かかる場合があります。

レビューパネルでモデルや推論レベルを変更してもチャット内の選択は変わりません。レビューパネルの選択がデプロイ済みエージェントに適用されます。

TIP

チャットからエージェントをデプロイしてもチャットは閉じたりアーカイブされません。後で同じチャットに戻ったり、エージェント詳細ページの Edit Agent in Chat をクリックして動作を更新し再デプロイできます。

チャットから再デプロイする

エージェントを更新または再デプロイするには：

1. エージェント詳細ページで右上の Edit Agent in Chat をクリックします。元のチャットがまだ存在する場合は、Chats リストから開くことも可能です。

   

2. 開いたチャットを確認します。

   • 元のチャットが存在する場合は、過去の会話履歴が利用可能です。
   • チャットが削除されている場合は、過去の会話履歴なしで編集ページが開きます。

3. エージェントの変更内容を記述します。過去の会話履歴があり動作を変えたくない場合はこのステップを省略できます。

4. 変更を依頼した場合は、Builderがエージェント定義を更新・検証するまで待ちます。

5. Review Changes をクリックしてレビューパネルを開きます。パネルにはエージェントに保存されたモデルと推論レベルが表示されます。

6. 名前、説明、モデルと推論レベル、トリガー、指示、ツールを確認し、必要に応じて設定を更新します。

7. Redeploy Agent をクリックします。

8. チャットが 常に確認 モードの場合、Confirm deployment? ダイアログで Confirm をクリックします。他の承認モードでは追加確認は不要です。

再デプロイにより、レビューパネルの定義、モデル、推論レベルで実行中のエージェントが更新されます。更新されたモデルと推論レベルは再デプロイ成功後に反映されます。以前の実行履歴は保持されます。

チャットの名前変更

1. Chats リストページで、Actions 列の編集アイコンをクリックします。
2. 新しいタイトルを入力して確定します。

チャットの削除

1. Chats リストページで、Actions 列の削除アイコンをクリックします。
2. 削除を確認します。

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

次のステップ

• エージェントの管理
• コネクターの管理
• デプロイメントレベルスキルの管理
• テンプレートの利用