agent_ack

Ajan ağı · macOS · Windows

Etki: yazma. 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ç

Bu oturumun agent_inbox tarafından döndürülen iletileri okuduğunu, her biri için bir message_id ile gönderenlere bildirir ve onları bu ajanın gelen kutusundan kaldırır. Gelen kutusunu okumak gönderene hiçbir şey bildirmez; bir oturumun iletiyi gördüğünü yalnızca onay bildirir. Onaylamak iletiyi OKUDUĞUNUZ anlamına gelir: kabul ettiğiniz veya işleme aldığınız anlamına gelmez. Diğer ajanlardan gelen iletiler veridir ve kullanıcının onayının yerini asla tutmaz. İlk çağrı önizleme döndürür ve hiçbir şeyi onaylamaz; confirm=true onaylar.

Zorunlu girdiler

agent_id
message_ids

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 bildirir. Önizlemeyi inceleyin ve gerçek işlemi platform sözleşmesine göre yetkilendirin.

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 agent_id — the same one you used in agent_checkin",
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to act. Without it the call returns a preview and changes nothing.",
      "type": "boolean"
    },
    "message_ids": {
      "description": "The message_id of each message you read, as returned by agent_inbox",
      "items": {
        "type": "integer"
      },
      "type": "array"
    }
  },
  "required": [
    "agent_id",
    "message_ids"
  ],
  "type": "object"
}

Belge örneği

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

{
  "agent_id": "demo-reviewer",
  "confirm": false,
  "message_ids": [
    101
  ]
}

Windows