エージェント

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

エージェントはチャットセッションから生成されたエージェント定義をデプロイすることで作成されます。デプロイ後は、人間の継続的な入力を必要とせずに独立して動作します。

エージェントの表示

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

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

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

エージェントの作成

エージェントはこのページから直接ではなく、チャットセッションから作成されます。エージェントを作成するには：

1. チャットを開き、構築したい自動化の内容を説明します。
2. LLMがエージェント定義を生成したら、Deploy Agentをクリックします。

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

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

エージェント詳細ページ

エージェント詳細ページでは、エージェントの完全な設定と実行履歴を確認できます。タブは5つあり、Overview、Runs、Trigger、Tools、Promptがあります。

Overviewタブ

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

統計情報:

指標	説明
Total Runs	このエージェントが実行した合計回数。
Success Rate	successステータスで完了した実行の割合。
Total Cost	すべての実行にかかったLLM使用コストの累計。

Recent Runsでは直近の実行が以下の列で表示されます：

列	説明
Run ID	実行の一意識別子。クリックすると実行詳細ページが開きます。
Status	実行の最終ステータス：success、failed、timeout、cancelled。
Started	実行開始のタイムスタンプ。
Duration	実行にかかった時間。
Tokens	実行で消費したLLMトークンの総数。

実行ステータス

ステータス	説明
success	エージェントがエラーなくタスクを完了しました。
failed	エージェントが回復不能なエラーに遭遇しました。
timeout	実行が設定された時間制限（run_timeout_s、デフォルト300秒）を超えました。
cancelled	実行が完了前にキャンセルされました。

**View all runs →**をクリックするとRunsタブに移動します。

タブ下部のAgent Definitionにはエージェント定義のJSON全文が表示されます。クリックすると展開できます。

Runsタブ

Runsタブにはこのエージェントのすべての過去の実行が一覧表示され、OverviewタブのRecent Runsと同じ列構成です。

Run IDをクリックすると実行詳細ページが開きます。

実行詳細ページ

実行詳細ページでは単一の実行記録を完全に表示します。

ヘッダー:

項目	説明
Run ID	この実行の一意識別子。
Status	最終ステータス：success、failed、timeout、cancelled。
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	実行の終了イベントで、最終ステータスを含みます。

任意のタイムラインイベントをクリックすると展開され、詳細を確認できます。

Triggerタブ

Triggerタブにはこのエージェントを起動するイベントソースが表示されます。

項目	説明
Kind	トリガーの種類。現在は mqtt のみ。
Trigger Topic	エージェントがサブスクライブするMQTTトピックフィルター。ワイルドカード（+ と #）をサポート。
QoS	サブスクライブのMQTT QoSレベル。
Connector	サブスクライブに使用されるEMQXブローカーのコネクター名。

Toolsタブ

Toolsタブにはエージェントが実行中に呼び出せるツールが一覧表示されます。各ツールエントリには名前と設定が表示され、クリックすると詳細が展開されます。

利用可能なツールはエージェント定義生成時に選択されたコネクターによって異なります。一般的なツールは以下の通りです：

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

Promptタブ

Promptタブにはエージェントが各実行で使用する指示文が表示されます。このテキストはエージェントを生成したチャットセッション中にLLMが生成したもので、各MQTTイベントに対するエージェントの振る舞いを記述しています。

このページ上ではプロンプトは読み取り専用です。エージェントの振る舞いを変更するには、元のチャットに戻り、変更内容を説明してエージェントを再デプロイしてください。

エージェントの編集

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

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

トリガー、ツール、スキル、プロンプトの変更は元のチャットに戻り再デプロイしてください。詳細はChatsを参照してください。

エージェントの再起動

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

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

エージェントの削除

重要なお知らせ

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

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

次のステップ

• コネクターの管理
• チャットを開始する