コンテンツにスキップ

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

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

mentor オペレーション

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

すべてのオペレーションは、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 に名前が示されます。

mentor.brief

1 つのエージェントの利用プロファイルと、ストアからのヒント。

POST /v1/mentor.brief · MCP loom_mentor_brief · ロール viewer · 読み取り

入力フィールド 型 デフォルト 意味
org str 必須 テナント(ID タプルの最初の要素)。
namespace str 必須 オペレーションが読み書きする名前空間。
agent str '' 書き込みまたは読み取りを行うエージェント。オペレーションが許す場合、'-' または '*' は任意のエージェントを意味します。
window_seconds int 604800 台帳の読み取りがさかのぼる範囲(秒)。1 時間から 90 日まで。
出力フィールド 型 意味
org str テナント(ID タプルの最初の要素)。
namespace str オペレーションが読み書きする名前空間。
agent str 書き込みまたは読み取りを行うエージェント。オペレーションが許す場合、'-' または '*' は任意のエージェントを意味します。
window_seconds int プロファイルを算出した期間(秒)。キャッシュから返されたプロファイルは、算出時の期間を保持します。
computed_at datetime プロファイルを算出した時刻(UTC)。キャッシュから返された場合は、呼び出しより前の時刻になります。
sessions int 期間内にこのエージェントが持った、クライアントが名前を付けたセッションの数(重複なし。- と * は数えません)。
usage dict[str, int] 期間内にこのエージェントが呼び出した、オペレーションごとの回数。
planes list[MentorPlane] メンターが把握しているすべてのプレーン。このエージェントによる呼び出し回数と、利用可能かどうかを含みます。
hints list[MentorHint] このエージェントに対して発火したルール。それぞれ発火の根拠となったカウントを含み、なければ空です。
adoption list[MentorAdoption] ヒントコードごとに、表示されたセッション数と従われたセッション数。表示数の多い順です。ヒントがエージェントに届かなかった場合や、読み取りに失敗した場合は空です。
usage_evidence list[UsageRung] 期間内のエージェントによる Loom の利用状況。1 段ごとに、主張の弱いものから順に、呼び出しの実行から採点済みの実行までを示します。
ledger_from datetime \| None 期間内のこのエージェントの台帳で最も古い行(種類は問いません)。行がない場合や読み取りに失敗した場合は None。
ledger_retention_days int \| None 設定された保持期間が、この名前空間の呼び出し台帳の行を保持する日数。0 は削除されるまで保持を意味し、読み取りに失敗した場合は None。
agents list[str] 期間内のこの名前空間の書き込み元。活動の多い順です。呼び出し元が自身のエージェント名を持たない場合(ダッシュボードなど)、ブリーフは先頭を既定値とし、agent_defaulted がそれを示します。
agent_defaulted bool 呼び出し元が実在するエージェント名を指定せず、ブリーフが agents の最も活発な書き込み元を選んだ場合は True。
skipped list[str] ブリーフが読み取れなかった事実。「step: reason」の形式。
healthy bool 警告またはクリティカルのヒントがないこと。

mentor.guide

このサーバーが提供するエージェント向けガイド。どの呼び出し元に対しても同じ内容です。

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

入力フィールド 型 デフォルト 意味
org str '' テナント(ID タプルの最初の要素)。
part Literal['skill', 'reference', 'all'] 'skill' 返す部分。skill(ループとルール。デフォルト)、reference(各プレーン)、または all。
出力フィールド 型 意味
version str ガイドのバージョン(skills/loom/SKILL.md の metadata.version)。
part Literal['skill', 'reference', 'all'] 要求どおりに返された部分。
text str Markdown 形式のガイド。スキルのフロントマターは含みません。