コンテンツにスキップ

未翻訳のページは英語で開き、英語と表示されます。

このページは英語の原文の機械翻訳です。内容は英語の原文が優先されます。 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>)。ステートメントの引用はこの値と照合されます。