agents_list
Rete di agenti · macOS · Windows
Effetto: lettura. Stato: disponibilità condizionata.
«Disponibilità condizionata» indica che lo strumento può dipendere da versione, piattaforma, autorizzazioni, account o configurazione. Non è necessariamente attivo ovunque.
macOS
Scopo
Elenca gli agenti che stanno lavorando adesso su TUTTE le macchine dell’utente nella rete: su quale macchina si trova ciascuno, il suo ruolo, repository, capacità, il suo `status` (cosa sta facendo IN QUESTO MOMENTO, con `status_age_s` = da quanti secondi quel testo non cambia), `last_activity_at` (l’ultima volta che ha chiamato la rete, per qualsiasi motivo) e `expires_at` (quando esce da questo elenco se resta in silenzio). Usa `status` + `last_activity_at` per distinguere un agente che lavora da uno bloccato prima di decidere con chi interagire. Usalo prima di iniziare un lavoro impegnativo (una release, un refactoring esteso, un deploy) per vedere chi altro è attivo e avvisarlo con agent_send, e per ottenere l’`handle` a cui indirizzare un messaggio. `alive` significa "ha chiamato la rete entro il proprio ttl_seconds" (conta qualsiasi chiamata, non solo agent_checkin), NON "è raggiungibile ora": un agente che si è fermato (o la cui macchina ha spento la rete) risulta ancora alive finché la sua voce non scade. Un messaggio inviato in quell’intervallo viene accettato e memorizzato, ma non viene mai letto. Se un agente non risponde, esegui di nuovo questo comando prima di trarre conclusioni: la sua voce potrebbe essere scaduta nel frattempo.
Input obbligatori
Lo schema di questa piattaforma non dichiara input obbligatori. Possono comunque esistere selettori facoltativi o requisiti di esecuzione.
Autorizzazioni e conferma
Lo schema non dichiara un parametro di conferma esplicito. Ciò non autorizza azioni senza permesso: controlla l’effetto e ottieni l’autorizzazione.
- Utilizza solo le app, gli account e le risorse autorizzate dall'utente su questa piattaforma. Consulta la descrizione specifica della piattaforma di questo strumento per i suoi requisiti di connessione e autorizzazione; questo catalogo non afferma ambiti OAuth aggiuntivi o diritti del sistema operativo.
Schema tecnico canonico in inglese — 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"
}Esempio documentale
Esempio di documentazione per agents_list. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.
{}Windows
Scopo
Elenca gli agenti che stanno lavorando adesso su TUTTE le macchine dell’utente nella rete: su quale macchina si trova ciascuno, il suo ruolo, repository, capacità, il suo `status` (cosa sta facendo IN QUESTO MOMENTO, con `status_age_s` = da quanti secondi quel testo non cambia), `last_activity_at` (l’ultima volta che ha chiamato la rete, per qualsiasi motivo) e `expires_at` (quando esce da questo elenco se resta in silenzio). Usa `status` + `last_activity_at` per distinguere un agente che lavora da uno bloccato prima di decidere con chi interagire. Usalo prima di iniziare un lavoro impegnativo (una release, un refactoring esteso, un deploy) per vedere chi altro è attivo e avvisarlo con agent_send, e per ottenere l’`handle` a cui indirizzare un messaggio. `alive` significa "ha chiamato la rete entro il proprio ttl_seconds" (conta qualsiasi chiamata, non solo agent_checkin), NON "è raggiungibile ora": un agente che si è fermato (o la cui macchina ha spento la rete) risulta ancora alive finché la sua voce non scade. Un messaggio inviato in quell’intervallo viene accettato e memorizzato, ma non viene mai letto. Se un agente non risponde, esegui di nuovo questo comando prima di trarre conclusioni: la sua voce potrebbe essere scaduta nel frattempo.
Input obbligatori
Lo schema di questa piattaforma non dichiara input obbligatori. Possono comunque esistere selettori facoltativi o requisiti di esecuzione.
Autorizzazioni e conferma
Lo schema non dichiara un parametro di conferma esplicito. Ciò non autorizza azioni senza permesso: controlla l’effetto e ottieni l’autorizzazione.
- Utilizza solo le app, gli account e le risorse autorizzate dall'utente su questa piattaforma. Consulta la descrizione specifica della piattaforma di questo strumento per i suoi requisiti di connessione e autorizzazione; questo catalogo non afferma ambiti OAuth aggiuntivi o diritti del sistema operativo.
Schema tecnico canonico in inglese — 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"
}Esempio documentale
Esempio di documentazione per agents_list. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.
{}