コンテンツにスキップ

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

このページは英語の原文の機械翻訳です。内容は英語の原文が優先されます。 Machine-translated from the English page, which is authoritative.

procedure オペレーション

各 procedure.* オペレーションが受け取るフィールドと返すフィールドの詳細です。

すべてのオペレーションは、HTTP では POST /v1/<op>、MCP ツールでは loom_<op> として呼び出せます。ID フィールド(org、namespace、agent、user_id、session_id)は、トランスポートが対応している場合、トークンと MCP セッションから補完されます。単一ユーザーサーバーでトークンなしに HTTP 呼び出しを行うと、code.* と tracker.*(それぞれのプレーンの org を保持します)を除くすべてのオペレーションでインストールの org が補完され、一部のオペレーションでは名前空間とエージェントも補完されます。詳しくは ID と名前空間を参照してください。オペレーション索引では、ロール、種別、MCP の all 一覧について説明しています。未知の入力フィールドは処理され、ignored_args に名前が記載されます。

procedure.add

手続きメモリを登録します。構造化されたフィールド(name、situation、steps)を持つ「X のやり方」のレシピです。

POST /v1/procedure.add · MCP loom_procedure_add · ロール writer · 書き込み

入力フィールド 型 デフォルト 意味
org str 必須 テナント(識別タプルの最初の要素)。
namespace str 必須 op が読み書きする名前空間。
agent str '-' 書き込みまたは読み取りを行うエージェント。'-' または '*' は、op が許す場合に任意のエージェントを意味します。
user_id str '-' 行が属するエンドユーザー。なしの場合は '-'。
session_id str '-' 行が属するセッションまたは会話。なしの場合は '-'。
name str 必須 手続きの名前。メモリキーは procedure_<slug of name> になるため、同じ名前を指定すると上書きされます。
situation str 必須 手続きが適用される状況(その前提条件)。このテキストが procedure.match の判定に使われます。
steps list[str] 必須 2 つ以上必要です。ステップが 1 つだけの場合は手続きではなく教訓として扱われます(マイナーも同じ基準を採用しています)。
tags list[str] (算出) 手続きに保存される呼び出し側のタグ。行にはタグ procedure も付与されます。
metadata dict[str, Any] (算出) 任意の構造化メタデータ(キーと値の形式の前提条件、期待される出力など)。
graph dict[str, Any] \| None None 任意の実行可能グラフ(ノード = ステップ / メモリ / 統合 / 判断、エッジ = dep / dataflow / branch)。
出力フィールド 型 意味
memory_key str 手続き行のキー(procedure_<slug>)。
memory_id str 書き込まれたメモリバージョンの ID。
version int 書き込まれた行のバージョン番号。

procedure.evolve

プロシージャに蓄積された実行トレースを統合し、改善されたグラフを生成します。成功したトラバースの回数で実証済みのパスを順位付けし、どの実行でも使われなかったステップをデッドエンドとしてフラグ付けし、…に位置するステップと遷移をフラグ付けします。

POST /v1/procedure.evolve · MCP loom_procedure_evolve · ロール writer · 書き込み · MCP の all ツールセットには含まれません

入力フィールド 型 デフォルト 意味
org str 必須 テナント(identity タプルの最初の要素)。
namespace str 必須 この op が読み書きする名前空間。
agent str '-' 書き込みまたは読み取りを行うエージェント。op が許す場合、'-' または '*' は任意のエージェントを意味します。
user_id str '-' 行が属するエンドユーザー。なしの場合は '-'。
session_id str '-' 行が属するセッションまたは会話。なしの場合は '-'。
memory_key str 必須 evolve 対象のプロシージャのキー(procedure_<slug>)。
min_runs int 3 枝刈りが根拠に基づいて動作するために必要な、統合済みの実行の最小数。
gate_mode Literal['sprt', 'margin'] 'sprt' 保留中のリビジョンに対する受け入れゲート。
gate_min_runs int 3 判定を下す前に、検証中のリビジョンで必要な実行数。
gate_margin float 0.05 margin モード:リバートの対象となる成功率の低下幅。
gate_min_drop float 0.15 sprt モード:リバートに値する低下幅、誤り率、およびこれを超えると点推定で判定する実行数。
gate_alpha float 0.05 sprt モード:誤ってリバートする誤り率。低いほど、リバートする前により多くの根拠が必要です。
gate_beta float 0.2 sprt モード:低下を見逃す誤り率。低いほど、受け入れる前により多くの根拠が必要です。
gate_max_runs int 50 sprt モード:リビジョンでこの実行数に達すると点推定で判定します。
strike_limit int \| None None プロシージャを隔離する連続失敗実行数。None = LOOM_PROCEDURE_STRIKE_LIMIT(3)、0 = 隔離しない。
gate_cost_tolerance float 0.25 受け入れ済みリビジョンに対するコストのタイブレーク:成功した実行のコストが前のリビジョンより この割合を超えて高い場合にリバートします(所要時間、ステップ数、トークンのうち、両側が報告している最初のもの)。両側とも gate_cost_min_samples 件のコスト付き成功が必要です…
gate_cost_min_samples int \| None None コストチェックのために各側で必要な、コスト付きの成功実行数。None = gate_min_runs。
出力フィールド 型 意味
memory_key str evolve されたプロシージャのキー。
version int この呼び出しが書き込んだプロシージャ行のバージョン。
revision int この呼び出し後のプロシージャのトポロジーリビジョン(リバートすると新しいリビジョンが開始されます)。
changed bool この呼び出しでグラフのフラグまたは隔離状態が変化した場合に True。
template bool プロシージャが再利用可能なテンプレート(安定しており、ほとんど成功し、隔離されていない)になった場合に True。
folded_runs int この呼び出しでグラフに統合された台帳の行数。
gate Literal['none', 'undecided', 'accept', 'revert'] 保留中のリビジョンに対する受け入れゲート:none(保留なし)、undecided(実行数がまだ不足)、accept、revert。
gate_mode str 使用されたゲートモード(sprt または margin)。保留中のリビジョンがなかった場合は ""。
gate_llr float sprt:累積対数尤度比(正の値は「リビジョンによって悪化した」ことを支持)。境界を越えると判定が下されます。
gate_before dict[str, int] {total, ok} 前のリビジョン
gate_after dict[str, int] {total, ok} 検証中のリビジョン
gate_cost_before dict[str, float] 各側の成功した実行のコストの中央値、および成功ゲートを通過したリビジョンがそれでもリバートされた理由("cost")。
gate_cost_after dict[str, float] 検証中のリビジョンで成功した実行のコストの中央値。
gate_reason str リバート時は success または cost。それ以外は ""。
dead_end_steps list[str] 統合済みのどの実行にもトラバースされなかったステップのテキスト(線形の steps から降格されたもの)。
fail_prone_steps list[str] 結果の対比:失敗した実行に偏って現れるステップ/遷移(失敗の割合 >= プロシージャ全体の基準失敗率 + マージン、かつ実行数が十分なもの)。
fail_prone_transitions list[str] 失敗した実行に偏って現れる遷移。src -> dst のノード ID で表します。
run_stats dict[str, int] この呼び出し後の、プロシージャの統合済み {total, ok}。
strikes int トレースログの末尾における連続失敗実行数、およびプロシージャがストライクアウトされているかどうか。
quarantined bool プロシージャがストライクアウトされた場合に True(strike_limit を参照)。
retention dict[str, float] トレースログにおける成功の保持:最初の実行が成功した連続する実行のペア数、そのうち次も成功した数、およびその割合。

procedure.fork

呼び出し元が読み取れる名前空間から、リクエストの名前空間へプロシージャをコピーし、エビデンスをリセットします。

POST /v1/procedure.fork · MCP loom_procedure_fork · ロール writer · 書き込み · 監査対象 · MCP の all ツールセットには含まれません

入力フィールド 型 デフォルト 意味
org str 必須 テナント(識別タプルの最初の要素)。
namespace str 必須 コピー先(リクエストの名前空間。WRITER はオペレーションが強制します)
agent str '-' 書き込みまたは読み取りを行うエージェント。'-' または '*' は、オペレーションが許可する場合に任意のエージェントを意味します。
user_id str '-' 行が属するエンドユーザー。なしの場合は '-'。
session_id str '-' 行が属するセッションまたは会話。なしの場合は '-'。
from_namespace str 必須 コピー元の名前空間。呼び出し元にはその読み取り権限が必要です。
from_org str '' デフォルトは org
memory_key str 必須 from_namespace 内でコピーするプロシージャのキー。
new_name str '' コピー時に名前を変更します(メモリキーは名前から導出されます)。
reason str '' プロシージャを採用した理由。forked_from に保持されます。
出力フィールド 型 意味
memory_key str コピー先の名前空間にある新しいプロシージャのキー。
version int 書き込まれた行のバージョン。
name str 新しいプロシージャの名前(new_name、またはコピー元の名前)。
steps list[str] コピーされたステップ。
forked_from dict[str, Any] 系譜情報:コピー元の org、名前空間、キー、リビジョン、ダイジェスト、テンプレートフラグ、実行統計、フォークした人、その理由、日時。

procedure.list

名前空間に登録されているプロシージャを列挙します(memory_key のプレフィックスまたはタグで絞り込めます)。

POST /v1/procedure.list · MCP loom_procedure_list · ロール viewer · 読み取り · MCP の all ツールセットには含まれません

入力フィールド 型 デフォルト 意味
org str 必須 テナント(アイデンティティタプルの最初の要素)。
namespace str 必須 op が読み書きする名前空間。
agent str '*' 書き込みまたは読み取りを行うエージェント。op が許す場合、'-' または '*' は任意のエージェントを意味します。
user_id str '-' 行が属するエンドユーザー。なしの場合は '-'。
session_id str '-' 行が属するセッションまたは会話。なしの場合は '-'。
prefix str '' キーが procedure_ + この値で始まるプロシージャのみ。"" の場合はすべて列挙します。
tags list[str] (算出) これらのタグのうち少なくとも 1 つを持つプロシージャのみ。空の場合はタグで絞り込みません。
limit int 50 読み取るプロシージャ行の最大数(サーバー側で 500 に制限されます)。
出力フィールド 型 意味
procedures list[_ProcedureSummary] 名前空間内のプロシージャ(名前、状況、タグ、キー、作成時刻)。

procedure.locate

この手順のどこにいるのか、次に何が来るのか。

POST /v1/procedure.locate · MCP loom_procedure_locate · ロール viewer · 読み取り · MCP の all ツールセットには含まれません

入力フィールド 型 デフォルト 意味
org str 必須 テナント(ID タプルの最初の要素)。
namespace str 必須 op が読み書きする名前空間。
agent str '*' 書き込みまたは読み取りを行うエージェント。op が許す場合、'-' または '*' は任意のエージェントを意味します。
user_id str '-' 行が属するエンドユーザー。なしの場合は '-'。
session_id str '-' 行が属するセッションまたは会話。なしの場合は '-'。
memory_key str 必須 エージェントが従っている手順のキー(procedure_<slug>)。
at str '' エージェントの現在位置:ノード ID、または直近の呼び出しのツール名。
recent_path list[str] (算出) この実行におけるエージェントの最近のノード ID またはツール名(古い順)。revisits と looping に使われます。
hops int 2 どこまで先を公開するか。次の判断には 2 で十分です。増やすとトークンも増えます。
include_notes bool True 先の遷移について、台帳にある最近の失敗ノートを付加します。
max_notes int 5 失敗ノートの最大数。0 の場合は付加しません。
出力フィールド 型 意味
memory_key str 読み取った手順のキー。
name str 手順の名前。
status Literal['template', 'exercised', 'authored', 'candidate', 'quarantined'] template、exercised、authored、candidate、quarantined のいずれか。
matched bool at(または recent_path の最後)がグラフのノードに一致する場合に True。
active dict[str, Any] \| None エージェントが現在いるノード。一致しない場合は None。
hops list[list[dict[str, Any]]] hops[0] = 1 ステップ先、hops[1] = 2 ステップ先、…(行き止まりは省略)。
entry_nodes list[str] 一致しない場合:入る辺を持たないノード ID。手順の開始点です。
dominant_next list[str] アクティブなノードから、実績のある経路上で次になるノード ID。
revisits dict[str, int] 軌跡ウィンドウ:この実行でのノードごとの訪問回数、アクティブなノードが再訪されているかどうか、そこからまだ通っていない出口。
looping bool アクティブなノードがすでに recent_path の前の方に現れている場合に True。
exits list[str] ループ中の場合:アクティブなノードから到達でき、この実行でまだ訪れていないノード ID。それ以外は空。
failure_notes list[dict[str, Any]] 先の遷移で失敗した実行に、エージェントが残したノート。
rendered str 上記の内容を決定的にテキスト化したもの。そのままプロンプトに組み込めます。
run_stats dict[str, int] 手順の集計済み {total, ok}。
for_agent dict[str, int] 呼び出したエージェントの {total, ok}。*、-、または実行がない場合は空。

procedure.match

呼び出し元が記述した状況に対して、situation フィールドが意味的に最も近い手順を検索します。

POST /v1/procedure.match · MCP loom_procedure_match · ロール viewer · 読み取り

入力フィールド 型 デフォルト 意味
org str 必須 テナント(ID タプルの最初の要素)。
namespace str 必須 op が読み書きする名前空間。
agent str '*' デフォルトのファンアウト — スコープ内の任意のエージェントの手順
user_id str '-' 行が属するエンドユーザー。なしの場合は '-'。
session_id str '-' 行が属するセッションまたは会話。なしの場合は '-'。
situation str 必須 エージェントが置かれている状態。各手順に保存されている situation と比較されます。
top_k int 5 検索される候補は最大でこの件数です(1–50)。フィルタにより、返る件数がそれより少なくなる場合があります。
tags list[str] (算出) これらのタグのうち少なくとも 1 つを持つ手順のみ。空の場合はタグによるフィルタなし。
namespace_scope Literal['this', 'all_mine'] 'all_mine' all_mine は呼び出し元自身の名前空間も検索します(ファンアウト上限まで)。this は namespace のみ検索します。
templates_only bool False true の場合、再利用可能なテンプレートに昇格した手順(実績があり、十分に実行されたワークフロートポロジー)のみを返します。
include_candidates bool True 候補とは、まだ一度も実行されておらず、かつ人間が作成していない手順です。
include_quarantined bool False 隔離された手順(直近 strike_limit 回の実行がすべて失敗したもの)は、指定しない限り除外されます。含める場合は、ラベル付きで最後に返されます。
recent_tools list[str] (算出) このタスクでエージェントが最近呼び出したツール。
tool_boost float 0.2 融合された score における tool_overlap の重み。0 の場合は recent_tools を無視します。
utility_weight float \| None None 融合スコアのうち、台帳から導出される有用性の項にかかる重み: score = similarity + tool_boost*overlap + weight * ((ok+1)/(total+2) - 0.5)。
goal str \| None None エージェントが追求している目的。エージェントが置かれている状態とは区別されます。
出力フィールド 型 意味
matches list[_ProcedureMatch] 一致した手順。ステータスのティア順(候補と隔離されたものは最後)、次に score 順。
matched int 台帳上のヒット率 — 一致した件数、最上位の手順とそのスコア(out_matched / out_procedure_key / out_score)。
procedure_key str 最上位の一致のメモリキー。一致がない場合は ""。
score float 最上位の一致の融合スコア。一致がない場合は 0。

procedure.record_run

プロシージャの1回の実行を報告し、実際にどの経路がうまく機能するかを loom が学習できるようにします。

POST /v1/procedure.record_run · MCP loom_procedure_record_run · ロール writer · 書き込み · MCP の all ツールセットには含まれません

入力フィールド 型 デフォルト 意味
org str 必須 テナント(ID タプルの最初の要素)。
namespace str 必須 op が読み書きする名前空間。
agent str '-' 書き込みまたは読み取りを行うエージェント。op が許可する場合、'-' または '*' は任意のエージェントを意味します。
user_id str '-' 行が属するエンドユーザー。なしの場合は '-'。
session_id str '-' 行が属するセッションまたは会話。なしの場合は '-'。
memory_key str 必須 実行されたプロシージャのキー(procedure_<slug>)。
path list[str] (算出) エージェントがこの実行で実際にたどったノード ID を順に並べたもの。
ok bool True 実行が成功したかどうか。
note str '' 実行に関する自由記述のメモ(失敗した理由など)。procedure.locate は失敗した実行のメモを表示します。
ts str '' 保存されません。台帳は各実行にサーバーの時刻を記録します。
steps_taken int \| None None 実行にかかったコスト。
duration_ms int 0 実行にかかった時間(ミリ秒)。0 は不明を意味します。
tokens int 0 実行で消費したトークン数。0 は不明を意味します。
出力フィールド 型 意味
memory_key str 実行が記録されたプロシージャのキー。
version int 常に 0。実行は台帳に書き込まれ、プロシージャの行は書き換えられません。
run_stats dict[str, int] この実行を含む {total, ok, unfolded}。unfolded は procedure.evolve がまだ取り込んでいない台帳上の実行の数です。

procedure.revise

プロシージャの編集後のトポロジーを提案します。あなたがリファイナーです。

POST /v1/procedure.revise · MCP loom_procedure_revise · ロール writer · 書き込み · 監査対象 · MCP の all ツールセットには含まれません

入力フィールド 型 デフォルト 意味
org str 必須 テナント(識別タプルの最初の要素)。
namespace str 必須 この op が読み書きする名前空間。
agent str '-' 書き込みまたは読み取りを行うエージェント。op が許可する場合、'-' または '*' は任意のエージェントを意味します。
user_id str '-' 行が属するエンドユーザー。なしの場合は '-'。
session_id str '-' 行が属するセッションまたは会話。なしの場合は '-'。
memory_key str 必須 改訂するプロシージャのキー(procedure_<slug>)。
graph dict[str, Any] 必須 提案するトポロジー(グラフ全体。変更しないノードは id を維持するため、統計が引き継がれます)。
reason str '' 理由:失敗した実行で何が判明したか、この編集で何を変更するか。
force bool False ゲートがすでに拒否したトポロジーでも提案します。
出力フィールド 型 意味
memory_key str 改訂されたプロシージャのキー。
version int この呼び出しが書き込んだプロシージャ行のバージョン。
revision int 新しいリビジョン番号。今後記録される実行はこの番号に対して集計されます。
prior_revision int 置き換えられるリビジョン(ゲートが差し戻した場合に復元されます)。
digest str 提案されたトポロジーのハッシュ。ゲートは拒否済みのトポロジーを識別するために使います。
steps list[str] 新しいグラフから導出された線形のステップ一覧。