Las páginas sin traducir se abren en inglés y se indican como inglés.
Esta página es una traducción automática de la página en inglés, que prevalece. Machine-translated from the English page, which is authoritative.
Operaciones de mentor
Los campos exactos que recibe y devuelve cada operación mentor.*.
Cada op es POST /v1/<op> sobre HTTP y la herramienta MCP loom_<op>. Los campos de identidad (org, namespace, agent, user_id, session_id) se rellenan a partir del token y de la sesión MCP cuando el transporte puede hacerlo; en una llamada HTTP sin token en un servidor de un solo usuario, se usa la org de la instalación en todas las ops salvo code.* y tracker.* (que conservan la de su plano), y en algunas ops también su espacio de nombres y su agente; consulta identidades y espacios de nombres. El índice de operaciones explica el rol, el tipo y el listado all de MCP. Los campos de entrada desconocidos se atienden y se nombran en ignored_args.
mentor.brief
El perfil de uso de un agente y las sugerencias del almacén.
POST /v1/mentor.brief · MCP loom_mentor_brief · rol viewer · lectura
| Campo de entrada | Tipo | Valor por defecto | Significado |
|---|---|---|---|
org |
str |
obligatorio | El tenant (primer elemento de la tupla de identidad). |
namespace |
str |
obligatorio | El espacio de nombres que la op lee o escribe. |
agent |
str |
'' |
El agente que escribe o lee; '-' o '*' significa cualquier agente donde la op lo permita. |
window_seconds |
int |
604800 |
Hasta dónde llega hacia atrás la lectura del registro, en segundos; de 1 hora a 90 días. |
| Campo de salida | Tipo | Significado |
|---|---|---|
org |
str |
El tenant (primer elemento de la tupla de identidad). |
namespace |
str |
El espacio de nombres que la op lee o escribe. |
agent |
str |
El agente que escribe o lee; '-' o '*' significa cualquier agente donde la op lo permita. |
window_seconds |
int |
La ventana sobre la que se calculó el perfil, en segundos; un perfil servido desde la caché conserva la ventana con la que se calculó. |
computed_at |
datetime |
Cuándo se calculó el perfil (UTC); anterior a la llamada cuando se sirve desde la caché. |
sessions |
int |
Sesiones distintas con nombre de cliente de este agente en la ventana (- y * no cuentan). |
usage |
dict[str, int] |
Llamadas por operación de este agente en la ventana. |
planes |
list[MentorPlane] |
Cada plano que el mentor conoce, con las llamadas de este agente a él y si está disponible. |
hints |
list[MentorHint] |
Las reglas que se activaron para este agente, cada una con los recuentos que la activaron; vacío si no hay ninguna. |
adoption |
list[MentorAdoption] |
Por código de sugerencia, las sesiones en las que se mostró y en las que se siguió, de más a menos mostrada; vacío si ninguna sugerencia llegó al agente o la lectura falló. |
usage_evidence |
list[UsageRung] |
El uso de Loom por parte del agente en la ventana, un peldaño cada uno, de la afirmación más débil a la más fuerte: desde una llamada realizada hasta una ejecución evaluada. |
ledger_from |
datetime \| None |
La fila más antigua del registro de este agente en la ventana, de cualquier tipo; None cuando no hay ninguna o la lectura falló. |
ledger_retention_days |
int \| None |
Días que la retención configurada conserva las filas del registro de llamadas de este espacio de nombres; 0 las conserva hasta que se borren, None cuando la lectura falló. |
agents |
list[str] |
Los agentes que escriben en el espacio de nombres en la ventana, del más activo al menos; el brief usa por defecto el primero cuando quien llama no tiene un nombre de agente propio (el dashboard); agent_defaulted lo indica. |
agent_defaulted |
bool |
True cuando quien llama no indicó ningún agente real y el brief eligió al principal escritor de agents. |
skipped |
list[str] |
Datos que el brief no pudo leer, con el formato "paso: motivo". |
healthy |
bool |
No hay ninguna sugerencia de advertencia ni crítica. |
mentor.guide
La guía del agente que distribuye este servidor; es la misma para todos los que llaman.
POST /v1/mentor.guide · MCP loom_mentor_guide · rol viewer · lectura · no aparece en el conjunto de herramientas all de MCP
| Campo de entrada | Tipo | Valor por defecto | Significado |
|---|---|---|---|
org |
str |
'' |
El tenant (primer elemento de la tupla de identidad). |
part |
Literal['skill', 'reference', 'all'] |
'skill' |
Qué parte: skill (el bucle y las reglas, el valor por defecto), reference (cada plano) o all. |
| Campo de salida | Tipo | Significado |
|---|---|---|
version |
str |
La versión de la guía (metadata.version de skills/loom/SKILL.md). |
part |
Literal['skill', 'reference', 'all'] |
La parte devuelta, tal como se pidió. |
text |
str |
La guía en Markdown, sin el frontmatter de la skill. |