تتيح حزمة Omazy للإضافات شحن إضافات متوافقة مع MCP يمكن لأي شركة على Omazy تثبيتها — لربط أدواتها الداخلية، أو كشف واجهات API الخاصة لوكلاء الذكاء الاصطناعي، أو أتمتة سير العمل الذي لا يناسب أي تكامل جاهز.
جمهوران
سواء كنت تشحن إضافة لآلاف مساحات العمل أو تربط واحدة خاصة بشركتك — نفس الحزمة، نفس البنية.
ابنِ مرة واحدة. كل مساحة عمل في Omazy تصبح عميلاً. تتولى Omazy المصادقة والفوترة والتوقيع وحدود المعدّل — ركّز أنت على التكامل.
هل أنت بالفعل على Omazy لكنك بحاجة لربطها بـ CRM داخلي أو ERP أو واجهة API خاصة؟ ابنِ إضافة خاصة في أيام — ثم ثبّتها كأي إضافة من السوق.
تشريح الإضافة
أحد عشر نوعاً من المكونات. اختر ما تحتاجه — صرّح به بمزخرفات على وحدة Python.
وظائف يستدعيها وكيل الذكاء الاصطناعي: shopify.search_products، crm.lookup_account.
بيانات قابلة للقراءة فقط بعنوان: shopify://products/{id}. تتدفق إلى سياق الوكيل عند الطلب.
مقاطع نصية تُلحق بأمر النظام عندما تكون الإضافة نشطة. بنطاق محدد أو دائماً.
@plugin.on_webhook — تفاعل مع أحداث من النظام السفلي أو من Omazy core.
مهام مجدولة لمواءمة الكتالوج، إعادة فهرسة المخزون، تحديث سمات العملاء.
دورة الحياة: on_install، on_uninstall، on_activate. تجهيز OAuth وكتابة الإعدادات الافتراضية.
أزرار في واجهة مساحة العمل: 'مزامنة الآن'، 'إعادة الاتصال'.
سلاسل RFC 2202 جاهزة تُشحن مع الإضافة — يثبتها المشغلون كنقاط بداية.
بداية سريعة في 5 دقائق
أنشئ هيكل إضافة، سجّل أداة، شغّلها محلياً، ثم استدعِها من dev-omazy CLI. خمس دقائق إن كان لديك Python و Docker.
الخطوة 1
uv run omazy-plugin new my-pluginالخطوة 2
from omazy_plugin_sdk import Plugin
plugin = Plugin(slug="my-plugin", version="1.0.0", scopes=["my-plugin:read"])
@plugin.tool(
name="my.search",
description="Search the customer's catalog",
billable_meter="tool_call",
)
async def search(ctx, query: str, limit: int = 5) -> dict:
return {"results": [...] }
app = plugin.fastapi()الخطوة 3
docker compose up dev-omazy
uv run --package omazy-plugin-my-plugin uvicorn my_plugin.main:app --port 8082الخطوة 4
uv run dev-omazy call \
--target http://localhost:8082/tools/call \
--tool my.search \
--args '{"query":"hello"}'عندما تكون جاهزاً للنشر، قدّم القائمة على omazy.com/marketplace/submit. تستغرق المراجعة حوالي 3 أيام عمل.
احصل على وصول مبكر ←بنية وقت التشغيل
Omazy توقّع كل طلب، تسجّل كل حدث، وتفرض كل نطاق صلاحيات. أنت تعيد النتيجة فقط.
وكيل مساحة العمل يطلق استدعاء أداة
نية → الإطار يختار الأداة → يدرج الاستدعاء
بوابة MCP توقّع وتُمرّر
JWT موقّع بمفتاح البائع · فحص النطاق · حد المعدّل
إضافة البائع تتعامل مع الاستدعاء
تطبيق FastAPI الخاص بك · بيانات اعتماد لدى البائع · يُعيد JSON
تسجيل حدث الاستخدام، وإعادة الرد
زيادة عداد الفوترة · تخزين التتبع · يستمر الوكيل
استضافة لدى البائع
أنت تشغّل الإضافة على بنيتك. Omazy لا تنفّذ كود البائع أبداً.
عزل بيانات الاعتماد
رموز OAuth السفلية (Shopify، إلخ) لدى تخزينك، وليس لدى Omazy.
قابل لإعادة التشغيل
كل استدعاء في مخزن تتبع Omazy — صحّح الأخطاء من تذكرة عميل، وليس من سجلاتك وحدها.
الثقة + الفوترة
كل طلب من Omazy إلى الإضافة يحمل JWT موقّعاً بمفتاح البائع. ارفض غير الموقّع، لن تتعرّض للانتحال.
لا يمكن للوكيل استدعاء سوى الأدوات التي صرّحت بها مساحة العمل. الصلاحيات هي محيط الأمان، وليس الأوامر النصية.
Omazy تتولى الفوترة والضرائب والاسترداد والدفعات. تحويل شهري إلى حسابك المرتبط في Stripe.
حدود معدّل لكل بائع وقاطع دائرة يحميان الجانبين. إضافة سيئة السلوك لن تُعطّل مساحة العمل.
حالات استخدام للمشغّلين
الإضافات ليست فقط للسوق. نفس الحزمة تشغّل إضافات خاصة توسّع مساحة عمل واحدة.
غلّف نقاط /orders و /customers الداخلية كإضافة. يستدعيها وكيلك بنفس فحوصات النطاق وسجل التدقيق كأي أداة من الطرف الأول.
Salesforce / HubSpot جاهزة. CRM داخلي ليس كذلك. ابنِ إضافة من 200 سطر تكشف البحث والإنشاء والتحديث — ويحصل عليها مشغلوك كتكامل عادي.
فرز مطالبات التأمين، توجيه المخزون متعدد المستودعات، فحوصات الامتثال الداخلية. إن كان خاصاً بشركتك، فهو إضافة.
وصول مبكر · بيتا
اترك بريدك الإلكتروني وأخبرنا بما تريد بناءه. سنُسرّع أول 50 مؤلف إضافة بتأهيل البائعين، ومفاتيح التوقيع، وخط مباشر مع فريق الحزمة.
أنت في القائمة.
سنرسل لك بريداً عندما يكون وصولك جاهزاً.