Depanați cu ipoteze testabile

Descrieți defecțiunea înainte de a propune o corecție

O cerere utilă de depanare precizează comportamentul așteptat, comportamentul observat și domeniul afectat. Includeți versiunea, intrarea relevantă și eroarea. Eliminați credențialele și înregistrările private din loguri înainte de a le furniza unui instrument AI.

„Exportul nu funcționează” oferă puțină orientare. O descriere mai bună este: „Exportul reușește local. În staging, aceeași cerere a managerului returnează 403 după ultima instalare în mediu. Celelalte rute încă funcționează.”

Descrierea nu stabilește cauza. Identifică diferențe care pot ghida investigația.

Păstrați mai multe explicații posibile

Cereți agentului un set mic de cauze plauzibile și dovezile pentru fiecare. Nu îi cereți să se fixeze pe prima explicație convingătoare.

Pentru eșecul fictiv al exportului, cauzele posibile includ o permisiune lipsă pentru identitatea serviciului, o asociere modificată a rolurilor sau o cerere trimisă către mediul greșit. Fiecare explicație anticipează dovezi diferite.

Tabelul este un punct de plecare. Un răspuns 403 poate proveni din straturi diferite. Identificați componenta care l-a produs înainte de a presupune că autorizarea aplicației a eșuat.

Alegeți o observație sigură

Începeți cu o observație care poate deosebi explicațiile la cost mic. Comparați versiunea instalată în mediu și configurația care nu conține secrete. Inspectați eroarea relevantă și identificatorul cererii. Reproduceți problema într-un mediu de testare autorizat când este posibil.

Nu acordați permisiuni ample doar pentru a vedea dacă dispare eroarea. Acțiunea schimbă limita de securitate și poate ascunde permisiunea care lipsește efectiv. Nu introduceți un log complet din producție în model când sunt suficiente eroarea cu informațiile sensibile eliminate și calea cererii.

Precizați ce ar slăbi fiecare ipoteză. Aceasta ajută agentul să își revizuiască explicația în loc să își apere primul răspuns.

Modificați câte o cauză pe rând

După ce dovezile identifică o cauză probabilă, faceți o corecție concentrată. Evitați combinarea unei schimbări de permisiune cu actualizarea unei biblioteci și rescrierea unui handler. Dacă simptomul dispare, nu ați ști care modificare a contat.

Verificați condiția inițială de eșec. Verificați și limita învecinată. Dacă remediați accesul unui manager, confirmați că unui utilizator neautorizat i se refuză în continuare accesul.

Pentru un defect recurent, adăugați o verificare de regresie la stratul care îl poate detecta. Un test unitar nu poate detecta orice eroare de configurație a instalării în mediu. Unele defecțiuni necesită o verificare de integrare sau o verificare controlată după instalare.

Opriți încercările repetate fără dovezi noi

Un agent poate genera multe variante ale unei corecții. Mai multe încercări nu îmbunătățesc neapărat diagnosticul. Dacă aceeași defecțiune se repetă, întrebați ce observație nouă va oferi următoarea încercare.

Stabiliți o limită de timp sau de încercări pentru o investigație incertă. La atingerea limitei, raportați dovezile actuale, ipotezele respinse și întrebarea nerezolvată. Această consemnare permite altei persoane să continue fără a repeta aceleași experimente.

După recuperare, consemnați cauza și condiția care i-a permis să ajungă în mediul afectat. O corecție elimină defectul imediat. O acțiune ulterioară utilă reduce șansa repetării aceleiași defecțiuni.