الأتمتة

التكاملات

شغّل المحرّكات من الكود. الحسابات التي تستخدمها على الشاشة متاحة للنصوص البرمجية في المتصفح، ولأنظمتك عبر REST API، ولمساعدي الذكاء الاصطناعي عبر MCP، من خلال كتالوج واحد لدوال المحرّك.

دوال المحرك في الفهرس المشترك
27
إصدار OpenAPI، مُولَّد من الكتالوج
3.1
الأدوات المتاحة عبر MCP
50
صلاحيات مفاتيح API: القراءة والكتابة والتشغيل
3
محرر النصوص البرمجية في Converge: قائمة بنصوص برمجية مثال على اليسار، ومحرر JavaScript يحسب جدول نفط أسود في الوسط، وجدول المخرجات للضغط ونسبة الغاز المذاب ومعامل حجم التكوين واللزوجة في الأسفل.
نص برمجي مثال محلول يحسب جدول نفط أسود، ومخرجاته في جدول ومخططات.

ما الذي يفعله

المحرّكات نفسها، بثلاث طرق للوصول

توصف كل دالة من دوال محرّك Converge مرة واحدة، في كتالوج يحدّد مدخلاتها ومخرجاتها ووحداتها. ويستدعي محرر النصوص البرمجية وREST API وخادم MCP جميعها هذا الكتالوج، فيحصل النص البرمجي والتكامل ومساعد الذكاء الاصطناعي على الأرقام نفسها التي تعرضها الشاشة بالضبط.

النصوص البرمجية مكتوبة بـ JavaScript، وتُشغَّل في كل مرة في عامل متصفح جديد ومُقفل: بلا شبكة، وبلا وصول إلى الصفحة، وبلا eval، وبلا استيرادات، ومع حد زمني. وهي تطبع وتُجدول وترسم، وتُحفظ مع المشروع، وتبدأ من أمثلة جاهزة. وتقدّم REST API مواصفة OpenAPI 3.1 مُولَّدة من الكتالوج، فلا يمكن أن يبتعد التوثيق عن الكود.

يتيح خادم MCP لأي مساعد ذكاء اصطناعي متوافق مع MCP عرض مشاريعك وقراءتها وتشغيل دوال المحرّك عبر Streamable HTTP. تُصادَق استدعاءات API بمفاتيح شخصية محدّدة الصلاحيات، وتشغل مقعدًا عائمًا لوحدتها، بالطريقة نفسها التي يعمل بها التطبيق.

نظرة سريعة

  • نصوص JavaScript البرمجية في عامل متصفح معزول
  • أمثلة جاهزة بالوحدات الحقلية أو المترية
  • مخرجات print وtable وplot
  • نصوص برمجية تُحفظ مع المشروع
  • واجهة REST API مع مواصفة OpenAPI 3.1
  • مقتطفات curl وPython وJavaScript
  • مفاتيح API شخصية محدّدة الصلاحيات بتاريخ انتهاء
  • 120 طلبًا في الدقيقة لكل مفتاح
  • خادم MCP عبر Streamable HTTP
  • المشاريع معروضة كموارد MCP
  • كتالوج واحد من 27 دالة للمحرّك
  • تنطبق المقاعد على استدعاءات API كما في التطبيق

القدرات الرئيسية

النصوص البرمجية وREST وMCP بالتفصيل

محرر النصوص البرمجية

أتمِت الحسابات المتكررة دون مغادرة المتصفح.

  • JavaScript في عامل جديد ومقيَّد لكل تشغيل
  • لا شبكة، ولا وصول إلى الصفحة، ولا eval، ولا استيراد
  • حد زمني 10 ثوانٍ افتراضيًا، و60 ثانية كحد أقصى
  • مخرجات console وprint وtable() وplot()
  • نصوص برمجية تُحفظ لكل مشروع
  • الوحدات الحقلية افتراضيًا؛ واستدعاء واحد يحوّل إلى المترية

أمثلة جاهزة

ابدأ من نص برمجي يعمل أصلًا.

  • جدول النفط الأسود
  • حساسية التحليل العقدي لنسبة الماء
  • مواءمة الانحدار والتنبؤ
  • الغلاف الطوري لـ SPE5
  • تشخيص موازنة المواد
  • الوحدات المترية، واختبار بئر بمخطط Horner والمشتقة

فهرس المحرك

وصف واحد لكل دالة، تستخدمه المسارات الثلاثة كلها.

  • دوال PVT ومعادلات الحالة
  • IPR وVLP والتحليل العقدي للبئر
  • موازنة المواد والانحدار
  • اختبار آبار اصطناعي، Horner والمشتقة
  • المحاكاة، وBuckley-Leverett، وحل الشبكة، والتنبؤ المتكامل
  • مقاييس الاقتصاديات والتدفق النقدي؛ وتحليل البيانات والتحقق منها

REST API

اربط Converge بأنظمتك ومسارات بياناتك.

  • مواصفة OpenAPI 3.1 على /v1/openapi.json، مولَّدة من الفهرس
  • اعرض دوال المحرّك وشغّلها
  • سرد المشاريع وقراءتها وحفظها وحذفها، مع إصداراتها
  • مقتطفات شيفرة بلغات curl وPython وJavaScript

المصادقة والحدود

مفاتيح تتحكم بها، بنطاقات تقتصر على ما تحتاجه.

  • مفاتيح API شخصية تُرسَل كرمز Bearer
  • يُخزَّن مُجزّأً فقط ويُعرض مرة واحدة
  • النطاقات: projects:read وprojects:write وengine:run
  • انتهاء الصلاحية من 1 إلى 730 يومًا، أو بلا انتهاء؛ وحتى 25 مفتاحًا نشطًا لكل مستخدم
  • 120 طلبًا في الدقيقة لكل مفتاح
  • لا يمكن لمفاتيح API اعتماد مراجعة

خادم MCP

دع مساعدًا ذكيًا يعمل على مشاريعك في Converge.

  • Streamable HTTP وJSON-RPC 2.0، بلا حالة
  • دوال الفهرس الـ27، و21 أداة لنموذج المائع للقراءة فقط، وسرد المشاريع وقراءتها
  • المشاريع المحفوظة متاحة كموارد
  • يعمل مع أي عميل متوافق مع MCP

سير العمل

من النص البرمجي إلى التكامل

  1. جرّب مثالًا محلولًا

    افتح محرر النصوص البرمجية، وشغّل مثالًا، واقرأ الجدول والمخططات.

  2. اكتب نصك البرمجي الخاص

    استدعِ أي دالة من دوال المحرّك، بالوحدات الحقلية أو المترية، واحفظ النص البرمجي مع المشروع.

  3. أنشئ مفتاح API

    اختر الصلاحيات وتاريخ الانتهاء؛ يُعرض المفتاح مرة واحدة.

  4. استدعِ REST API

    اقرأ مواصفة OpenAPI وانسخ مقتطفًا بـ curl أو Python أو JavaScript.

  5. اربط مساعد ذكاء اصطناعي

    وجّه أي عميل متوافق مع MCP إلى نقطة نهاية MCP في Converge باستخدام مفتاحك.

التحقق

أعِد تشغيل المعايير المرجعية بنفسك

تنشر صفحة المعايير المرجعية نصوصًا برمجية لـ SPE1 وPVT واختبار الآبار والانحدار وموازنة المواد وصافي القيمة الحالية، يمكن لأي شخص إعادة تشغيلها في حسابه، عبر دوال المحرّك نفسها التي تتيحها واجهة API.

لم يُبنَ بعد: لغات برمجة نصية أخرى (تظهر Python في مقتطفات REST فقط)، وصلاحية الكتابة عبر MCP، وwebhooks، وتحسين الشبكة عبر الواجهة البرمجية. ولم يُتَح بعد انحدار اختبارات الآبار وفك الالتفاف عبر الواجهة البرمجية.

المدخلات والمخرجات

ما يدخل وما يخرج

المدخلات

  • نصوص JavaScript البرمجية في المحرر
  • طلبات JSON إلى واجهة REST API
  • استدعاءات أدوات MCP من مساعد ذكاء اصطناعي
  • مفاتيح API شخصية بنطاقات صلاحيات

المخرجات

  • نتائج المحرّك بصيغة JSON
  • جداول ومخططات في المحرر
  • بيانات المشروع وإصداراته
  • نتائج أدوات MCP وموارده

التصدير

  • مواصفة OpenAPI 3.1
  • نصوص برمجية تُحفظ مع المشروع
  • ملف JSON للمشروع عبر الواجهة البرمجية

الأسئلة الشائعة

التكاملات: أسئلة شائعة

بأي لغة تُكتب النصوص البرمجية؟

JavaScript، يعمل في عامل متصفح معزول دون وصول إلى الشبكة أو الصفحة، بحد زمني 10 ثوانٍ افتراضيًا و60 كحد أقصى.

هل تستخدم النصوص البرمجية وواجهة API المحرّكات نفسها التي يستخدمها التطبيق؟

نعم. تستدعي النصوص البرمجية وREST API وخادم MCP جميعها كتالوجًا واحدًا لدوال المحرّك، فتطابق النتائج الشاشة.

كيف أُصادق على واجهة REST API؟

بمفتاح API شخصي يُرسل كرمز Bearer. تُحدَّد صلاحيات المفاتيح بـ projects:read أو projects:write أو engine:run، ويمكن أن تنتهي صلاحيتها، ولا تُخزَّن إلا كقيمة مُجزّأة (hash)، وتُعرض مرة واحدة.

ما مساعدو الذكاء الاصطناعي الذين يمكنهم استخدام خادم MCP؟

أي عميل يدعم MCP عبر Streamable HTTP. يعرض الخادم 50 أداة، منها دوال المحرك وأدوات نموذج المائع للقراءة فقط، ومشاريعك المحفوظة كموارد.

هل توجد مواصفة لواجهة API؟

نعم. مواصفة OpenAPI 3.1 على /v1/openapi.json، مُولَّدة من كتالوج المحرّك فتطابق الكود دائمًا.

أتمت الحسابات التي تكرّرها.