Todas las herramientas

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

Enumera los agentes que trabajan actualmente en TODAS las máquinas del usuario en la malla: en qué máquina está cada uno, su función, repositorio, capacidades, su `status` (qué está haciendo AHORA MISMO, con `status_age_s` = cuántos segundos ese texto ha estado sin cambios), `last_activity_at` (la última vez que llamó a la malla) y `expires_at` (cuándo sale de esta lista si permanece inactivo). Utilice `status` + `last_activity_at` para distinguir a un compañero que trabaja de uno estancado antes de decidir con quién interactuar. Úselo antes de comenzar un trabajo pesado (un lanzamiento, una refactorización amplia, una implementación) para ver quién más está activo y advertirles con agent_send, y para obtener el `handle` al que dirige un mensaje. `alive` significa que hubo una llamada a la malla dentro de su propio `ttl_seconds`; cualquier llamada cuenta, no solo agent_checkin; NO "es accesible ahora": un agente que se detuvo (o cuya máquina apagó la malla) todavía aparece como activo hasta que expire su entrada. Un mensaje enviado en esa ventana se acepta y se almacena, y simplemente nunca se lee. Si un par no responde, vuelva a ejecutar esto antes de concluir nada; es posible que su entrada haya caducado desde entonces.

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.

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

Enumera los agentes que trabajan actualmente en TODAS las máquinas del usuario en la malla: en qué máquina se encuentra cada uno, su función, repositorio y capacidades. Úselo antes de comenzar un trabajo pesado (un lanzamiento, una refactorización amplia, una implementación) para ver quién más está activo y advertirles con agent_send, y para obtener el `handle` al que dirige un mensaje. `alive` significa que hubo una llamada a la malla dentro de su propio `ttl_seconds`; cualquier llamada cuenta, no solo agent_checkin; NO "es accesible ahora": un agente que se detuvo (o cuya máquina apagó la malla) todavía aparece como activo hasta que su entrada expire. Un mensaje enviado en esa ventana se acepta y se almacena, y simplemente nunca se lee. Si un par no responde, vuelva a ejecutar esto antes de concluir nada; es posible que su entrada haya caducado desde entonces.

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.

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"
    }
  },
  "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.

{}