البناء المتقدم: التداول والرؤية الحاسوبية

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

المشروع الأول: وكيل التداول باستخدام Alpaca Markets API

توفر Alpaca Markets (alpaca.markets) واجهة برمجة للتداول في الأسهم، بما في ذلك وضع التداول الورقي الذي يتيح لك اختبار الاستراتيجيات بأموال محاكاة قبل المخاطرة برأس مال حقيقي.

إخلاء مسؤولية: التداول ينطوي على مخاطر مالية. ما يلي هو لأغراض تعليمية فقط. لا تنشر روبوت تداول بأموال حقيقية دون اختبار شامل وإدارة مخاطر وفهم للوائح المالية في نطاقك القانوني. الأداء السابق لأي استراتيجية لا يضمن النتائج المستقبلية.

الهندسة المعمارية:

┌──────────────────────────────────────┐
│            وكيل التداول              │
├──────────────────────────────────────┤
│  المحفزات: جدول ساعات السوق         │
│  + شروط تنبيه الأسعار              │
├──────────────┬───────────────────────┤
│ Alpaca API   │  تغذية بيانات السوق  │
│ (أوامر،      │  (أسعار، حجم،        │
│  مراكز،      │   تحليل الأخبار)     │
│  حساب)       │                      │
├──────────────┴───────────────────────┤
│  محرك الاستراتيجية                  │
│  (قواعد + تحليل LLM)               │
├──────────────────────────────────────┤
│  طبقة إدارة المخاطر                │
│  (حدود المراكز، وقف الخسائر،       │
│   سقف الخسائر اليومية)             │
├──────────────────────────────────────┤
│  الإجراءات: شراء، بيع، احتفاظ، تنبيه│
└──────────────────────────────────────┘

الأدوات المطلوبة:

• واجهة Alpaca Markets API (حساب تداول ورقي للاختبار)
• تغذية بيانات السوق (توفرها Alpaca مع واجهتها البرمجية)
• نموذج LLM لتحليل مشاعر الأخبار (اختياري لكنه قوي)
• قواعد إدارة المخاطر (حدود صارمة لا يمكن للوكيل تجاوزها)

سير العمل:

1. يُنشَّط الوكيل خلال ساعات السوق
2. يسحب المراكز الحالية ورصيد الحساب وأسعار قائمة المراقبة
3. يحلل بيانات السوق مقابل قواعد محددة مسبقاً (المتوسطات المتحركة، ارتفاعات الحجم، عتبات الأسعار)
4. اختيارياً يُغذّي عناوين الأخبار الأخيرة للـ LLM لتحليل المشاعر
5. إذا أُطلقت إشارة تداول واجتازت جميع فحوصات المخاطر، يُنفّذ الأمر عبر Alpaca API
6. يُسجّل كل قرار مع التبرير الكامل للمراجعة اللاحقة

# وكيل التداول - التداول الورقي مع Alpaca
import alpaca_trade_api as tradeapi

# إعداد التداول الورقي - يستخدم أموالاً محاكاة
api = tradeapi.REST(
    key_id="your_paper_key",
    secret_key="your_paper_secret",
    base_url="https://paper-api.alpaca.markets"  # نقطة نهاية التداول الورقي
)

def check_trading_signal(symbol: str, strategy: dict) -> dict:
    """تقييم ما إذا كان السهم يستوفي معايير التداول."""
    # الحصول على بيانات الأسعار الأخيرة
    bars = api.get_bars(symbol, "1Day", limit=50).df

    # تقاطع المتوسطات المتحركة البسيطة (استراتيجية مثال)
    bars["sma_20"] = bars["close"].rolling(window=20).mean()
    bars["sma_50"] = bars["close"].rolling(window=50).mean()

    latest = bars.iloc[-1]
    previous = bars.iloc[-2]

    signal = {
        "symbol": symbol,
        "action": "hold",
        "reason": "لم يُكتشف أي إشارة",
    }

    # إشارة شراء: المتوسط قصير الأجل يتقاطع فوق المتوسط طويل الأجل
    if previous["sma_20"] <= previous["sma_50"] and latest["sma_20"] > latest["sma_50"]:
        signal["action"] = "buy"
        signal["reason"] = "تقاطع SMA 20 فوق SMA 50"

    # إشارة بيع: المتوسط قصير الأجل يتقاطع تحت المتوسط طويل الأجل
    if previous["sma_20"] >= previous["sma_50"] and latest["sma_20"] < latest["sma_50"]:
        signal["action"] = "sell"
        signal["reason"] = "تقاطع SMA 20 تحت SMA 50"

    return signal

def execute_with_risk_checks(signal: dict, risk_params: dict) -> dict:
    """تنفيذ صفقة فقط إذا اجتازت جميع فحوصات إدارة المخاطر."""
    account = api.get_account()
    portfolio_value = float(account.portfolio_value)

    # فحص المخاطر: الحد الأقصى لحجم المركز
    max_position = portfolio_value * risk_params["max_position_pct"]

    # فحص المخاطر: حد الخسارة اليومية
    daily_pnl = float(account.portfolio_value) - float(account.last_equity)
    if daily_pnl < -risk_params["max_daily_loss"]:
        return {"executed": False, "reason": "تم الوصول لحد الخسارة اليومية"}

    # فحص المخاطر: الحد الأقصى لعدد المراكز المفتوحة
    positions = api.list_positions()
    if len(positions) >= risk_params["max_open_positions"]:
        return {"executed": False, "reason": "تم الوصول للحد الأقصى للمراكز"}

    # اجتاز جميع الفحوصات — تنفيذ الصفقة
    if signal["action"] == "buy":
        order = api.submit_order(
            symbol=signal["symbol"],
            qty=calculate_position_size(signal["symbol"], max_position),
            side="buy",
            type="market",
            time_in_force="day"
        )
        return {"executed": True, "order_id": order.id}

    return {"executed": False, "reason": "لم يُتخذ أي إجراء"}

قرارات التصميم الحرجة:

• التداول الورقي أولاً. طوّر واختبر دائماً مع نقطة نهاية التداول الورقي في Alpaca. لا تتصل أبداً بالتداول الحي حتى يتم التحقق من الاستراتيجية بشكل مكثف.
• حدود مخاطر صارمة. يجب أن يكون لدى الوكيل حدود غير قابلة للتفاوض: الحد الأقصى لحجم المركز، الحد الأقصى للخسارة اليومية، الحد الأقصى لعدد المراكز. هذه ليست اقتراحات — إنها قواطع دائرة.
• تسجيل كامل. يجب تسجيل كل قرار وكل إشارة وكل صفقة مع التبرير. تحتاج لمراجعة ما فعله الوكيل ولماذا.

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

المشروع الثاني: VisionClaw — الرؤية الحاسوبية تلتقي بتنسيق الوكلاء

VisionClaw، الذي أنشأه Xiaoan (Sean Liu)، هو مشروع يجمع بين نظارات Meta Ray-Ban الذكية وGemini Live API وOpenClaw لإنشاء وكيل يمكنه الرؤية ووصف العالم في الوقت الحقيقي. المشروع مفتوح المصدر ومتاح على github.com/Intent-Lab/VisionClaw.

هنا حيث يلتقي تنسيق الوكلاء بالعالم المادي.

كيف يعمل:

┌──────────────────────────────────────┐
│          بنية VisionClaw             │
├──────────────────────────────────────┤
│  العتاد: نظارات Meta Ray-Ban       │
│  (كاميرا + ميكروفون + سماعة)       │
├──────────────────────────────────────┤
│  واجهة الرؤية: Gemini Live API      │
│  (فهم الصور في الوقت الحقيقي)      │
├──────────────────────────────────────┤
│  التنسيق: OpenClaw                  │
│  (توجيه الأدوات، الذاكرة، الإجراءات)│
├──────────────────────────────────────┤
│  المخرج: استجابة صوتية عبر النظارات│
│  + إجراءات اختيارية (بحث، حفظ،     │
│    تنقل، تعرّف)                    │
└──────────────────────────────────────┘

الطبقات الثلاث:

1. العتاد القابل للارتداء (Meta Ray-Bans): يلتقط ما تراه عبر الكاميرا المدمجة وما تقوله عبر الميكروفون. يُوصل الاستجابات الصوتية عبر السماعات. النظارات هي عيون الوكيل وأذنيه وصوته.

2. الذكاء الاصطناعي متعدد الوسائط (Gemini Live API): يعالج تغذية الكاميرا في الوقت الحقيقي. يفهم ما في الإطار — أشياء، نصوص، مشاهد، أشخاص، معالم. هذا ليس تصنيف صور بسيط — إنه فهم سياقي للمشهد يمكنه الإجابة على أسئلة حول ما يراه.

3. تنسيق الوكيل (OpenClaw): يأخذ الفهم البصري ويوجهه عبر إطار عمل الوكيل. يمكن للوكيل استخدام أدوات — البحث عن معلومات حول ما يراه، حفظ الملاحظات في الذاكرة، توفير اتجاهات التنقل، أو تفعيل إجراءات أخرى بناءً على المدخلات البصرية.

ما يُمكّنه هذا:

• المشي في متجر بقالة والسؤال "ما هو الخيار العضوي الأرخص هنا؟" — الوكيل يقرأ الأسعار والملصقات عبر النظارات
• زيارة مدينة جديدة والحصول على معلومات سياقية عن المباني والمعالم واللافتات في الوقت الحقيقي
• حضور مؤتمر وجعل الوكيل يتعرف على المتحدثين ويُلخص شرائحهم ويحفظ الملاحظات

نمط التقارب:

يُوضح VisionClaw اتجاهاً أوسع — تقارب ثلاث قدرات:

القدرة	ما توفره	مثال
الذكاء الاصطناعي متعدد الوسائط	الفهم عبر النص والصورة والصوت والفيديو	Gemini Live API
العتاد القابل للارتداء	مستشعرات دائمة في العالم المادي	نظارات Meta Ray-Ban
تنسيق الوكلاء	إجراءات مستقلة بناءً على الفهم	إطار عمل OpenClaw

كل قدرة بمفردها مثيرة للاهتمام. مجتمعة، تُنشئ شيئاً مختلفاً نوعياً: وكيل موجود في العالم المادي، يفهم ما يُدركه، ويمكنه التصرف بناءً على ذلك الفهم.

حدود قدرات الوكلاء

كلا المشروعين يمثلان وكلاء تتجاوز أتمتة سير العمل القائمة:

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

الخيط المشترك هو الإجراء المستقل في بيئات معقدة. الوكيل لا ينتظرك لتخبره بما يفعله بعد ذلك — إنه يُدرك ويُقرر ويتصرف ضمن الحدود التي حددتها.

النقطة الرئيسية: الوكلاء المتقدمة لا تُؤتمت المهام فحسب — بل تُمكّن قدرات لا يستطيع البشر وحدهم الحفاظ عليها. وكلاء التداول توفر تنفيذاً متسقاً بلا عاطفة. وكلاء الرؤية توفر إدراكاً مستمراً وفهماً سياقياً. كلاهما يتطلب تحديد حدود دقيقة: الوكيل يتصرف ضمن قيود صارمة، والبشر يحددون تلك القيود.

التالي: تحويل مهاراتك في بناء الوكلاء إلى عمل تجاري — النماذج واستراتيجيات التسعير وأساليب اكتساب العملاء التي تنجح. :::