agent_send

Ajan ağı · macOS · Windows

Etki: gönderme. 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ç

Kullanıcının BAŞKA bir makinesindeki ajana koordinasyon iletisi gönderir (handle değerini agents_list aracından alın). Sürüm sırasında birleştirmeleri durdurmak ('freeze'), bir PR'ın hazır olduğunu duyurmak ('pr-ready'), işi devretmek ('handoff') veya sürümün yayımlandığını bildirmek ('release-out') için kullanın. to_agent olmadan ileti o makinedeki tüm ajanlara ulaşır; dondurma için istenen budur. HEDEFLENMİŞ bir to_agent ALIVE olmalıdır; agents_list sonucundan alın, asla uydurmayın. Etkin değilse o makinede ETKİN olan agent_ids listesini içeren 404 alırsınız; böylece ileti sessizce kaybolmak yerine bunlardan birine yeniden yönlendirilebilir. Alıcı iletiyi bir sonraki agent_inbox yoklamasında alır; bu anlık değildir ve zorla yaptırabileceğiniz bir istek değildir: ne yapacağına diğer ajan karar verir.

Zorunlu girdiler

to
msg_type

Girdi adları aracın istediği biçimde aynen korunur. İngilizce kanonik teknik tanımlar aşağıdaki açılır şemadadır.

İ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": {
    "from_agent": {
      "description": "Your own agent_id, so the recipient knows who is asking",
      "type": "string"
    },
    "msg_type": {
      "description": "One of: ping, pr-ready, freeze, freeze-clear, release-out, handoff, note",
      "type": "string"
    },
    "payload": {
      "description": "The content: reason, PR number, branch… Keep it small (max 16KB).",
      "type": "object"
    },
    "to": {
      "description": "Handle of the target machine, from agents_list",
      "type": "string"
    },
    "to_agent": {
      "description": "Optional: a single agent_id on that machine (it must have checked in). Omit to reach all of them.",
      "type": "string"
    }
  },
  "required": [
    "to",
    "msg_type"
  ],
  "type": "object"
}

Belge örneği

agent_send 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.

{
  "msg_type": "note",
  "payload": {
    "message": "The documentation review is ready."
  },
  "to": "demo-workstation"
}

Windows