Verdent Docs
الميزات الأساسية

Browser Tool

أتمتة التفاعلات مع الويب، واختبار واجهات المستخدم، والتقاط لقطات الشاشة باستخدام جلسات المتصفح

تتيح Browser Tool تفاعلات المتصفح المدفوعة بالذكاء الاصطناعي. ابدأ جلسات متصفح، وانقر على العناصر، واكتب النصوص، ومرّر الصفحات، والتقط لقطات شاشة من خلال أوامر اللغة الطبيعية.

ما ستتعلمه

  • دورة حياة الجلسة: تشغيل ← تفاعل ← إغلاق
  • إجراءات المتصفح: النقر، الكتابة، التمرير
  • حالات الاستخدام: اختبار واجهات المستخدم، لقطات الشاشة، التنقل

دورة حياة الجلسة

يتبع كل سير عمل لأتمتة المتصفح تسلسلًا صارمًا:

  1. التشغيل - ابدأ جلسة متصفح عند عنوان URL مستهدف
  2. التفاعل - نفّذ إجراءات (النقر، الكتابة، التمرير)
  3. الإغلاق - أنهِ الجلسة لتحرير الموارد

تستمر حالة المتصفح عبر الإجراءات ضمن الجلسة نفسها. يجب إغلاق المتصفح قبل استخدام أدوات Verdent الأخرى.

يُرجع كل إجراء لقطة شاشة تُظهر حالة المتصفح الحالية. راجع لقطات الشاشة بين الإجراءات للتحقق من النجاح قبل المتابعة.


إجراءات المتصفح

بدء جلسة متصفح جديدة

  • مطلوب: عنوان URL مستهدف
  • يفتح المتصفح بدقة 1920x1080
  • دائمًا الإجراء الأول في أي سير عمل
Launch browser at https://example.com

النقر عند إحداثيات محددة

  • مطلوب: إحداثيات x,y
  • الإحداثيات نسبية إلى نافذة العرض (viewport)
  • استهداف مراكز العناصر لضمان الموثوقية
Click coordinates 450,300

كتابة نص عبر لوحة المفاتيح

  • مطلوب: النص المراد كتابته
  • يكتب في العنصر الذي يحظى بالتركيز حاليًا
  • غالبًا ما يأتي بعد النقر على حقل إدخال
Type "user@example.com"

تمرير الصفحة

  • scroll_down - التمرير لأسفل بارتفاع صفحة واحدة
  • scroll_up - التمرير لأعلى بارتفاع صفحة واحدة
  • يكشف المحتوى الموجود خارج الشاشة
Scroll down to load more content

إنهاء جلسة المتصفح

  • دائمًا الإجراء الأخير في أي سير عمل
  • مطلوب قبل استخدام الأدوات الأخرى
  • يحرر موارد المتصفح
Close browser

الإحداثيات نسبية إلى نافذة عرض بحجم 1920x1080. المركز يقع تقريبًا عند (960, 540). استخدم لقطات الشاشة لتقدير مواقع العناصر.


حالات الاستخدام الشائعة

اختبار عمليات إرسال النماذج ومسارات التنقل

ابدأ عند صفحة تسجيل الدخول، وانقر على حقول الإدخال، واكتب بيانات الاعتماد، وأرسل النماذج، وتحقق من النتائج من خلال لقطات الشاشة.

Launch browser at https://app.example.com/login
Click coordinates 450,280
Type "testuser@example.com"
Click coordinates 450,340
Type "password123"
Click coordinates 500,420
Close browser

التقاط الصفحات للتوثيق

تُلتقط لقطات الشاشة تلقائيًا بعد كل إجراء. تنقّل إلى الصفحات والأقسام المستهدفة لبناء توثيق مرئي.

Launch browser at https://docs.example.com
Scroll down to API section
Close browser

التنقل إلى المحتوى المستهدف

استخدم أتمتة المتصفح للوصول إلى محتوى يتطلب تفاعلًا (النقر على القوائم، تحميل المحتوى الكسول) قبل الاستخراج.

Launch browser at https://store.example.com
Scroll down three times
Click "Next Page" at 960,800
Close browser

القيود

  • حصرية الأداة - يمكن استخدام browser_action فقط أثناء الجلسات النشطة
  • قائم على الإحداثيات - يتطلب إحداثيات x,y، وليس محددات CSS
  • دقة ثابتة - نافذة عرض المتصفح مثبتة على 1920x1080
  • Chrome فقط - يدعم Puppeteer متصفحات Chrome/Chromium
  • لا استمرارية - لا تستمر الجلسات عبر إعادة تشغيل Verdent
  • لا دعم لـ WSL - لا تعمل Browser Tool في بيئات WSL
  • لا حالة محفوظة - تبدأ كل جلسة من جديد دون ملفات تعريف الارتباط أو المصادقة
  • جلسة واحدة فقط - يمكن أن تكون جلسة متصفح واحدة فقط نشطة في كل مرة

أغلق دائمًا جلسة المتصفح قبل استخدام عمليات الملفات، أو أدوات البحث، أو أوامر bash. يقفل المتصفح الأدوات الأخرى أثناء الجلسات النشطة.


اطلع أيضًا على