Saltar a contenido

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.