未翻訳のページは英語で開き、英語と表示されます。
このページは英語の原文の機械翻訳です。内容は英語の原文が優先されます。 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 |
後続の操作を示すプレーンテキストのヒント。 |