mentor 操作
mentor 操作
本页由机器从英文原文翻译,内容以英文原文为准。 Machine-translated from the English page, which is authoritative.
每个 mentor.* 操作所接受和返回的确切字段。
每个操作都是 HTTP 上的 POST /v1/<op>,同时也是 MCP 工具 loom_<op>。身份字段(org、namespace、agent、user_id、session_id)在传输层能够提供时,会根据令牌和 MCP 会话自动填充;对于单用户服务器上不带令牌的 HTTP 调用,除 code.* 和 tracker.*(它们保留各自平面的组织)之外,所有操作都使用该安装的 org,而部分操作还会使用其命名空间和 agent;参见身份与命名空间。操作索引说明了角色、类型以及 MCP 的 all 列表。未知的输入字段会照常处理,并列在 ignored_args 中。
mentor.brief
某个 agent 的使用画像以及存储提示。
POST /v1/mentor.brief · MCP loom_mentor_brief · 角色 viewer · 读取
| 输入字段 | 类型 | 默认值 | 含义 |
|---|---|---|---|
org |
str |
必填 | 租户(身份元组的第一个元素)。 |
namespace |
str |
必填 | 该操作读取或写入的命名空间。 |
agent |
str |
'' |
写入或读取的 agent;'-' 或 '*' 表示在操作允许时的任意 agent。 |
window_seconds |
int |
604800 |
读取账本时向前回溯的时长,单位为秒;范围为 1 小时到 90 天。 |
| 输出字段 | 类型 | 含义 |
|---|---|---|
org |
str |
租户(身份元组的第一个元素)。 |
namespace |
str |
该操作读取或写入的命名空间。 |
agent |
str |
写入或读取的 agent;'-' 或 '*' 表示在操作允许时的任意 agent。 |
window_seconds |
int |
计算画像所用的时间窗口,单位为秒;从缓存返回的画像沿用其计算时的窗口。 |
computed_at |
datetime |
画像的计算时间(UTC);从缓存返回时早于本次调用。 |
sessions |
int |
该 agent 在窗口内由客户端命名的不同会话数(不计 - 和 *)。 |
usage |
dict[str, int] |
该 agent 在窗口内对各操作的调用次数。 |
planes |
list[MentorPlane] |
mentor 已知的所有平面,包含该 agent 对每个平面的调用次数以及该平面是否可用。 |
hints |
list[MentorHint] |
针对该 agent 触发的规则,每条附带触发它的计数;没有则为空。 |
adoption |
list[MentorAdoption] |
按提示代码统计其被展示的会话数和被采纳的会话数,展示最多的排在最前;没有提示到达该 agent 或读取失败时为空。 |
usage_evidence |
list[UsageRung] |
该 agent 在窗口内对 Loom 的使用情况,每级一项,从最弱的说明开始:从发起过一次调用到完成一次评分运行。 |
ledger_from |
datetime | None |
该 agent 在窗口内最早的账本行,不论类型;没有账本行或读取失败时为 None。 |
ledger_retention_days |
int | None |
已配置的保留策略对该命名空间的调用账本行的保留天数;0 表示保留到被删除,读取失败时为 None。 |
agents |
list[str] |
该命名空间在窗口内的写入者,最活跃的排在最前;调用方没有自己的 agent 名称时(如控制台),简报默认取第一个,agent_defaulted 会标明这一点。 |
agent_defaulted |
bool |
调用方没有指定真实的 agent,简报选取了 agents 中写入最多的 agent 时为 True。 |
skipped |
list[str] |
简报无法读取的事项,格式为 “step: reason”。 |
healthy |
bool |
没有警告级或严重级的提示。 |
mentor.guide
此服务器附带的 agent 指南;对所有调用方都相同。
POST /v1/mentor.guide · MCP loom_mentor_guide · 角色 viewer · 读取 · 不在 MCP all 工具集中列出
| 输入字段 | 类型 | 默认值 | 含义 |
|---|---|---|---|
org |
str |
'' |
租户(身份元组的第一个元素)。 |
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 格式的指南,不含 skill 的 frontmatter。 |