チャット

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

チャットは以下の2つの目的で使用されます。

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

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

チャットの表示

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

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

新しいチャットの開始

1. 左メニューのChatsをクリックします。
2. + New Chatをクリックします。
3. 必要に応じて、このセッションで利用可能にするコネクターを選択します（コネクターの選択を参照）。
4. 入力欄にリクエストを入力し、送信します。

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

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

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

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

あらかじめ定義されたエージェントシナリオから開始するには、左ナビゲーションメニューの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サービスを参照するエージェント定義は生成できません。

シンキングモード

入力エリア右下にはシンキングモードのセレクターがあります。以下の3つのモードが利用可能です。

モード	説明
Instant	より高速に応答し、推論は少なめ。単純な質問や単発タスクに適しています。
Thinking	応答前により多くの推論を行います。複数のツールやスキルを使う複雑なエージェント定義に適しています。
Pro	最も多くの推論を行います。高度で多段階のエージェント設計やトラブルシューティングに適しています。

リクエストに合ったモードを選択してから送信してください。

エージェント定義の調整

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

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

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

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

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

LLMがエージェント定義を生成すると、チャット下部にDeploy Agentボタンが表示されます。

1. 生成された定義を確認します。フォローアップで質問や変更依頼も可能です。
2. Deploy Agentをクリックします。チャットから自動生成されたAgent NameとDescriptionが入力済みのダイアログが表示されます。
3. 必要に応じて名前や説明を編集し、ダイアログ内のDeploy Agentをクリックします。
4. エージェント詳細ページが開きます。エージェントがRunning状態になるまで数分かかることがあります。

TIP

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

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

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

1. エージェント詳細ページを開き、右上のEdit Agent in Chatをクリックします。元のチャットがまだ存在する場合は、Chatsリストからも開けます。
2. 開いたチャットを確認します。
   • 元のチャットが存在する場合は、以前の会話履歴が利用可能です。
   • チャットが削除されている場合は、会話履歴なしで編集ページが開きます。
3. エージェントの変更内容をリクエストします。以前の会話履歴があり、動作を変えたくない場合はこのステップを省略できます。
4. 変更を依頼した場合は、Builderがエージェント定義を更新・検証するまで待ちます。
5. Redeploy Agentをクリックします。

再デプロイにより、チャットの定義で稼働中のエージェントが更新されます。以前の実行履歴は保持されます。

チャットの名前変更

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

チャットの削除

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

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

次のステップ

• エージェントの管理
• コネクターの管理
• テンプレートの使用