پیکیج
ایجنٹوں کو پورٹیبل آرکائیوز کے طور پر ایکسپورٹ، شیئر اور انسٹال کریں۔
یہ کیا کرتا ہے
ایک ایجنٹ، اس کا فولڈر ٹری، کنفیگریشن، معلومات (knowledge) اور ورک فلوز کو مینی فیسٹ، معاونین کی فہرست اور ماخذ کے ریکارڈ کے ساتھ ایک واحد .agentpkg ZIP آرکائیو میں سیریلائز کیا جاتا ہے۔ اسے انسٹال کرنے کے لیے تین مراحل کا عمل ہے: پلان (بغیر کسی رائٹ کے معائنہ)، ریویو (خلاصہ کی تصدیق)، اپلائی (TOCTOU سیفٹی چیک کے ساتھ رائٹ کرنا)۔ تقسیم کے تین طریقے دستیاب ہیں: فائل میں براہ راست ایکسپورٹ، میعاد ختم ہونے والے شیئر ٹوکن کے ساتھ نجی ہینڈ آف لنکس، اور تصدیق شدہ پروف آف کانسیپٹ سیمپل رنز کے ساتھ ایک منتخب شوکیس گیلری۔
یہ کیوں اہم ہے
جس ایجنٹ کو آپ منتقل نہیں کر سکتے، وہ آپ کی ملکیت نہیں ہے۔ پورٹیبل آرکائیوز کا مطلب ہے کہ ایک ایجنٹ اپنی معلومات کو پیچھے چھوڑے بغیر اکاؤنٹس، ٹولز اور ماڈلز کے درمیان منتقل ہو سکتا ہے، اور اپلائی کرنے سے پہلے پلان کرنے کے مرحلے کا مطلب ہے کہ اسے انسٹال کرنا ایک فیصلہ ہے، نہ کہ کوئی ضمنی اثر (side effect)۔
یہ کیسے کام کرتا ہے
پیکیج کی حد کے پار زیرو آئی ڈی لیکیج
سیریلائزیشن کے دوران اندرونی UUIDs کو uuidv5 کے ساتھ دوبارہ تیار کیا جاتا ہے، اس لیے پیکیج میں ماخذ سے کوئی اکاؤنٹ، ٹیننٹ یا فولڈر کے شناخت کار (identifiers) شامل نہیں ہوتے۔
TOCTOU سیفٹی کے ساتھ تین مرحلوں پر مشتمل انسٹالیشن
پلان بغیر کسی رائٹ کے معائنہ کرتا ہے، ریویو خلاصہ کی تصدیق کرتا ہے، اپلائی رائٹ کرنے سے پہلے دوبارہ خلاصہ چیک کرتا ہے۔ ریویو اور اپلائی کے درمیان تبدیل ہونے والے پیکیج کو مسترد کر دیا جاتا ہے۔
شوکیس میں تصدیق شدہ سیمپل رنز شامل ہیں
شوکیس گیلری کے ورک فلو میں ایک ترمیم شدہ حقیقی رن شامل ہوتا ہے تاکہ کوئی بھی اسے انسٹال کرنے سے پہلے کام کرتے ہوئے دیکھ سکے، اور ڈسپلے پر تصدیق کی جانچ کی جاتی ہے۔
سوالات
- پیکیج میں کیا ہوتا ہے؟
- فولڈر ٹری، ہر لیف دستاویز، .context اور .agent کنفیگ فائلیں، ورک فلوز، اور معاون اور ماخذ کے میٹا ڈیٹا کے ساتھ ایک مینی فیسٹ۔ کوئی کریڈنشیلز، کوئی ایمبیڈنگز، اور کوئی تصدیقی حیثیت شامل نہیں ہوتی۔
- کیا میں کسی دوسرے اکاؤنٹ کے صارف کے ساتھ پیکیج شیئر کر سکتا ہوں؟
- جی ہاں۔ ایک نجی ہینڈ آف لنک میں میعاد ختم ہونے والا شیئر ٹوکن ہوتا ہے۔ وصول کنندہ اسے اسی پلان-ریویو-اپلائی فلو کے ذریعے اپنے اکاؤنٹ میں انسٹال کرتا ہے۔
The rest of the bag
AccessControl
فی دستاویز پرمیشنز جو صرف صفحات کو ہی نہیں، بلکہ جوابات کو بھی فلٹر کرتی ہیں۔
رفتار کے لیے پالیسی ریزولوشن کو فی سیشن کیش کیا جاتا ہے؛ پرمیشن میں تبدیلی ہر ان-فلائٹ درخواست پر فوری طور پر لاگو ہونے کے بجائے کیش انویلیڈیشن (منسوخی) پر منتقل ہوتی ہے۔
دستاویزات
ایک فولڈر ٹری جسے ایجنٹ پڑھتا ہے، اور ایک کنفیگ فائل جس پر وہ عمل کرتا ہے۔
ایکسٹریکشن میں PDFs، اسپریڈ شیٹس اور ٹرانسکرپٹس شامل ہیں۔ غیر معمولی بائنری فارمیٹس کو پارس نہیں کیا جاتا ہے۔
ایونٹس
ایجنٹس نے کیا کیا، اور کیوں کیا، اس کا ایک پائیدار لیجر۔
ان-پروسیس ایونٹ بس ایک سنگل نوڈ ایمیٹر ہے، نہ کہ کوئی ڈسٹریبیوٹڈ بروکر۔ ایجنٹس کے درمیان پائیدار ریکارڈ ایک الگ Postgres ٹاسک لیجر ہے۔
That was step 6 of 6: a reply leaves, and the trail stays. آمد سے لے کر دوبارہ چلانے کے قابل ریکارڈ تک، یہی پورا راستہ ہے۔