Tutti gli strumenti

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 attualmente lavorano sulle ALL macchine dell'utente nella mesh: su quale macchina si trova ciascuno, il suo ruolo, repository, capacità, il suo `status` (cosa sta facendo RIGHT NOW, con `status_age_s` = quanti secondi il testo è rimasto invariato), `last_activity_at` (l'ultima volta che ha chiamato il mesh) e `expires_at` (quando esce da questo elenco se rimane in silenzio). Usa `status` + `last_activity_at` per distinguere un peer che lavora da uno bloccato prima di decidere con chi interagire. Usalo prima di iniziare un lavoro pesante (un rilascio, un ampio refactoring, una distribuzione) per vedere chi altro è attivo e avvisarlo con agent_send e per ottenere il `handle` a cui indirizzi un messaggio. `alive` significa "chiamato la mesh all'interno della propria ttl_seconds" — conta qualsiasi chiamata, non solo agent_checkin — NOT "è raggiungibile ora": un agente che si è fermato (o la cui macchina ha spento la mesh) legge ancora alive fino alla scadenza della sua voce. Un messaggio inviato in quella finestra viene accettato e archiviato e semplicemente non viene mai letto. Se un peer non risponde, eseguilo nuovamente prima di concludere qualsiasi cosa: la sua voce potrebbe essere scaduta da allora.

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.

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 attualmente lavorano sulle ALL macchine dell'utente nel mesh: su quale macchina si trova ciascuno, il suo ruolo, repository e capacità. Usalo prima di iniziare un lavoro pesante (un rilascio, un ampio refactoring, una distribuzione) per vedere chi altro è attivo e avvisarlo con agent_send e per ottenere lo `handle` a cui indirizzi un messaggio. `alive` significa "chiamato la mesh all'interno della propria ttl_seconds" — conta qualsiasi chiamata, non solo agent_checkin — NOT "è raggiungibile ora": un agente che si è fermato (o la cui macchina ha spento la mesh) legge ancora alive fino alla scadenza della sua voce. Un messaggio inviato in quella finestra viene accettato e archiviato e semplicemente non viene mai letto. Se un peer non risponde, eseguilo nuovamente prima di concludere qualsiasi cosa: la sua voce potrebbe essere scaduta da allora.

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.

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

{}