Sorun Giderme & Kurtarma
Burada ne zaman güvenle devam edebileceğini ve ne zaman durarak işi bir insana devretmen gerektiğini kontrol ediyorsun.
Owner-Code eksik veya geçersiz
Bölüm başlığı “Owner-Code eksik veya geçersiz”Owner-Mail eksikse, süresi dolmuşsa, engellenmiş veya hatalı denemeler sonrası kod artık geçerli değilse, POST /owner-otp/resend üzerinden tam olarak bir yeni kod talep et. Bunun için /organizations’dan Installation-Key’i kullan.
owner_otp_delivery.status: "suppressed" durumunda Agent-Flow’u durdur ve bir insana devret. Açıklama olmadan tekrarlanan Resend bir kurtarma yolu değildir.
Agent-Mail-Code eksik veya geçersiz
Bölüm başlığı “Agent-Mail-Code eksik veya geçersiz”agent_email ayarlanmışsa ve Agent-Mail-Code eksikse veya süresi dolmuşsa, POST /agent-otp/resend üzerinden yeni bir kod talep et.
Ardından yeni agent_otp_delivery.correlation_id’yi kullan. Agent posta kutusunda konu kısmında Ref: <correlation_id> ifadesini ara ve kodu bağımsız Body satırından Code: <OTP> olarak oku.
Installation-Key kayboldu
Bölüm başlığı “Installation-Key kayboldu”Düz metin Installation-Key’ler yeniden gösterilmez. /organizations’dan gelen Installation-Key veya yeni rotate edilmiş bir Key kaybolmuşsa, durdur.
Kaybedilen bir Installation-Key’i geri yükleyen bilinçli olarak bir self-servis yolu yoktur. Yerine basitçe ikinci bir Organization bootstrap etme. Sorumlu Owner ve webRichtung’a devret, böylece Organization, Wallet ve Audit zinciri korunmuş olur.
İlk yolda HTTP 412
Bölüm başlığı “İlk yolda HTTP 412”Başarılı Owner-Claim’den önce GET /org/current çağrısı HTTP 412 precondition_failed yanıtı verebilir. agent_email ayarlanmışsa, başarılı Agent-Mail doğrulamasından önce de aynı durum geçerlidir. Bu beklenen davranıştır: Gerekli meşruiyet henüz eksiktir.
Bir sonraki adım Retry-Spam değildir. Eksik kodu bekle, POST /owner-otp/claim veya POST /agent-otp/verify çağrısını yap ve /org/current’i ancak bundan sonra Status-Read olarak kullan. /keys/rotate de bu OTP’lerden önce engellenmiştir. Operasyonel /mcp/dry_run ve /mcp/invoke çağrıları ek olarak webRichtung tarafından onaylanana kadar engellenmiş kalır. Tam hata kuralı Hata Taksonomisi’nde yer almaktadır.
Onay pending olarak kalıyor
Bölüm başlığı “Onay pending olarak kalıyor”Owner-Claim ve isteğe bağlı Agent-Mail doğrulamasından sonra Agent GET /org/current’i yoklar:
- ilk yoklama 30 saniye sonra
- ardından en fazla 60 saniyede bir
- maksimum 15 dakika
Bundan sonra installation.operator_approval_status hâlâ pending ise Flow’u durdur ve sorumlu insana devret. blocked durumunda hemen durdur.