منصوبے کے بارے میں

Peaky Peek (agent_debugger) ایک مقامی، اوپن سورس آڈٹ اور ٹرسٹ کنسول ہے جو خاص طور پر AI ایجنٹس کو ڈیبگ کرنے کے لیے ڈیزائن کیا گیا ہے۔ روایتی observability ٹولز جیسے LangSmith، OpenTelemetry، یا Sentry کے برعکس، Peaky Peek اس سوال کا جواب دینے پر توجہ مرکوز کرتا ہے جو آپریٹرز اصل میں پوچھتے ہیں: کیا میں اس ایجنٹ کے کام پر بھروسہ کر سکتا ہوں؟ یہ ٹول ہر ایجنٹ ایکشن کے پیچھے مکمل causal chain کو پکڑتا ہے اور ہر run کو ایک آڈٹ ریکارڈ کے طور پر پیش کرتا ہے جو پانچ اہم سوالات کے جواب دیتا ہے: کیا ہوا، کیوں، کس ثبوت کے ساتھ، کس نتیجے کے ساتھ، اور کہاں ناکام ہوا۔ ہر claim کو قطعی طور پر درجہ بند کیا جاتا ہے: verified، partially verified، contradicted، unsupported، unverified، یا stale، اور ہر سیشن کو ایک قابل وضاحت ٹرسٹ اسکور اور ایک verdict card ملتا ہے جس میں ایک نامزد posture ہوتا ہے (act، verify-first، یا do-not-act)۔ اہم خصوصیات میں شامل ہیں: - Agent Audit & Trust Console: قطعی verdict cards، قابل وضاحت ٹرسٹ اسکور، failure narratives، verification badges، اور risk signals کے ساتھ - Decision Tree Visualization: ایجنٹ کی reasoning کو انٹرایکٹو درخت کے طور پر دیکھنے کے لیے - Checkpoint Replay: checkpoint-aware playback کے ساتھ ایجنٹ کی execution میں time-travel کرنے کے لیے - Trace Search: تمام سیشنز میں مخصوص واقعات تلاش کرنے کے لیے - Failure Clustering & Multi-Agent Coordination: اسی طرح کی ناکامیوں کا adaptive تجزیہ کرنے کے لیے - Session Comparison: دو ایجنٹ runs کا ساتھ ساتھ موازنہ کرنے کے لیے انٹیگریشن تین طریقوں سے دستیاب ہے: ایک سادہ decorator (@trace)، ایک context manager (trace_session)، اور zero-config auto-patching جو PydanticAI، LangChain، OpenAI SDK، CrewAI، AutoGen، LlamaIndex، اور Anthropic کے ساتھ بغیر کوڈ تبدیلیوں کے کام کرتا ہے۔ آرکیٹیکچر ایک SDK layer (instrumentation کے لیے)، ایک intelligence layer (detection اور replay کے لیے)، ایک FastAPI سرور (SQLite storage کے ساتھ)، اور ایک React/TypeScript فرنٹ اینڈ (نو مخصوص panels کے ساتھ) پر مشتمل ہے۔ یہ پروجیکٹ MIT لائسنس یافتہ ہے، Python 3.10+ کی ضرورت ہے، اور pip کے ذریعے peaky-peek-server کے طور پر دستیاب ہے۔ پرائیویسی خصوصیات میں local-first آپریشن شامل ہے جس میں کوئی بیرونی telemetry نہیں، اختیاری redaction pipeline، bcrypt hashing کے ساتھ API key authentication، اور SQLite storage شامل ہے جس میں کوئی cloud dependency نہیں۔