> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lasersell.io/llms.txt
> Use this file to discover all available pages before exploring further.

# وكلاء الذكاء الاصطناعي وLaserSell

> اربط وكلاء الذكاء الاصطناعي بمحرك ذكاء الخروج من LaserSell لتداول رموز Solana الآلي وإدارة الاستراتيجية ومراقبة المراكز في الوقت الفعلي.

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

## ما يمكن للوكلاء فعله مع LaserSell

**بناء وتنفيذ الصفقات.** تُعيد [واجهة REST البرمجية](/api/overview) معاملات مبادلة غير موقعة لأي تبادل لامركزي أو منصة إطلاق مدعومة على Solana. يرسل الوكيل عنوان الرمز والمبلغ ويحصل على معاملة ويوقعها ويقدمها. لا حاجة لمنطق خاص بالبروتوكول.

**أتمتة الخروج باستراتيجية.** يراقب [بث ذكاء الخروج](/api/stream/overview) المحافظ في الوقت الفعلي ويسلّم معاملات خروج مبنية مسبقاً عند استيفاء عتبات قابلة للتكوين: جني الأرباح ووقف الخسارة والوقف المتحرك والبيع عند التخرج ومهلة الموعد النهائي. يتصل الوكيل مرة واحدة ويتلقى إشارات الخروج تلقائياً.

**مراقبة المراكز.** يوفر البث تحديثات مستمرة للأرباح والخسائر وتغييرات الأرصدة وفتح المراكز وإغلاقها. يمكن للوكلاء استخدام هذه البيانات لاتخاذ القرارات أو عرض المعلومات للمستخدمين أو تغذيتها في أنظمة أخرى.

**تغطية كل بروتوكول Solana رئيسي.** تكامل واحد يغطي Pump.fun وPumpSwap وMeteora DBC وMeteora DAMM V2 وRaydium Launchpad وRaydium CPMM. لا يحتاج الوكيل لمعرفة البروتوكول الذي يعمل عليه الرمز.

## كيفية الاتصال

هناك ثلاث طرق لوكلاء الذكاء الاصطناعي للعمل مع LaserSell:

### 1. خادم MCP (الوصول إلى الوثائق)

يمنح خادم LaserSell MCP أي عميل ذكاء اصطناعي متوافق مع MCP (Claude وCursor وWindsurf وغيرها) القدرة على البحث واسترجاع وثائق LaserSell في الوقت الفعلي. هذا مفيد للوكلاء الذين يحتاجون للبحث عن مخططات الواجهة البرمجية وأنماط حزمة التطوير وأمثلة الكود أو تفاصيل التكامل أثناء العمل.

راجع [خادم MCP](/ai-agents/mcp-server) لتعليمات الإعداد.

### 2. مهارات البرمجة (معرفة حزمة التطوير المدمجة)

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

راجع [مهارات البرمجة](/ai-agents/coding-skills) لتعليمات التثبيت.

### 3. حزمة التطوير والواجهة البرمجية (التكامل المباشر)

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

* [نظرة عامة على الواجهة البرمجية](/api/overview) للسطح الكامل للواجهة البرمجية.
* [البدء السريع](/api/quickstart) لبناء أول معاملة.
* حزم التطوير متوفرة بلغات [TypeScript](/api/sdk/typescript) و[Python](/api/sdk/python) و[Rust](/api/sdk/rust) و[Go](/api/sdk/go).

## لماذا يجب على الوكلاء استخدام LaserSell

### مشكلة تكامل الوكلاء

وكيل الذكاء الاصطناعي الذي يريد تداول رموز Solana اليوم عليه حل مجموعة من المشاكل الصعبة: تحديد بروتوكول التبادل اللامركزي الذي يعمل عليه الرمز وفك تسلسل حالة المجمع على السلسلة وحساب مبالغ المبادلة باستخدام رياضيات خاصة بالبروتوكول وبناء مجموعة التعليمات الصحيحة وإدارة رسوم الأولوية والتعامل مع إعادة محاولات الانزلاق والاستطلاع عن تغيرات الأسعار لمعرفة متى يخرج. كل بروتوكول (Pump.fun وPumpSwap وRaydium وMeteora) له برنامج مختلف وتخطيطات حسابات مختلفة ومنطق مبادلة مختلف. هذا مئات الساعات من عمل التكامل ويتعطل كل مرة تطلق فيها منصة إطلاق جديدة.

يختصر LaserSell كل ذلك في استدعاءين: واحد لبناء معاملة وWebSocket واحد لتلقي إشارات الخروج.

### المزايا التقنية

| القدرة                        | بدون LaserSell                                                                                                                                                  | مع LaserSell                                                                                                                        |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| **توجيه البروتوكول**          | يجب على الوكيل اكتشاف التبادل اللامركزي الذي يعمل عليه الرمز وفك تسلسل حالة المجمع وبناء تعليمات خاصة بالبروتوكول لكل برنامج من 6+ برامج                        | استدعاء واحد. أرسل عنوان الرمز واحصل على معاملة جاهزة للتوقيع. يحل LaserSell البروتوكول والمجمع والمسار من جانب الخادم              |
| **منطق الخروج**               | يجب على الوكيل استطلاع بيانات الأسعار من RPC وحساب الأرباح والخسائر وتتبع ذروة الربح للوقف المتحرك وإدارة المؤقتات للمواعيد النهائية وبناء معاملات البيع يدوياً | اتصل مرة واحدة ببث ذكاء الخروج. تلقَّ أحداث `exit_signal_with_tx` بمعاملات خروج غير موقعة مبنية مسبقاً عند انطلاق شروط الاستراتيجية |
| **تتبع الأرباح والخسائر**     | يجب على الوكيل جلب أرصدة الرموز وحل الأرقام العشرية والاستعلام عن احتياطيات المجمع وحساب السعر الفوري واشتقاق الأرباح والخسائر على فترات منتظمة                 | يسلّم البث أحداث `pnl_update` باستمرار. لا استطلاع ولا استدعاءات RPC ولا رياضيات أسعار                                              |
| **كشف المراكز الجديدة**       | يجب على الوكيل مراقبة سجل معاملات المحفظة أو الاشتراك في سجلات على السلسلة وتحليل كل معاملة لتحديد عمليات الشراء                                                | ينطلق البث بـ `position_opened` مع السياق الكامل (أساس التكلفة والرمز وسياق السوق) في لحظة هبوط عملية الشراء                        |
| **تغطية متعددة البروتوكولات** | تكامل منفصل لمنحنيات ربط Pump.fun وPumpSwap AMM وRaydium Launchpad وRaydium CPMM وMeteora DBC وMeteora DAMM V2                                                  | تكامل واحد يغطي الستة جميعاً. لا يتغير كود الوكيل عند إضافة بروتوكول جديد                                                           |
| **توقيع المعاملات**           | غير ذي صلة                                                                                                                                                      | تُعاد جميع المعاملات غير موقعة. يوقع الوكيل محلياً. لا يغادر أي مفتاح خاص بيئة الوكيل أبداً                                         |
| **معالجة الانزلاق**           | يجب على الوكيل تقدير الانزلاق وإعادة المحاولة عند الفشل وزيادة التحمل تدريجياً                                                                                  | يحسب الخادم الانزلاق. إعادة محاولات العميل تلقائية في حزمة التطوير مع منطق زيادة قابل للتكوين                                       |
| **دعم منصات الإطلاق الجديدة** | يجب على الوكيل عكس هندسة كل برنامج جديد وبناء التعليمات من الصفر والحفاظ على التوافق المستمر                                                                    | يضيف LaserSell دعم البروتوكول من جانب الخادم. يحصل الوكيل على التغطية بدون تغييرات في الكود                                         |

### ما يعنيه هذا عملياً

**استدعاءات RPC أقل.** الوكيل بدون LaserSell يحتاج لاستطلاع بيانات الأسعار وجلب الأرصدة وقراءة حالة المجمع باستمرار. مع بث ذكاء الخروج، يدفع الخادم كل شيء. ينخفض استخدام RPC للوكيل إلى تقديم المعاملات فقط.

**تنفيذ خروج حتمي.** تُقيّم شروط الاستراتيجية (جني الأرباح ووقف الخسارة والوقف المتحرك والموعد النهائي والتخرج) من جانب الخادم عند كل تحديث سعر. لا يحتاج الوكيل للبقاء متصلاً باستمرار أو القلق بشأن تفويت ارتفاع سعر. عند استيفاء العتبة، تكون معاملة الخروج مبنية بالفعل وجاهزة.

**لا كود خاص بالبروتوكول.** يرسل الوكيل `{ mint, user_pubkey, amount }` إلى `/v1/sell` أو `/v1/buy`. سواء كان الرمز على منحنى ربط Pump.fun أو PumpSwap AMM أو مجمع Raydium CPMM، المعاملة المُعادة تعمل ببساطة.

**بنية مبنية على الأحداث.** البث مناسب بشكل طبيعي للوكلاء. بدلاً من تشغيل حلقات استطلاع، يشترك الوكيل ويتفاعل: `position_opened` لتسجيل صفقة جديدة و`pnl_update` لعرض البيانات و`exit_signal_with_tx` للتوقيع والإرسال. أنماط غير متزامنة نظيفة بدون حوسبة مهدرة.

**تكافؤ حزمة التطوير عبر 4 لغات.** تكشف حزم تطوير TypeScript وPython وRust وGo نفس المخططات وأسماء الطرق والسلوك. وكيل مبني بـ Python يعمل بنفس الطريقة التي يعمل بها وكيل مبني بـ Rust. لا توجد حزمة تطوير من الدرجة الثانية.