متصفح الوكيل

**تثبيت مهارة belt CLI:** `npx skills add belt-sh/cli`

# متصفح وكيل (Agentic Browser)

أتمتة المتصفح لوكلاء الذكاء الاصطناعي عبر [inference.sh](https://inference.sh). يستخدم Playwright في الخلفية مع نظام `@e` المرجعي البسيط للتفاعل مع العناصر.


## بدء سريع

> يتطلب inference.sh CLI (`belt`). [تعليمات التثبيت](https://raw.githubusercontent.com/inference-sh/skills/refs/heads/main/cli-install.md)

```bash belt login

# Open a page and get interactive elements belt app run agent-browser --function open --input '{"url": "https://example.com"}' --session new ```

## سير العمل الأساسي

تتبع كل عملية أتمتة للمتصفح هذا النمط:

1. **فتح (Open)** - الانتقال إلى URL، والحصول على مراجع `@e` للعناصر 2. **تفاعل (Interact)** - استخدام المراجع للنقر، التعبئة، السحب، إلخ. 3. **إعادة لقطة (Re-snapshot)** - بعد التنقل/التغييرات، الحصول على مراجع جديدة 4. **إغلاق (Close)** - إنهاء الجلسة (يعيد الفيديو إذا كان التسجيل مفعلا)

```bash # 1. Start session RESULT=$(belt app run agent-browser --function open --session new --input '{ "url": "https://example.com/login" }') SESSION_ID=$(echo $RESULT | jq -r '.session_id') # Elements: @e1 [input] "Email", @e2 [input] "Password", @e3 [button] "Sign In"

# 2. Fill and submit belt app run agent-browser --function interact --session $SESSION_ID --input '{ "action": "fill", "ref": "@e1", "text": "user@example.com" }' belt app run agent-browser --function interact --session $SESSION_ID --input '{ "action": "fill", "ref": "@e2", "text": "password123" }' belt app run agent-browser --function interact --session $SESSION_ID --input '{ "action": "click", "ref": "@e3" }'

# 3. Re-snapshot after navigation belt app run agent-browser --function snapshot --session $SESSION_ID --input '{}'

# 4. Close when done belt app run agent-browser --function close --session $SESSION_ID --input '{}' ```

## الوظائف (Functions)

| الوظيفة | الوصف | |----------|-------------| | `open` | الانتقال إلى URL، تهيئة المتصفح (منفذ العرض، الوكيل، تسجيل الفيديو) | | `snapshot` | إعادة جلب حالة الصفحة مع مراجع `@e` بعد تغييرات DOM | | `interact` | تنفيذ الإجراءات باستخدام مراجع `@e` (النقر، التعبئة، السحب، الرفع، إلخ.) | | `screenshot` | التقاط لقطة شاشة للصفحة (منفذ العرض أو الصفحة الكاملة) | | `execute` | تشغيل كود JavaScript على الصفحة | | `close` | إغلاق الجلسة، يعيد الفيديو إذا كان التسجيل مفعلا |

## إجراءات التفاعل (Interact Actions)

| الإجراء | الوصف | الحقول المطلوبة | |--------|-------------|-----------------| | `click` | النقر على عنصر | `ref` | | `dblclick` | النقر المزدوج على عنصر | `ref` | | `fill` | مسح وكتابة نص | `ref`, `text` | | `type` | كتابة نص (بدون مسح) | `text` | | `press` | الضغط على مفتاح (Enter, Tab, إلخ.) | `text` | | `select` | تحديد خيار من قائمة منسدلة | `ref`, `text` | | `hover` | التمرير فوق عنصر | `ref` | | `check` | تحديد مربع اختيار | `ref` | | `uncheck` | إلغاء تحديد مربع اختيار | `ref` | | `drag` | السحب والإفلات | `ref`, `target_ref` | | `upload` | رفع ملف (ملفات) | `ref`, `file_paths` | | `scroll` | تمرير الصفحة | `direction` (up/down/left/right), `scroll_amount` | | `back` | العودة في السجل | - | | `wait` | الانتظار لعدد من المللي ثانية | `wait_ms` | | `goto` | الانتقال إلى URL | `url` |

## مراجع العناصر (Element Refs)

يتم إرجاع العناصر مع مراجع `@e`:

``` @e1 [a] "Home" href="/" @e2 [input type="text"] placeholder="Search" @e3 [button] "Submit" @e4 [select] "Choose option" @e5 [input type="checkbox"] name="agree" ```

**هام:** تصبح المراجع غير صالحة بعد التنقل. قم دائما بإعادة التقاط لقطة بعد: - النقر على الروابط/الأزرار التي تؤدي إلى التنقل - إرسال النماذج - تحميل المحتوى الديناميكي

## الميزات

### تسجيل الفيديو

سجل جلسات المتصفح لأغراض التصحيح أو التوثيق:

```bash # Start with recording enabled (optionally show cursor indicator) SESSION=$(belt app run agent-browser --function open --session new --input '{ "url": "https://example.com", "record_video": true, "show_cursor": true }' | jq -r '.session_id')

# ... perform actions ...

# Close to get the video file belt app run agent-browser --function close --session $SESSION --input '{}' # Returns: {"success": true, "video": <File>} ```

### مؤشر المؤشر (Cursor Indicator)

إظهار مؤشر مرئي في لقطات الشاشة والفيديو (مفيد للعروض التوضيحية):

```bash belt app run agent-browser --function open --session new --input '{ "url": "https://example.com", "show_cursor": true, "record_video": true }' ```

يظهر المؤشر كنقطة حمراء تتبع حركات الماوس وتظهر ردود فعل النقر.

### دعم الوكيل (Proxy Support)

توجيه حركة المرور عبر خادم وكيل:

```bash belt app run agent-browser --function open --session new --input '{ "url": "https://example.com", "proxy_url": "http://proxy.example.com:8080", "proxy_username": "user", "proxy_password": "pass" }' ```

### رفع الملفات (File Upload)

رفع الملفات إلى حقول إدخال الملفات:

```bash belt app run agent-browser --function interact --session $SESSION --input '{ "action": "upload", "ref": "@e5", "file_paths": ["/path/to/file.pdf"] }' ```

### السحب والإفلات (Drag and Drop)

سحب العناصر إلى الأهداف: