チャット
チャットとは、組み込みのLLMと対話し、エージェントに実行してほしい内容を記述する会話のことです。LLMはリクエストを解釈し、エージェントの指示やスキルを生成し、デプロイ可能な完全なエージェント定義を組み立てます。
チャットには以下の2つの目的があります。
- 単発タスク：最近のデバイスデータの照会、インシデントの要約、MQTTイベントの解析などを、永続的なエージェントを作成せずにLLMに依頼します。
- エージェント作成：自動化の目標を記述し、フォローアップメッセージで動作を反復調整し、その結果を長時間稼働するエージェントとしてデプロイします。
エージェント作成チャットは、ゼロから開始することも、組み込みテンプレートから開始することもできます。テンプレートベースのチャットは、あらかじめ定義された指示、トリガー、ツール、およびサポート用のワークスペースファイルから始まります。
チャットの表示
左メニューの Chats をクリックするとチャットページが開きます。リストにはこのデプロイメント内のすべてのチャットが以下の列で表示されます。
| 列 | 説明 |
|---|---|
| タイトル | チャットタイトル。最初のメッセージから自動生成されます。クリックするとチャットが開きます。 |
| デプロイ済みエージェント | このチャットからデプロイされたエージェント（あれば） |
| 最終更新日時 | チャットが最後にアクティブだった日時 |
| 操作 | チャットの名前変更または削除 |
新しいチャットの開始
- 左メニューの Chats をクリックします。
- + New Chat をクリックします。
- 必要に応じて、このセッションで利用可能にするコネクターを選択します（コネクターの選択参照）。
- [任意] 入力欄左下の Add File アイコンをクリックして、チャットにコンテキストを提供する画像やテキストファイルを添付します（添付ファイルの追加参照）。
- 入力欄にリクエストを入力し、送信ボタンをクリックします。
入力欄のプレースホルダーには、開始のヒントとなる例文が表示されます。例えば：
- 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サービスを参照するエージェント定義は生成できません。
添付ファイルの追加
スクリーンショット、デバイスログの抜粋、サンプルペイロード、短い設定ファイルなど、LLMに追加のコンテキストが必要な場合は、チャットメッセージにファイルを添付できます。
添付ファイルを追加するには：
- 入力欄左下の Add File アイコンをクリックします。
- 現在のチャットメッセージに添付する最大3ファイルを選択します。
- リクエストとともにメッセージを送信します。
1つのチャットメッセージには最大3つの添付ファイルを含められます。各ファイルのサイズは 2 MiB 以下である必要があります。
対応する添付ファイルの種類は以下の通りです。
- JPEG、JPG、PNG画像
- UTF-8エンコードのテキストファイル
シンキングモード
入力欄右下にシンキングモードの選択があります。以下の3モードから選択可能です。
| モード | 説明 |
|---|---|
| Instant | LLMがより高速に、簡単な推論で応答します。単純な質問や単発タスクに適しています。 |
| Thinking | LLMがより多くの推論を行って応答します。複数のツールやスキルを使う複雑なエージェント定義に適しています。 |
| Pro | LLMが最も多くの推論を行って応答します。高度な多段階エージェント設計やトラブルシューティングに適しています。 |
リクエストに合ったモードを選択してから送信してください。
エージェント定義の調整
LLMの応答後も会話を続けてエージェントを調整できます。
- トリガートピックの変更、閾値の調整、新しいツールの追加を依頼する。
- 別のスキル実装やより保守的なアラート条件を依頼する。
- デプロイ前に生成内容の説明を求める。
フォローアップメッセージごとにワークスペース内のエージェント定義が更新されます。LLMは同一チャット内のすべてのメッセージのコンテキストを保持します。
テンプレートから作成したチャットの場合、Builderは関連するスキル、スクリプト、アセットも更新します。必要な変数やコネクターが不足している場合は、検証前に入力を求められます。
チャットからエージェントをデプロイする
LLMがエージェント定義を生成すると、チャット下部に Deploy Agent ボタンが表示されます。
- 生成された定義を確認します。フォローアップで質問や変更依頼も可能です。
- Deploy Agent をクリックします。チャットから生成されたエージェント名と説明があらかじめ入力されたダイアログが表示されます。
- 必要に応じて名前や説明を編集し、ダイアログ内の Deploy Agent をクリックします。
- エージェント詳細ページが開きます。エージェントが Running 状態になるまで数分かかる場合があります。
TIP
チャットからエージェントをデプロイしてもチャットは閉じたりアーカイブされたりしません。後で同じチャットに戻ったり、エージェント詳細ページの Edit Agent in Chat をクリックして動作を更新し再デプロイできます。
チャットから再デプロイする
エージェントを更新または再デプロイするには：
- エージェント詳細ページを開き、右上の Edit Agent in Chat をクリックします。元のチャットが存在する場合は、Chats リストから開くこともできます。
- 開いたチャットを確認します。
- 元のチャットが存在する場合、過去の会話履歴が利用可能です。
- チャットが削除されている場合、過去の会話履歴なしで編集ページが開きます。
- エージェントの変更内容を記述します。過去の会話履歴があり動作を変えたくない場合はこのステップを省略できます。
- 変更を依頼した場合は、Builderがエージェント定義を更新・検証するのを待ちます。
- Redeploy Agent をクリックします。
再デプロイにより、チャットの定義で実行中のエージェントが更新されます。以前の実行履歴は保持されます。
チャットの名前変更
- Chats リストページで、Actions 列の編集アイコンをクリックします。
- 新しいタイトルを入力して確定します。
チャットの削除
- Chats リストページで、Actions 列の削除アイコンをクリックします。
- 削除を確認します。
チャットを削除しても、そのチャットからデプロイされたエージェントには影響しません。エージェントは独立して稼働し続けます。後でそのエージェントの Edit Agent in Chat をクリックすると、削除済みの会話履歴なしで編集ページが開きます。新しいリクエストを入力してエージェントを更新し、Redeploy Agent をクリックしてください。