دليل Flova CLI لوكلاء الذكاء الاصطناعي

يتيح لك Flova CLI استخدام Flova من داخل Agent خارجي مثل Codex وClaude Code. ما عليك سوى نسخ Prompt الإعداد إلى Agent الذي تستخدمه؛ سيقوم بتثبيت Flova CLI وFlova Skill وتحميلهما، والاتصال بحسابك في Flova، ثم مساعدتك باللغة الطبيعية على إنشاء المشاريع، ومتابعة التوليد، وقراءة حالة المشروع، وتصدير الفيديو النهائي.

هذا ليس مثل استخدام Flova كواجهة API منفردة لتوليد الصور أو الفيديو. يتصل Flova CLI بنظام مشاريع Flova الكامل: متطلبات المشروع، وسجل المحادثة، والـ storyboard، والوسائط، والمستندات، والـ timeline تبقى كلها داخل المشروع نفسه. يتحدث Agent الخارجي معك، ويستدعي CLI، ويبلغك بالتقدم؛ بينما يواصل Flova دفع صناعة الفيديو داخل المشروع.

متى تستخدمه

استخدم Flova CLI عندما تكون معتادًا على العمل داخل Codex أو Claude Code أو بيئة Agent أخرى، وتريد أن يشارك ذلك Agent في صناعة الفيديو. على سبيل المثال:

• العمل في Codex على النصوص أو المراجع أو ملاحظات المنتج، مع طلب إنشاء مشروع فيديو من Flova.
• طلب استدعاء Flova من Claude Code لتوليد storyboard والوسائط والمونتاج النهائي بناءً على طلبك باللغة الطبيعية.
• جعل Agent خارجي يقرأ حالة مشروع Flova الحقيقية بدلًا من وصف التقدم اعتمادًا على الذاكرة.
• في مهام التوليد أو التصدير الطويلة، دع Agent يواصل متابعة حالة المهمة ويعود إليك برابط المشروع والنتيجة النهائية عند الانتهاء.

طريقة الإعداد

افتح صفحة Flova CLI في Flova، ثم سلّم Flova إلى Agent الذي تستخدمه:

انسخ Prompt الإعداد

أرسل النص أدناه إلى AI Agent الذي تستخدمه. سيقوم بتثبيت Flova CLI وSkill وتحميلهما، ويرشدك خلال تسجيل الدخول، ثم يواصل الإنشاء باستخدام Flova Skill.

مثال:

ساعدني في تثبيت Flova CLI: https://cli.flova.ai/flovaCLI-setup.md

صف الفيديو

صف الفيديو كما تفعل في محادثة عادية مع الذكاء الاصطناعي. اذكر هدف الفيديو، ومدته، ونسبة العرض إلى الارتفاع، والأسلوب، والمحتوى الأساسي، وتوقعات التسليم النهائية. إذا أردت اختيار Flova Skill المناسب أولًا، فاطلب من Agent أن يوصي بخيارات قبل إنشاء المشروع.

مثال:

استخدم Flova لصناعة فيلم قصير سردي دافئ وخيالي مدته 30 ثانية وبنسبة 16:9:في ليلة انقطاع كهرباء، يكتشف روبوت صغير يعيش على سطح مبنى في المدينة بذرة متوهجة، ويتغلب على العقبات ليحملها إلى فتاة صغيرة تائهة في الطابق السفلي.يجب أن يكون الإيقاع واضحًا: تعرض أول 5 ثوانٍ انقطاع الكهرباء وتقدم الروبوت، ويعرض المنتصف رحلته لتسليم البذرة، وتُظهر النهاية المدينة وهي تضيء من جديد.قبل بدء الإنتاج، أوصِ بـ 2-3 من Flova Skills المناسبة، واشرح سبب ملاءمة كل واحدة، وانتظر اختياري قبل إنشاء المشروع.

اختر وواصل المراجعة

مع تقدم المشروع، يمكنك مراجعة العمل، وتقديم ملاحظات، وإخبار Agent بما تم اعتماده بالفعل وما يجب تغييره بعد ذلك.

مثال:

الـ storyboard مقبول بشكل عام، لكن الـ shot الثالث مظلم جدًا. عدّل الـ shot الثالث فقط، ولا تغيّر تصميم الشخصية الذي تم تأكيده، ثم واصل الإنتاج بعد اكتمال التعديل.

يتبع Agent Prompt الإعداد لتثبيت Flova CLI وقراءة Flova Skill، حيث تُشرح طريقة إنشاء المشاريع، ورفع المواد، وإرسال التعليمات الإبداعية، وانتظار نتائج التوليد، وقراءة حالة المشروع، وتصدير الفيديوهات.

في معظم الحالات، يتصل Agent بحسابك في Flova من خلال تسجيل الدخول عبر المتصفح. يفتح صفحة تفويض؛ وبعد تسجيل دخولك إلى Flova والموافقة على الطلب، يمكن للـ CLI المحلي المتابعة بصلاحيات حسابك.

إذا تعذر على Agent فتح متصفح، أو إذا أردت تفويض Agent خارجي مباشرة، يمكنك إنشاء Agent API Key من صفحة Flova أو إعدادات الحساب وتقديمه عبر قناة آمنة. يمنح API Key وصولًا إلى حسابك في Flova، لذلك عامله ككلمة مرور. يمكنك إلغاؤه متى لم تعد بحاجة إليه.

ما الذي يمكن أن يفعله Agent

بعد الإعداد، يمكن لـ Agent خارجي استخدام Flova CLI من أجل:

• إنشاء مشروع جديد أو متابعة مشروع موجود.
• رفع الصور أو الفيديوهات أو الملفات الصوتية أو المستندات كمواد للمشروع.
• إرسال تعليمات إبداعية باللغة الطبيعية إلى Flova كي يدفع الـ storyboard وتوليد الوسائط والصوت والـ timeline والتحضير للتصدير.
• قراءة storyboard المشروع والوسائط والمستندات وسجل المحادثة وحالة التصدير.
• الاستمرار في التحقق من حالة المهمة أثناء التوليد أو التصدير، واستعادة المتابعة المحلية إذا انقطعت.
• بدء التصدير عندما يصبح الفيديو جاهزًا، ثم الرجوع إليك برابط المشروع والفيديو النهائي والحالة الحالية.

العلاقة مع تطبيق Flova على الويب

المشاريع التي تُنشأ أو تتقدم عبر CLI تظل مشاريع Flova عادية. يمكنك العودة إلى تطبيق Flova على الويب في أي وقت لمراجعة storyboard وMedia Space وDocs panel وTimeline، أو متابعة التحرير مباشرة في تطبيق الويب.

والعكس صحيح أيضًا: يمكن لـ Agent خارجي متابعة العمل على مشروع ويب موجود. يقرأ الحالة الحالية للمشروع، ثم يتابع بناءً على storyboard والوسائط والمستندات وجاهزية التصدير الحقيقية.

نصائح للاستخدام

• أخبر Agent بهدف الفيديو، ومدته، ونسبة العرض إلى الارتفاع، والأسلوب، والنقاط الأساسية، والمواد الموجودة، وتوقعات التسليم النهائية.
• تجنب قول "تابع التوليد" فقط. من الأفضل توضيح المرحلة الحالية والخطوة التالية، مثل تحسين storyboard أولًا، أو توليد keyframes أولًا، أو التصدير عندما تصبح Timeline جاهزة.
• اطلب من Agent قراءة حالة المشروع قبل الإبلاغ عن التقدم حتى لا يخمّن من المحادثات السابقة.
• شارك API Keys فقط مع Agent تثق بهم. لا تضعها في الكود أو السجلات أو المستندات المشتركة.
• في مهام التوليد أو التصدير الطويلة، لا تعتبر انقطاع CLI المحلي فشلًا للمشروع. قد تظل مهمة Flova الخلفية قيد التشغيل، ويمكن لـ Agent استعادة التقدم عبر CLI.