الوثائق1.0 (latest)
الصفحاتأدوات QuantCraft · 27 / 29

QuantCraft Tools

QuantCraft Tools مجموعة مدمجة من أدوات السوق للقراءة فقط يمكن للذكاء الاصطناعي استدعاؤها نيابةً عنك — في دردشة QuantCraft AI، وفي عقدة AI Prompt لدى الوكيل، وفي وكلاء الذكاء الاصطناعي Test / Optimization. فبدلًا من تخمين الأسعار أو نسخ الأرقام إلى موجّهك، يجلب النموذج ما يحتاج إليه ويستدل على البيانات الحقيقية.

وهي مفعّلة افتراضيًا. أدِرها من AI ← MCPs في القائمة العليا: QuantCraft Tools (built-in) هو الصف الأول، مع خانة Enabled for chat، إلى جانب أي خوادم MCP مخصّصة تضيفها. وتؤثر هذه الخانة على الدردشة فقط — أما عقد AI Prompt فلديها الأدوات دائمًا.


ما تفعله الأدوات

الأداةما تُرجعه
get_ohlcvأعمدة OHLCV الحديثة لرمز (حتى 60).
compute_indicatorأحدث قيمة (أو قيم) لمؤشر — rsi وmacd وbollinger وatr وadx وvwap وsupertrend وبقية مجموعة المخططات. تطابق خطوط الخرج المخطط (مثل MACD ← macd / signal / histogram).
get_fundamentalsالبيانات المالية للشركة — الميزانية وقائمة الدخل والتدفق النقدي والأرباح والنسب والقيم لكل سهم والتقييم والدرجات (Piotroski / Altman / Beneish) — عند نقطة زمنية. ويمكن للنموذج طلب fields التي يحتاج إليها فقط. راجع البيانات الأساسية.
run_screenerيشغّل مرشّح بيانات أساسية ويُرجع الرموز المطابقة. راجع الماسح (Screener).
get_accountالرصيد وحقوق الملكية والربح والخسارة المحققة / غير المحققة.
get_positionsالمراكز المفتوحة.

الأدوات الست جميعها للقراءة فقط — يمكن للذكاء الاصطناعي أن يطّلع ولا يتداول أبدًا. أما إرسال الأوامر فيبقى في عقدة Execution لدى الوكيل.


في دردشة المساعد

اطرح سؤالًا عن البيانات فيستدعي النموذج أداة في منتصف الإجابة — سترى حالة مثل Calling MCP (QuantCraft Tools): get_ohlcv أثناء تشغيلها. أمثلة:

  • «ما آخر إغلاق لـ AAPL ومؤشر RSI لـ 14 يومًا؟»
  • «اعثر على الشركات الكبرى الرابحة التي تتداول بأقل من 15 ضعف الأرباح.»
  • «كم لدي من القوة الشرائية وما الذي أحتفظ به؟»

تستخدم get_ohlcv وcompute_indicator وget_account وget_positions حساب Trade المتصل لديك للبيانات الحية. وبلا حساب متصل تُبلّغ بأن البيانات غير متاحة (تقول get_account «not connected») بدل أن تفشل. وتستخدم get_fundamentals جلسة QuantCraft المسجّل دخولها (نفس الوصول الذي يغذّي البيانات الأساسية للاختبارات الرجعية)؛ وعند تسجيل الخروج تُبلّغ «not available».


في عقدة AI Prompt لدى وكيل

عند تشغيل عقدة AI Prompt، يمكن للنموذج استدعاء الأدوات نفسها — ضمن نطاق ذلك التشغيل:

  • تَرى get_ohlcv / compute_indicator أعمدة التشغيل نفسه لرمز التشغيل.
  • تراعي get_fundamentals تاريخ الإيداع الصحيح للعمود الحالي.
  • تقرأ get_account / get_positions حساب التشغيل التجريبي أو الحقيقي.

وهكذا فإن موجّهًا مثل:

«استخدم compute_indicator وget_fundamentals لتقرر ما إذا كان هذا دخول قيمة. أجب بـ true أو false.»

…يتيح للعقدة جمع الأدلة قبل أن تجيب، بدل أن تحمّل كل شيء مسبقًا في نص الموجّه.

ملاحظات:

  • تعمل مع QuantCraft Premium (منحة Claude فقط)، ومفتاح Anthropic أو OpenCode متصل، ونقاط نهاية Custom LLM المستضافة ذاتيًا (متوافقة مع OpenAI وتدعم استدعاء الأدوات). وDeepSeek — بمفتاح خاص أو مستضاف — غير مدعوم في عقد AI Prompt.
  • يقيّم الاختبار العقدة عند كل تقييم مجدول (فاصل الأعمدة في Scheduler)، وكل جولة أدوات هي استدعاء نموذج، لذا فإن ميزانية استدعاءات الذكاء الاصطناعي (500 استدعاء لكل اختبار) تغطي استخدام الأدوات أيضًا. ضيّق النطاق الزمني أو استخدم جدولًا أقل كثافة إذا بلغتها. ولا يوجد إعداد لتغيير الميزانية أو لإيقاف الأدوات لعقدة.
  • run_screener داخل التشغيل محدود بنحو 45 ثانية لكل استدعاء (أو يتوقف عند الضغط على Stop)؛ وتُرجَع نتيجة جزئية وتُوسَم كذلك.
  • يظهر كل استدعاء أداة في علامة تبويب Output الخاصة بالعقدة مع ملخص من سطر واحد.

في وكلاء Test / Optimization

يمكن لوكلاء الذكاء الاصطناعي Test وOptimization استخدام الأدوات نفسها عند تحديد Allow market data tools في إعدادات الوكيل (معطّل افتراضيًا). راجع الوكلاء.


انظر أيضًا

  • QuantCraft AI — ربط نموذج وأدوات الذكاء الاصطناعي وخوادم MCP
  • الوكلاء — عقد AI Prompt وAI Builder ووكلاء Test / Optimization
  • الماسح (Screener) — المرشّحات الكامنة خلف run_screener
3 دقائق للقراءةاقترح تعديلًا ↗
أدوات QuantCraft — الوثائق (1.0 (latest)) | QuantCraft