Agents
エージェントとは、MQTTイベントに反応してインフラストラクチャ上で動作する、デプロイされた長時間実行プロセスのことです。各エージェントは独立したサンドボックス内で実行され、設定されたMQTTトピックを監視し、トリガーに一致する受信メッセージごとに処理を実行します。
エージェントはチャットで生成されたエージェント定義をデプロイすることで作成されます。チャットはゼロから開始することも、組み込みテンプレートから開始することも可能です。デプロイ後は、エージェントは独立して動作し、継続的な人手による操作は不要です。
エージェントの表示
左メニューの Agents をクリックすると、エージェントページが開きます。このページには現在のデプロイメント内のすべてのエージェントが表示されます。各エージェントカードには以下が表示されます：
- 名前 と 説明
- ステータス：
StartingまたはRunning - 作成日時
- 実行回数合計
エージェントカードをクリックすると、その詳細ページが開きます。
エージェントの作成
エージェントはこのページから直接作成するのではなく、チャットセッションから作成します。以下のいずれかの方法で作成してください：
- チャットを開き、構築したい自動化内容を記述する。
- Templates を開き、組み込みテンプレートを選択して Use Template をクリックし、テンプレートベースのチャットを開始する。
チャット内で生成されたワークスペースを確認・修正します。エージェント定義が検証に合格したら、Review Agent をクリックし、右側のパネルでデプロイ設定を確認後、Deploy Agent をクリックします。
エージェントはエージェントページに Starting ステータスで表示され、数分で Running に切り替わります。完全なワークフローについては Chats を参照してください。
追加のエージェントをゼロから作成する場合は、エージェントページ右上の + New Agent をクリックして新しいチャットセッションを開きます。
デプロイメントレベルのスキル
デプロイメントレベルのスキルは、類似のエージェントを作成するための再利用可能なMarkdown指示書です。現在のEMQX Agentsデプロイメント内のチャットでスキルを参照し、このエージェントの要件を記述してから、生成された定義を確認・デプロイします。デプロイメントレベルのスキルは、デプロイされたエージェントにバンドルされたスキルとは独立して管理され、デプロイ済みエージェントを自動的に変更しません。準備、アップロード、使用方法については Manage EMQX Agents Skills をご覧ください。
エージェント詳細ページ
エージェント詳細ページでは、デプロイされた設定、ワークスペースファイル、実行履歴を確認できます。タブは Overview、Runs、Configuration、Skills の4つがあります。
ページヘッダーには、デプロイされたエージェントで使用されているモデルと推論負荷が表示されます。これらの設定はチャットリクエストで選択されたモデルや推論負荷とは別です。変更するには、チャット内でエージェントを編集し、更新された設定を確認して再デプロイしてください。
Overview タブ
Overviewタブでは集計統計と最近の実行履歴を表示します。
統計情報:
| 指標 | 説明 |
|---|---|
| Total Runs | このエージェントが実行した合計回数。 |
| Success Rate | 完了した実行のうち成功した割合（％）。 |
| Total Credits Used | このエージェントの実行で消費されたクレジットの合計。クレジットデータが利用できない場合は — と表示されます。 |
成功率は以下の式で計算されます：
Success Rate = 成功した実行数 / (成功 + 失敗 + タイムアウトの実行数) × 100%Timeout ステータスの実行は失敗としてカウントされます。Dropped 実行は開始されなかったため除外されます。Queued または Running ステータスの実行は終了ステータスに達するまで含まれません。
デプロイメントの利用可能クレジット、含まれるクレジット使用量、購入済みクレジット、現在の使用サイクルについては View Credits Usage を参照してください。
Recent Runs には直近の実行が以下の列で表示されます：
| 列 | 説明 |
|---|---|
| Run ID | 実行の一意識別子。クリックすると実行詳細ページが開きます。 |
| Status | 実行の現在のステータス：Queued、Running、Succeeded、Dropped、Failed、Timeout のいずれか。 |
| Started | 実行開始のタイムスタンプ。 |
| Duration | 実行にかかった時間。 |
| Credits | 実行で消費されたクレジット。実行中またはクレジット情報がない場合は — と表示されます。 |
実行ステータス
| ステータス | 説明 |
|---|---|
| Queued | 実行がキューで待機中。 |
| Running | 実行中。 |
| Succeeded | 実行が正常に完了。 |
| Dropped | 実行キューが満杯のため開始されなかった。 |
| Failed | 実行エラーにより終了。 |
| Timeout | 実行時間制限を超過。成功率計算時は失敗としてカウント。 |
View all runs → をクリックするとRunsタブに移動します。
Runs タブ
Runsタブにはこのエージェントのすべての過去実行が、OverviewタブのRecent Runsと同じ列で一覧表示されます。
Run IDをクリックすると実行詳細ページが開きます。
実行詳細ページ
実行詳細ページでは単一実行の完全な記録を表示します。
ヘッダー:
| 項目 | 説明 |
|---|---|
| Run ID | この実行の一意識別子。 |
| Status | 現在の実行ステータス：Queued、Running、Succeeded、Dropped、Failed、Timeout のいずれか。 |
| Started / Completed | 開始および終了のタイムスタンプ。 |
| Duration | 総実行時間。 |
| Credits | 実行で消費されたクレジット。実行終了後に利用可能。実行中またはクレジット情報がない場合は — と表示。 |
タイムライン には実行中のすべてのイベントが時系列で表示されます：
| イベントタイプ | 説明 |
|---|---|
TRIGGER | 実行を開始したMQTTメッセージと受信トピック。 |
BUNDLE LOADED | エージェントのスキルと設定が正常に読み込まれた。 |
CONTEXT LOADED | 会話コンテキストが準備された。 |
TOOLS RESOLVED | 実行で使用可能なツールが解決・バインドされた。 |
SYSTEM INIT | エージェントの指示がシステム指示として適用された。 |
TOOL RESULT | エージェントによるツール呼び出しの結果（例：read、run_script、mqtt.publish、MCPコネクターのツール）。チェックマークは成功を示す。 |
LLM CALL | LLM呼び出し。呼び出し回数および入出力トークン数を含む。 |
RESPONSE | この実行に対するエージェントの最終応答テキスト。 |
RUN END | 終了イベント。最終ステータスを含む。 |
任意のタイムラインイベントをクリックすると展開され、詳細が表示されます。
Configuration タブ
Configurationタブでは、エージェントの動作を決定するデプロイ済みのエージェント定義（指示、トリガー、ツール）を表示します。
| 項目 | 説明 |
|---|---|
| Instructions | 各エージェント実行に適用される指示。 |
| Trigger | エージェントを起動するイベントソース。MQTTトピックフィルターとQoSレベルを含む。 |
| Tools | 実行中に利用可能なツールと制限（例：mqtt.publishで許可されるトピック）。 |
MQTTトリガーの場合、設定は以下を含みます：
| 項目 | 説明 |
|---|---|
| Type | トリガーの種類（例：MQTT Event）。 |
| Topic | エージェントがサブスクライブするMQTTトピックフィルター。ワイルドカード（+、#）対応。 |
| QoS | サブスクライブのMQTT QoSレベル。 |
ツールを展開すると設定内容を確認できます。ツールによっては、プロバイダー、コネクターID、許可トピック、その他制限が含まれます。
利用可能なツールは、エージェント定義生成時に選択されたコネクターによって異なります。一般的なツールは以下の通りです：
| ツール | 説明 |
|---|---|
mqtt.publish | MQTTトピックにメッセージをパブリッシュする。allowed_topicsに記載されたトピックに制限される。 |
tables.sql | EMQX Tablesコネクターに対してSQLクエリを実行。クエリごとに max_rows 結果に制限。 |
| MCPコネクターのツール | GmailやSlackなどMCPコネクターサービスが提供するツール。利用可能なアクションは認可されたサービスによる。 |
デプロイ済みの設定は読み取り専用です。エージェントの動作を変更するには、Edit the Agent Behavior in a Chat に記載の Edit Agent in Chat を使用してください。
Skills タブ
Skillsタブには、このデプロイ済みエージェントにバンドルされたスキルとサポートファイルが表示されます。これらのファイルは、左ナビゲーションメニューの Skills から管理する再利用可能なデプロイメントレベルのスキルとは異なります。ワークスペースツリーでファイルを選択すると内容を確認できます。バンドルされたスキルには SKILL.md ファイルやエージェント動作を実装するスクリプトが含まれることがあります。
Markdownファイルはレンダリングビューとソースビューの切り替えが可能です。選択したファイルはダウンロードもできます。
これらのファイルはエージェント詳細ページ上で読み取り専用です。スキルを変更するには、Edit Agent in Chat を使い、ビルダーに動作更新を依頼してからエージェントを再デプロイしてください。
エージェントの編集
エージェント名と説明の編集
エージェント詳細ページからエージェントの名前と説明を更新できます。
- エージェント詳細ページで、エージェント名の横にある編集アイコンをクリックします。
- Edit Agent ダイアログで Agent Name または Description を更新します。
- Save をクリックします。
チャットでエージェント動作を編集
エージェントのチャットを使って、指示、トリガー、ツール、スキル、スクリプト、アセットを更新します：
- エージェント詳細ページの右上にある Edit Agent in Chat をクリックします。
- 開いたチャットを確認します：
- エージェントを生成したチャットがまだ存在する場合、以前の会話履歴が利用可能です。
- チャットが削除されている場合は、会話履歴なしで編集ページが開きます。
- エージェントの変更内容を記述してリクエストを入力します。以前の会話履歴があり、動作を変更しない場合はこのステップを省略できます。
- 変更をリクエストした場合は、ビルダーがエージェント定義を更新・検証するまで待ちます。
- Review Changes をクリックしてレビューパネルを開きます。
- 名前、説明、モデルと推論負荷、トリガー、指示、ツールを確認し、必要に応じて設定を更新します。
- Redeploy Agent をクリックします。
- チャットが Always ask モードの場合は、Confirm deployment? ダイアログで Confirm をクリックします。その他のツール承認モードでは追加の確認は不要です。
更新されたモデルと推論負荷は再デプロイ成功後に反映されます。レビューパネルでの変更はチャットリクエストに選択されたモデルや推論負荷には影響しません。
詳細は Redeploy from a Chat をご覧ください。
エージェントの再起動
エージェントが停止または失敗状態になった場合、エージェント詳細ページから再起動できます。
- エージェント詳細ページの右上にある再起動アイコンをクリックします。
- エージェントは Running 状態に戻り、トリガーイベントの監視を再開します。
エージェントの削除
重要なお知らせ
エージェントを削除すると即座に停止し、関連するすべての実行履歴が削除されます。この操作は元に戻せません。
- エージェント詳細ページの右上にある削除アイコンをクリックします。
- 削除を確認します。