agents_list
Ajan ağı · macOS · Windows
Etki: okuma. Durum: koşullu kullanılabilir.
“Koşullu kullanılabilirlik”, aracın sürüme, platforma, izinlere, hesaba veya yapılandırmaya bağlı olabileceğini belirtir. Her kurulumda etkin olduğu anlamına gelmez.
macOS
Amaç
Ağdaki kullanıcının TÜM makinelerinde şu anda çalışan ajanları listeler: her birinin hangi makinede olduğu, rolü, deposu, yetenekleri, `status` değeri (ŞU ANDA ne yaptığı; `status_age_s` = bu metnin kaç saniyedir değişmediği), `last_activity_at` (ağı herhangi bir nedenle en son ne zaman çağırdığı) ve `expires_at` (sessiz kalırsa bu listeden ne zaman düşeceği). Kiminle etkileşime gireceğinize karar vermeden önce çalışan bir ajanı takılmış olandan ayırmak için `status` + `last_activity_at` kullanın. Ağır bir işe (sürüm, geniş bir yeniden düzenleme, dağıtım) başlamadan önce kimin aktif olduğunu görmek ve agent_send ile uyarmak, ayrıca mesaj göndereceğiniz `handle` değerini almak için kullanın. `alive`, "kendi ttl_seconds süresi içinde ağı çağırdı" anlamına gelir (yalnızca agent_checkin değil, her çağrı sayılır); "şu anda ulaşılabilir" anlamına GELMEZ: durmuş bir ajan (veya makinesi ağı kapatmış bir ajan) girdisinin süresi dolana kadar alive olarak görünmeye devam eder. Bu aralıkta gönderilen bir mesaj kabul edilir ve saklanır, ancak hiçbir zaman okunmaz. Bir ajan yanıt vermezse, bir sonuca varmadan önce bunu yeniden çalıştırın: girdisinin süresi bu arada dolmuş olabilir.
Zorunlu girdiler
Bu platformun şeması zorunlu girdi bildirmiyor. İsteğe bağlı seçiciler veya çalışma zamanı gereksinimleri yine de olabilir.
İzinler ve onay
Şema açık bir onay parametresi bildirmez. Bu, izinsiz işlem yapma yetkisi vermez; etkiyi inceleyin ve yetki alın.
- Yalnızca kullanıcının bu platformda yetkilendirdiği uygulamaları, hesapları ve kaynakları kullanın. Bağlantı ve izin gereksinimleri için bu aracın platforma özgü açıklamasına bakın; bu katalog ek OAuth kapsamları veya OS yetkileri bulunduğunu ileri sürmez.
İngilizce kanonik teknik şema — 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"
}Belge örneği
agents_list için örnek belge. Bu örneği çalıştırmayın. Gösterilen bağımsız değişkenler kurgusal bir veri kümesine aittir; gerçek bir çağrıdan önce gerçek tanıtıcıları bulun ve izin alın.
{}Windows
Amaç
Ağdaki kullanıcının TÜM makinelerinde şu anda çalışan ajanları listeler: her birinin hangi makinede olduğu, rolü, deposu, yetenekleri, `status` değeri (ŞU ANDA ne yaptığı; `status_age_s` = bu metnin kaç saniyedir değişmediği), `last_activity_at` (ağı herhangi bir nedenle en son ne zaman çağırdığı) ve `expires_at` (sessiz kalırsa bu listeden ne zaman düşeceği). Kiminle etkileşime gireceğinize karar vermeden önce çalışan bir ajanı takılmış olandan ayırmak için `status` + `last_activity_at` kullanın. Ağır bir işe (sürüm, geniş bir yeniden düzenleme, dağıtım) başlamadan önce kimin aktif olduğunu görmek ve agent_send ile uyarmak, ayrıca mesaj göndereceğiniz `handle` değerini almak için kullanın. `alive`, "kendi ttl_seconds süresi içinde ağı çağırdı" anlamına gelir (yalnızca agent_checkin değil, her çağrı sayılır); "şu anda ulaşılabilir" anlamına GELMEZ: durmuş bir ajan (veya makinesi ağı kapatmış bir ajan) girdisinin süresi dolana kadar alive olarak görünmeye devam eder. Bu aralıkta gönderilen bir mesaj kabul edilir ve saklanır, ancak hiçbir zaman okunmaz. Bir ajan yanıt vermezse, bir sonuca varmadan önce bunu yeniden çalıştırın: girdisinin süresi bu arada dolmuş olabilir.
Zorunlu girdiler
Bu platformun şeması zorunlu girdi bildirmiyor. İsteğe bağlı seçiciler veya çalışma zamanı gereksinimleri yine de olabilir.
İzinler ve onay
Şema açık bir onay parametresi bildirmez. Bu, izinsiz işlem yapma yetkisi vermez; etkiyi inceleyin ve yetki alın.
- Yalnızca kullanıcının bu platformda yetkilendirdiği uygulamaları, hesapları ve kaynakları kullanın. Bağlantı ve izin gereksinimleri için bu aracın platforma özgü açıklamasına bakın; bu katalog ek OAuth kapsamları veya OS yetkileri bulunduğunu ileri sürmez.
İngilizce kanonik teknik şema — 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"
}Belge örneği
agents_list için örnek belge. Bu örneği çalıştırmayın. Gösterilen bağımsız değişkenler kurgusal bir veri kümesine aittir; gerçek bir çağrıdan önce gerçek tanıtıcıları bulun ve izin alın.
{}