تهيئة TradingAgents API
Updated 2026-09-06
صل عميل النموذج الموثق ثم تحقق من رسم البحث بصورة منفصلة. يغطي هذا الدليل الذي راجعته المصادر تهيئة المزود وتبعيات البيانات المالية وتجربة أولى محدودة.
ابدأ بسؤال بحث ذي إصدار
اضبط المزود المتوافق وعنوان backend المخصص ودوري نموذج، ثم اختبر شركة واحدة في تاريخ بحث محدد. ينظم TradingAgents المحللين وحجج البحث المتعارضة ومراجعة المخاطر؛ لذا تتمثل المهمة الأولى المفيدة في فحص كيفية شرح هذه الأدوار لحزمة المصدر نفسها. اختر الشركة وموعد قطع المعلومات قبل تغيير النماذج. احتفظ بالحقائق الأساسية والعناصر غير المحسومة من التشغيل الأول حتى تستخدم مقارنات النماذج اللاحقة السؤال نفسه. تتبع الحقول أدناه مراجعة service 9dee508c.
هيّئ المزود المتوافق ودوري النموذج
تعرض default_config.py التي راجعناها llm_provider وbackend_url وdeep_think_llm وquick_think_llm. يستخدم العميل المتوافق نقطة النهاية المقدمة، بينما المصادقة إعداد بيئة منفصل. يحتاج موضعا الدورين إلى معرّف نموذج دقيق يقبله العميل ونقطة النهاية المختاران. يكيّف المثال حقول المصدر تلك ولا ينشئ إلا التهيئة. عيّن RESEARCH_MODEL_ID وSUMMARY_MODEL_ID من الكتالوج الحالي بعد فحص القدرات المطلوبة. هذه الأسماء مواضع بيئة محلية وليست معرّفات نموذج أو إعدادات TradingAgents الافتراضية. احتفظ ببيانات الاعتماد في بيئة العملية لا في البرنامج.
import os
from copy import deepcopy
from tradingagents.default_config import DEFAULT_CONFIG
config = deepcopy(DEFAULT_CONFIG)
config.update({
"llm_provider": "openai_compatible",
"backend_url": "https://api.apisrouter.com/v1",
"deep_think_llm": os.environ["RESEARCH_MODEL_ID"],
"quick_think_llm": os.environ["SUMMARY_MODEL_ID"],
"max_debate_rounds": 1,
"max_risk_discuss_rounds": 1,
})
assert os.environ["OPENAI_COMPATIBLE_API_KEY"]
# Configuration only. This does not start a research run.أبقِ مسار النموذج منفصلًا عن البيانات المالية
هيّئ موردي البيانات المالية بصورة مستقلة عن نقطة نهاية النموذج. بالنسبة للأسهم الدولية، احسم هوية المُصدر ورمز البورصة قبل الجمع. احتفظ بعملة التداول وعملة التقرير والمنطقة الزمنية للسوق واختيار المعيار. يحتاج إيصال إيداع مدرج في الولايات المتحدة وسهمه العادي الأساسي إلى قاعدة تحويل صريحة قبل مقارنة سلسلتي السعر. يوضح الرسم اتصال إعدادات النموذج؛ وتحتفظ أدوات البيانات المالية ببيانات اعتمادها وتغطيتها وطوابع مصدرها. افحص هذه الأدوات قبل تشخيص مدخل بحث مفقود كفشل LLM.
اختر الأدوار وفق عقد المهمة
اختبر القدرات التي يستخدمها كل دور فعليًا. الرد النصي لا يثبت تحليل استدعاءات الأدوات أو معالجة السياق الطويل أو سلوك المخرج المنظم. وقد يغير تبديل عائلة نموذج سلوك محول المزود حتى عندما تقبل نقطة النهاية معرّفه. ابدأ بأصغر مجموعة مفيدة من الأدوار وأضف النقاش فقط عندما يحدد ادعاءات غير مدعومة أو دليلًا مضادًا مفيدًا. قيّم الأثر النهائي مقابل حزمة المصدر نفسها بدل اعتبار التقرير الأطول بحثًا أفضل.
| الدور | الدليل المطلوب | الفشل الذي يجب فحصه |
|---|---|---|
| المحلل | نتيجة الأداة ومحدد المصدر | حقائق مختلقة بعد خطأ بيانات |
| مناظرة البحث | حجج مرتبطة بأدلة المحلل | عرض ادعاءات مكررة كأنها تأييد |
| مراجعة المخاطر | افتراضات صريحة وعناصر غير محسومة | موقف واثق دون مدخلات متحققة |
استخدم اختبار قبول مرحليًا للتشغيل الأول
افحص التهيئة المحلولة أولًا دون طباعة المفاتيح. ثم، في بيئة تنفيذ مصرح بها، شغّل عميل المشروع بالنموذج المختار واحتفظ بسجل طلب منقح. اختبر بعد ذلك تفاعل أداة مطلوبًا ومسار خطئه. وأخيرًا شغّل TradingAgentsGraph بمجموعة مصادر محدودة وافحص الحالة الناتجة والحقائق المستشهد بها ومخرج البحث النهائي. احفظ مراجعة المستودع وإصدارات التبعيات وتجزئات الإدخال وإعدادات الأدوار. تجتاز استجابة المصنع مرحلة العميل فقط؛ ويحتاج التقرير الكامل إلى مراجعة المصدر والأرقام قبل اعتباره أثر بحث مفيدًا.
import os
from research_config import config
from tradingagents.graph.trading_graph import TradingAgentsGraph
graph = TradingAgentsGraph(debug=False, config=config)
state, decision = graph.propagate(
os.environ["RESEARCH_TICKER"],
os.environ["RESEARCH_DATE"],
)
# Inspect state and decision against the source packet.
# Running this template makes model and data requests.احمِ البحث التاريخي من المعلومات اللاحقة
لا يثبت تاريخ التحليل المطلوب أن كل استجابة للمزود من نقطة زمنية. تحقق من إتاحة الأساسيات حتى موعد القطع وتصحيح المقالات لاحقًا ومجيء البيانات المخزنة من تجربة أخرى. احتفظ بوقت النشر الأصلي ووقت الإدخال منفصلين. أبقِ تغذية التدريب أو التأمل خارج فترة التقييم المحجوزة. يجب أن تتضمن قوائم الرموز التاريخية عمليات الشطب وتغييرات الرموز ذات الصلة. سجّل معالجة إجراءات الشركات ومعيار المقارنة مع كل تجربة حتى لا يختلط تغيير النموذج بتغيير البيانات.
ضع ميزانية للنقاش والإعادات والسياق المتكرر
يأتي إنفاق الوكيل المالي من كل طلب في الرسم، بما في ذلك الملخصات والسياق المتكرر والإعادات المفوترة. استخدم عقد التسعير الحالي للتخطيط وطابق استخدام الطلب الفعلي لاحقًا. حدّد جولات النقاش وحجم المصدر والمهام المتوازية والإعادات الآلية قبل المسح. خزّن استخراج المصدر باستخدام إصدارات الوثائق وميّز إعادة استخدام التطبيق عن خصم فوترة المزود. تابع اشتراكات البيانات والحساب المحلي منفصلين عن رسوم LLM وقارن التكلفة لكل أثر بحث مقبول. ابدأ بالتشغيل المحدود أعلاه قبل توسيع كون الرموز والتواريخ.
شخّص المرحلة التي فشلت
في إخفاق المصادقة، تحقق من وصول مفتاح المزود المتوافق إلى العملية التي تنشئ العميل. وفي النماذج المفقودة، قارن المعرّف الدقيق ووصول الحساب بالكتالوج الحالي. وفي مخرج أداة مشوه، احتفظ بمخطط الأداة والاستجابة المنقحة لا الاستثناء النهائي فقط. قد يكون التوقف طلبًا لمورد بيانات أو حلقة أداة متكررة أو مهلة نموذج؛ افحص طوابع مراحل الوقت قبل زيادة الحدود. توقف عند غياب البيانات الإلزامية. قد يخفي التكرار حتى ظهور النثر الفشل الأصلي ويستهلك ميزانية البحث كلها.
الأدلة والقيود
راجعت المصادر التهيئة في 5 سبتمبر 2026 عند المراجعة 9dee508c. الأمثلة قوالب شرح؛ لم تُنفذ طلبة عميل APIsRouter أو رسم كامل أو حالة تكلفة مقاسة لهذا الدليل. تحقق من النماذج وأدوات البيانات المختارة في تشغيل محدود خاص بك قبل توسيع سير العمل.
الأسئلة الشائعة
أي مفتاح يقرأه openai_compatible؟
يربط المزود الذي راجعناه ذلك بـ OPENAI_COMPATIBLE_API_KEY. اضبطه في بيئة التنفيذ وتحقق من المزود المحلول دون طباعة السر.
هل يمكن للدورين استخدام نموذجين مختلفين؟
تحتوي التهيئة على حقلي deep_think_llm وquick_think_llm منفصلين. تحقق من المعرّفين الدقيقين وكل قدرة مطلوبة؛ ولا يثبت اشتراكهما في نقطة نهاية واحدة التوافق.
هل توفر نقطة النهاية أسعار الأسهم؟
لا. تأتي بيانات السوق عبر أدوات موردين مهيأة منفصلة، لكل منها تغطية وبيانات اعتماد وترخيص وتوفر خاص.
أي تاريخ ينبغي تمريره إلى propagate؟
استخدم تاريخ البحث المقصود وتحقق بصورة منفصلة من احترام كل أداة بيانات لموعد قطع المعلومات. لا يجعل وسيط التاريخ وحده البيانات الحالية من نقطة زمنية.
كيف أختار دوري النموذجين؟
استخدم معرّفات كتالوج حالية واختبر الأدوات وصيغ المخرج المطلوبة، ثم قارن تقارير مقبولة من حزمة المصدر نفسها قبل تغيير أي دور.
هل يثبت الرسم الناجح استراتيجية تداول؟
لا. يثبت نتيجة سير عمل تحت المدخلات المختبرة. يحتاج تقييم الاستراتيجية إلى بيانات من نقطة زمنية وتقييم مستقل وافتراضات تنفيذ واقعية.