agents_list

Maillage d’agents · macOS · Windows

Effet: lecture. État: disponibilité conditionnelle.

«Disponibilité conditionnelle» signifie que l’outil peut dépendre de la version, de la plateforme, des autorisations, du compte ou de la configuration. Il n’est pas forcément actif partout.

macOS

Objectif

Répertorie les agents travaillant actuellement sur les machines de l'utilisateur dans le maillage - sur quelle machine se trouve chacun, son rôle, son référentiel, ses capacités, son « status » (ce qu'il fait RIGHT NOW, avec « status_age_s » = combien de secondes ce texte est resté inchangé), « last_activity_at » (la dernière fois qu'il a appelé le mesh du tout) et `expires_at` (quand il disparaît de cette liste s'il reste silencieux). Utilisez `status` + `last_activity_at` pour distinguer un homologue qui travaille d'un homologue bloqué avant de décider avec qui interagir. Utilisez-le avant de commencer un travail fastidieux (une version, un large refactor, un déploiement) pour voir qui d'autre est actif et les avertir avec agent_send, et pour obtenir le « handle » auquel vous adressez un message. « alive » signifie « appelé le maillage dans son propre ttl_seconds » — tout appel compte, pas seulement agent_checkin — NOT « est joignable maintenant » : un agent qui s'est arrêté (ou dont la machine a désactivé le maillage) lit toujours alive jusqu'à l'expiration de son entrée. Un message envoyé dans cette fenêtre est accepté et stocké, et n'est tout simplement jamais lu. Si un homologue ne répond pas, réexécutez cette opération avant de conclure quoi que ce soit – son entrée a peut-être expiré depuis.

Entrées requises

Le schéma de cette plateforme ne déclare aucune entrée requise. Des sélecteurs facultatifs ou des conditions d’exécution peuvent néanmoins exister.

Autorisations et confirmation

Le schéma ne déclare aucun paramètre de confirmation explicite. Cela n’autorise aucune action sans permission : vérifiez l’effet et obtenez une autorisation.

Utilisez uniquement les applications, comptes et ressources autorisés par l'utilisateur sur cette plateforme. Consultez la description spécifique à la plate-forme de cet outil pour connaître ses exigences de connexion et d'autorisation ; ce catalogue ne revendique pas d'étendues OAuth ou de droits d'exploitation supplémentaires pour le système d'exploitation.

Schéma technique canonique en anglais — 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"
}

Exemple documentaire

Exemple de documentation pour agents_list. N’exécutez pas cet exemple. Les arguments présentés appartiennent à un jeu de données fictif ; résolvez les identifiants réels et obtenez une autorisation avant tout appel réel.

{}

Windows

Objectif

Répertorie les agents travaillant actuellement sur les machines de l'utilisateur dans le maillage : sur quelle machine chacun se trouve, son rôle, son référentiel et ses capacités. Utilisez-le avant de commencer un travail lourd (une version, un refactor à grande échelle, un déploiement) pour voir qui d'autre est actif et les avertir avec agent_send, et pour obtenir le « handle » auquel vous adressez un message. « alive » signifie « appelé le maillage dans son propre ttl_seconds » — tout appel compte, pas seulement agent_checkin — NOT « est joignable maintenant » : un agent qui s'est arrêté (ou dont la machine a désactivé le maillage) lit toujours alive jusqu'à l'expiration de son entrée. Un message envoyé dans cette fenêtre est accepté et stocké, et n'est tout simplement jamais lu. Si un homologue ne répond pas, réexécutez cette opération avant de conclure quoi que ce soit – son entrée a peut-être expiré depuis.

Entrées requises

Le schéma de cette plateforme ne déclare aucune entrée requise. Des sélecteurs facultatifs ou des conditions d’exécution peuvent néanmoins exister.

Autorisations et confirmation

Le schéma ne déclare aucun paramètre de confirmation explicite. Cela n’autorise aucune action sans permission : vérifiez l’effet et obtenez une autorisation.

Utilisez uniquement les applications, comptes et ressources autorisés par l'utilisateur sur cette plateforme. Consultez la description spécifique à la plate-forme de cet outil pour connaître ses exigences de connexion et d'autorisation ; ce catalogue ne revendique pas d'étendues OAuth ou de droits d'exploitation supplémentaires pour le système d'exploitation.

Schéma technique canonique en anglais — 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"
}

Exemple documentaire

{}