الجداول وendpoints

0:00/0:00

في الدرس السابق نفّذت المصادقة في HeroMate. الآن تصمم جوهر تطبيقك — بدءاً من الجداول وendpoints. إذا لم تكن متأكداً مما ستبنيه بعد، يمكنك التخطيط مع وكيل الذكاء الاصطناعي: افتح محادثة جديدة وصف ما تريده (مثلاً تطبيق إدارة مهام). أنت في البداية تستكشف التوصيات فقط — البنية والأسلوب والميزات — ولم يُبنَ شيء بعد.

ماذا يغطي هذا الفيديو

من الخطة إلى التنفيذ
عندما ترضى عن الخطة، تطلب من الوكيل بدء تنفيذها في HeroMate. يستخدم أدوات MCP، وينشئ الجداول، ويمكنك تأكيدها تحت Database في مشروعك (مثلاً جدول task بالأعمدة الصحيحة).

Endpoints
ينشئ الوكيل أيضاً REST endpoints ويختبرها. هذا متعمّد أن يكون أساسياً في هذه المرحلة — تدفقات بسيطة مثل عقدة start إضافة إلى عقدة database — لأن الدروس ستزداد تعقيداً لاحقاً.

عرض API
تعيش endpoints الخاصة بك و محرر سير العمل البصري معاً تحت عنصر API في الشريط الجانبي (Build → API). هناك ترى endpoints مثل create task وlist tasks. فتح أحدها (مثلاً list tasks) يظهر سير عمل بسيطاً: يكفي لإثبات الفكرة، وليس التعقيد النهائي.

يمكن أن تصبح Endpoints أدوات للوكيل

يمكن لاحقاً تعليم أي endpoint كـ أداة (is_tool=true) حتى تستدعيها عقدة agent للذكاء الاصطناعي — مثلاً السماح لمساعد بإنشاء المهام أو عرضها للمستخدم. ستفعل هذا في درس وكلاء الذكاء الاصطناعي والدردشة.

عندما يفشل شيء
يمكن أن تحدث أخطاء — هذا لا يعني أن HeroMate معطّلة؛ غالباً يعني أن الإعداد أو التدفق المُنشأ يحتاج تعديلاً. تخبر الوكيل بوجود خطأ وتطلب منه إصلاحه في HeroMate. يحقّق ويصحّح وتعيد المحاولة. في الفيديو، تسبّب حقل date في مشكلة حفظ؛ بعد الإصلاح تعمل عمليات الحفظ ويمكنك التحقق من الصفوف في جدول task (بما فيها صفوف الاختبار الأقدم التي أنشأها الذكاء الاصطناعي أثناء التكرار).

التكرار بميزات جديدة
تريد مجموعات مهام؟ اطلب من الوكيل تلك الوظيفة — لا تحتاج عملية مختلفة. مع المشروع المتصل مسبقاً، تواصل التكرار: مزيد من الجداول، ومزيد من endpoints، وتعديلات واجهة صغيرة (مثلاً إضافة زر حذف، وتصفية حسب المجموعة، ومجموعة اختبار). تبقى واجهة المثال بسيطة عن قصد؛ يمكنك مواصلة تحسين التخطيط والأشرطة الجانبية والصفحات — النقطة هي السرعة والمرونة: تركّز على تشكيل المنتج بينما يساعد الوكيل في بناء الخلفية.

التكاملات
Endpoints ليست محدودة بقاعدة بياناتك وحدها. تشحن HeroMate بالفعل نحو 24 تكاملاً خارجياً — Stripe وTelegram وWhatsApp وSlack وNotion وGoogle Sheets وGitHub وShopify والمزيد — إضافة إلى عقدة HTTP Request عامة لأي API آخر. تربطها في سير العمل نفسه مع نمو تطبيقك.

طريقة التفكير
حافظ على الحلقة نفسها: ابنِ، اصطدم بالأخطاء، أعدها إلى الذكاء الاصطناعي، ودعه يصلح الإعداد داخل HeroMate.