تضمين أدوات Muapi
يوفر Muapi نوعين منفصلين من iframe: تضمين النموذج لتوليد نموذج واحد، وتضمين Creative Agent لمساحة عمل حوارية. يرتبط كل تضمين بحساب Muapi الذي أنشأه.
تضمين Playground لنموذج
- سجّل الدخول وافتح صفحة النموذج في Playground.
- اختر تبويب Embed لعرض رمز التضمين.
- انسخ مقطع iframe وأضفه إلى صفحة موقعك.
يعرض التضمين نموذج التوليد للعنصر المحدد ومدخلاته الحالية. تستخدم التوليدات الحساب المرتبط بالرمز وتخصم من رصيده؛ لا تنشر التضمين إلا إذا كنت تقبل استخدام الزوار لهذا الرصيد.
تضمين Creative Agent
- افتح Assistant وأنشئ تضمين Agent.
- انسخ مقطع iframe الظاهر.
- الصقه في HTML لموقعك حيث تريد ظهور اللوحة.
<iframe src="https://muapi.ai/embed/agent/YOUR_EMBED_CODE" style="width:100%;height:100%;border:0;" allow="clipboard-write" allowfullscreen></iframe>
حدّد ارتفاعًا للإطار أو حاويته. تعرض صفحة Assistant تضميناتك ويمكنك إلغاء أي تضمين لم تعد تحتاج إليه.
تقييد Agent بمواقع محددة
يدعم Agent قائمة اختيارية بالمصادر المسموح بها. اضبطها عند الإنشاء عبر POST /api/v1/agent-embeds أو حدّثها باستخدام PATCH /api/v1/agent-embeds/{embed_id}، مع أسماء مضيف مثل example.com. تُرفض الطلبات من المصادر الأخرى عند ضبط القائمة؛ والقائمة الفارغة تسمح بكل المصادر. ينطبق ذلك على Creative Agent فقط، لا على تضمين Playground للنماذج.
الإدارة واستكشاف الأخطاء
- تعامل مع رمز التضمين كبيانات اعتماد؛ فقد يسبب استخدامًا على حساب المالك.
- إذا كان iframe فارغًا أو غير متاح، تحقق من اكتمال الرمز وتوفر النموذج أو Agent.
- عند تقييد Agent، طابق اسم مضيف الصفحة مع قائمة المصادر.
- راجع معاملات النموذج وتكلفته قبل النشر.
راجع الرصيد والنماذج ودليل Creative Canvas.