未翻訳のページは英語で開き、英語と表示されます。
このページは英語の原文の機械翻訳です。内容は英語の原文が優先されます。 Machine-translated from the English page, which is authoritative.
insights オペレーション
各 insights.* オペレーションが受け取るフィールドと返すフィールドの正確な一覧です。
すべてのオペレーションは、HTTP では POST /v1/<op>、MCP ツールでは loom_<op> として呼び出せます。アイデンティティのフィールド(org、namespace、agent、user_id、session_id)は、トランスポートが対応している場合、トークンと MCP セッションから補完されます。シングルユーザーサーバーでトークンなしの HTTP 呼び出しを行う場合は、code.* と tracker.*(それぞれのプレーンの値を保持します)を除くすべてのオペレーションで、インストールの org が使われます。一部のオペレーションでは、名前空間とエージェントも補完されます。詳しくはアイデンティティと名前空間を参照してください。ロール、種別、MCP の all 一覧については、オペレーション索引で説明しています。未知の入力フィールドは受け付けられ、ignored_args に名前が示されます。
insights.catalog
insights.query が読み取れるテーブルを一覧します。各カラムの型と意味、テーブルの正しい読み方(キーごとに有効な行が 1 つか、イベントごとに 1 行か)、およびステートメントの実行時の上限を返します。
POST /v1/insights.catalog · MCP loom_insights_catalog · ロール viewer · 読み取り · MCP の all ツールセットには含まれません
| 入力フィールド | 型 | デフォルト | 意味 |
|---|---|---|---|
org |
str |
必須 | テナント(アイデンティティタプルの最初の要素)。 |
namespace |
str |
必須 | オペレーションが読み書きする名前空間。 |
| 出力フィールド | 型 | 意味 |
|---|---|---|
tables |
list[CatalogTable] |
insights.query が読み取るテーブル。カラムと読み方を含みます。 |
max_result_rows |
int |
1 つのステートメントが返す最大行数。超えた分は切り捨てられます。 |
max_execution_s |
float |
1 つのステートメントが ClickHouse に停止されるまでに実行できる最長時間(このレプリカの上限。ロール中は、保存されている上限プロファイルと異なる場合があります)。 |
max_rows_to_read |
int |
1 つのステートメントが読み取れる最大行数。超える場合は時間またはキーのフィルターを追加してください。 |
insights.query
insights.catalog が一覧するテーブルに対して、読み取り専用の SQL SELECT(または WITH)を 1 つ実行します。ほかの読み取りでは答えられない質問、たとえばメモリ、競合、利用状況、ドキュメント、そして…
POST /v1/insights.query · MCP loom_insights_query · ロール viewer · 読み取り · MCP の all ツールセットには含まれません
| 入力フィールド | 型 | デフォルト | 意味 |
|---|---|---|---|
org |
str |
必須 | テナント(アイデンティティタプルの最初の要素)。 |
namespace |
str |
必須 | オペレーションが読み書きする名前空間。 |
sql |
str |
必須 | insights.catalog が一覧するテーブルに対する SELECT または WITH ステートメント 1 つ。この名前空間の行だけを読み取ります。 |
limit |
int |
100 |
返す最大行数(デフォルトは 100)。デプロイメントの上限(LOOM_CH_ANALYSIS_MAX_RESULT_ROWS)がこれより小さい場合は、その上限が優先されます。 |
| 出力フィールド | 型 | 意味 |
|---|---|---|
columns |
list[AnalysisColumn] |
ステートメントの結果カラム。それぞれ ClickHouse の型を持ちます。 |
rows |
list[list[Any]] |
行ごとに 1 つのリスト。columns の順に並びます。日付、UUID、小数は文字列です。 |
row_count |
int |
rows に含まれる行数。最大でも limit です。 |
truncated |
bool |
limit より多くの行が一致しました。ステートメントを絞り込むか、集計してください。 |
sql_digest |
str |
リクエスト台帳が sql について記録するダイジェスト(sha256:<hex>/<length>)。ステートメントの引用はこの値と照合されます。 |