Otonom Agent Protokolü

PAP: Plugged.in Agent Protocol

Otonom AI agentları için güvenli, versiyonlanmış ve denetlenebilir kontrol protokolü. DNS tabanlı kimlik, mTLS, imzalı mesajlar ve tam açık kaynak şeffaflığı ile dağıtık bilişim için altyapı seviyesi temel.

"Bağlantıdan koordinasyona — otonomi, anarşi olmadan."

Vizyon: Uzay İstasyonu & Uydular

PAP, her agentın komut istasyonuna bağlı kendi kendine yeten bir uzay aracı gibi davrandığı Plugged.in ekosistemi için bir kontrol ve telemetri omurgası sağlar.

İstasyon (Plugged.in Core)

Orkestrasyon merkezi — komut gönderir, telemetri alır, kimlik ve politika yönetir.

Uydular (Agentlar)

Otonom, görev odaklı ve kod tabanı açısından heterojen. Bağımsız çalışır ama İstasyonun otoritesini tanır.

// PAP Proxy Mimarisi

Agent  ↔  PAP Proxy  ↔  Agent
           │
           │ Auth | Routing | Logging
           │
           └─ Plugged.in Core
              │
              ├─ Registry
              ├─ Policy Engine
              └─ Memory Service

Çift Profil Mimarisi

PAP, farklı kullanım senaryoları ve güvenlik gereksinimlerini karşılamak için iki farklı iletişim profili sunar.

PAP-CP (Kontrol Düzlemi)

Agent-to-Station kritik kontrol mesajlaşması için yüksek güvenceli profil.

Transport:gRPC / TLS 1.3

Güvenlik:mTLS + Ed25519

Kullanım Alanları:Yaşam döngüsü, acil durum, sahiplik transferi

PAP-Hooks (Veri Düzlemi)

Agent-to-Agent ve developer odaklı entegrasyonlar için daha esnek profil.

Transport:JSON-RPC / WebSocket

Güvenlik:OAuth 2.1 PKCE

Kullanım Alanları:Araç çağrıları, olaylar, webhook'lar

Yaşam Döngüsü Durum Makinesi

Her agent deterministik bir durum makinesini takip eder ve kontrol merkezi tüm geçişler üzerinde mutlak otoriteye sahiptir.

YENİ

HAZIR

AKTİF

SONLANDIRILIYOR

SONLANDIRILDI

NEW ──────► PROVISIONED ──────► ACTIVE ◄────► DRAINING ──────► TERMINATED
                                    │
                                    │ (error/force)
                                    ▼
                                 KILLED

Kill yetkisi yalnızca Plugged.in Core'a aittir — imzalı kontrol mesajları aracılığıyla uygulanır.

Temel Özellikler

Otonom agent yönetimi için tasarlanmış kurumsal düzey özellikler.

Zombi Önleme

Sürekli heartbeat olayları canlılık ve yük durumunu raporlar. Watchdog eşikleri yanıtsız agentları yükseltir ve sonlandırır.

Yaşam Döngüsü Yönetimi

Sağlama, çalıştırma, sahiplik transferi, normal sonlandırma ve zorla kill dahil tam yaşam döngüsü yetkisi.

DNS Tabanlı Kimlik

Her agent kendi adresine sahiptir: {agent}.{bölge}.a.plugged.in — Kubernetes-native yönlendirme ve DNSSEC doğrulama.

Sahiplik Transferi

Agent kimliği, durumu koruyarak güvenli bir şekilde başka bir istasyona taşınabilir — çoklu bulut taşınabilirliği için tasarlandı.

Sağlık İzleme

Heartbeat vs Metrikler Ayrımı

PAP, zombi tespiti güvenilirliğini sağlamak için heartbeat sinyallerini ayrıntılı metriklerden ayırır. Heartbeat'ler minimal ve sabit boyutludur; metrikler ayrı bir kanal üzerinden akar.

ACİL5s

BOŞTA30s

UYKU15min

// Heartbeat Event — minimal ve sabit

message HeartbeatEvent {
  Header header = 1;
  enum Mode {
    EMERGENCY = 0;
    IDLE = 1;
    SLEEP = 2;
  }
  Mode mode = 2;
  uint64 uptime_seconds = 3;
  // NO OTHER FIELDS ALLOWED
}

Hata Kod Kitabı

HTTP semantiklerinden esinlenen standart hata kodları, belirsizlik olmadan iletişimi güvence altına alır.

Kod

İsim

Anlam

200

Başarılı

202

ACCEPTED

Asenkron işleniyor

408

TIMEOUT

İşlem zaman aşımına uğradı

429

RATE_LIMITED

Üstel geri çekilme

480

AGENT_UNHEALTHY

Heartbeat kaçırıldı

481

AGENT_BUSY

Agent aşırı yüklü

500

INTERNAL_ERROR

Agent iç hatası

505

VERSION_UNSUPPORTED

Protokol uyumsuzluğu

Protokol Karşılaştırması

PAP'ın diğer agent protokollerinden farkı: operasyonel DevOps kontrolleri ile bilişsel AI tasarımını birleştirir.

Özellik	MCP	A2A	PAP
Merkezi Kontrol	❌	⚠️	✅
Kill Yetkisi	❌	❌	✅
DNS Tabanlı Kimlik	❌	❌	✅
Zombi Tespiti	⚠️	❌	✅
Sahiplik Transferi	❌	❌	✅
gRPC Native	❌	❌	✅

PAP ile Agentlarınızı Kontrol Edin

Otonom agentlarınız için güvenli, denetlenebilir ve ölçeklenebilir kontrol altyapısı kurun.