未翻訳のページは英語で開き、英語と表示されます。
このページは英語の原文の機械翻訳です。内容は英語の原文が優先されます。 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 形式のガイド。スキルのフロントマターは含みません。 |