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
Liste les agents qui travaillent en ce moment sur TOUTES les machines de l’utilisateur dans le maillage : la machine de chacun, son rôle, son dépôt, ses capacités, son `status` (ce qu’il fait EN CE MOMENT, avec `status_age_s` = depuis combien de secondes ce texte n’a pas changé), `last_activity_at` (la dernière fois qu’il a appelé le maillage, pour quoi que ce soit) et `expires_at` (le moment où il quitte cette liste s’il reste silencieux). Utilisez `status` + `last_activity_at` pour distinguer un pair qui travaille d’un pair bloqué avant de décider avec qui interagir. Utilisez-la avant de commencer un travail lourd (une release, une refactorisation étendue, un déploiement) pour voir qui d’autre est actif et le prévenir avec agent_send, et pour obtenir le `handle` auquel adresser un message. `alive` signifie « a appelé le maillage dans son propre ttl_seconds » (tout appel compte, pas seulement agent_checkin), et NON « est joignable maintenant » : un agent arrêté (ou dont la machine a désactivé le maillage) apparaît encore comme alive jusqu’à l’expiration de son entrée. Un message envoyé dans cet intervalle est accepté et stocké, mais n’est jamais lu. Si un pair ne répond pas, relancez cette commande avant de conclure quoi que ce soit : son entrée a peut-être expiré entre-temps.
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
Liste les agents qui travaillent en ce moment sur TOUTES les machines de l’utilisateur dans le maillage : la machine de chacun, son rôle, son dépôt, ses capacités, son `status` (ce qu’il fait EN CE MOMENT, avec `status_age_s` = depuis combien de secondes ce texte n’a pas changé), `last_activity_at` (la dernière fois qu’il a appelé le maillage, pour quoi que ce soit) et `expires_at` (le moment où il quitte cette liste s’il reste silencieux). Utilisez `status` + `last_activity_at` pour distinguer un pair qui travaille d’un pair bloqué avant de décider avec qui interagir. Utilisez-la avant de commencer un travail lourd (une release, une refactorisation étendue, un déploiement) pour voir qui d’autre est actif et le prévenir avec agent_send, et pour obtenir le `handle` auquel adresser un message. `alive` signifie « a appelé le maillage dans son propre ttl_seconds » (tout appel compte, pas seulement agent_checkin), et NON « est joignable maintenant » : un agent arrêté (ou dont la machine a désactivé le maillage) apparaît encore comme alive jusqu’à l’expiration de son entrée. Un message envoyé dans cet intervalle est accepté et stocké, mais n’est jamais lu. Si un pair ne répond pas, relancez cette commande avant de conclure quoi que ce soit : son entrée a peut-être expiré entre-temps.
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"
},
"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"
}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.
{}