コンテンツにスキップ

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

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

decision オペレーション

各 decision.* オペレーションが受け取るフィールドと返すフィールドを正確に示します。

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

decision.chain

決定の因果連鎖をたどります。上流(その決定を引き起こした、または影響を与えたもの)と下流(その決定が引き起こしたもの)のどちらか、または両方を、作成済みのグラフ上で最大 4 ホップまでたどります。

POST /v1/decision.chain · MCP loom_decision_chain · role viewer · read · MCP の all ツールセットには含まれません

入力フィールド 型 デフォルト 意味
org str 必須 テナント(識別タプルの最初の要素)。
namespace str 必須 op が読み取りまたは書き込みを行う名前空間。
memory_key str 必須 たどり始めるキー。通常は決定のキーです。
direction Literal['upstream', 'downstream', 'both'] 'both' upstream はここに至った原因を、downstream はここから生じた結果をたどります。both は両方をたどります。
max_hops int 3 たどるエッジの数。1〜4。
出力フィールド 型 意味
seed str 開始キー(そのまま返されます)。
seed_decision DecisionRow \| None シードの決定レコード。シードが有効な決定でない場合は null。
nodes list[ChainNodeRow] caused、influenced、derived_from のエッジをたどって到達したすべてのキー。各キーは 1 回だけ含まれ、近いホップから順に並びます。

decision.outcome

現実の結果が出たあとに決定のループを閉じます。実際に何が起きたか、またそれがうまくいったか(success)を記録します。

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

入力フィールド 型 デフォルト 意味
org str 必須 テナント(アイデンティティタプルの最初の要素)。
namespace str 必須 この op が読み書きする名前空間。
memory_key str 必須 更新対象の有効な決定。該当する決定がない場合、またはレコードの書き込み元に、このキーの有効な決定行がない場合は 404 を返します。
realized_outcome str 必須 実際に起きたこと。決定レコードに保存されます。
success bool \| None None None の場合はレコードの判定をそのまま維持します。True/False を指定すると判定を設定し、決定を下した run のメモリにクレジットを付与(またはマーク)します。
agent str '*' 書き込みまたは読み取りを行うエージェント。'-' または '*' は、op が許可する場合に任意のエージェントを意味します。
出力フィールド 型 意味
memory_key str 決定のキー(そのまま返されます)。
updated bool 常に true です。決定が存在しない場合は代わりに 404 を返します。
memories_credited int run 台帳を通じてクレジットされたメモリの数(run.complete の memories_used)。

decision.precedents

決定を下す前に、似た状況で何が決定されたかを確認します。過去の決定に対するセマンティック検索(カテゴリを指定することも可能)で、それぞれの決定について、その理由、却下された代替案、そして判明している場合は…

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

入力フィールド 型 デフォルト 意味
org str 必須 テナント(識別タプルの最初の要素)。
namespace str 必須 この op が読み書きする名前空間。
agent str '*' 書き込みまたは読み取りを行うエージェント。'-' または '*' は、op が許可する場合に任意のエージェントを意味します。
query str 必須 決定を下すエージェントから見た、現在のシナリオ。
category str '' このカテゴリの決定のみを対象にします(大文字と小文字を区別しません)。"" の場合は全カテゴリを検索します。
top_k int 5 返す先例の最大件数。1〜25。
with_outcome_only bool False 実現した結果が判明している決定のみを対象にします(decision.outcome が呼び出されたもの)。
出力フィールド 型 意味
precedents list[DecisionRow] 有効な過去の決定。決定内容が最も類似するものが先頭になります。
embedding_model str 内部のメモリ検索が使用したエンベッダー。

decision.record

DECISION を第一級のオブジェクトとして記録します。後で影響する選択(ベンダー、設計、修正、ロールバックなど)で選択肢のうちどれかを選ぶたびに呼び出してください。

POST /v1/decision.record · MCP loom_decision_record · ロール writer · 冪等 · 監査対象 · MCP の all ツールセットには含まれません

入力フィールド 型 デフォルト 意味
org str 必須 テナント(ID タプルの最初の要素)。
namespace str 必須 この op が読み書きする名前空間。
agent str 必須 書き込みまたは読み取りを行うエージェント。op が許す場合、'-' または '*' は任意のエージェントを意味します。
user_id str '-' 行が属するエンドユーザー。なしの場合は '-'。
session_id str '-' 行が属するセッションまたは会話。なしの場合は '-'。
run_id str '-' この decision が行われた run(run.begin)。
category str 必須 category と scenario で decision が識別されます。同じ scenario を再度決定すると、以前の記録は置き換えられます(履歴には残ります)。
scenario str 必須 決定が必要だった状況。decision.precedents はクエリを decision の statement と照合し、statement は scenario で始まります。
reasoning str 必須 この結果を選んだ理由。
outcome str 必須 決定した内容。
alternatives list[str] (算出) 検討したが選ばれなかったもの。「なぜ X ではないのか」という質問に必要でありながら、多くの decision ログに欠けているフィールドです。
confidence float 0.0 決定者の確信度(0〜1)。0 は記録なしを意味します(その場合、メモリ行とエッジは 1.0 を持ちます)。
stage Literal['decided', 'proposed'] 'decided' "decided"(デフォルト)、または、まだ選ばれても実装されてもいない案(提案、計画、アクションアイテム)を示す "proposed"。memory.set の proposed(検証中の事実)とは無関係です。
decision_maker str '' 決定した人またはエージェント。"" の場合は呼び出し元の agent を記録します。
caused_by list[str] (算出) この decision の原因となった、または影響を与えた memory_key(decision、事実、手順)。それぞれが、この呼び出しを根拠とする作成済みエッジ(memory.link)になります。
influenced_by list[str] (算出) 原因とはならずに decision を形作ったキー。それぞれが influenced エッジになります。
tags list[str] (算出) decision と decision:category:<category> に加えて、メモリ行に付ける追加のタグ。ここに decision:proposed タグを指定しても無視されます(stage で設定してください)。
valid_at datetime \| None None decision が有効になった実世界の時刻。None の場合は現在。
files list[str] \| None None この decision が適用されるリポジトリのファイル(リポジトリ相対パスまたはファイル名のみ)。memory.for_file は、それらのファイルを編集する前にこの decision を返します。
source_class Literal['derived', 'external', 'imported'] \| None None この decision が他のコンテンツから導出された(derived)、または外部から来た(external、imported)ことを宣言します。
source_resource_id str '' この decision の取得元のファイルパス、ドキュメント ID または URL。ヒットに引用されます。
出力フィールド 型 意味
memory_key str category + scenario から導出される decision のキー。decision.outcome と decision.chain に渡します。
record_id str 書き込まれた decision レコードバージョンの ID。
superseded_prior bool 同じ category + scenario の有効な decision が存在し、今回の decision に置き換えられた場合は True。
edges_written int 書き込まれた caused / influenced エッジの数。リンクに失敗したものはスキップされます。
next str 後続の操作を示すプレーンテキストのヒント。