エージェント

エージェントとは、MQTTイベントに反応し、インフラストラクチャ上で動作するデプロイ済みの長時間実行プロセスです。各エージェントは分離されたサンドボックス内で実行され、設定されたMQTTトピックを監視し、トリガーに一致する受信メッセージごとに実行を行います。

エージェントはチャットで生成されたエージェント定義をデプロイすることで作成されます。チャットはゼロから開始することも、組み込みテンプレートから開始することも可能です。デプロイ後は、エージェントは独立して動作し、継続的な人手による操作は不要です。

エージェントの表示

左メニューの Agents をクリックすると、エージェントページが開きます。このページにはこのデプロイメント内のすべてのエージェントが表示されます。各エージェントカードには以下が表示されます。

• 名前 と 説明
• ステータス：Starting または Running
• 作成日時
• 実行回数合計

エージェントカードをクリックすると、その詳細ページが開きます。

エージェントの作成

エージェントはこのページから直接作成するのではなく、チャットセッションから作成します。以下のいずれかの方法で作成してください。

• チャットを開き、構築したい自動化内容を説明する。
• Templates を開き、組み込みテンプレートを選択して Use Template をクリックし、テンプレートベースのチャットを開始する。

チャット内で生成されたワークスペースを確認・修正し、エージェント定義が検証に合格したら Deploy Agent をクリックします。

エージェントはエージェントページに Starting ステータスで表示され、数分後に Running に遷移します。全体のワークフローについてはChatsを参照してください。

追加でエージェントをゼロから作成する場合は、エージェントページ右上の + New Agent をクリックして新しいチャットセッションを開始します。

エージェント詳細ページ

エージェント詳細ページでは、デプロイされた設定、ワークスペースファイル、実行履歴を確認できます。タブは Overview、Runs、Configuration、Skills の4つがあります。

Overview タブ

Overviewタブでは集計統計と最近の実行履歴を表示します。

統計情報:

指標	説明
Total Runs	このエージェントが実行した総回数。
Success Rate	完了した実行のうち成功した割合（%）。
Total Cost	全実行における累積LLM使用コスト。

成功率は以下の式で計算されます。

Success Rate = 成功した実行 / (成功した実行 + 失敗した実行 + タイムアウトした実行) × 100%

Timeout ステータスの実行は失敗実行としてカウントされます。Dropped 実行は開始されなかったため除外されます。Queued または Running ステータスの実行は終了ステータスになるまで含まれません。

Recent Runs には直近の数回の実行が以下の列で表示されます。

列	説明
Run ID	実行の一意識別子。クリックすると実行詳細ページが開きます。
Status	現在の実行ステータス：Queued、Running、Succeeded、Dropped、Failed、Timeout。
Started	実行開始のタイムスタンプ。
Duration	実行にかかった時間。
Tokens	実行で消費されたLLMトークンの合計数。

実行ステータス

ステータス	説明
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	総実行時間。

トークン使用量:

項目	説明
Input Token	この実行のLLM入力コンテキスト内のトークン数。
Output Token	LLMが生成したトークン数。
Cached Token	LLMプロンプトキャッシュから提供されたトークン数。
Cost	この実行のLLM使用コスト。

タイムライン には実行中のすべてのイベントが時系列で表示されます。

イベント種別	説明
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トリガーの場合、設定は以下を含みます。

項目	説明
Kind	トリガータイプ（例：mqtt.subscribe）。
Trigger Topic	エージェントがサブスクライブするMQTTトピックフィルター。ワイルドカード（+、#）対応。
QoS	サブスクリプションのMQTT QoSレベル。

ツールを展開すると設定内容を確認できます。ツールによっては、プロバイダー、コネクターID、許可トピック、その他制限が含まれます。

利用可能なツールはエージェント定義生成時に選択されたコネクターに依存します。代表的なツールは以下の通りです。

ツール	説明
mqtt.publish	MQTTトピックにメッセージをパブリッシュする。allowed_topicsにリストされたトピックに制限される。
tables.sql	EMQX Tablesコネクターに対してSQLクエリを実行する。クエリごとにmax_rows件の結果に制限。
MCPコネクターのツール	GmailやSlackなどのMCPコネクターサービスが提供するツール。利用可能なアクションは認可されたサービスによる。

デプロイ済み設定は読み取り専用です。エージェントの動作を変更するには、チャットでのエージェント編集を参照してください。

Skills タブ

Skillsタブでは、デプロイされたエージェントにバンドルされたスキルと関連ファイルを表示します。ワークスペースツリーでファイルを選択すると内容を確認できます。スキルは SKILL.md ファイルやエージェント動作を実装するスクリプトを含むことがあります。

Markdownファイルはレンダリングビューとソースビューを切り替え可能です。選択したファイルはダウンロードもできます。

これらのファイルはエージェント詳細ページでは読み取り専用です。スキルを変更するには Edit Agent in Chat を使い、ビルダーに動作更新を依頼してエージェントを再デプロイしてください。

エージェントの編集

エージェント名と説明の編集

エージェントの 名前 と 説明 はエージェント詳細ページから更新できます。

1. エージェント詳細ページでエージェント名の横にある編集アイコンをクリックします。
2. Edit Agent ダイアログで Agent Name または Description を更新します。
3. Save をクリックします。

チャットでのエージェント動作編集

エージェントのチャットを使って、指示、トリガー、ツール、スキル、スクリプト、アセットを更新します。

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

詳細はチャットからの再デプロイを参照してください。

エージェントの再起動

エージェントが停止または失敗状態になった場合、エージェント詳細ページから再起動できます。

1. エージェント詳細ページ右上の再起動アイコンをクリックします。
2. エージェントは Running 状態に戻り、トリガーイベントの監視を再開します。

エージェントの削除

重要なお知らせ

エージェントを削除すると即時に停止し、関連するすべての実行履歴が削除されます。この操作は元に戻せません。

1. エージェント詳細ページ右上の削除アイコンをクリックします。
2. 削除を確認します。

次のステップ

• コネクターの管理
• チャットの開始
• テンプレートの利用