GoCloud
الوكلاء واللوحات وواجهات API
اربط مصدرًا محدودًا بمهمة قابلة للمراجعة، واترك النشر تحت تحكم صريح.
أدلة GoRun
في هذا الدليل
- ابنِ لوحة مفيدة
- الوكيل المُدار والوكيل الخارجي
- جهّز مسودات من الاستوديو
- استخدم المفتاح والمخطط الصحيحين
ابنِ لوحة مفيدة
- أنشئ Canvas خاصة أو اختر قالبًا مثل مراجعة ما قبل النشر أو تحويل مقال لمسودات اجتماعية.
- اختر المحتوى المصدر وأضف تعليمات، ثم صِل العقد بمزوّد مهيأ أو وكيل مسمى. أكمل الحقول الناقصة في القالب قبل التشغيل.
- احفظ ثم عاين السياق والوجهة والموديل أو الأداة المختارة. شغّل بعد مراجعة الطلب.
- اقرأ الملاحظة الناتجة أو الوسائط الخاصة. النتيجة لا تنشر مقالًا ولا تستبدله؛ طبّق التعديل التحريري من مسار المراجعة والحفظ المنفصل.
مسار القصة إلى الفيديو له مراحل تراجعها منفردة: أنشئ السيناريو وراجعه، وصِل نتيجته بمزوّد فيديو أو رندر مهيأ، ثم راجع تلك المرحلة وشغّلها. لا يفترض النظام واجهة فيديو موحدة لكل المزوّدين.
الوكيل المُدار والوكيل الخارجي
- وكيل نصي مُدار: يستخدم GoRun الاتصال المحفوظ والموديل المختار لإنتاج نص داخل مهمة اللوحة التي راجعتها.
- وكيل MCP خارجي: يحتاج العميل الخارجي المسمى للاتصال والتقاط المهمة. حالة الانتظار لا تعني أن العميل يعمل بالفعل.
- مفتاح الوكيل يحتاج النطاقات المناسبة ومنحًا صريحًا للوحة. يكشف المنح السياق المختار، وليس كل اللوحات الخاصة.
- تبدأ الجداول معطلة. فعّل العمل المتكرر صراحة بعد مراجعة الطلب؛ وقد تستلزم تغييرات المصدر أو الرسم أو المزوّد موافقة جديدة.
- الإلغاء يوقف القبول أو الإرسال المحلي حيث يمكن، لكنه لا يسترجع طلبًا قبله مزوّد خارجي.
جهّز مسودات من الاستوديو
يستطيع الاستوديو أسفل محرر المحتوى المحفوظ استخدام العنوان والنص غير المحفوظين حاليًا. اختر نصًا أو صورة أو مهمة وسائط MCP مدعومة، وعدّل التعليمات وراجع المعاملات قبل التوليد. إزالة نتيجة من الاستوديو لا تحذف ملفًا سبق استيراده إلى الوسائط.
حفظ اتصال لا يجهّز كل القدرات. الصور تحتاج نقطة نهاية مدعومة وموديلًا محددًا، والفيديو والرندر يحتاجان أداة مهيأة وربطًا صحيحًا للنتيجة والحالة. اكتشاف الأدوات ليس توليدًا.
استخدم المفتاح والمخطط الصحيحين
افتح /api/docs على موقعك للاطلاع على توثيق REST التفاعلي، و/api/v1/openapi.json للمخطط المولد. استخدم مفتاح API مع REST ومفتاح وكيل مع /mcp؛ النوعان غير قابلين للتبادل.
يستخدم REST ترويسة Authorization: Bearer. احتفظ بالمفتاح الحقيقي في بيئة خاصة أو مدير أسرار، وليس داخل HTML عام أو روابط أو صور شاشة. تتقاطع نطاقات المفتاح مع صلاحيات مالكه الحالية. وتحتاج طلبات جلسة المتصفح المعدّلة للبيانات حماية CSRF أيضًا.
اقرأ المخططات التي يعرضها الموقع المثبت بدل نسخ نقاط نهاية مفترضة. استخدم بيانات اختبار ومراجعة صريحة قبل الكتابة أو استدعاء المزوّد أو النشر.