البناء بالذكاء الاصطناعي

استخدم وكلاء الذكاء الاصطناعي للمساعدة في بناء تكاملات OrcaRail. نوفر مجموعة من الأدوات وأفضل الممارسات إذا كنت تستخدم النماذج اللغوية أثناء التطوير.

توثيق بنص عادي

يمكنك الوصول إلى كل توثيقنا كملفات Markdown بنص عادي. يساعد ذلك أدوات الذكاء الاصطناعي ووكلاءه على استهلاك محتوانا، ويتيح لك نسخ محتوى أي مستند كاملًا ولصقه في نموذج لغوي. يُفضَّل Markdown على استخراج المحتوى أو نسخه من صفحاتنا المعروضة بـ HTML وJavaScript لأن:

• النص العادي يحتوي على رموز تنسيق أقل
• المحتوى غير المعروض في العرض الافتراضي (مثل المخفي داخل تبويب) يظهر في نسخة النص العادي
• تستطيع النماذج اللغوية تحليل التسلسل الهرمي في Markdown وفهمه

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

خادم MCP

لأدوات البرمجة بالوكلاء التي تدعم Model Context Protocol، ثبّت الحزمة الرسمية @orcarail/mcp. توفر أدوات الـ payment intents والاشتراكات والكتالوج والأسعار والدفع عبر stdio (الفكرة نفسها لخادم MCP من Stripe)، ليتمكن وكيلك من إنشاء المدفوعات وإدارة الفوترة مباشرةً.

بيانات الاعتماد اختيارية للأدوات العامة (rates.* وpay.*). تحتاج الأدوات الخاصة إلى ORCARAIL_API_KEY وORCARAIL_API_SECRET (فضّل متغيرات البيئة على خيارات سطر الأوامر).

# Public tools only (no credentials)
npx -y @orcarail/mcp --tools=all

# Claude Code with credentials via env
claude mcp add orcarail \
  -e ORCARAIL_API_KEY=ak_live_xxx \
  -e ORCARAIL_API_SECRET=sk_live_xxx \
  -- npx -y @orcarail/mcp --tools=all

في Cursor أضف الخادم إلى .cursor/mcp.json؛ وفي Codex أضفه إلى ~/.codex/config.toml. راجع دليل خادم MCP للإعداد الكامل والمرجع الكامل للأدوات وإرشادات الأمان.

استخدم مفتاح sandbox مع الوكلاء

أعطِ وكيلك مفتاح API من مؤسسة sandbox (ak_test_…). عندها يستطيع إنشاء المدفوعات ومحاكاتها على الشبكات التجريبية دون نقل أموال حقيقية أبدًا. انتقل إلى مفتاح حي للإنتاج فقط.

زوّد وكيل الذكاء الاصطناعي بالتوثيق

يمكنك تزويد مساعد البرمجة بالذكاء الاصطناعي بتوثيق OrcaRail مباشرةً. إليك بعض الطرق:

انسخ صفحة توثيق

انسخ محتوى أي صفحة توثيق والصقه في محادثة النموذج اللغوي. للحصول على أفضل النتائج، انسخ مصدر Markdown بدلًا من HTML المعروض.

استخدم ملف llms.txt

وجّه وكيل الذكاء الاصطناعي إلى ملف /llms.txt. يسرد هذا الملف أهم صفحات التوثيق مع أوصافها، ما يسهّل على الوكيل اكتشاف المعلومات التي يحتاجها وجلبها.

ضمّن التوثيق في مشروعك

نزّل التوثيق الذي تحتاجه وضعه في مجلد مشروعك. كثير من مساعدي البرمجة بالذكاء الاصطناعي (مثل Cursor وWindsurf وClaude Code وGitHub Copilot) يفهرسون ملفات مشروعك تلقائيًا كسياق.

# Example: download the getting started guide
curl -o orcarail-getting-started.md https://raw.githubusercontent.com/orcarail/orcarail/main/docs/getting-started.md

موارد أساسية لوكلاء الذكاء الاصطناعي

عند بناء تكامل مع OrcaRail بمساعدة الذكاء الاصطناعي، هذه أكثر المستندات فائدة لتقديمها كسياق:

المورد	الوصف
البدء	إعداد الحساب ومفاتيح API وأول دفعة
Payment Intents	إنشاء الـ payment intents وإدارتها
Node.js SDK	تثبيت @orcarail/node واستخدامها
خادم MCP	ربط Claude Code أو Cursor أو Codex
PHP SDK	تثبيت orcarail/orcarail-php واستخدامها
الـ webhooks	استقبال إشعارات الدفع لحظيًا
الاشتراكات	المدفوعات المتكررة والخصم التلقائي
المصادقة	مفاتيح API ورموز bearer
مرجع API	توثيق كامل لنقاط النهاية

نصائح للتطوير بمساعدة الذكاء الاصطناعي

1. ابدأ بصفحة البدء — أعطِ وكيلك صفحة البدء أولًا. تغطي إنشاء الحساب ومفاتيح API وتدفق الدفع الأساسي.

2. قدّم مرجع الـ SDK — يحتوي دليل Node.js SDK ومرجع API الخاص به، أو دليل PHP SDK ومرجع API لـ PHP، على كل الدوال المتاحة مع أمثلة.

3. ضمّن توثيق الـ webhooks للإنتاج — في تكاملات الإنتاج، ضمّن دائمًا توثيق الـ webhooks وتوقيعات الـ webhooks ليُعدّ وكيلك معالجة الأحداث بشكل صحيح.

4. استخدم العرض التوضيحي كقالب — يقدم تطبيق العرض التوضيحي مثالًا كاملًا يعمل. وجّه وكيلك إلى مستودع GitHub كتطبيق مرجعي كامل.

5. حدّد شبكتك — تدعم OrcaRail شبكات متعددة. أخبر وكيلك بشبكات البلوكتشين والرموز التي تريد قبولها ليضبط التكامل بشكل صحيح.

ملاحظات مهمة للنماذج اللغوية

:::info لوكلاء الذكاء الاصطناعي الذين يقرؤون هذه الصفحة

• OrcaRail بوابة دفع بالعملات الرقمية؛ وليست معالج دفع تقليديًا بالعملات الورقية
• كل المبالغ مقوّمة بعملات مستقرة (USDC وUSDT وغيرها) على شبكات البلوكتشين المدعومة
• الكائن الأساسي في الخادم الخلفي هو Payment Intent: أنشئه، وأكّده، ووجّه العميل إلى صفحة الدفع المستضافة، ثم عالِج أحداث الـ webhook
• تستخدم المصادقة مفتاح API + السر (Basic Auth) بين الخوادم، أو رمز Bearer (JWT) للطلبات التي يصادق عليها المستخدم
• حِزم SDK الرسمية هي @orcarail/node لـ JavaScript/TypeScript وorcarail/orcarail-php لـ PHP 8.1+
• الرابط الأساسي لـ API هو https://api.orcarail.com
• تحقق دائمًا من توقيعات الـ webhooks باستخدام دوال التحقق المدمجة في الـ SDK

:::