LangAlpha v2026.07.22

أداة تسخير وكيل استثمار بطابع الـ vibe
تم بناء LangAlpha للمساعدة في تفسير الأسواق المالية ودعم قرارات الاستثمار.

الإنجليزية ｜ 简体中文 ｜ 日本語

بدء الاستخدام • وثائق API • نواة الوكيل • الخلفية • الويب • واجهة TUI • المهارات • MCP

ثبّت موجزاً إخبارياً مختاراً من لوحة التحكم، وأطلق العنان لتوليد الأفكار، ووجّه وكلاء فرعيين متوازيين لفحص السوق — ثم احصل على خمس أفكار تداول زوجية (طويل/قصير) في لوحة تحكم تفاعلية مضمنة، مخصصة لدفترك.

لماذا LangAlpha

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

من الـ vibe coding إلى الـ vibe investing

مستوحى من هندسة البرمجيات: قاعدة الكود تستمر، وكل إيداع يبني على ما سبقه. نجحت أدوات تسخير الوكلاء البرمجية مثل Claude Code و OpenCode من خلال بناء وكلاء تتبنى هذا النمط، تستكشف السياق الحالي وتبني على العمل السابق. يجلب LangAlpha نفس البصيرة: أعطِ الوكيل مساحة عمل مستمرة، وسيتضاعف البحث طبيعياً.

عملياً، تنشئ مساحة عمل لكل هدف بحثي ("إعادة التوازن للربع الثاني"، "تعمق في الطلب على مراكز البيانات"، "تدوير قطاع الطاقة"). يجريك الوكيل مقابلة حول أهدافك وأسلوبك، وينتج أول تسليماته، ويحفظ كل شيء في نظام ملفات مساحة العمل. عد غداً وستظل ملفاتك، وسلاسل المحادثات، والبحوث المتراكمة موجودة.

أبرز المميزات

• اكتشاف تدريجي للأدوات — أي أدوات MCP تُحمّل كملخص في السياق والوثائق الكاملة تُفرغ في مساحة العمل، مما يسمح للوكيل باكتشاف واستخدام الأدوات عند الطلب حقاً. كما يدعم ربط أدوات JSON بالمهارات ولا يكشفها للوكيل إلا عند تفعيل المهارة.
• الاستدعاء البرمجي للأدوات (PTC) — يكتب الوكيل وينفذ كود Python لمعالجة البيانات المالية من خوادم MCP بدلاً من صب البيانات الخام في نافذة سياق LLM، مما يتيح تحليلاً معقداً متعدد الخطوات مع تقليل هدر الرموز المميزة بشكل كبير.
• النظام البيئي للبيانات المالية — تسلسل هرمي متعدد الطبقات لمزودي البيانات مع أدوات أصلية للاستعلامات السريعة وخوادم MCP لمعالجة البيانات الضخمة، والرسم البياني، والتحليل متعدد السنوات في بيئات معزولة.
• مساحات عمل مستمرة — كل مساحة عمل تقابل بيئة معزولة مخصصة بها أدلة منظمة وملف ملاحظات مساحة العمل (agent.md) الذي يضاعف البحث عبر الجلسات والسلاسل. مخزن ذاكرة طويل الأجل منفصل (.agents/user/memory/، .agents/workspace/memory/) يحتفظ بتفضيلات المستخدم الدائمة والمعرفة عبر البيئات المعزولة، ومخزن مذكرات يديره المستخدم (.agents/user/memo/) يتيح لك رفع ملفات PDF وملاحظات بحثية بصيغة markdown يمكن للوكيل قراءتها عند الطلب.
• مهارات للبحث المالي — سير عمل مسبقة البناء لنماذج التدفقات النقدية المخصومة (DCF)، وإعداد تقارير التغطية، وتحليل الأرباح، والملاحظات الصباحية، وتوليد المستندات، والمزيد — قابلة للتفعيل بأمر شرطة مائلة أو الكشف التلقائي.
• منصة عمل البحث المالي — واجهة ويب تحتوي على رسوم بيانية مالية مضمنة، عارض ملفات متعدد التنسيقات، رسم بياني لـ TradingView، بيانات سوق فورية عبر WebSocket، تعليقات توضيحية مرسومة من قبل الوكيل على الرسوم البيانية، لوحة مصادر لكل جولة، محادثات قابلة للمشاركة، ومراقبة الوكلاء الفرعيين.
• طبقة نماذج متعددة المزودين — تجريد LLM غير مرتبط بمزود معين مع تجاوز تلقائي عند الخطأ.
• الأتمتة — جدولة مهام متكررة أو لمرة واحدة، أو تشغيل أتمتة تعتمد على السعر حيث يتم تفعيلها عندما يصل سهم أو مؤشر إلى شرط سعر فوري.
• السكرتير — وكيل الفلاش يعمل كسكرتير: إنشاء وإدارة مساحات العمل، إرسال تحليلات PTC عميقة في الخلفية، مراقبة المهام الجاري تشغيلها، واسترجاع النتائج — كل ذلك من خلال أوامر محادثة مع موافقة بشرية في الحلقة.
• سرب الوكلاء — وكلاء فرعيون متوازيون غير متزامنون مع نوافذ سياق معزولة، مجموعة أدوات/مهارات محملة مسبقاً، توجيه أثناء التنفيذ، استئناف قائم على نقاط التفتيش، ومراقبة حية للتقدم في الواجهة.
• التوجيه الحي — إرسال رسائل متابعة أثناء عمل الوكيل/الوكيل الفرعي لتصحيح المسار أو التوضيح أو إعادة التوجيه دون انتظار انتهائه.
• حزمة البرامج الوسيطة — حزمة برامج وسيطة عميقة وقابلة للتكوين تدير تحميل المهارات، وضع التخطيط، الإدخال متعدد الوسائط، الضغط التلقائي، وإدارة السياق لدعم جلسات الوكيل الطويلة.
• الأمان وخزنة مساحة العمل — تشفير أثناء التخزين عبر pgcrypto، كشف تلقائي لتسرب بيانات الاعتماد وتنقيحها، تنفيذ معزول، وتخزين أسرار لكل مساحة عمل للوصول الآمن للوكيل.
• تكاملات القنوات — استخدم LangAlpha من Slack و Discord و Feishu و Telegram، بالإضافة إلى التسليم عبر البريد الإلكتروني للنتائج المجدولة.
• بنية تحتية جاهزة للإنتاج — نشاط الوكيل المدفوع عبر SSE مع إعادة تشغيل معوض بذاكرة Redis مؤقتة، تنفيذ خلفي منفصل عن اتصالات HTTP، واستمرارية الحالة المدعومة بـ PostgreSQL.

ما الذي يشغله

هندسة النظام```mermaid %%{init: {'theme': 'neutral'}}%%

flowchart TB Web["Web UI
React 19 · Vite · Tailwind"] -- "REST · SSE" --> API Web -- "WebSocket" --> WSP CLI["CLI / TUI"] -- "REST · SSE" --> API

subgraph Server ["FastAPI Backend"]
    API["API Routers<br/>Threads · Workspaces · Market Data<br/>OAuth · Automations · Skills"]
    WSP["WebSocket Proxy"]
    API --> ChatHandler["Chat Handler<br/>LLM Resolution · Workflow Dispatch"]
    ChatHandler --> BTM["Background Task Manager<br/>Decoupled Execution · Workflow Lifecycle"]
end

subgraph PostgreSQL ["PostgreSQL — Dual Pool"]
    AppPool[("App Data<br/>Users · Workspaces · Threads<br/>Turns · BYOK Keys · Automations")]
    CheckPool[("LangGraph Checkpointer<br/>Agent State · Checkpoints")]
end

subgraph Redis ["Redis"]
    EventBuf[("SSE Event Buffer<br/>150K events · Reconnect Replay")]
    DataCache[("API Cache<br/>Market Data · SWR")]
    Steering[("Steering Queue<br/>User Messages Mid-workflow")]
end

BTM --> AppPool
BTM --> CheckPool
BTM --> EventBuf
BTM --> Steering
API --> DataCache

BTM -. "Sandbox API" .-> Daytona["Daytona<br/>Cloud Sandboxes"]
API -. "REST" .-> FinAPIs["Financial APIs<br/>FMP · SEC EDGAR"]
WSP -. "WebSocket" .-> GData["ginlix-data<br/>Polygon.io · Massive"]

### طبقة النماذج متعددة المزودين

يعمل LangAlpha على طبقة نماذج غير مرتبطة بمزود معين، تُجرد عبر واجهات خلفية متعددة للـ LLM. تعمل نفس مجموعة الوسائط البرمجية، الأدوات، وسير العمل بغض النظر عن النموذج الذي يقوم بتشغيلها. يأتي مع وضعين:

- **وضع PTC** للبحث الاستثماري العميق متعدد الخطوات. يدفع الاستدلال القوي التحليل متعدد الخطوات حيث يخطط الوكيل لنهجه، ويفكر في البيانات المالية، ويكتب كودًا للتحليل المعقد. السياق الطويل يتيح الرجوع إلى إيداعات هيئة الأوراق المالية وتقارير البحث في مسار واحد.
- **وضع Flash** للردود السريعة في المحادثة وتنسيق مساحات العمل: استعلامات سوقية سريعة، الرسم البياني والدردشة في MarketView، أسئلة وأجوبة خفيفة، وسكرتير يدير مساحات العمل، ويُرسل تحليلات PTC العميقة في الخلفية، ويعيد النتائج عبر محادثة طبيعية.

**احضر نموذجك الخاص** — استخدم اشتراكاتك الحالية في الذكاء الاصطناعي ومفاتيح API مباشرة. يمكنك ربط اشتراكات ChatGPT أو Claude عبر OAuth (OpenAI Codex OAuth، Claude Code OAuth)، أو استخدام خطط البرمجة من Kimi (Moonshot)، GLM (Zhipu)، MiniMax، أو Doubao (Volcengine)، أو توفير مفاتيح API الخاصة بك لأي مزود مدعوم عبر BYOK. جميع المفاتيح مشفرة في حالة السكون عبر PostgreSQL pgcrypto (راجع [الأمان](#security)).

**مرونة النموذج** — إعادة محاولة تلقائية عند الأخطاء المؤقتة، ثم التحويل إلى نموذج بديل مُكوّن. يتم توحيد جهد الاستدلال (`منخفض`/`متوسط`/`عالي`) عبر المزودين تلقائيًا.

### الاستدعاء البرمجي للأدوات (PTC) وهندسة مساحات العمل

تتفاعل معظم وكلاء الذكاء الاصطناعي مع البيانات من خلال استدعاءات أدوات JSON فردية تُفرغ النتيجة مباشرة في نافذة السياق. يعكس الاستدعاء البرمجي للأدوات (PTC) هذا: بدلاً من تمرير البيانات الخام عبر LLM، يكتب الوكيل وينفذ الكود داخل صندوق رمل سحابي [Daytona](https://www.daytona.io/) يعالج البيانات محليًا ويعيد فقط النتيجة النهائية. هذا يقلل بشكل كبير من هدر الرموز المميزة مع تمكين تحليل كان سيتجاوز حدود السياق.

**سير تنفيذ PTC**```mermaid
%%{init: {'theme': 'neutral'}}%%

flowchart LR
    LLM["LLM"] -- "1 — Writes Python" --> EC["ExecuteCode Tool"]
    EC -- "2 — Sends to sandbox" --> Run["Code Runner"]

    subgraph Sandbox ["Daytona Cloud Sandbox"]
        Run -- "3 — import tools.*" --> Wrappers["Generated Wrappers<br/>One module per MCP server"]
        Wrappers -- "4 — JSON-RPC stdio" --> MCP["MCP Servers<br/>Subprocesses in sandbox"]
    end

    MCP -- "5 — REST / WS" --> APIs["Financial APIs<br/>FMP · Yahoo · Polygon"]
    APIs -- "6 — Data" --> MCP
    Run -- "7 — stdout · charts · files" --> EC
    EC -- "8 — Result" --> LLM

بالإضافة إلى ذلك، تتيح بيئة مساحة العمل الاستمرار بعد جلسة واحدة. يحتوي كل صندوق حماية على تخطيط دليل منظم — work/<task>/ لمناطق العمل الخاصة بالمهمة (البيانات والمخططات والرمز)، وresults/ للتقارير النهائية، وdata/ لمجموعات البيانات المشتركة — وهذا يضمن بقاء النتائج الوسيطة عبر الجلسات. في الجذر يوجد agent.md، ملف ملاحظات مساحة العمل الذي يحتفظ به الوكيل عبر سلاسل المحادثة: أهداف مساحة العمل، والنتائج الرئيسية، وفهرس سلاسل المحادثة، وفهرس ملفات للأعمال الفنية الهامة. تقوم طبقة وسيطة بحقن agent.md في كل استدعاء للنموذج، بحيث يكون لدى الوكيل دائمًا السياق الكامل للعمل السابق دون إعادة قراءة الملفات. بشكل متوازٍ، يلتقط نظام ذاكرة طويل الأجل مدعوم بالتخزين (.agents/user/memory/، .agents/workspace/memory/) التفضيلات الدائمة للمستخدم ومعرفة عبر الصناديق الحماية التي تبقى بعد إعادة ضبط مساحة العمل، ومخزن ملاحظات يديره المستخدم (.agents/user/memo/) يحتفظ بالمستندات التي تقوم بتحميلها — يتم استخراج النص من ملفات PDF من جانب الخادم ويتم إنشاء البيانات الوصفية بشكل غير متزامن بواسطة LLM بحيث يمكن للوكيل العثور عليها والاستشهاد بها حسب الموضوع. تدعم كل مساحة عمل سلاسل محادثة متعددة مرتبطة بهدف بحث واحد.

ترتبط كل مساحة عمل بصندوق حماية دائم — نظّم البحث حسب الموضوع أو المحفظة أو الأطروحة.

يكتب الوكيل كودًا لبناء لوحات معلومات تفاعلية — هنا، تقويم محفزات Mag 7 + أشباه الموصلات.

نظام البيانات المالية

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

الأدوات الأصلية للمرجع السريع عبر استدعاءات الأدوات المباشرة:

• نظرة عامة على الشركة مع أسعار لحظية، وأداء السعر، والمقاييس المالية الرئيسية، وإجماع المحللين، وتوزيع الإيرادات
• إيداعات هيئة الأوراق المالية والبورصات (10-K، 10-Q، 8-K) مع نصوص مكالمات الأرباح وMarkdown منسق للاستشهاد
• مؤشرات السوق وأداء القطاع لسياق السوق العام
• البحث على الويب (Tavily، Serper، Bocha) — اختيار مزود يعتمد على البيان مع عمق متدرج (بحث سريع إلى بحث عميق)، بالإضافة إلى البحث بالصور ووضعي البحث بالذكاء الاصطناعي، قابل للتحديد لكل مستخدم — وزحف الويب مع تحمل الأخطاء بواسطة قاطع الدائرة

خوادم MCP للبيانات الأولية المستهلكة من خلال تنفيذ كود PTC:

• بيانات الأسعار لسلسلة زمنية OHLCV عبر الأسهم والسلع والعملات المشفرة والفوركس، بالإضافة إلى تحليلات الفائدة القصيرة والحجم القصير
• الأساسيات للبيانات المالية متعددة السنوات والنسب ومقاييس النمو والتقييم ومعاملات الداخليين وأرباح الأسهم والانقسامات والأسهم الحرة والمديرين التنفيذيين الرئيسيين والمؤشرات الفنية
• اقتصاد كلي للناتج المحلي الإجمالي ومؤشر أسعار المستهلك والبطالة وسعر أموال الاحتياطي الفيدرالي ومنحنى عائد الخزانة (شهر واحد – 30 سنة) وعلاوات المخاطر القطرية والتقويم الاقتصادي وتقويم الأرباح
• الخيارات لسلسلة الخيارات مع التصفية وبيانات OHLCV التاريخية لعقود الخيارات ولقطات العرض/الطلب الفورية
• مجموعة Yahoo Finance (السعر، الأساسيات، التحليل، السوق) لتغطية رئيسية للبيانات المالية وتصنيفات المحللين والحائزين والفحص والتقويمات
• X (تويتر) لقراءة المنشورات والبحث عن المستخدم/التغريدة وجلب سلسلة التغريدات لتحليل المشاعر وتتبع الأحداث، بالإضافة إلى خادم تجميع للصفحات المقدمة بـ JS والمحمية من البوتات

يختار الوكيل الطبقة المناسبة تلقائيًا: الأدوات الأصلية للبحث السريع الذي يتناسب مع السياق، وأدوات MCP عندما تتطلب المهمة معالجة البيانات بكميات كبيرة، أو رسم المخططات، أو تحليل الاتجاهات متعددة السنوات في صندوق الحماية.

يمكن تكوين خوادم MCP لكل مساحة عمل. يمكن تعطيل الخوادم المضمنة بشكل فردي، ويمكن إضافة خوادم HTTP أو stdio مخصصة — بما في ذلك تلك التي تقرأ بيانات الاعتماد من خزينة مساحة العمل — من خلال API أو واجهة المستخدم، وتصبح سارية المفعول في غضون ثوانٍ دون إعادة تشغيل.

سلسلة الاحتياط لمزود البيانات

يدعم LangAlpha تسلسلًا هرميًا لمزودي البيانات من ثلاث طبقات. كل طبقة اختيارية — يتدهور النظام بأمان عندما تكون الطبقات الأعلى غير متوفرة:

جميع الطبقات ممكّنة افتراضيًا. للتشغيل ببيانات مجانية فقط (Yahoo Finance)، قم بتشغيل make config مع التحديد المطلوب. يمكنك أيضًا تعديل agent_config.yaml يدويًا.

[!NOTE] بيانات Yahoo Finance من مصادر مجتمعية ولها قيود: لا توجد بيانات يومية بفترات أقل من ساعة واحدة، أسعار متأخرة، تغطية محدودة للاقتصاد الكلي، وحدود معدل عرضة. يُوصى بشدة باستخدام FMP_API_KEY (الطبقة المجانية متاحة).

مهارات البحث المالية

يأتي الوكيل مزودًا بـ 23 مهارة بحث مالي مبنية مسبقًا، كل منها قابل للتفعيل بأمر شرطة مائلة أو اكتشاف تلقائي. تتبع المهارات مواصفات مهارات الوكيل ويمكن توسيعها بوضع ملف SKILL.md في مساحة العمل.

إقرار: بعض المهارات مقتبسة من anthropics/financial-services-plugins.

تقدم مهارة تحليل المقارنات نموذج Excel وتقرير PDF — مع نطاقات أسعار مستنبطة من مضاعفات مجموعة النظراء.

الذكاء متعدد الوسائط

يقرأ الوكيل الصور (PNG، JPG، GIF، WebP) وملفات PDF بشكل أصلي — تعترض الطبقة الوسيطة متعددة الوسائط قراءات الملفات، وتنزع المحتوى من صندوق الحماية أو عناوين URL، وتحقنه كـ base64 في المحادثة للتفسير البصري المباشر. في MarketView، يمكن التقاط مخطط الشموع المباشر للمستخدم وإرساله إلى الوكيل كسياق متعدد الوسائط — تشمل اللقطة كلاً من صورة المخطط والبيانات الوصفية المنظمة (الرمز، الفاصل الزمني، OHLCV، المتوسطات المتحركة، RSI، نطاق 52 أسبوعًا) بحيث يمكن للوكيل التفكير في كل من النمط البصري والبيانات الأساسية.

يرسل MarketView المخطط المباشر إلى الوكيل لتحليل فني في الوقت الفعلي.

التعليقات التوضيحية للمخططات التي يرسمها الوكيل

اطلب من الوكيل وضع علامات على مخطط MarketView وسيقوم بالرسم مباشرة على اللوحة — مستويات السعر، خطوط الاتجاه، تصحيحات فيبوناتشي، شارات الأحداث، المستطيلات، وعلامات النص. تتدفق التعليقات التوضيحية مباشرة عبر SSE، وتستمر لكل مساحة عمل ولكل زوج symbol:timeframe (رسم على NVDA:1day يبقى منفصلاً عن NVDA:1hour)، وتعاد تشغيلها عند إعادة الاتصال. عندما تتم المحادثة خارج MarketView، يعرض نص الدردشة بطاقة معاينة مصغرة مع وسيلة شرح التعليقات ورابط بنقرة واحدة للمخطط المباشر. يتم تحميل مهارة التعليقات التوضيحية للمخطط تلقائيًا عند إرسال رسالة من MarketView، لذلك يعرف الوكيل دائمًا أي رمز وإطار زمني يشير إليه "المخطط".

الأتمتة

يمكن للوكيل جدولة مهامه الخاصة من داخل المحادثة — لا حاجة لواجهة مستخدم منفصلة. يمكن للمستخدمين أيضًا إدارة الأتمتة من صفحة الأتمتة المخصصة مع CRUD كامل، وسجل التنفيذ، والتفعيل اليدوي. تشترك جميع أنواع الأتمتة في نفس AutomationExecutor، ووضع الوكيل القابل للتكوين (PTC أو Flash)، والتعطيل التلقائي بعد الفشل المتتالي.

زمني — تعبيرات cron القياسية للجداول المتكررة ("تشغيل هذا التحليل كل يوم اثنين في الساعة 9 صباحًا") وجدولة التاريخ والوقت لمرة واحدة للتنفيذات المستقبلية الفردية.

مدفوع بالسعر — حدد هدف سعر أو حركة نسبة مئوية لأي سهم أو مؤشر رئيسي، وينفذ الوكيل تعليماتك في اللحظة التي يتحقق فيها الشرط. يشترك PriceMonitorService في اتصال WebSocket مشترك إلى ginlix-data للحصول على تغذية في الوقت الفعلي (الأسهم على الطبقة الفورية، المؤشرات على الطبقة المتأخرة). يمنع إلغاء الازدواج المستند إلى Redis المشغلات المكررة عبر مثيلات الخادم.

يمكن دمج الشروط (منطق AND)، وتدعم كل أتمتة سعرية وضع مرة واحدة (تطلق مرة واحدة) أو وضع متكرر مع فترة تهدئة قابلة للتكوين (4 ساعات على الأقل، أو مرة واحدة لكل يوم تداول افتراضيًا).

[!NOTE] تتطلب الأتمتة المدفوعة بالسعر تغذية WebSocket في الوقت الفعلي من ginlix-data. خلال مرحلة البيتا، هذه الميزة متاحة حصريًا على المنصة المستضافة. دعم أوسع لمصادر بيانات WebSocket مخطط له في الإصدارات المستقبلية.

جدولة بحث متكرر — هنا، تحليلات ما قبل الأرباح لـ Mag 7 تعمل تلقائيًا قبل كل تقرير.

هندسة الوكيل```mermaid %%{init: {'theme': 'neutral'}}%%

flowchart TB subgraph Orchestrator ["BackgroundSubagentOrchestrator"] direction TB Agent["Main Agent · LangGraph ReAct"] end

Agent -- "Task(init · update · resume)" --> SubPool
SubPool -- "results" --> Orchestrator

subgraph SubPool ["Subagent Pool — Parallel Async"]
    direction LR
    S1["general-purpose"]
    S2["research"]
    S3["user-defined"]
end

subgraph Middleware ["Middleware Stack"]
    direction LR
    MW1["Tool Safety<br/>Leak Detection<br/>Protected Paths<br/>Error Handling"]
    MW2["Context & Skills<br/>agent.md Injection<br/>Skill Loading<br/>Multimodal"]
    MW3["Coordination<br/>HITL · Plan Mode<br/>Steering<br/>Subagent Dispatch"]
    MW4["Resilience<br/>Compaction<br/>Retry + Fallback<br/>Prompt Caching"]
end

Agent -- "wraps model + tool calls" --> Middleware
Middleware --> LLM["Multi-Provider LLM<br/>OpenAI · Anthropic · Gemini · DeepSeek<br/>Qwen · Kimi · Doubao · GLM · MiniMax · ..."]

Agent <--> Tools

subgraph Tools ["Tool Layer"]
    direction LR
    T1["execute_code<br/>bash"]
    T2["Filesystem<br/>read · write · edit<br/>glob · grep"]
    T3["Finance<br/>Market Data · SEC<br/>Options · Screener"]
    T4["Web<br/>Search · Fetch"]
    T5["ShowWidget<br/>Inline HTML"]
end

T1 <--> Workspace
T2 <--> Workspace

subgraph Workspace ["Workspace — Daytona Sandbox"]
    direction LR
    W1["agent.md<br/>Workspace Notes"]
    W2["work/‹task›/<br/>data · charts"]
    W3["results/<br/>Reports"]
    W4["tools/<br/>MCP Wrappers"]
end

### سرب الوكلاء

الوكيل الأساسي يعمل على [LangGraph](https://github.com/langchain-ai/langgraph) ويطلق وكلاء فرعيين غير متزامنين بالتوازي عبر أداة `Task()`. ينفذ الوكلاء الفرعيون بشكل متزامن مع نوافذ سياق معزولة، مما يمنع الانحراف في سلاسل التفكير الطويلة. يعيد كل وكيل فرعي النتائج المُجمَّعة إلى الوكيل الرئيسي، مما يحافظ على خفة المُنسِّق. يمكن للوكيل الرئيسي اختيار انتظار نتيجة وكيل فرعي أو مواصلة أعمال أخرى معلقة. يمكنك أيضًا التبديل إلى عرض **الوكلاء الفرعيين** في واجهة المستخدم لرؤية تقدمهم في الوقت الفعلي (واجهة ويب فقط).

إلى جانب الإرسال البسيط، يمكن للوكيل الرئيسي إرسال تعليمات متابعة إلى وكيل فرعي لا يزال قيد التشغيل، أو استئناف وكيل فرعي مكتمل مع السياق الكامل للتحسين التكراري. إذا تم إعادة تشغيل الخادم، يتم إعادة بناء حالة الوكيل الفرعي تلقائيًا من آخر نقطة تفتيش له.

<p align="center">
  <img src="https://assets.kitploit.com/production/public/readmes/13458/dd8d54f3a8879372cf72c8a05d6ecce70c53ed0d86c8aed6a49c49276d4f97e4.png" alt="وكلاء فرعيون متوازيون يبحثون في سلسلة حوسبة مركز البيانات مع مخطط زمني تفاعلي لحوسبة الذكاء الاصطناعي" width="800" />
</p>
<p align="center"><em>يعمل الوكلاء الفرعيون للبحث بالتوازي عبر سلسلة الحوسبة — تندمج النتائج في مخطط زمني تفاعلي لحوسبة الذكاء الاصطناعي يغطي NVIDIA وGoogle وAMD وAWS وباقي الصناعة.</em></p>

### مجموعة البرامج الوسيطة

يأتي الوكيل مع مجموعة من البرامج الوسيطة، تتضمن:

- **التوجيه المباشر** — يمكن للوكلاء أن يسلكوا منعطفات خاطئة، أو يتبعوا بيانات غير ذات صلة، أو يسيئوا فهم نيتك أثناء التحليل. يتيح لك التوجيه تصحيح المسار دون انتظار. أرسل رسالة متابعة في أي وقت أثناء عمل الوكيل — تعليمات محدثة، توضيحات، أو أسئلة جديدة كليًا — ويلتقطها الوكيل قبل خطوته التالية، وكأنك قلتها في الوقت الفعلي. يعمل التوجيه على كل المستويات: إعادة توجيه الوكيل الرئيسي، إرسال متابعات لوكلاء فرعيين فرديين في الخلفية، أو السماح للنظام بإعادة الرسائل غير المستهلكة بلطف إلى مربع الإدخال الخاص بك إذا انتهى سير العمل أولاً. لا يُفقد أي عمل، ولا حاجة لإعادة التشغيل.
- **تحميل المهارات الديناميكي** عبر أداة `LoadSkill` التي تتيح للوكيل اكتشاف وتفعيل مجموعات أدوات المهارات عند الطلب، مما يحافظ على سطح الأدوات الافتراضي خفيفًا مع إتاحة القدرات المتخصصة عند الحاجة.
- **متعدد الوسائط** يعترض قراءة الملفات للصور وملفات PDF، ويحمل المحتوى من البيئة الرملية أو عناوين URL، ويحقنه كـ base64 في المحادثة لتتمكن النماذج متعددة الوسائط من تفسيرها بشكل أصلي.
- **وضع التخطيط** مع مقاطعات الإشراف البشري يتيح لك مراجعة استراتيجية الوكيل والموافقة عليها قبل التنفيذ.
- **الضغط التلقائي** يضغط تاريخ المحادثة عند الاقتراب من حدود الرموز، مع الحفاظ على السياق الرئيسي مع توفير المساحة.
- **إدارة السياق** تقوم تلقائيًا بتفريغ نتائج الأدوات الكبيرة إلى نظام ملفات مساحة العمل، مع الاحتفاظ بمعاينة قصيرة في السياق، وتضغط المحادثات الطويلة مع نموها — تلخص الجولات الأقدم مع إبقاء النص الكامل قابلاً للاسترداد في مساحة العمل. يمكن أن تعمل جلسات البحث إلى أجل غير مسمى دون الوصول إلى حدود السياق.

انظر [`src/ptc_agent/agent/middleware/`](https://github.com/ginlix-ai/langalpha/blob/HEAD/src/ptc_agent/agent/middleware/) للمجموعة الكاملة.

إقرار: بعض مكونات البرامج الوسيطة مقتبسة أو مستوحاة من التطبيق في [LangChain DeepAgents](https://github.com/langchain-ai/deepagents).

### البث والبنية التحتية

يقوم الخادم ببث جميع أنشطة الوكيل عبر SSE: أجزاء النص، استدعاءات الأدوات مع الوسائط والنتائج، تحديثات حالة الوكيل الفرعي، آثار عمليات الملفات، ومقاطعات الإشراف البشري. كل قرار يتخذه الوكيل يمكن تتبعه بالكامل في واجهة المستخدم.

تعمل سير العمل كمهام خلفية مستقلة، منفصلة تمامًا عن اتصال HTTP/SSE. إذا تم إغلاق علامة التبويب في المتصفح أو انقطع الاتصال بالشبكة، يستمر الوكيل في العمل. عند إعادة الاتصال، يتم إعادة تشغيل ما يصل إلى 150,000 حدث مخزن مؤقتًا ليلتقط العميل من حيث توقف تمامًا.

يقوم PostgreSQL بدعم نقاط التفتيش الخاصة بـ LangGraph، وتاريخ المحادثة، وبيانات المستخدم (قوائم المراقبة، المحافظ، التفضيلات)، بحيث تستمر حالة الوكيل وسياق المستخدم عبر الجلسات. يقوم Redis بتخزين أحداث SSE مؤقتًا بحيث لا تؤدي تحديثات المتصفح وانقطاعات الشبكة إلى فقدان الرسائل أثناء الإرسال: يعيد العميل الاتصال ويعيد التشغيل تلقائيًا. يتم عرض بيانات المستخدم على الوكيل كملفات JSON افتراضية مدعومة مباشرة بقاعدة البيانات — تقوم عمليات القراءة بتسلسل الصفوف الحية عند الطلب وتطبق عمليات الكتابة في معاملة واحدة تم التحقق منها، دون رحلة ذهاب وإياب للمزامنة مع البيئة الرملية — بينما تتم مزامنة المهارات مع البيئة الرملية عند بدء الجلسة عبر ذاكرة تخزين مؤقت قائمة على البيان، ويتم إعادة تحميلها فقط عند تغييرها. راجع [مرجع API](https://github.com/ginlix-ai/langalpha/blob/HEAD/docs/api/README.md) الكامل للتفاصيل.

### تتبع المصادر

يتم تتبع كل مصدر بيانات خارجي يلمسه الوكيل وإظهاره. يسجل برنامج وسيط للتتبع كل بحث ويب، جلب صفحة، إيداع لدى SEC، استدعاء بيانات سوق، استدعاء أداة MCP، وقراءة ملف في مساحة العمل — بما في ذلك الوصول الذي تقوم به الوكلاء الفرعيون في الخلفية — ويصدر حدث دفق `provenance` لكل مصدر، ولا يدخل أي منها في سياق LLM. تقوم واجهة المستخدم بعرض هذه المصادر كلوحة مصادر بجانب كل جولة: مصادر مجمعة حسب النوع، أيقونات مفضلة للمواقع الإلكترونية، وعرض تفصيلي يكشف المزود، الطابع الزمني، الوسائط الملتقطة، بصمة محتوى، ومقتطف. مفتاح تبديل *هذه الجولة / جميع المصادر* يكشف عن بصمة البيانات الكاملة عبر سلسلة المحادثة بأكملها، والنقر على مصدر ملف أو مذكرة يفتحه مباشرة في لوحة ملفات مساحة العمل — مسار تدقيق كامل للبيانات وراء كل مخرج بحث.

## الأمان وخزانة مساحة العمل

يطبق LangAlpha نموذج أمان متعدد الطبقات عبر بيانات الاعتماد، تنفيذ الكود، والأسرار التي يوفرها المستخدم.

**التشفير عند التخزين** — يتم تشفير جميع البيانات الحساسة (مفاتيح API من نوع BYOK، رموز OAuth، أسرار الخزانة) داخل PostgreSQL باستخدام `pgcrypto`. لا يتم تخزين النص الصريح في قاعدة البيانات أبدًا.

**كشف تسرب بيانات الاعتماد** — يتم فحص كل مخرج من مخرجات الأدوات قبل وصوله إلى سياق LLM. تقوم البرامج الوسيطة بحل جميع قيم الأسرار المعروفة (مفاتيح خادم MCP، رموز البيئة الرملية، أسرار الخزانة) وتقوم بحذف أي تطابق كـ `[REDACTED:KEY_NAME]`. ينطبق نفس الحذف على الأسطح الموجهة للبشر — يتم تنظيف قراءات الملفات والتنزيلات قبل الوصول إلى العميل.

**تنفيذ الكود في بيئة رملية** — تعمل كل مساحة عمل في بيئة رملية سحابية خاصة بها [Daytona](https://www.daytona.io/) مع نظام ملفات وحدود شبكة مخصصة. تمنع حراس المسارات المحمية الوكيل من الوصول إلى أدلة النظام الداخلية — مما يمنع كل من إدخال الأداة (تقصير الاستدعاء قبل التنفيذ) وإخراج الأداة (حذف المسارات المسربة).

### خزانة مساحة العمل

تحتوي كل مساحة عمل على خزانة أسرار مدمجة لتخزين مفاتيح API وبيانات الاعتماد التي يمكن للوكيل استخدامها أثناء تنفيذ الكود — مفيدة للوصول إلى مصادر بيانات خارجية (واجهات برمجة تطبيقات الوساطة، موردي بيانات خارجيين، إلخ) أو بناء سير عمل مدعوم بـ LLM داخل مساحة العمل. قم بتخزين سر مرة واحدة في واجهة المستخدم، وسيكون متاحًا لكل جلسة وكيل في تلك المساحة عبر واجهة برمجة تطبيقات Python بسيطة:```python
from vault import get, list_names, load_env

api_key = get("MY_API_KEY")       # retrieve a single secret
names = list_names()               # list available secret names
load_env()                         # bulk-load all secrets as env vars

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

الواجهة الأمامية

واجهة المستخدم على الويب هي أكثر من مجرد واجهة دردشة — إنها منصة عمل بحثية كاملة:

• لوحة تحكم قابلة للتخصيص — ابدأ من تخطيط محدد مسبقًا (Morning Brief, Trader, Researcher, Agent Desk, Trader (TradingView), أو Portfolio Steward) أو أنشئ تخطيطك الخاص من معرض الويدجتات الذي يغطي الأسواق والذكاء والسياق الشخصي وأسطح الوكيل واختصارات مساحة العمل
• رسوم بيانية مالية مضمّنة — نتائج الأدوات تُعرض كرسوم خطية تفاعلية ورسوم شريطية وبطاقات نظرة عامة مباشرة في سلسلة المحادثة
• ويدجتات HTML مضمّنة — يمكن للوكيل عرض تصورات HTML/SVG تفاعلية (مخططات Chart.js، بطاقات قياسية، جداول بيانات) مباشرة في الدردشة عبر أداة ShowWidget، مع تنسيق متوافق مع السمة وإطارات iframe معزولة
• تقارير بحثية HTML — يكتب الوكيل مستندات HTML كاملة ذاتية الاحتواء إلى results/، تُخدم بدلالات متصفح حقيقية (تعمل البرامج النصية، تُحمل مكتبات CDN، تُحل الأصول النسبية)، قابلة للعرض بملء الشاشة والتصدير إلى PDF — متميزة عن الويدجتات المضمّنة ولوحات المعلومات الحية
• عارض ملفات متعدد التنسيقات — PDF (صفحات قابلة للتكبير)، Excel، CSV، معاينة HTML، وكود المصدر (محرر Monaco مع وضع الفروق) — كلها قابلة للعرض مضمّنة دون تحميل
• رسم بياني TradingView — مخطط TradingView المتقدم الكامل مع أدوات الرسم والمؤشرات وتنسيق الشموع الاحترافي
• بيانات سوق حية — تغذية أسعار WebSocket في الوقت الفعلي بدقة علامة 1 ثانية (الأسهم الأمريكية)، تصور ساعات التداول الممتدة، وتراكبات متعددة للمتوسطات المتحركة
• تعليقات الوكيل على المخططات — يضع الوكيل علامات على مخطط MarketView بمستويات الأسعار وخطوط الاتجاه وتصحيحات فيبوناتشي وشارات الأحداث، محفوظة لكل symbol:timeframe ومعاينة مضمّنة في الدردشة
• محادثات قابلة للمشاركة — مشاركة بنقرة واحدة بأذونات دقيقة (تبديل تصفح الملفات ووصول التحميل)، إعادة التشغيل عبر رابط عام
• مراقبة الوكلاء الفرعيين في الوقت الفعلي — شاهد المخرجات المتدفقة واستدعاءات الأدوات لكل مهمة خلفية مباشرة، مع القدرة على إرسال تعليمات أثناء التنفيذ
• لوحة مصدر المعلومات — كل دورة تدرج المصادر الخارجية التي وصل إليها الوكيل (الويب، إيداعات SEC، بيانات السوق، أدوات MCP، الملفات) مع أيقونات المفضلة وبصمات المحتوى ومفتاح نطاق لكل سلسلة
• الأتمتة — إدارة CRUD مع منشئ cron، سجل التنفيذ، المشغل اليدوي، والأتمتة المدفوعة بالسعر التي تُفعل عندما يصل سهم أو مؤشر إلى حالة سعر في الوقت الفعلي

تعرض لوحة التحكم مؤشرات السوق وإحاطة شخصية وقائمة المراقبة الخاصة بك — يمكن تثبيت أي بلاطة للوكيل كسياق دردشة لبدء سلسلة بحث.

ابدأ من تخطيط محدد مسبق — Morning Brief, Agent Desk, Researcher, أو Trader.	أو أنشئ تخطيطك الخاص من معرض الويدجتات — الأسواق والذكاء والشخصي والوكيل ومساحة العمل.

تكاملات القنوات

استخدم LangAlpha من الأدوات التي تعمل بها بالفعل. تقوم بوابة التكامل بترحيل الرسائل بين منصات المراسلة والوكيل الأساسي، مع تلقي كل قناة ردودًا بتنسيقها الأصلي. تكاملات القنوات متاحة حصريًا على خدمتنا المستضافة مع إعداد بنقرة واحدة وربط حساب سريع — زر التكاملات للبدء.

تقدم Slack وDiscord قنوات أصلية ومجموعات على مستوى الخيوط، والتي تتوافق بشكل طبيعي مع مساحات العمل والخيوط في LangAlpha — يتم إدارة السياق بشكل أصلي. تفتقر Telegram وWhatsApp إلى هذه الأساسيات، لذا فهما يعملان بوضع تنسيق مبسط. تمتلك Feishu واجهة مراسلة كاملة وواجهة بطاقات مع OAuth قريبًا. Telegram لديه دعم جزئي مع تغطية كاملة قريبًا. WhatsApp مخطط له.

البدء

[!TIP] لا ترغب في الاستضافة الذاتية؟ جرب النسخة المستضافة — فهي تتضمن بنية تحتية كاملة للبيانات (FMP، بيانات السوق في الوقت الفعلي، الصناديق الرملية السحابية) بشكل جاهز. أحضر مفتاح LLM الخاص بك (BYOK) وابدأ فورًا دون إعداد.

يمكنك بدء LangAlpha بـ لا شيء سوى Docker — لا مفاتيح API للبيانات، لا صندوق رملي سحابي. فقط Docker للبنية التحتية واشتراك LLM الخاص بك لنموذج الذكاء الاصطناعي.```bash git clone https://github.com/ginlix-ai/langalpha.git cd langalpha make config # interactive wizard — creates .env, configures LLM, data sources, sandbox, and search make up # starts PostgreSQL, Redis, backend, and frontend

- **الواجهة الأمامية:** [http://localhost:5173](http://localhost:5173)
- **واجهة برمجة التطبيقات الخلفية:** [http://localhost:8000](http://localhost:8000) (وثائق تفاعلية على `/docs`)
- **التحقق:** `curl http://localhost:8000/health`

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

| المفتاح                              | ما يوفره                                                                                                                 |
| ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ |
| `DAYTONA_API_KEY`                    | بيئات رملية سحابية دائمة مع دعم مساحات العمل عبر الجلسات ([daytona.io](https://www.daytona.io/))                         |
| `FMP_API_KEY`                        | بيانات أساسية عالية الجودة، بيانات الاقتصاد الكلي، إيداعات هيئة الأوراق المالية، خيارات ([النسخة المجانية متوفرة](https://site.financialmodelingprep.com/)) |
| `SERPER_API_KEY` أو `TAVILY_API_KEY` | البحث عبر الويب                                                                                                          |
| `LANGSMITH_API_KEY`                  | تتبع LangSmith لتشغيلات LangGraph                                                                                        |
| `OTEL_EXPORTER_OTLP_ENDPOINT`        | تتبع وقياسات OpenTelemetry إلى أي خلفية OTLP (Jaeger، Grafana Tempo، Datadog، Honeycomb، ...)                            |
| `SANDBOX_PROVIDER`                   | تجاوز مزود البيئة الرملية (`daytona` أو `docker`)؛ يتم اكتشافه تلقائيًا من `DAYTONA_API_KEY` عندما لا يكون مضبوطًا        |

> [!NOTE]
> بدون مفاتيح الخدمات الخارجية ستحصل على تجربة وظيفية ولكنها محدودة: توفر Yahoo Finance بيانات تاريخية مجانية للأسعار والأساسيات والأرباح وتحليلات المحللين، ولكنها تفتقر إلى الأسعار اللحظية وبيانات التداول اليومية والاقتصاد الكلي وتحليلات الخيارات. تحل البيئة الرملية Docker محل البيئات الرملية السحابية Daytona — يعمل تنفيذ كود PTC الكامل، ولكن مع أمان وعزل أقل. أضف المفاتيح تدريجيًا لفتح المزيد من الإمكانيات.

قم بتشغيل `make help` لرؤية جميع الأوامر المتاحة. للإعداد اليدوي بدون Docker، راجع [CONTRIBUTING.md](https://github.com/ginlix-ai/langalpha/blob/HEAD/CONTRIBUTING.md#manual-setup).

## التوثيق

- **[مرجع واجهة برمجة التطبيقات](https://github.com/ginlix-ai/langalpha/blob/HEAD/docs/api/README.md)** مع نقاط نهاية لبث الدردشة ومساحات العمل وحالة سير العمل والمزيد
- **وثائق واجهة برمجة التطبيقات التفاعلية** على `http://localhost:8000/docs` عندما يكون الخادم قيد التشغيل

## الاتصال

للشراكات أو التعاون أو الاستفسارات العامة، تواصل مع [[email protected]](mailto:[email protected]).

## إخلاء المسؤولية

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

## الترخيص

ترخيص Apache 2.0