Browser Tool
أتمتة التفاعلات مع الويب، واختبار واجهات المستخدم، والتقاط لقطات الشاشة باستخدام جلسات المتصفح
تتيح Browser Tool تفاعلات المتصفح المدفوعة بالذكاء الاصطناعي. ابدأ جلسات متصفح، وانقر على العناصر، واكتب النصوص، ومرّر الصفحات، والتقط لقطات شاشة من خلال أوامر اللغة الطبيعية.
ما ستتعلمه
- دورة حياة الجلسة: تشغيل ← تفاعل ← إغلاق
- إجراءات المتصفح: النقر، الكتابة، التمرير
- حالات الاستخدام: اختبار واجهات المستخدم، لقطات الشاشة، التنقل
دورة حياة الجلسة
يتبع كل سير عمل لأتمتة المتصفح تسلسلًا صارمًا:
- التشغيل - ابدأ جلسة متصفح عند عنوان URL مستهدف
- التفاعل - نفّذ إجراءات (النقر، الكتابة، التمرير)
- الإغلاق - أنهِ الجلسة لتحرير الموارد
تستمر حالة المتصفح عبر الإجراءات ضمن الجلسة نفسها. يجب إغلاق المتصفح قبل استخدام أدوات 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القيود
- حصرية الأداة - يمكن استخدام browser_action فقط أثناء الجلسات النشطة
- قائم على الإحداثيات - يتطلب إحداثيات x,y، وليس محددات CSS
- دقة ثابتة - نافذة عرض المتصفح مثبتة على 1920x1080
- Chrome فقط - يدعم Puppeteer متصفحات Chrome/Chromium
- لا استمرارية - لا تستمر الجلسات عبر إعادة تشغيل Verdent
- لا دعم لـ WSL - لا تعمل Browser Tool في بيئات WSL
- لا حالة محفوظة - تبدأ كل جلسة من جديد دون ملفات تعريف الارتباط أو المصادقة
- جلسة واحدة فقط - يمكن أن تكون جلسة متصفح واحدة فقط نشطة في كل مرة
أغلق دائمًا جلسة المتصفح قبل استخدام عمليات الملفات، أو أدوات البحث، أو أوامر bash. يقفل المتصفح الأدوات الأخرى أثناء الجلسات النشطة.