ツール、ワークフロー、データテーブル

これらは LoopAgent の「行動能力」です——設定しておくと、モデルは対話の中でそれらを自律的に呼び出し、目標のタスクを完了できます。

ツールと MCP

• LoopAgent にプラグイン／MCP を紐付けると、モデルは必要に応じて対応するツールを呼び出せます。
• 認証情報の安全性：URL、API Key、認証ヘッダーなどの機密情報はすべてプラットフォーム側に保存され、実行もプラットフォーム側で完結するため、モデルはあなたの鍵に一切触れません。key／token／secret に類する名前のパラメータはモデルから隠され、実行時にプラットフォームが注入します。
• ツールの数が少ないときは、モデルが直接それらを見て呼び出せます。数が多い（30 個超）ときは、Token を節約しコストを抑えるために「遅延ロード」モードに切り替わります。

使用上のポイント

• ツールのエラーで本ターンは中断しません：あるツール呼び出しが失敗すると、ツールカードにエラー情報が表示され、モデルはそれを言い換えて伝えるか再試行し、サービスを継続します。
• ツール呼び出しの過程が見えない：LoopAgent - 出力の「呼び出し過程を表示」スイッチで制御されます（プラグインレベルとエージェントレベルの両方をオンにする必要があります）。

ツールを呼び出せないときの切り分け

1. エージェントのツールのメインスイッチがオンになっているか。
2. プラグインがそのエージェントに紐付けられ、有効になっているか。
3. その操作（action）がプラグインレベルまたはエージェントレベルで無効化されていないか。
4. MCP のチェックホワイトリストがそのツールを除外していないか。

ワークフロー

公開済みのワークフローは1つのツールになり、モデルはツールを呼び出すのと同じようにそれをトリガーできます。ワークフローの START ノードの入力パラメータが、このツールの入力パラメータになります。

ワークフローを呼び出し可能なツールにするには、3つの条件を同時に満たす必要があります（1つでも欠けるとツールは表示されず、エラーにもなりません）。

1. エージェントのワークフローのメインスイッチがオンになっている。
2. そのワークフローがこのエージェントに関連付けられている。
3. そのワークフローが公開済みである（下書きしか保存されていないワークフローはスキップされます）。

• ワークフローの下書きを変更しても公開しなければ、LoopAgent が実行するのは依然として古い公開済みバージョンです。
• ワークフローの「概要」には用途を明確に書いてください。そうしないとモデルが見つけられず、呼び出しません。
• ワークフロー実行のクレジットは、ワークフローが属する組織の口座に計上されます。

データテーブルとグラフ

LoopAgent にデータテーブルを紐付けると、モデルは自動的に2つの能力を得ます。自然言語でテーブルを照会することと、照会結果をグラフに描くことです。モデルは終始 SQL を書きません。

• 自然言語でのテーブル照会：モデルが何を照会したいかを自然言語1文で記述し、プラットフォームがそれをクエリに変換して結果を返します。
• グラフの生成：本ターンで最後に実行した照会の結果を、棒グラフ／折れ線グラフ／円グラフなどのグラフにレンダリングし、ユーザーに直接表示します。
• 必ず先に照会してから描く：グラフを生成する前に、同じターン内で少なくとも一度テーブルの照会に成功している必要があります。ユーザーが新しいターンを始めていきなり「グラフを描いて」と言い、先に照会していない場合は、まず一度照会するよう促されます——これは設計であり、不具合ではありません。

テーブルの提供元：LoopAgent のデータテーブルは、LoopAgent 自身のデータノード内で選択します。LoopAgent のデータノードでテーブルを選んでください。エージェントの他の場所にあるデータテーブル設定を変更しても、LoopAgent には反映されません。