تتيح "أدوات مطوّري البرامج في Chrome المخصّصة للوكلاء" لوكيلك بدء جلسة متصفّح وتثبيت إضافات Chrome أو التفاعل معها باستخدام خادم MCP. ويسمح ذلك لوكيل الترميز بالتحكّم في دورة حياة الإضافة: تثبيتها وإعادة تحميلها وتشغيل الإجراءات.
بدلاً من تحميل إضافة غير مضغوطة يدويًا، والنقر على زر إعادة التحميل في صفحة إدارة الإضافات في كل مرة تغيّر فيها الرمز، وتشغيل الإضافة يدويًا لاختبارها، اطلب من وكيل الذكاء الاصطناعي إدارة العملية بأكملها بشكل مستقل. ويؤدي ذلك إلى سدّ الفجوة بين إنشاء الرموز الثابتة واختبار الإضافات المباشرة.
يمكنك استخدام أدوات الإضافات لإجراء ما يلي:
- تثبيت الإضافات: يمكنك تثبيت إضافة Chrome غير مضغوطة من مسار دليل محلي.
- إدراج الإضافات: يمكنك استرداد قائمة بجميع إضافات Chrome المثبّتة، بما في ذلك اسمها ورقم تعريفها وإصدارها وحالتها المفعّلة.
- إعادة تحميل الإضافات: يمكنك إعادة تحميل إضافة Chrome غير مضغوطة حسب رقم تعريفها لتطبيق تغييرات الرمز على الفور.
- تشغيل الإجراءات: يمكنك تشغيل الإجراء التلقائي لإضافة حسب رقم تعريفها،
مثل فتح قائمة أو تنفيذ إجراء نص برمجي في الخلفية (راجِع
chrome.action في مستندات واجهة برمجة التطبيقات).
- إلغاء تثبيت الإضافات: يمكنك إزالة إضافة Chrome من جلسة المتصفّح حسب رقم تعريفها.
المتطلبات الأساسية
قبل استخدام أدوات الإضافات، تأكَّد من توفّر ما يلي:
- علامة تجريبية: لا تكون فئة "الإضافات" مفعّلة تلقائيًا في "أدوات مطوّري البرامج" للوكلاء. عليك ضبط خادم MCP
الخادم باستخدام العلامة
--categoryExtensions. - الإضافات غير المضغوطة: تتطلّب أدوات مثل
install_extensionمسارًا مطلقًا إلى مجلد الإضافة غير المضغوطة، ما يجعلها مثالية للتطوير المحلي.
حالات استخدام أدوات إضافات Chrome
اطلب من وكيلك إدارة دورة حياة الإضافة أثناء تطويرها وإصلاح الأخطاء.
ملاحظة: خطوات تنفيذ الوكيل هي أمثلة على السلوك المحتمَل. قد يتصرّف وكيلك بشكل مختلف.
تكرار الإضافة وإعادة تحميلها بسرعة
تؤدي إعادة تحميل الإضافة يدويًا بعد كل تغيير في الملف إلى إبطاء عملية التطوير. اطلب من وكيلك تطبيق إصلاح للرمز وإعادة تحميل الإضافة على الفور للتحقّق من السلوك الجديد بدون تدخّل يدوي.
مثال على الطلب:
يمكنك استخدام نهج عام:
Verify the extension has access to the active tab.
أو يمكنك تقديم تفاصيل أكثر:
Update the manifest.json to include the "activeTab" permission. Then, reload the extension with ID 'abc123xyz' and trigger its default action to ensure it works.
مثال على تنفيذ الوكيل: يعدِّل وكيلك ملف manifest.json على نظام الملفات. ثم يستدعي الأداة reload_extension باستخدام رقم التعريف المقدَّم.
أخيرًا، يستدعي الأداة trigger_extension_action لتفعيل الإضافة والتحقّق من عدم ظهور أي أخطاء في الأذونات في وحدة التحكّم.
اختبار الإجراء التلقائي للإضافة على صفحة مستهدَفة
عليك غالبًا اختبار كيفية تفاعل نص المحتوى أو إجراء الإضافة مع موقع إلكتروني معيّن. يمكنك أتمتة هذه العملية من خلال توجيه وكيلك للانتقال إلى الموقع الإلكتروني وتثبيت الإضافة وتشغيلها.
مثال على الطلب:
يمكنك استخدام نهج عام:
Test my extension on example.com and verify it works correctly.
أو يمكنك تقديم تفاصيل أكثر:
Navigate to example.com, install the unpacked extension located at '/Users/dev/my-extension', and trigger the extension action. Check the console logs to verify the content script executed correctly.
مثال على تنفيذ الوكيل: ينتقل وكيلك إلى عنوان URL المستهدَف باستخدام navigate_page. ثم يستخدم install_extension مع المسار المطلق المقدَّم. بعد تحميل الإضافة، ينفّذ trigger_extension_action لمحاكاة نقرة من المستخدم. أخيرًا، يستخدم list_console_messages لتأكيد تشغيل نص المحتوى وإنتاج الناتج المتوقّع.
التحقّق من الإضافات المثبّتة وتنظيفها
أثناء الاختبار الآلي، قد تحتاج إلى التحقّق مما إذا تم تحميل إضافة بشكل صحيح باستخدام الإصدار المناسب، أو إزالتها لضمان حالة نظيفة للاختبار التالي.
مثال على الطلب:
Uninstall 'My Test Extension' from the browser.
مثال على تنفيذ الوكيل: يستخدم وكيلك الأداة list_extensions لاسترداد قائمة الإضافات المثبّتة وبياناتها الوصفية. ويحلّل الناتج لتحديد رقم التعريف المرتبط بـ "My Test Extension". ثم يستخدم الأداة uninstall_extension مع رقم التعريف هذا لإزالتها بأمان من المتصفّح.
إنشاء إضافة جديدة واختبارها
يتطلّب بدء إضافة Chrome جديدة من البداية عادةً إنشاء ملفات أساسية وتحميل الدليل غير المضغوط يدويًا في المتصفّح لاختبارها. يمكنك تخطّي عملية الإعداد اليدوي هذه من خلال توجيه وكيلك لإنشاء الرمز الأولي وتحميل الإضافة والتحقّق من وظائفها الأساسية، من البداية إلى النهاية، في خطوة واحدة.
مثال على الطلب:
Build a Chrome extension that turns the page background gray when I click its icon. Save the files to '/tmp/gray-bg-ext', navigate to example.com, load the extension, and verify that it works.
مثال على تنفيذ الوكيل: ينشئ وكيلك ملف manifest.json أساسيًا للإصدار Manifest V3 وخدمة في الخلفية تستمع إلى الحدث chrome.action.onClicked. ثم ينتقل إلى صفحة الاختبار ويستدعي install_extension ويستخدم trigger_extension_action لمحاكاة نقرة من المستخدم. أخيرًا، يفحص نموذج العناصر في المستند أو يأخذ لقطة شاشة لتأكيد تحوّل الخلفية إلى اللون الرمادي، ما يثبت أنّ الملفات الأساسية تعمل.