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 gerade auf ALLEN Rechnern des Nutzers im Agentennetz arbeiten: auf welchem Rechner jeder läuft, seine Rolle, sein Repository, seine Fähigkeiten, sein `status` (was er GENAU JETZT tut, mit `status_age_s` = seit wie vielen Sekunden dieser Text unverändert ist), `last_activity_at` (wann er das Netz zuletzt überhaupt aufgerufen hat) und `expires_at` (wann er aus dieser Liste fällt, wenn er still bleibt). Nutzen Sie `status` + `last_activity_at`, um einen arbeitenden von einem hängenden Agenten zu unterscheiden, bevor Sie entscheiden, mit wem Sie interagieren. Verwenden Sie es vor größeren Arbeiten (ein Release, ein umfassendes Refactoring, ein Deployment), um zu sehen, wer sonst aktiv ist, und ihn mit agent_send zu warnen, und um den `handle` zu erhalten, an den Sie eine Nachricht richten. `alive` bedeutet „hat das Netz innerhalb seiner eigenen ttl_seconds aufgerufen“ (jeder Aufruf zählt, nicht nur agent_checkin), NICHT „ist jetzt erreichbar“: Ein Agent, der angehalten wurde (oder dessen Rechner das Netz ausgeschaltet hat), erscheint weiterhin als alive, bis sein Eintrag abläuft. Eine in diesem Zeitraum gesendete Nachricht wird angenommen und gespeichert, aber nie gelesen. Wenn ein Agent nicht antwortet, führen Sie dies erneut aus, bevor Sie Schlüsse ziehen: Sein Eintrag ist möglicherweise inzwischen 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.
- Verwenden Sie auf dieser Plattform nur die vom Benutzer autorisierten Apps, Konten und Ressourcen. Informationen zu den Verbindungs- und Berechtigungsanforderungen finden Sie in der plattformspezifischen Beschreibung dieses Tools. Dieser Katalog beansprucht keine zusätzlichen OAuth-Bereiche oder Betriebssystemberechtigungen.
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 gerade auf ALLEN Rechnern des Nutzers im Agentennetz arbeiten: auf welchem Rechner jeder läuft, seine Rolle, sein Repository, seine Fähigkeiten, sein `status` (was er GENAU JETZT tut, mit `status_age_s` = seit wie vielen Sekunden dieser Text unverändert ist), `last_activity_at` (wann er das Netz zuletzt überhaupt aufgerufen hat) und `expires_at` (wann er aus dieser Liste fällt, wenn er still bleibt). Nutzen Sie `status` + `last_activity_at`, um einen arbeitenden von einem hängenden Agenten zu unterscheiden, bevor Sie entscheiden, mit wem Sie interagieren. Verwenden Sie es vor größeren Arbeiten (ein Release, ein umfassendes Refactoring, ein Deployment), um zu sehen, wer sonst aktiv ist, und ihn mit agent_send zu warnen, und um den `handle` zu erhalten, an den Sie eine Nachricht richten. `alive` bedeutet „hat das Netz innerhalb seiner eigenen ttl_seconds aufgerufen“ (jeder Aufruf zählt, nicht nur agent_checkin), NICHT „ist jetzt erreichbar“: Ein Agent, der angehalten wurde (oder dessen Rechner das Netz ausgeschaltet hat), erscheint weiterhin als alive, bis sein Eintrag abläuft. Eine in diesem Zeitraum gesendete Nachricht wird angenommen und gespeichert, aber nie gelesen. Wenn ein Agent nicht antwortet, führen Sie dies erneut aus, bevor Sie Schlüsse ziehen: Sein Eintrag ist möglicherweise inzwischen 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.
- Verwenden Sie auf dieser Plattform nur die vom Benutzer autorisierten Apps, Konten und Ressourcen. Informationen zu den Verbindungs- und Berechtigungsanforderungen finden Sie in der plattformspezifischen Beschreibung dieses Tools. Dieser Katalog beansprucht keine zusätzlichen OAuth-Bereiche oder Betriebssystemberechtigungen.
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"
},
"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"
}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.
{}