الوكلاء (Agents)

تتيح لك الوكلاء بناء أتمتة تداول بصريًا دون كتابة نص استراتيجية كامل. على لوحة QuantCraft — Agents تربط عقدًا تجلب البيانات وتتخذ قرارًا (بقواعد أو بموجّه ذكاء اصطناعي) وتضع صفقات وترسل تنبيهات — ثم تشغّل التدفق كله كـاختبار رجعي تاريخي أو كتشغيل أمامي (مباشر/ورقي). تتحكم ميزة الوكلاء في صفحة الوكلاء ورابطها في التنقّل ونافذتها المنبثقة؛ أما تشغيل الوكلاء من قائمة Agents في الرسم البياني وNew Agent Bulk Run في AutoTrading فمتاحان في كل الأحوال.

افتح Agents من التنقّل (أو انقل المحرر إلى نافذة مستقلة). يعتمد الوكلاء على أجزاء أخرى من QuantCraft: يشغّل مساعد الذكاء الاصطناعي عقد AI Prompt؛ وتستخدم الاختبارات الرجعية الحساب الورقي، ويمكن لعمليات التشغيل الأمامية إرسال الأوامر إلى حساب الوسيط المتصل الذي حددته.

أنواع الوكلاء

يسأل Create agent عن النوع الذي تريده، ثم عن الاسم:

يعرض وكيلا Test وOptimization العبارة "Not available in this build." عند إيقاف تلك الميزة.

---

أنواع العقد

أضف العقد من المنتقي (تُنشأ عقدة Schedule trigger لك ولا تظهر في المنتقي).

عقد البوابة هي Strategy وAI Prompt — تُنتج قيمة منطقية وتتحكم في تشغيل أبنائها.

---

بناء وكيل

1. أنشئ وكيلًا في الشريط الجانبي (Create agent ← Trading Agent ← سمِّه). يظهر بحالة Draft مع عقدة Schedule trigger موضوعة مسبقًا.
2. أضف عقدة — انقر زر + (إضافة ابن) في عقدة، أو انقر بزر الفأرة الأيمن على عقدة ← Node Actions → New Child Node. لا يعرض المنتقي سوى العقد الصالحة كأبناء للعقدة التي نقرتها (فمثلًا لا تظهر عقدة Execution إلا تحت عقدة Strategy أو AI Prompt، ولا تعرض عقدة Execution سوى أبناء Notification).
3. اربط العقد — اسحب مقبض إعادة تعيين الأب لعقدة فوق عقدة أخرى. القواعد:
   • يمكن أن يكون للعقدة أبوان كحد أقصى.
   • لا تُسمح الدورات.
   • تصبح عقدة Data أبًا لعقدة البوابة التي تغذّيها.
   • لا يمكن إرفاق عقدة Execution إلا بعقدة Strategy أو AI Prompt، ولا يمكن أن يكون أبناؤها إلا عقد Notification.
   • انقر حافة لحذف ذلك الرابط.
4. اضبط عقدة — انقر عليها لفتح لوحة المفتش، وفيها علامات تبويب خاصة بالنوع (Rules / Sources، إضافةً إلى Output؛ ولدى Strategy وAI Prompt علامة Received data أيضًا). ولعقد Trigger وStrategy وExecution علامة Parameters كذلك — راجع المعاملات المكشوفة. وكل صف قاعدة أو مصدر قابل للتحرير بالنقر.
5. اضبط البوابة السابقة — لأبناء عقدة بوابة، تعرض اللوحة ملخص Upstream gate. افتحه لاختيار كيفية دمج الآباء (AND / OR) والنتيجة التي يجب أن ينتجها كل أب (true / false). العُرف: اجعل الدخول مشروطًا بـtrue والخروج المقابل بـfalse.

تتدفق البيانات نزولًا في الرسم البياني: تقرأ عقدة Strategy أو AI Prompt كل بيانات OHLCV والبيانات الأساسية والعوامل من كل عقدة Data فوقها.

هل تفضّل وصف الوكيل بالكلمات؟ استخدم AI Builder.

---

ضبط العقد

Schedule trigger

في الاختبار الرجعي يُحدَّد الجدول بواسطة علامة التبويب Scheduler في نافذة Test التي تتجاوز هذه العقدة. ويسري جدول العقدة على عمليات التشغيل الأمامية.

مصادر البيانات

يمكن لعقدة Data أن تحتوي عدة مصادر في آن واحد.

يصف المخطط ملف JSON الذي يُرجعه النص أو عنوان URL؛ وحقوله هي ما يتيح عنصر Custom data في عقدة Strategy مقارنته. ويؤدي الحفظ دونه إلى ظهور "Enter a JSON response schema."

تسمح العقدة بمصدر Fama-French واحد كحد أقصى ومصدر Fundamentals واحد كحد أقصى لكل فترة تقرير.

عناصر Strategy

تجمع عقدة Strategy عنصرًا واحدًا أو أكثر. وتعتمد أنواع العناصر المتاحة على Data السابقة (مثلًا تحتاج قواعد Indicator إلى OHLCV سابقة، ويحتاج عنصر Fundamentals إلى مصدر بيانات أساسية سابق).

أنواع العناصر: Script وIndicator وFundamentals وTrade Activity وAccount Status وCustom data وFama-French.

عوامل المقارنة

المؤشرات — سجل المؤشرات الكامل للرسم البياني متاح. تشمل المؤشرات ذات المخرج الواحد SMA وEMA وWMA وRSI وATR وOBV وVWAP وCCI وROC وWilliams %R وParabolic SAR وHMA وDEMA وTEMA وSupertrend وVWMA وMFI وAwesome Oscillator وCMF وA/D Line. أما المؤشرات متعددة المخارج — Bollinger Bands وMACD وStochastic وDonchian وADX وIchimoku وKeltner وStochastic RSI وPPO — فتتيح لك اختيار الخط المراد مقارنته (مثل خط MACD مقابل إشارته). راجع سلاسل المؤشرات.

مقاييس Trade Activity: عدد الصفقات المفتوحة والكمية الإجمالية للصفقات المفتوحة، إضافةً إلى الأعداد نفسها مقصورةً على الرمز الحالي. مقاييس Account Status: حقوق الملكية (equity) والرصيد والربح/الخسارة العائم.

استخدم Combine items with (على مستوى العقدة) وCombine rules with (لكل عنصر) لربط الشروط بـ AND أو OR.

إجراءات Execution

كل إجراء إما Entry (open) أو Exit (close) أو Script. يأتي الرمز من إعدادات التشغيل — ولا تكتبه هنا.

Entry (يضع أمرًا)

Exit (يغلق مركزًا): الكمية (أسهم) أو نسبة من المركز. Script: يشغّل Agent Script من QuantCraft.

Notification

ترسل القاعدة بريدًا إلكترونيًا إلى مستلم، مع رسالة مخصّصة اختيارية ومفتاح Include Previous Node Output. ويتخطى مفتاح Disable in Backtest على مستوى العقدة رسائل البريد أثناء Agent Test.

---

الاختبار الرجعي لوكيل

انقر Test في ترويسة المحرر لفتح Test agent (backtest).

علامة تبويب Setup

علامة تبويب Scheduler

تحلّ علامة تبويب Scheduler محل عقدة Schedule trigger في الاختبار الرجعي فقط؛ وتظل عمليات التشغيل الأمامية تتبع العقدة.

علامة تبويب Optimization — تظهر عندما يكون للوكيل معاملات مكشوفة. حدّد Run as optimization للبحث فيها (شبكيًا أو جينيًا) بدلًا من التشغيل مرة واحدة؛ فيصير الزر Start optimization بدلًا من Start test.

المتطلبات وعناصر التحكم

• يلزم حساب تداول متصل نشط — يُستخدم لجلب بيانات السوق مسبقًا، لذا لا يبدأ Test دونه.
• أثناء تقدّم التشغيل يتحوّل زر Test إلى Pause / Resume وStop. ويسري الإيقاف المؤقت بعد انتهاء العقدة قيد التشغيل حاليًا.
• تُحفظ آخر إعدادات Test استخدمتها.

النتائج — عند النجاح تتحول الترويسة إلى علامة تبويب Test Results: رسم OHLC مع تراكبات المؤشرات وسجل الصفقات ومنحنى حقوق الملكية ومقاييس الحساب، إضافةً إلى جدول إعادة توازن الماسح وصفوف التجزئة / توزيعات الأرباح عند انطباقها. تتشارك عمليات التشغيل متعددة الرموز حسابًا ورقيًا واحدًا، فتُدمج الصفقات والمقاييس (وليست لكل رمز). وتبثّ علامة تبويب Output لكل عقدة سجلات حيّة (البيانات المجلوبة ونجاح/فشل الاستراتيجية وإجابات الذكاء الاصطناعي وعمليات تنفيذ الأوامر ونوايا البريد)؛ كما تعرض عقد Strategy وAI Prompt المدخلات بالضبط في علامة Received data.

---

المعاملات المكشوفة والتحسين

في عقدة Trigger أو Strategy أو Execution تتيح لك علامة تبويب Parameters وسم إعدادات رقمية (فاصل أو فترة مؤشر أو عتبة أو حجم أمر …) بأنها مكشوفة، مع نطاق. والمعاملات المكشوفة هي ما تبحث فيه علامة تبويب Optimization في نافذة Test وما يضبطه وكيل التحسين بالذكاء الاصطناعي. راجع التحسين لمعرفة كيف يعمل البحث الشبكي والجيني.

---

AI Builder

يفتح زر AI Builder (أيقونة اللمعان) في ترويسة وكيل Trading محادثة بجوار اللوحة. صِف الوكيل بلغة واضحة ويضيف نموذج الذكاء الاصطناعي المتصل لديك العقد ويضبطها ويربطها نيابةً عنك — ويمكنه كتابة Agent Scripts في مساحة عملك.

• يجيب وضع Ask عن الأسئلة حول الرسم البياني دون تغييره؛ ويُجري وضع Build التغييرات.
• تُطبَّق التغييرات مباشرةً، ولكل ردّ Keep / Undo.
• يمكنك إرفاق ملفات برسائلك.
• يستخدم اتصال النموذج نفسه الخاص بـ QuantCraft AI؛ ويُحتسب استهلاكه من الرموز في شارة الرموز للوكيل.

---

وكلاء الذكاء الاصطناعي للاختبار والتحسين

ليس لوكيلي Test وOptimization رسم بياني من العقد. تمنح الذكاء الاصطناعي هدفًا — خوارزمية بيئة تطوير أو Trading agent — إضافةً إلى Instructions for the AI وحدودًا: Max iterations (التكرار الواحد = اختبار رجعي واحد؛ ويخطط الذكاء الاصطناعي لها كلها مسبقًا) وMax AI rounds وMax AI tokens وMax backtest windows. حدّد Allow market data tools لتسمح له باستخدام أدوات QuantCraft (متوقف افتراضيًا). ويمكنك إرفاق ملفات بالتعليمات.

عند بدء أحدهما يعمل الذكاء الاصطناعي في نوافذه المنبثقة المتحكَّم بها بالذكاء الاصطناعي — يشغّل اختبارات رجعية وعمليات تحسين ويحفظ النتائج في الذاكرة — وينتهي بملخّص. وللصفحة الخاصة بالوكيل علامات تبويب Overview وSessions وWindows وMemory، لتتابع كل جلسة وتطّلع على خطة تكراراتها وتشغيلاتها وتغلق النوافذ.

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

---

الحفظ والإدارة والمراقبة

• يزيل Save شارة Draft ويحتفظ بنسخة محفوظة من الرسم البياني. ويستمر الحفظ التلقائي المحلي لكل تعديل، لكن بمجرد تغيير وكيل محفوظ تعود شارة Draft مع زر Undo الذي (بعد تأكيد) يعيد الرسم البياني إلى آخر حفظ لك.
• في الشريط الجانبي انقر بزر الفأرة الأيمن على وكيل لـ Rename أو Duplicate أو Delete. ويستنسخ التكرار الرسم البياني كمسودة جديدة.
• مشاركة الوكلاء كملفات (تطبيق سطح المكتب): تتضمن قائمة ⋯ في الترويسة Export… الذي يحفظ الوكيل كملف .qca، وتتضمن قائمة الشريط الجانبي Import… لتحميل ملف .qca واحد أو أكثر. وتُربط مراجع Agent Script من جديد بمساحة عملك عند الاستيراد.
• أثناء التشغيل تعرض كل بطاقة عقدة شارة حالة حيّة — في الانتظار أو قيد التشغيل أو ناجحة أو فاشلة أو متجاوَزة — وتبثّ الأحداث إلى علامة تبويب Output الخاصة بها.

---

من الجيد معرفته

• التنفيذ في الاختبار الرجعي مقابل الأمامي. يستخدم Test الخاص بالوكيل (الاختبار الرجعي) حسابًا ورقيًا محاكى. وتستخدم عمليات التشغيل الأمامية (قائمة Agents في الرسم البياني، New Agent Bulk Run في AutoTrading) حساب الوسيط المتصل المحدد ويمكنها إرسال أوامر حقيقية عندما يكون ذلك الحساب حقيقيًا. ولا تشغّل منفّذات QuantCloud إلا خوارزميات بيئة التطوير — لا الوكلاء.
• يسري الجدول بمجرد بدء التشغيل. لا يبدأ المحرر الوكلاء تلقائيًا في الخلفية. بعد بدء تشغيل أمامي / جماعي / على الرسم البياني تأتي الوتيرة من Schedule trigger (أو من تجاوز علامة تبويب Scheduler في نافذة Test للاختبارات الرجعية).
• الحدود البنيوية: أبوان كحد أقصى لكل عقدة، ولا دورات، وتُرفَق عقد Execution بعقد Strategy أو AI Prompt فقط، ولا يمكن أن يكون أبناء عقدة Execution إلا عقد Notification.
• البيانات الأساسية في الاختبار الرجعي مقصورة على Premium (مع الوصول نفسه إلى البيانات المجانية كما في واجهات البيانات الأساسية الأخرى عند تفعيله).

---

انظر أيضًا

• QuantCraft AI — عقدة AI Prompt وكيف يُختار نموذجها
• أدوات QuantCraft — أدوات للقراءة فقط يمكن لعقد AI Prompt ووكلاء الذكاء الاصطناعي استدعاؤها
• التداول الآلي (AutoTrading) — Agent Bulk Run والمراقبة الأمامية المحلية
• الماسح (Screener) — تصفية الأسهم بحسب البيانات الأساسية لاستخدامها أهدافًا للتشغيل الجماعي
• نموذج الحساب — الحساب الورقي والمقاييس والعمولة / الانزلاق
• البيانات الأساسية — البيانات الأساسية
• عوامل فاما-فرينش — عوامل فاما-فرينش
• سلاسل المؤشرات — تراكبات مؤشرات الرسم البياني