agents_list
Malla de agentes · macOS · Windows
Efecto: lectura. Estado: disponibilidad controlada.
«Disponibilidad controlada» significa que la herramienta figura en los artefactos publicados y puede depender de versión, plataforma, permisos, cuenta o configuración. Esta referencia no promete que esté activa en todas las instalaciones. Que una herramienta figure para macOS no implica que esté disponible en Windows, ni al revés.
macOS
Propósito
Lista los agentes que están trabajando ahora en TODAS las máquinas del usuario en la malla: en qué máquina está cada uno, su rol, repositorio, capacidades, su `status` (lo que está haciendo EN ESTE MOMENTO, con `status_age_s` = cuántos segundos lleva ese texto sin cambiar), `last_activity_at` (la última vez que llamó a la malla, por cualquier motivo) y `expires_at` (cuándo sale de esta lista si sigue en silencio). Usa `status` + `last_activity_at` para distinguir un par que está trabajando de uno trabado antes de decidir con quién interactuar. Úsala antes de empezar un trabajo pesado (una release, una refactorización amplia, un despliegue) para ver quién más está activo y avisarle con agent_send, y para obtener el `handle` al que diriges un mensaje. `alive` significa «llamó a la malla dentro de su propio ttl_seconds» (cuenta cualquier llamada, no solo agent_checkin), NO «está accesible ahora»: un agente que se detuvo (o cuya máquina apagó la malla) sigue figurando como alive hasta que su entrada caduca. Un mensaje enviado en ese intervalo se acepta y se guarda, y simplemente nunca se lee. Si un par no responde, vuelve a ejecutar esto antes de sacar conclusiones: puede que su entrada ya haya caducado.
Entradas obligatorias
El esquema de esta plataforma no declara entradas obligatorias. Aun así, pueden existir selectores opcionales o requisitos de ejecución.
Permisos y confirmación
El esquema no declara un parámetro explícito de confirmación. Esto no autoriza a actuar sin permiso: revisa el efecto y obtén autorización antes de una llamada real.
- Utilice únicamente las aplicaciones, cuentas y recursos autorizados por el usuario en esta plataforma. Consulte la descripción específica de la plataforma de esta herramienta para conocer sus requisitos de conexión y permisos. Este catálogo no afirma alcances OAuth adicionales ni derechos de sistema operativo.
Esquema técnico canónico en inglés — macOS
{
"properties": {
"agent_id": {
"description": "Your own agent_id. Reading the directory counts as activity, so passing it also renews YOUR presence; omit it and nobody is renewed.",
"type": "string"
},
"include_stale": {
"description": "Also list agents whose entry expired (default false)",
"type": "boolean"
}
},
"required": [],
"type": "object"
}Ejemplo documental
Ejemplo de documentación para agents_list. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.
{}Windows
Propósito
Lista los agentes que están trabajando ahora en TODAS las máquinas del usuario en la malla: en qué máquina está cada uno, su rol, repositorio, capacidades, su `status` (lo que está haciendo EN ESTE MOMENTO, con `status_age_s` = cuántos segundos lleva ese texto sin cambiar), `last_activity_at` (la última vez que llamó a la malla, por cualquier motivo) y `expires_at` (cuándo sale de esta lista si sigue en silencio). Usa `status` + `last_activity_at` para distinguir un par que está trabajando de uno trabado antes de decidir con quién interactuar. Úsala antes de empezar un trabajo pesado (una release, una refactorización amplia, un despliegue) para ver quién más está activo y avisarle con agent_send, y para obtener el `handle` al que diriges un mensaje. `alive` significa «llamó a la malla dentro de su propio ttl_seconds» (cuenta cualquier llamada, no solo agent_checkin), NO «está accesible ahora»: un agente que se detuvo (o cuya máquina apagó la malla) sigue figurando como alive hasta que su entrada caduca. Un mensaje enviado en ese intervalo se acepta y se guarda, y simplemente nunca se lee. Si un par no responde, vuelve a ejecutar esto antes de sacar conclusiones: puede que su entrada ya haya caducado.
Entradas obligatorias
El esquema de esta plataforma no declara entradas obligatorias. Aun así, pueden existir selectores opcionales o requisitos de ejecución.
Permisos y confirmación
El esquema no declara un parámetro explícito de confirmación. Esto no autoriza a actuar sin permiso: revisa el efecto y obtén autorización antes de una llamada real.
- Utilice únicamente las aplicaciones, cuentas y recursos autorizados por el usuario en esta plataforma. Consulte la descripción específica de la plataforma de esta herramienta para conocer sus requisitos de conexión y permisos. Este catálogo no afirma alcances OAuth adicionales ni derechos de sistema operativo.
Esquema técnico canónico en inglés — Windows
{
"properties": {
"agent_id": {
"description": "Your own agent_id. Reading the directory counts as activity, so passing it also renews YOUR presence; omit it and nobody is renewed.",
"type": "string"
},
"include_stale": {
"description": "Also list agents whose entry expired (default false)",
"type": "boolean"
},
"limit": {
"description": "Most agents to return (default 50, max 200). Live agents come first; when more exist the reply says truncated and the total.",
"type": "integer"
}
},
"type": "object"
}Ejemplo documental
Ejemplo de documentación para agents_list. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.
{}