প্রকল্প সম্পর্কে

Peaky Peek (agent_debugger) হলো AI এজেন্ট ডিবাগ করার জন্য তৈরি একটি লোকাল-ফার্স্ট, ওপেন-সোর্স অডিট ও ট্রাস্ট কনসোল। LangSmith, OpenTelemetry, বা Sentry-এর মতো ঐতিহ্যবাহী অবজারভেবিলিটি টুলের বিপরীতে, Peaky Peek সেই প্রশ্নের উত্তর দিতে মনোযোগী যা অপারেটররা আসলে গুরুত্ব দেয়: এই এজেন্ট যা করেছে তা কি আমি বিশ্বাস করতে পারি? টুলটি প্রতিটি এজেন্ট অ্যাকশনের পেছনের সম্পূর্ণ কার্যকারণ চেইন ধারণ করে এবং প্রতিটি রানকে একটি অডিট রেকর্ড হিসেবে পুনর্গঠন করে, যা পাঁচটি মূল প্রশ্নের উত্তর দেয়: কী ঘটেছে, কেন, কী প্রমাণে, কী ফলাফলে, এবং কোথায় ব্যর্থ হয়েছে। প্রতিটি দাবি নির্ধারকভাবে শ্রেণিবদ্ধ করা হয় — যাচাইকৃত, আংশিক যাচাইকৃত, বিরোধিত, অসমর্থিত, অযাচাইকৃত, বা অপ্রচলিত — এবং প্রতিটি সেশনের জন্য একটি ব্যাখ্যাযোগ্য ট্রাস্ট স্কোর ও একটি ভের্ডিক্ট কার্ড দেওয়া হয়, যেখানে একটি নামযুক্ত অবস্থান থাকে (act, verify-first, বা do-not-act)। মূল বৈশিষ্ট্যসমূহ: - এজেন্ট অডিট ও ট্রাস্ট কনসোল — নির্ধারক ভের্ডিক্ট কার্ড, ব্যাখ্যাযোগ্য ট্রাস্ট স্কোর, ব্যর্থতার বিবরণ, যাচাইকরণ ব্যাজ এবং ঝুঁকি সংকেত - ডিসিশন ট্রি ভিজুয়ালাইজেশন — ইন্টারেক্টিভ ট্রি আকারে এজেন্টের যুক্তি অনুসন্ধান - চেকপয়েন্ট রিপ্লে — চেকপয়েন্ট-সচেতন প্লেব্যাকসহ এজেন্ট এক্সিকিউশনে সময়ভ্রমণ - ট্রেস সার্চ — সব সেশন জুড়ে নির্দিষ্ট ইভেন্ট খুঁজে বের করা - ফেইলিওর ক্লাস্টারিং ও মাল্টি-এজেন্ট কোঅর্ডিনেশন — একই ধরনের ব্যর্থতার অভিযোজিত বিশ্লেষণ - সেশন কম্পারিজন — দুইটি এজেন্ট রানের পাশাপাশি তুলনা ইন্টিগ্রেশন তিনটি পদ্ধতিতে সম্ভব: একটি সরল ডেকোরেটর (@trace), একটি কনটেক্সট ম্যানেজার (trace_session), এবং কোড পরিবর্তন ছাড়াই কাজ করা জিরো-কনফিগ অটো-প্যাচিং, যা PydanticAI, LangChain, OpenAI SDK, CrewAI, AutoGen, LlamaIndex এবং Anthropic-এর সাথে সামঞ্জস্যপূর্ণ। আর্কিটেকচারে রয়েছে ইনস্ট্রুমেন্টেশনের জন্য একটি SDK লেয়ার, ডিটেকশন ও রিপ্লের জন্য একটি ইন্টেলিজেন্স লেয়ার, SQLite স্টোরেজসহ একটি FastAPI সার্ভার, এবং নয়টি বিশেষায়িত প্যানেলসহ একটি React/TypeScript ফ্রন্টএন্ড। প্রকল্পটি MIT লাইসেন্সধারী, Python 3.10+ প্রয়োজন, এবং pip-এর মাধ্যমে peaky-peek-server হিসেবে পাওয়া যায়। প্রাইভেসি বৈশিষ্ট্যের মধ্যে রয়েছে লোকাল-ফার্স্ট অপারেশন — কোনো বাহ্যিক টেলিমেট্রি নেই, ঐচ্ছিক রিড্যাকশন পাইপলাইন, bcrypt হ্যাশিংসহ API কী অথেনটিকেশন, এবং ক্লাউড নির্ভরতাহীন SQLite স্টোরেজ।