مقامی ترجیحی ویب تحقیق اور براؤزر آٹومیشن کے لیے qz-browser-agent استعمال کرنے کا طریقہ

qz-browser-agent کیا ہے؟

qz-browser-agent، جسے 轻舟 یا “ہلکی کشتی” بھی کہا جاتا ہے، ویب تحقیق، براؤزر آٹومیشن اور ساختہ ڈیٹا اخذ کرنے کے لیے مقامی ترجیح والا Chrome ایکسٹینشن ہے۔ یہ آپ کو اپنا ماڈل فراہم کنندہ استعمال کرنے، براؤزر کے سائیڈ پینل کے ذریعے ویب سائٹس سے تعامل کرنے، اور دوبارہ استعمال کے قابل Skills یا TypeScript صلاحیتوں کے ذریعے ایجنٹ کو وسعت دینے کی سہولت دیتا ہے۔

سیشنز، Skills اور جمع کیا گیا ڈیٹا آپ کے براؤزر میں محفوظ ہوتا ہے۔ ماڈل کی درخواستوں میں آپ کا پرامپٹ اور صفحے یا فائل کا وہ مواد شامل ہو سکتا ہے جسے آپ ٹاسک کے سیاق میں شامل کرتے ہیں۔ Skills اور MCP کنکشنز آپ کی جانب سے ترتیب دی گئی سروسز کے ساتھ ڈیٹا کا تبادلہ کر سکتے ہیں، اس لیے بیرونی سروسز استعمال کرنے سے پہلے پروجیکٹ کی اجازتوں اور ڈیٹا کے بہاؤ کی دستاویزات کا جائزہ لیں۔

اہم خصوصیات

• براؤزر آٹومیشن: DOM عناصر یا اسکرین شاٹس سے تعامل کریں، فارم پُر کریں، اور ڈیسک ٹاپ یا موبائل ویو پورٹس میں ٹیبز کے درمیان کام کریں۔
• متوازی ذیلی ٹاسکس: ٹاسکس بیک وقت چلائیں اور کام جاری رہنے کے دوران اسے روکیں، سمت تبدیل کریں یا سیاق شامل کریں۔
• ساختہ ڈیٹا: ٹیبلز، میڈیا اور صفحے کے مواد کو مقامی کلیکشنز میں اخذ کریں، پھر سائیڈ پینل سے نتائج کا پیش نظارہ، ترمیم اور برآمد کریں۔
• Skills: ہدایات، اسکرپٹس، ٹولز اور حسب ضرورت سائیڈ پینل UI کو دوبارہ استعمال کے قابل ورک فلو کے طور پر پیکیج کریں، اور اختیاری طور پر مماثل ویب سائٹس پر فعال کریں۔
• ماڈل کا انتخاب: ایسے فراہم کنندگان سے کنیکٹ کریں جو مطابقت رکھنے والے API پروٹوکول اور ٹول کالنگ کو سپورٹ کرتے ہوں، جن میں مقامی ماڈل سرورز بھی شامل ہیں۔
• TypeScript صلاحیتیں: ایجنٹ ٹولز، پینل ویوز، سیٹنگز صفحات یا ماڈل فراہم کنندگان شامل کریں۔
• MCP برج: اختیاری طور پر مقامی MCP برج کے ذریعے براؤزر ٹولز اور ٹاسک کنٹرولز کو بیرونی ایجنٹس کے لیے دستیاب کریں۔

Chrome ایکسٹینشن انسٹال کریں

تازہ ترین ریلیز استعمال کریں

1. تازہ ترین qz-browser-agent ریلیز ڈاؤن لوڈ کریں۔
2. ڈاؤن لوڈ کی گئی ZIP آرکائیو کو ایکسٹریکٹ کریں۔
3. Chrome میں chrome://extensions کھولیں۔
4. Developer mode فعال کریں۔
5. Load unpacked پر کلک کریں اور ایکسٹریکٹ کیا گیا qz-browser-agent-extension فولڈر منتخب کریں۔

سورس سے بنائیں

qz کو مقامی طور پر بنانے کے لیے Node.js 24 LTS اور npm انسٹال کریں، پھر ریپوزٹری کلون یا ڈاؤن لوڈ کریں۔ پروجیکٹ ڈائریکٹری سے انحصارات انسٹال کریں اور ایکسٹینشن build تیار کریں:

npm ci
npm run build

Build مکمل ہونے پر chrome://extensions پر واپس جائیں، Load unpacked منتخب کریں، اور تیار کردہ dist/extension/ ڈائریکٹری منتخب کریں۔

ماڈل فراہم کنندہ ترتیب دیں

1. ایکسٹینشن ٹول بار سے qz کا سائیڈ پینل کھولیں۔
2. Settings کھولیں۔
3. ماڈل فراہم کنندہ منتخب کریں اور اس کی اسناد درج کریں۔
4. اگر آپ حسب ضرورت endpoint استعمال کر رہے ہیں تو اس کا URL اور معاون پروٹوکول دونوں فراہم کریں۔
5. ماڈل منتخب کریں اور کنفیگریشن محفوظ کریں۔

qz ایسے فراہم کنندگان کے ساتھ کام کرنے کے لیے بنایا گیا ہے جو معاون API پروٹوکول اور ٹول کالنگ فراہم کرتے ہوں۔ آپ اپنی ترتیب کے مطابق کسی مطابقت رکھنے والے ہوسٹڈ فراہم کنندہ یا مقامی ماڈل سرور کو استعمال کر سکتے ہیں۔

اپنا پہلا براؤزر ٹاسک چلائیں

فراہم کنندہ ترتیب دینے کے بعد تحقیق اور اخذ کرنے کی ایک سادہ درخواست سے آغاز کریں:

Open example.com and extract its main heading into a table.

ایجنٹ مطلوبہ صفحے پر جا سکتا ہے، اس کے مواد کا جائزہ لے سکتا ہے، اور اخذ کیا گیا نتیجہ مقامی کلیکشن میں رکھ سکتا ہے۔ جمع کیے گئے ڈیٹا کا پیش نظارہ یا ترمیم کرنے کے لیے سائیڈ پینل استعمال کریں، اور کلیکشن تیار ہونے پر اسے برآمد کریں۔

زیادہ پیچیدہ تحقیق کے لیے qz سے متعدد صفحات یا ٹیبز پر کام کرنے کو کہیں۔ جب کسی ٹاسک میں کام کے آزاد حصے ہوں تو متوازی ذیلی ٹاسکس انہیں بیک وقت پروسیس کرنے میں مدد دے سکتے ہیں۔ آپ جاری ٹاسک کو روک بھی سکتے ہیں، اس کی سمت تبدیل کر سکتے ہیں یا اضافی سیاق فراہم کر سکتے ہیں۔

Skills کے ذریعے qz کو وسعت دیں

Skills بار بار انجام دیے جانے والے ورک فلو کے لیے دوبارہ استعمال کے قابل پیکیجز ہیں۔ ایک Skill ہدایات، JavaScript آٹومیشن، ٹولز اور سائیڈ پینل میں حسب ضرورت تعاملی ویجٹس کو یکجا کر سکتی ہے۔ Site Skills کو مماثل ویب سائٹس پر فعال ہونے کے لیے بھی ترتیب دیا جا سکتا ہے۔

qz انٹرفیس سے Skills کا نظم کریں یا انہیں Git ریپوزٹریز سے انسٹال کریں۔ Skills اس وقت استعمال کریں جب کسی ورک فلو کو بار بار ہونے والے تحقیقی ٹاسکس میں یکساں رویے کی ضرورت ہو، مثلاً کسی مخصوص سائٹ سے معلومات جمع کرنا یا حسب ضرورت پینل کمپوننٹ کے ذریعے نتائج پیش کرنا۔

TypeScript صلاحیتیں شامل کریں

TypeScript صلاحیتیں ڈویلپرز کو ایکسٹینشن میں نئی فعالیت شامل کرنے دیتی ہیں۔ یہ ایجنٹ ٹولز، ٹول کے نتائج دکھانے والے رینڈررز، سیٹنگز صفحات، پینل ویوز یا ماڈل فراہم کنندگان فراہم کر سکتی ہیں۔

آغاز کے لیے پروجیکٹ کی capability مثال کو src/capabilities/ میں کاپی کریں، اس کی رجسٹریشنز کے نام تبدیل کریں، اور صرف وہ شراکتیں رکھیں جن کی آپ کی خصوصیت کو ضرورت ہے۔ ایک کم سے کم entry فائل اس طرح ٹولز اور رینڈررز ایکسپورٹ کر سکتی ہے:

// src/capabilities/<your-feature>/index.ts
export { default as tools } from "./tools.js";
export { default as renderers } from "./renderers.js";

Build ان اعلانات کو خودکار طور پر دریافت کر لیتا ہے۔ ٹول handlers بیک گراؤنڈ سروس ورکر میں چلتے ہیں اور فعال ٹیبز کو کارروائیاں یا اسکرپٹ پر عمل درآمد سونپ سکتے ہیں۔ رینڈررز سائیڈ پینل میں تعاملی نتیجہ کارڈز mount کرتے ہیں۔

SDK کی تفصیلات اور موجودہ ایکسٹینشن معاہدوں کے لیے صلاحیتوں کی رہنما دستاویز اور پروجیکٹ کی شراکت داروں کی دستاویزات دیکھیں۔ یہ APIs تجرباتی ہیں، اس لیے ایکسٹینشن بناتے وقت ممکنہ تبدیلیوں کو مدنظر رکھیں۔

ترقیاتی ورک فلو

پروجیکٹ کا ٹیسٹ ماحول ترتیب دینے کے لیے کمانڈز اور بلڈ آپشنز کی دستاویزات پر عمل کریں۔ ترقیاتی کمانڈز یہ ہیں:

npm run dev       # سورس میں تبدیلیوں پر دوبارہ بلڈ کریں
npm test          # پہلے سے طے شدہ ٹیسٹ سوٹس چلائیں
npm run verify    # قسموں کی جانچ کریں اور کوریج کے ساتھ خودکار سوٹس چلائیں

دوبارہ بلڈ کے بعد chrome://extensions سے ایکسٹینشن ری لوڈ کریں اور qz سائیڈ پینل دوبارہ کھولیں۔ اس سے یقینی ہوتا ہے کہ Chrome ایکسٹینشن کی تازہ ترین تیار کردہ فائلیں استعمال کر رہا ہے۔

اعلیٰ درجے کے استعمال کی تجاویز

• منظم پرامپٹس استعمال کریں: ہدف صفحات، جمع کیے جانے والے فیلڈز اور مطلوبہ آؤٹ پٹ فارمیٹ بیان کریں تاکہ اخذ کردہ ڈیٹا کو ایک مفید مجموعے میں منظم کیا جا سکے۔
• درست تعامل کا طریقہ منتخب کریں: DOM پر مبنی تعامل صفحے کے عناصر اور فارمز کے لیے مفید ہے، جبکہ اسکرین شاٹ پر مبنی تعامل اس وقت مددگار ہو سکتا ہے جب بصری سیاق اہم ہو۔
• قابلِ تکرار ورک فلو الگ رکھیں: بار بار دہرائی جانے والی ہدایات اور اسکرپٹس کو ہر پرامپٹ میں دہرانے کے بجائے Skills میں تبدیل کریں۔
• متوازی کام احتیاط سے استعمال کریں: آزاد تحقیقی ذیلی کام بیک وقت سونپیں، پھر سائیڈ پینل میں مشترکہ نتائج کا جائزہ لیں۔
• موزوں ہونے پر مقامی سروسز کو ترجیح دیں: qz مقامی ماڈل سرورز کو سپورٹ کرتا ہے، جو ماڈل ٹریفک کو آپ کے زیرِ اختیار انفراسٹرکچر کے اندر رکھنے میں مدد دے سکتے ہیں۔
• ڈیٹا کنکشنز کا جائزہ لیں: صفحے کا مواد، فائلیں، Skills اور MCP انٹیگریشنز درخواستوں میں شامل کیے جا سکتے ہیں یا تشکیل شدہ سروسز کے ساتھ تبادلہ کیے جا سکتے ہیں۔ حساس معلومات سنبھالنے سے پہلے اجازتوں کی جانچ کریں۔
• سورس میں تبدیلیوں کے بعد ری لوڈ کریں: کامیاب دوبارہ بلڈ سے ایکسٹینشن خودکار طور پر ریفریش نہیں ہوتی؛ ٹیسٹنگ سے پہلے اسے Chrome میں ری لوڈ کریں۔

اختیاری MCP انٹیگریشن

اختیاری مقامی MCP برج بیرونی ایجنٹس کو براؤزر ٹولز اور ٹاسک کنٹرولز فراہم کرتا ہے۔ اسے اس وقت استعمال کریں جب آپ کو کسی دوسرے MCP سے مطابقت رکھنے والے ایجنٹ یا ایپلیکیشن سے qz کنٹرول کروانا ہو۔ چونکہ MCP کنکشنز تشکیل شدہ سروسز کے ساتھ ڈیٹا کا تبادلہ کر سکتے ہیں، اس لیے اسے فعال کرنے سے پہلے برج کی دستاویزات اور ڈیٹا کے بہاؤ کے اثرات کا جائزہ لیں۔

نتیجہ

qz-browser-agent میں Chrome سائیڈ پینل، ماڈل سے چلنے والی براؤزر آٹومیشن، منظم مقامی مجموعے، متوازی ذیلی کام، اور Skills و TypeScript کے ذریعے توسیع پذیری شامل ہیں۔ فوری آغاز کے لیے ریلیز انسٹال کریں، مطابقت رکھنے والے ماڈل فراہم کنندہ کو تشکیل دیں، اور ایک مرکوز اخراجی پرامپٹ آزمائیں۔ اگر آپ کو حسبِ ضرورت ورک فلو یا انٹیگریشنز درکار ہوں تو سورس سے بلڈ کریں اور Skills، صلاحیتوں یا اختیاری MCP برج کے ذریعے پروجیکٹ کو وسعت دیں۔