未翻訳のページは英語で開き、英語と表示されます。
このページは英語の原文の機械翻訳です。内容は英語の原文が優先されます。 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] |
新しいグラフから導出された線形のステップ一覧。 |