未翻訳のページは英語で開き、英語と表示されます。
このページは英語の原文の機械翻訳です。内容は英語の原文が優先されます。 Machine-translated from the English page, which is authoritative.
observe オペレーション
各 observe.* オペレーションが受け取るフィールドと返すフィールドの詳細です。
すべてのオペレーションは、HTTP では POST /v1/<op>、MCP ツールでは loom_<op> として呼び出せます。アイデンティティのフィールド(org、namespace、agent、user_id、session_id)は、トランスポートが対応している場合にトークンと MCP セッションから補完されます。単一ユーザーのサーバーでトークンなしに HTTP 呼び出しを行う場合は、code.* と tracker.*(それぞれのプレーンの値を保持)を除くすべてのオペレーションでインストールの org が使われ、一部のオペレーションでは名前空間とエージェントも補完されます。詳しくは アイデンティティと名前空間 を参照してください。ロール、種別、MCP の all 一覧については オペレーション一覧 で説明しています。未知の入力フィールドは処理されたうえで、ignored_args に名前が示されます。
observe.crystallize
セッションの保留中のオブザベーションを、メモリへの抽出が可能な状態にします(キューへの登録のみ)。
POST /v1/observe.crystallize · MCP loom_observe_crystallize · role writer · idempotent
| 入力フィールド | 型 | デフォルト | 意味 |
|---|---|---|---|
org |
str |
必須 | テナント(アイデンティティタプルの最初の要素)。 |
namespace |
str |
必須 | オペレーションが読み書きする名前空間。 |
agent |
str |
必須 | 書き込みまたは読み取りを行うエージェント。オペレーションが許可する場合、'-' または '*' は任意のエージェントを意味します。 |
user_id |
str |
'-' |
行が属するエンドユーザー。なしの場合は '-'。 |
session_id |
str |
'-' |
行が属するセッションまたは会話。なしの場合は '-'。 |
max_observations |
int |
500 |
セッションの保留中のオブザベーションのうち、古いものから最大でこの件数を ready にします。 |
| 出力フィールド | 型 | 意味 |
|---|---|---|
enqueued |
int |
抽出ワーカー向けに crystallize:ready とマークされたオブザベーションの数。保留中のものがなかった場合は 0。 |
session_id |
str |
行が属するセッションまたは会話。なしの場合は '-'。 |
observe.record
ツールのオブザベーション(入力、出力、ファイル、エラー)を 1 件、エピソードプレーンに記録します。LLM 呼び出しはありません。
POST /v1/observe.record · MCP loom_observe_record · role writer · idempotent
| 入力フィールド | 型 | デフォルト | 意味 |
|---|---|---|---|
org |
str |
必須 | テナント(アイデンティティタプルの最初の要素)。 |
namespace |
str |
必須 | オペレーションが読み書きする名前空間。 |
agent |
str |
必須 | 書き込みまたは読み取りを行うエージェント。オペレーションが許可する場合、'-' または '*' は任意のエージェントを意味します。 |
user_id |
str |
'-' |
行が属するエンドユーザー。なしの場合は '-'。 |
session_id |
str |
'-' |
行が属するセッションまたは会話。なしの場合は '-'。 |
run_id |
str |
'-' |
呼び出しが属するエージェントの実行(タスクのスコープ)。なしの場合は '-'。 |
tool_name |
str |
必須 | 実行されたツールの名前。部分文字列の一致によってオブザベーションの kind が決まります。 |
tool_input |
dict[str, Any] \| list[Any] \| str \| int \| float \| bool \| None |
None |
フックから転送される任意の JSON。文字列化して切り詰められ、実行されることはありません。 |
tool_output |
dict[str, Any] \| list[Any] \| str \| int \| float \| bool \| None |
None |
ツールが返した内容。文字列化され、ナラティブでは 800 文字に切り詰められます。 |
file_paths |
list[str] |
(算出) | 入力やナラティブから検出されたパスとマージされます。 |
error |
str \| None |
None |
呼び出しが失敗した場合にのみ指定されます。オブザベーションの種別を error に再分類します。 |
tags |
list[str] |
(算出) | サーバー自身のタグ(observation、種別、ファイルのベース名)の後に追加される任意のタグ。保持されるタグは合計で最大 32 個です。 |
observation_date |
str |
'' |
valid_at として記録される ISO 形式 YYYY-MM-DD。空の場合は NULL のままにします。 |
action_type |
str |
'' |
クライアント独自のアクション分類(file_read、command_run など)。action:<type> タグとして追加されます。 |
metadata |
dict[str, Any] |
(算出) | クライアントのコンテキスト(project、repo、event)。受け付けられますが、保存されません。 |
observed_at |
str |
'' |
ツールが実行された時刻。後から送信されたキャプチャも、実際に起きた時刻の日付になります。 |
| 出力フィールド | 型 | 意味 |
|---|---|---|
memory_key |
str |
エピソード行のキー(obs:<session_id>:<hash prefix>)。同じ呼び出しに対してフックが再度発火した場合も同じキーになります。 |
memory_id |
str |
常に空です。行の id はテーブルによって割り当てられ、読み戻されません。 |
kind |
str |
file_edit / command_run / error / web_fetch / file_read / tool_use。 |
tags |
list[str] |
行に保存されたタグ(最大 32 個)。 |
file_paths |
list[str] |
行に保存されたファイルパス。送信されたものに加え、入力とナラティブから検出されたものを含みます。自己参照の呼び出しでは空です。 |
content_sha256 |
str |
保存されたオブザベーションの値(kind、tool、ナラティブ、パス、エラー)のハッシュ。 |
tool_name |
str |
行が保持する内容。台帳では out_tool_name / out_has_error / out_narrative_chars として記録されます。ナラティブが 40 文字のものは、オブザベーションではなくツール名です。 |
has_error |
bool |
error が空でなかった場合は True(自己参照の呼び出しでは常に False)。 |
narrative_chars |
int |
保存されたナラティブの文字数(最大 2000)。 |
skipped_reason |
str |
行が内容なしで保存された理由。"self_referential"(ツールが loom 自身、またはハーネスのメタツールだった)、"blacklisted"(内容がブラックリストのパターンに一致した)。それ以外は ""。 |