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 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.