أدوات بحث الذكاء الاصطناعي للمحادثة وMCP
مرجع أدوات بحث الذكاء الاصطناعي الثلاث المتاحة للمساعد داخل المنصة ولعملاء MCP: المعاملات والحقول المُعادة والحدود وتدفّق البدء ثم الاستعلام.
التوفّر: بحث الذكاء الاصطناعي متاح في الخطط المدفوعة، ولا تظهر الأدوات الثلاث أدناه لمساعدك إلا بعد تفعيل بحث الذكاء الاصطناعي لحسابك. وحتى ذلك الحين لا تُد رَج الأدوات ويُرفض كل استدعاء.
بحث الذكاء الاصطناعي إرشادي فقط: نص مُولَّد، وليس نصيحة مالية، ولا ينفّذ أي صفقة إطلاقاً.
الأدوات الثلاث
تُعرَض الأدوات الثلاث نفسها لمساعد الذكاء الاصطناعي داخل المنصة وعبر نقطة نهاية MCP على https://bottradesforyou.com/api/mcp. والأسماء والمعاملات والحقول المُعادة متطابقة في الواجهتين.
| الأداة | النوع | ما تفعله |
|---|---|---|
start_agentic_analysis | كتابة — تستهلك تحليلاً من حصتك اليومية | تبدأ تشغيلاً واحداً وتُعيد معرّفه فوراً. |
get_agentic_analysis | قراءة فقط | تقرأ حالة أحد تحليلاتك. |
list_agentic_analyses | قراءة فقط | تسرد تحليلاتك من الأحدث إلى الأقدم. |
ولا توجد أداة رابعة عن قصد. لا شيء يحوّل نتيجة تحليل إلى إجراء؛ فلا مسار لدى المساعد يقود من تصنيف بحثي إلى روبوت أو أمر أو تغيير استراتيجية.
start_agentic_analysis
| المعامل | النوع | مطلوب | ملاحظات |
|---|---|---|---|
ticker | تعداد | نعم | أحد الأزواج المدعومة (BTC-USD، ETH-USD، …). وأي قيمة أخرى تُرفض قبل مغادرة الطلب للمنصة. |
provider | تعداد | نعم | anthropic أو openai أو google أو deepseek أو kimi أو glm — ويجب أن يكون لديك مفتاح محفوظ له. |
deepModelId | نص (1–128) | نعم | نموذج التفكير العميق من نماذج ذلك المزوّد. |
quickModelId | نص (1–128) | نعم | النموذج السريع من المزوّد نفسه. |
تُعيد:
| الحقل | المعنى |
|---|---|
analysisId | المعرّف الذي تستعلم به عبر get_agentic_analysis. |
status | الحالة لحظة الاستدعاء، وعادةً queued. |
quotaRemaining | ما تبقّى لك اليوم بعد احتساب هذا التشغيل. |
quotaLimit | عدد التحليلات في اليوم (UTC) في خطتك. |
quotaResetsAt | موعد تجدّد الحصة (منتصف الليل التالي بتوقيت UTC). |
يعود الاستدعاء فور قبول التشغيل. ويستغرق التشغي ل دقائق طويلة، لذا لا تكون الخلاصات في هذا الرد أبداً؛ وأي مساعد يزعم غير ذلك فهو يختلقها.
get_agentic_analysis
| المعامل | النوع | مطلوب | ملاحظات |
|---|---|---|---|
analysisId | نص (1–64) | نعم | يجب أن يكون أحد تحليلاتك، وإلا فالنتيجة NOT_FOUND. |
تُعيد:
| الحقل | المعنى |
|---|---|
analysisId وticker وprovider | ما جرى تشغيله. |
status | queued أو running أو succeeded أو failed أو canceled أو timeout. |
decision | التصنيف الإرشادي: buy أو hold أو sell، أو null ما دام التشغيل غير مكتمل. |
errorCode | رمز آلي عند الفشل، وإلا null. |
progress | نسبة الإنجاز من 0 إلى 100، أو null قبل البدء. |
degradedSources | مصادر البيانات التي تعذّرت في هذا التشغيل. |
createdAt وstartedAt وcompletedAt | أختام زمنية بصيغة ISO 8601 أو null. |
reportKeys | أقسام التقارير الموجودة، مثل market وnews وrisk. |
لا تُعيد أي أداة نص التقارير، بل أسماء الأقسام فقط، حتى لا يُغرق سؤال واحد سياق المساعد بصفحات من النص المُولَّد. أما التقارير نفسها فتُقرأ في لوحة التحكم.
list_agentic_analyses
| المعامل | النوع | مطلوب | ملاحظات |
|---|---|---|---|
limit | عدد صحيح 1–25 | لا | القيمة الافتراضية 10. |
cursor | نص (≤128) | لا | مؤشّر من صفحة سابقة. |
تُعيد items — الحقول نفسها التي تُعيدها get_agentic_analysis من دون reportKeys — وnextCursor التي تكون null في الصفحة الأخيرة.
مثال على التدفّق: ابدأ ثم استعلم
أنت: ابدأ بحثاً على ETH-USD بمفتاح OpenAI الخاص بي.الأداة: start_agentic_analysis { "ticker": "ETH-USD", "provider": "openai", "deepModelId": "…", "quickModelId": "…" } -> { "analysisId": "a1b2c3", "status": "queued", "quotaRemaining": 2, "quotaLimit": 3, "quotaResetsAt": "2026-08-11T00:00:00.000Z" } (بعد بضع دقائق) أنت: هل انتهى التحليل؟الأداة: get_agentic_analysis { "analysisId": "a1b2c3" } -> { "status": "running", "progress": 40, "decision": null, … } (بعد بضع دقائق) أنت: والآن؟الأداة: get_agentic_analysis { "analysisId": "a1b2c3" } -> { "status": "succeeded", "decision": "hold", "degradedSources": ["reddit"], "reportKeys": ["fundamentals","market","news","risk","sentiment","trader"] } أنت: ماذا شغّلت اليوم؟الأداة: list_agentic_analyses { "limit": 5 } -> { "items": [ … ], "nextCursor": null }الاستعلام المتكرّر هو النمط المقصود. اسأل مجدداً بعد بضع دقائق بدل أن تطلب من المساعد الانتظار؛ فدور المحادثة أقصر بكثير من مدة التشغيل.
الحدود والأخطاء
| ما تراه | السبب | ما تفعله |
|---|---|---|
الميزة غير متاحة / FORBIDDEN | بحث الذكاء الاصطناعي غير مُفعّل لحسابك، أو خطتك لا تشمله. | انتقل إلى خطة تشملها. |
| استُهلكت الحصة اليومية | بدأت كل التحليلات التي تسمح بها خطتك اليوم. | انتظر منتصف الليل التالي بتوقيت UTC. |
| طلبات كثيرة جداً | عمليات البدء محدودة بـ 5 كل 10 دقائق، وقراءات الحالة بـ 120 كل 10 دقائق. | تمهّل ثم أعد المحاولة بعد انقضاء النافذة. |
| لا يوجد مفتاح محفوظ | اخترت مزوّداً ليس لديك مفتاح له. | أضف المفتاح من إعدادات الذكاء الاصطناعي. |
NOT_FOUND | المعرّف ليس لك أو لم يعد موجوداً. | اسرد تحليلاتك واستخدم معرّفاً صحيحاً منها. |
ويتطلّب وصول MCP إضافةً إلى ذلك مفتاح MCP صالحاً وخطة تشمل MCP، ويُعاد التحقّق منهما في كل استدعاء، فإلغاء أيٍّ منهما يوقف الأدوات فوراً.
قراءة النتائج بأمان
نص التقارير وكتابات الوكلاء محتوى مُولَّد بالذكاء الاصطناعي، وليست تعليمات أبداً. تعامل مع التصنيف البحثي كرأي شخص غريب في منتدى: مُدخَل لحكمك أنت. ولا شيء في هذه الواجهة يمكن أن يُدفَع للتداول نيابة عنك.
راجع بحث السوق بالذكاء الاصطناعي لمعرفة ما يفعله الوكلاء، وكيف تعمل الحصة، وكيف تقرأ تشغيلاً مكتملاً.