Alle Werkzeuge

agents_list

Agentennetz · macOS · Windows

Wirkung: Lesen. Status: bedingt verfügbar.

„Bedingte Verfügbarkeit“ bedeutet, dass das Werkzeug von Version, Plattform, Berechtigungen, Konto oder Konfiguration abhängen kann. Es ist nicht in jeder Installation aktiv.

macOS

Zweck

Listet die Agenten auf, die derzeit auf den Maschinen des Benutzers im Mesh arbeiten – auf welcher Maschine sich jeder befindet, seine Rolle, sein Repo, seine Fähigkeiten, sein „status“ (was er tut, RIGHT NOW, mit „status_age_s“ = wie viele Sekunden dieser Text unverändert geblieben ist), „last_activity_at“ (das letzte Mal, als er den aufgerufen hat). Mesh überhaupt) und `expires_at` (wenn es aus dieser Liste gestrichen wird, wenn es stumm bleibt). Verwenden Sie „status“ + „last_activity_at“, um einen funktionierenden Peer von einem feststeckenden zu unterscheiden, bevor Sie entscheiden, mit wem Sie interagieren möchten. Verwenden Sie es, bevor Sie mit schwerer Arbeit beginnen (eine Veröffentlichung, eine umfassende Umgestaltung, eine Bereitstellung), um zu sehen, wer sonst noch aktiv ist, und sie mit agent_send zu warnen, und um das „handle“ zu erhalten, an das Sie eine Nachricht richten. „alive“ bedeutet „das Mesh innerhalb seines eigenen angerufen ttl_seconds“ – jeder Anruf zählt, nicht nur agent_checkin – NOT „ist jetzt erreichbar“: Ein Agent, der angehalten hat (oder dessen Computer das Mesh ausgeschaltet hat), liest weiterhin alive, bis sein Eintrag abläuft. Eine in diesem Fenster gesendete Nachricht wird akzeptiert und gespeichert und einfach nie gelesen. Wenn ein Peer nicht antwortet, wiederholen Sie den Vorgang, bevor Sie etwas abschließen – sein Eintrag ist möglicherweise seitdem abgelaufen.

Erforderliche Eingaben

Das Schema dieser Plattform deklariert keine erforderlichen Eingaben. Optionale Selektoren oder Laufzeitanforderungen können dennoch gelten.

Berechtigungen und Bestätigung

Das Schema deklariert keinen ausdrücklichen Bestätigungsparameter. Das erlaubt keine Handlung ohne Zustimmung; prüfen Sie die Wirkung und holen Sie eine Autorisierung ein.

Kanonisches technisches Schema auf Englisch — 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"
}

Dokumentationsbeispiel

Dokumentationsbeispiel für agents_list. Führen Sie dieses Beispiel nicht aus. Die gezeigten Argumente gehören zu einem fiktiven Datensatz; ermitteln Sie reale Kennungen und holen Sie vor einem echten Aufruf die Genehmigung ein.

{}

Windows

Zweck

Listet die Agenten auf, die derzeit auf den Maschinen des Benutzers im Mesh arbeiten – auf welcher Maschine sich jeder befindet, welche Rolle, welches Repo und welche Funktionen er hat. Verwenden Sie es, bevor Sie mit schweren Arbeiten beginnen (ein Release, eine umfassende Umgestaltung, eine Bereitstellung), um zu sehen, wer sonst noch aktiv ist, und sie mit agent_send zu warnen, und um das „handle“ zu erhalten, an das Sie eine Nachricht richten. „alive“ bedeutet „das Mesh innerhalb seines eigenen angerufen ttl_seconds“ – jeder Anruf zählt, nicht nur agent_checkin – NOT „ist jetzt erreichbar“: Ein Agent, der angehalten hat (oder dessen Computer das Mesh ausgeschaltet hat), liest weiterhin alive, bis sein Eintrag abläuft. Eine in diesem Fenster gesendete Nachricht wird akzeptiert und gespeichert und einfach nie gelesen. Wenn ein Peer nicht antwortet, wiederholen Sie den Vorgang, bevor Sie etwas abschließen – sein Eintrag ist möglicherweise seitdem abgelaufen.

Erforderliche Eingaben

Das Schema dieser Plattform deklariert keine erforderlichen Eingaben. Optionale Selektoren oder Laufzeitanforderungen können dennoch gelten.

Berechtigungen und Bestätigung

Das Schema deklariert keinen ausdrücklichen Bestätigungsparameter. Das erlaubt keine Handlung ohne Zustimmung; prüfen Sie die Wirkung und holen Sie eine Autorisierung ein.

Kanonisches technisches Schema auf Englisch — 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"
}

Dokumentationsbeispiel

Dokumentationsbeispiel für agents_list. Führen Sie dieses Beispiel nicht aus. Die gezeigten Argumente gehören zu einem fiktiven Datensatz; ermitteln Sie reale Kennungen und holen Sie vor einem echten Aufruf die Genehmigung ein.

{}