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 agents
Los campos exactos que recibe y devuelve cada operación agents.*.
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 completan a partir del token y de la sesión MCP cuando el transporte puede hacerlo; en una llamada HTTP sin token a un servidor de un solo usuario, se usa la org de la instalación en todas las ops excepto 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.
agents.connected
Los agentes activos en una ventana: última vez visto, operaciones y costo por agente.
POST /v1/agents.connected · MCP loom_agents_connected · 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 \| None |
None |
Vacío → resumen de toda la org en todos los espacios de nombres que el llamador puede ver. |
window_hours |
int |
24 |
Cuánto tiempo atrás se consulta. 24 h es el valor adecuado para comprobar si un reinicio surtió efecto; auméntalo para inspeccionar tendencias. |
count_only |
bool |
False |
La insignia de la barra lateral necesita un solo número (cuántos agentes se vieron por primera vez dentro de la ventana e hicieron algo), no la fila de cada agente. |
| Campo de salida | Tipo | Significado |
|---|---|---|
rows |
list[ConnectedAgent] |
Una fila por cada agente visto en la ventana, del visto más recientemente al más antiguo; vacío con count_only o cuando el llamador no puede leer ningún espacio de nombres de la org. |
window_hours |
int |
El período de consulta que cubren las filas, en horas (repite el de la solicitud). |
new_count |
int \| None |
Con count_only, el número de agentes vistos por primera vez dentro de la ventana con al menos una op; None en caso contrario. |