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

یہ AG-UI گروپ چیٹ ایکسٹینشن پروٹوکول اسٹینڈرڈ v1.0 کے مطابق نافذ کردہ ایک گروپ چیٹ پروٹوکول حب (Hub) ہے، جسے C# / .NET 10 کے ASP.NET Core Minimal API کے ذریعے لکھا گیا ہے۔ یہ "گروپ چیٹ" کو ایک پروٹوکول لیئر کے طور پر پیش کرتا ہے جس میں تھرڈ پارٹی ایپلی کیشنز شامل ہو سکتی ہیں: گروپ اور ممبران کا لائف سائیکل، میسج فین آؤٹ، سبسکرپشن اور ریئل ٹائم ڈاؤن لنک سب ایک ہی ایونٹ اور ایرر کوڈ کنونشن پر عمل کرتے ہیں، اور AI ایجنٹس گروپ ممبران کے طور پر اس میں شرکت کرتے ہیں۔ پروٹوکول کی صلاحیتیں - گروپ لائف سائیکل: تخلیق، اپ ڈیٹ اور تحلیل، جو GROUP_CREATED / GROUP_UPDATED / GROUP_DISBANDED کے مطابق ہیں۔ - ممبر مینجمنٹ: شمولیت، اخراج، گروپ چھوڑنا، اور کردار یا پروفائل میں تبدیلی (GROUP_MEMBER_*)۔ - میسج فین آؤٹ: صارف کے پیغامات TEXT_MESSAGE_START/CONTENT/END ٹرپلیٹ کے طور پر براڈکاسٹ کیے جاتے ہیں، جس میں all، mentioned، اور private تین видиمانت 범위 (visibility ranges) فراہم کیے گئے ہیں، اور یہ میسج ری کال، ریڈ ریسپٹ اور "typing" اسٹیٹس کو سپورٹ کرتا ہے۔ - سبسکرپشن میکانزم: GROUP_SUBSCRIBE / GROUP_UNSUBSCRIBE / GROUP_SUBSCRIBE_ACK / GROUP_STATE_SNAPSHOT۔ - دوہرا ٹرانسپورٹ: WebSocket فل ڈوپلیکس (/ws) اور SSE سنگل ڈاؤن لنک (/sse)، جس میں ہارٹ بیٹ کیپ الائیو سہولت موجود ہے؛ SSE کو HTTP انٹرفیس کے ذریعے متحرک طور پر سبسکرائب اور ان سبسکرائب کیا جا سکتا ہے۔ - ایجنٹ ٹرگر رولز (پروٹوکول §6): مینشن ٹرگر، فل مانیٹرنگ، کی ورڈ ٹرگر، اور سیاق و سباق (context) ٹرگر (جس میں ماڈل سیاق و سباق کی بنیاد پر فیصلہ کرتا ہے کہ کیا جواب دینا ہے)۔ - HTTP اپ لنک API: گروپ بنانا، کسٹمر نالج بیس کی دریافت/داخلہ، گروپ نام کی خودکار تخلیق، ممبران کا اضافہ/حذف، میسج بھیجنا، اٹیچمنٹس اپ لوڈ/ڈاؤن لوڈ، ری کال، ریڈ ریسپٹ، انسانی-مشینی فیصلے، اسنیپ شاٹ اور ممبر لسٹ وغیرہ کو کور کرتا ہے۔ غلطیاں یکساں طور پر code + message کے طور پر واپس کی جاتی ہیں، اور اسٹیٹس کوڈز 403/404/409/400 پر میپ کیے گئے ہیں۔ ایجنٹس اور میموری - AguiGroupChat.Agents مائیکروسافٹ ایجنٹ فریم ورک پر مبنی IAgentGateway کو نافذ کرتا ہے: mock فراہم کنندہ فوری استعمال کے لیے دستیاب ہے، یا OpenAI ہم آہنگ اینڈ پوائنٹس (Ollama / vLLM / Azure OpenAI / DeepSeek) کو کنفیگر کیا جا سکتا ہے۔ ٹرگر ہونے پر یہ ٹیکسٹ ایونٹس کو اسٹریم کرتا ہے اور فنکشن کالز کے لیے TOOL_CALL_START فین آؤٹ کرتا ہے۔ - انسانی مداخلت (HITL): ٹولز کو ApprovalRequiredAIFunction کے طور پر نشان زد کیا جا سکتا ہے جس کے لیے منظوری درکار ہوتی ہے۔ ماڈل کال کے دوران عمل رک جاتا ہے، اور گروپ چیٹ میں AGENT_INTERACTION_REQUEST کارڈ براڈکاسٹ کیا جاتا ہے، جسے صرف ٹرگر کرنے والا شخص منظور یا مسترد کر سکتا ہے، جس کے بعد سیشن بحال ہو جاتا ہے۔ - RAG سیمیٹک میموری: MemoryContextProvider ریٹریول سیاق و سباق فراہم کرتا ہے، ویکٹرز pgvector میں محفوظ ہوتے ہیں، اور embedding کے لیے HTTP اینڈ پوائنٹ یا LLamaSharp مقامی ماڈل (جیسے bge-m3) استعمال کیا جا سکتا ہے۔ نالج بیس دستاویزات کی سلائسنگ اور ریٹریول کو سپورٹ کرتا ہے، جس میں میموری رینج، TopK، اور similarity threshold جیسے قابلِ ترتیب آپشنز موجود ہیں۔ - انسانی میموری اقسام: ہر ڈیجیٹل ملازم کے لیے پانچ میموری پری سیٹس اور لہجے کے موڈز کنفیگر کیے جا سکتے ہیں، ورنہ پلیٹ فارم کی عالمی سیٹنگز استعمال ہوتی ہیں۔ - بلٹ ان ٹولز میں کیلکولیٹر، یونٹ کنورژن، گروپ میموری ریٹریول اور اٹیچمنٹ ریڈنگ شامل ہیں، جبکہ web_search / read_url ڈیفالٹ طور پر بند ہوتے ہیں۔ - امیج سمجھ بوجھ: تصویر کے ساتھ جوابات کو ویژن ماڈل کی طرف بھیجا جاتا ہے، جہاں تصاویر base64 ملٹی موڈل مواد کے طور پر منتقل ہوتی ہیں۔ - سوچنے کا موڈ (Reasoning Mode): بیرونی سروسز کا REASONING_MESSAGE_CONTENT ایک آزاد چینل کے ذریعے جاتا ہے، اور فرنٹ اینڈ پر اسے فولڈ ایبل (collapsible) سوچنے کے عمل کے بلاک کے طور پر رینڈر کیا جاتا ہے۔ ایپلی کیشن اور توسیع شدہ خصوصیات - صارف مینجمنٹ: رجسٹریشن، لاگ ان، لاگ آؤٹ، پاس ورڈ تبدیلی، اور پروفائل مینجمنٹ، PBKDF2 پاس ورڈ ہیشنگ اور سیشن ٹوکنز کے ساتھ۔ WS/SSE ٹوکن کی بنیاد پر تصدیق کو سپورٹ کرتے ہیں۔ - پلیٹ فارم لیول RBAC: SuperAdmin / Admin / Operator / User کے چار درجات، جنہیں کنفیگریشن لسٹ یا سپر ایڈمن کے ذریعے تفویض کیا جا سکتا ہے۔ اس کے علاوہ ڈیجیٹل ملازمین اور مہارتوں کی نمایاں ہونے کے لیے یوزر گروپنگ اور گروپ اتھارائزیشن موجود ہے۔ - اسکل لائبریری: اسے prompt / shell / http / dotnet چار اقسام میں تقسیم کیا گیا ہے، جس میں صرف سسٹم ایڈمن ہی ایگزیکیوشن صلاحیت رکھنے والی مہارتوں میں تبدیلی کر سکتا ہے۔ یہ قدرتی زبان کے ذریعے اسکل تعریفات بنانے اور ٹیسٹ رن کرنے کو سپورٹ کرتا ہے۔ - ون کلک آرگنائزیشن آرکیسٹریشن: ایک جملے کی ضرورت درج کرنے پر، SSE کے ذریعے جاب پلانز جنریٹ ہوتے ہیں، اور آرگنائزیشن اسٹرکچر، اسکلز اور اسائنمنٹ کے جائزے کے بعد انہیں ڈیٹا بیس میں محفوظ کیا جاتا ہے، اور گروپ بھی بیک وقت بنایا جا سکتا ہے۔ - سنگل چیٹ اور کسٹمر نالج بیس: ڈیجیٹل ملازمین کے لیے نجی دو طرفہ چیٹ بنائی جا سکتی ہے؛ کسٹمر نالج بیس میں عام صارفین شرکاء کے طور پر داخل ہوتے ہیں اور سیشنز ایک دوسرے سے الگ ہوتے ہیں۔ - عالمی تلاش (Global Search): میسجز، سیمیٹک میموری اور نالج بیس میں تلاش کرتی ہے اور نتائج کو ویزیبیلیٹی کے مطابق فلٹر کرتی ہے۔ - لنک پراکسی، ڈیٹا ایکسپورٹ/امپورٹ، رن ٹائم ماڈل کنفیگریشن، آڈٹ لاگز اور اکاؤنٹ کی منسوخی جیسی کارپوریٹ تعمیل کی صلاحیتیں۔ نصب کرنا اور پروجیکٹ کی شکل - چار رننگ موڈز فراہم کیے گئے ہیں: ویب ڈیمو، صرف پروٹوکول Hub، ونڈوز ڈیسک ٹاپ (WPF + WebView2)، اور کراس پلیٹ فارم ڈیسک ٹاپ (Avalonia)۔ ڈیسک ٹاپ ورژن ایک ہی بیک اینڈ پروسیس کے لیے ملٹی پل انسٹنسز کو سپورٹ کرتا ہے۔ - ڈیٹا کی پائیداری کے لیے JSON سنگل فائل اسنیپ شاٹ یا postgres / mysql / sqlite ڈیٹا بیس کا انتخاب کیا جا سکتا ہے۔ docker compose کے ذریعے postgres(pgvector) + بلٹ ان Ollama + Web کو ایک کلک پر شروع کیا جا سکتا ہے، جس میں سیمیٹک میموری ڈیفالٹ طور پر فعال ہوتی ہے۔ - تھرڈ پارٹی انٹیگریشن SDKs (AguiClient + AguiRealtimeClient، net8.0/net10.0 سپورٹڈ)، نمونہ کلائنٹس، یونٹ اور اینڈ ٹو اینڈ ٹیسٹ، اور Playwright براؤزر آٹومیشن اسکرپٹس بھی شامل ہیں۔