agents_list
Agentennetwerk · macOS · Windows
Effect: lezen. Status: voorwaardelijk beschikbaar.
‘Voorwaardelijke beschikbaarheid’ betekent dat het hulpmiddel kan afhangen van versie, platform, machtigingen, account of configuratie. Het is niet in elke installatie actief.
macOS
Doel
Toont de agents die nu werken op ALLE machines van de gebruiker in het netwerk: op welke machine elk draait, de rol, repository, mogelijkheden, de `status` (wat de agent OP DIT MOMENT doet, met `status_age_s` = hoeveel seconden die tekst al ongewijzigd is), `last_activity_at` (de laatste keer dat de agent het netwerk überhaupt aanriep) en `expires_at` (wanneer de agent van deze lijst verdwijnt als hij stil blijft). Gebruik `status` + `last_activity_at` om een werkende agent te onderscheiden van een vastgelopen agent voordat je beslist met wie je contact opneemt. Gebruik dit voordat je zwaar werk begint (een release, een brede refactoring, een deploy) om te zien wie er nog meer actief is en die te waarschuwen met agent_send, en om de `handle` te krijgen waaraan je een bericht richt. `alive` betekent "heeft het netwerk aangeroepen binnen zijn eigen ttl_seconds" (elke aanroep telt, niet alleen agent_checkin), NIET "is nu bereikbaar": een agent die gestopt is (of waarvan de machine het netwerk heeft uitgezet) staat nog als alive tot zijn vermelding verloopt. Een bericht dat in die periode wordt verstuurd, wordt geaccepteerd en opgeslagen, maar nooit gelezen. Als een agent niet antwoordt, voer dit dan opnieuw uit voordat je iets concludeert: zijn vermelding kan inmiddels verlopen zijn.
Vereiste invoer
Het schema van dit platform vermeldt geen vereiste invoer. Optionele selectors of uitvoeringsvereisten kunnen nog steeds gelden.
Machtigingen en bevestiging
Het schema bevat geen expliciete bevestigingsparameter. Dit geeft geen toestemming om te handelen; controleer het effect en vraag autorisatie.
- Gebruik uitsluitend de apps, accounts en bronnen waarvoor de gebruiker op dit platform toestemming heeft gegeven. Raadpleeg de platformspecifieke beschrijving van deze tool voor de verbindings- en toestemmingsvereisten; deze catalogus veronderstelt geen aanvullende OAuth-bereiken of OS-rechten.
Canoniek technisch schema in het Engels — 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"
}Documentatievoorbeeld
Documentatievoorbeeld voor agents_list. Voer dit voorbeeld niet uit. De getoonde argumenten verwijzen naar fictieve gegevens; zoek vóór een echte aanroep de werkelijke identificatoren op en vraag toestemming.
{}Windows
Doel
Toont de agents die nu werken op ALLE machines van de gebruiker in het netwerk: op welke machine elk draait, de rol, repository, mogelijkheden, de `status` (wat de agent OP DIT MOMENT doet, met `status_age_s` = hoeveel seconden die tekst al ongewijzigd is), `last_activity_at` (de laatste keer dat de agent het netwerk überhaupt aanriep) en `expires_at` (wanneer de agent van deze lijst verdwijnt als hij stil blijft). Gebruik `status` + `last_activity_at` om een werkende agent te onderscheiden van een vastgelopen agent voordat je beslist met wie je contact opneemt. Gebruik dit voordat je zwaar werk begint (een release, een brede refactoring, een deploy) om te zien wie er nog meer actief is en die te waarschuwen met agent_send, en om de `handle` te krijgen waaraan je een bericht richt. `alive` betekent "heeft het netwerk aangeroepen binnen zijn eigen ttl_seconds" (elke aanroep telt, niet alleen agent_checkin), NIET "is nu bereikbaar": een agent die gestopt is (of waarvan de machine het netwerk heeft uitgezet) staat nog als alive tot zijn vermelding verloopt. Een bericht dat in die periode wordt verstuurd, wordt geaccepteerd en opgeslagen, maar nooit gelezen. Als een agent niet antwoordt, voer dit dan opnieuw uit voordat je iets concludeert: zijn vermelding kan inmiddels verlopen zijn.
Vereiste invoer
Het schema van dit platform vermeldt geen vereiste invoer. Optionele selectors of uitvoeringsvereisten kunnen nog steeds gelden.
Machtigingen en bevestiging
Het schema bevat geen expliciete bevestigingsparameter. Dit geeft geen toestemming om te handelen; controleer het effect en vraag autorisatie.
- Gebruik uitsluitend de apps, accounts en bronnen waarvoor de gebruiker op dit platform toestemming heeft gegeven. Raadpleeg de platformspecifieke beschrijving van deze tool voor de verbindings- en toestemmingsvereisten; deze catalogus veronderstelt geen aanvullende OAuth-bereiken of OS-rechten.
Canoniek technisch schema in het Engels — 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"
}Documentatievoorbeeld
Documentatievoorbeeld voor agents_list. Voer dit voorbeeld niet uit. De getoonde argumenten verwijzen naar fictieve gegevens; zoek vóór een echte aanroep de werkelijke identificatoren op en vraag toestemming.
{}