Canvas البصري

Canvas البصري هو حيث تصمم منطق endpoints. بدلاً من كتابة أسطر كود، تربط كتل وظيفية (عقداً) لإنشاء تدفق يعالج الطلبات ويعالج البيانات ويعيد الاستجابات.

الوظائف الأساسية

1. تصميم قائم على العقد

ابنِ منطقك بسحب العقد وإفلاتها من المكتبة (40 عقدة إجمالاً). تمثّل كل عقدة إجراءً محدداً. الفئات الرئيسية هي:

Triggers: نقطة دخول endpoint — أحد أربعة أنواع: HTTP API أو Webhook أو Schedule أو Telegram/Twilio.
AI: عقدة agent (HeroMate Managed أو مفتاح BYOK الخاص بك) وعقدة image_generation (مدارة فقط، تُحسب كأرصدة ذكاء اصطناعي، وتعيد عنوان URL للتخزين).
Database و Storage و Auth: اقرأ جداولك واكتبها، وأدر الملفات، ونفّذ عمليات المصادقة على الخادم.
Logic & Control: أضف شروطاً (if/else) وحلقات وتصفية ودمج وتحويلات حقول.
Communication & Integrations: اربط نحو 24 خدمة خارجية مثل WhatsApp و Stripe و Slack و Telegram و Notion و GitHub والمزيد — أو استدعِ أي شيء آخر بعقدة HTTP Request العامة.
Code node: تشغّل عقدة javascript_code JavaScript مخصصاً مع env_vars كنص واضح (ctx.env).

انظر مرجع عقد سير العمل والتكاملات الكامل لكل عقدة حسب الفئة.

2. الاختبار اليدوي

لديك تحكم كامل في منطقك. استخدم زر Test للتحقق من تدفقك. بتشغيل اختبارات يدوية يمكنك:

التأكد من اتصال كل العقد بشكل صحيح.
التحقق من مطابقة المدخلات والمخرجات لتوقعاتك.
اكتشاف أي مشكلات منطقية قبل النشر.

3. لوحة الاختبار المدمجة

لوحة الاختبار أفضل صديق لك للتصحيح.

محاكاة الطلبات: أرسل بيانات اختبار لترى كيف يستجيب تدفقك.
تنفيذ خطوة بخطوة: شاهد كيف تتحرك البيانات عبر كل عقدة في الوقت الفعلي.
السجلات: راجع سجلات التنفيذ التفصيلية لتصحيح أي مشكلات.

4. مساعدة الذكاء الاصطناعي (MCP)

يمكنك استخدام مساعد الذكاء الاصطناعي لتعديل Canvas نيابة عنك. اطلب ببساطة:

"أضف خطوة تحقق للتأكد مما إذا كان المستخدم مشرفاً."
"اربط مخرج قاعدة البيانات بعقدة إشعار WhatsApp جديدة."

أفضل الممارسات

أبقِه معيارياً: قسّم المنطق المعقد إلى تدفقات أصغر قابلة للإدارة.
استخدم أسماء وصفية: أعد تسمية عقدك لتعكس غرضها المحدد (مثلاً "Fetch User Profile" بدلاً من مجرد "Query").
اختبر كثيراً: استخدم لوحة الاختبار بعد إضافة عقد جديدة للتأكد من أن كل شيء يعمل بشكل صحيح.

الوظائف الأساسية

ابنِ منطقك بسحب العقد وإفلاتها من المكتبة (40 عقدة إجمالاً). تمثّل كل عقدة إجراءً محدداً. الفئات الرئيسية هي:

Triggers: نقطة دخول endpoint — أحد أربعة أنواع: HTTP API أو Webhook أو Schedule أو Telegram/Twilio.

AI: عقدة agent (HeroMate Managed أو مفتاح BYOK الخاص بك) وعقدة image_generation (مدارة فقط، تُحسب كأرصدة ذكاء اصطناعي، وتعيد عنوان URL للتخزين).

Database و Storage و Auth: اقرأ جداولك واكتبها، وأدر الملفات، ونفّذ عمليات المصادقة على الخادم.

Logic & Control: أضف شروطاً (if/else) وحلقات وتصفية ودمج وتحويلات حقول.

Communication & Integrations: اربط نحو 24 خدمة خارجية مثل WhatsApp و Stripe و Slack و Telegram و Notion و GitHub والمزيد — أو استدعِ أي شيء آخر بعقدة HTTP Request العامة.

Code node: تشغّل عقدة javascript_code JavaScript مخصصاً مع env_vars كنص واضح (ctx.env).

لديك تحكم كامل في منطقك. استخدم زر Test للتحقق من تدفقك. بتشغيل اختبارات يدوية يمكنك:

التأكد من اتصال كل العقد بشكل صحيح.

التحقق من مطابقة المدخلات والمخرجات لتوقعاتك.

اكتشاف أي مشكلات منطقية قبل النشر.

لوحة الاختبار أفضل صديق لك للتصحيح.

محاكاة الطلبات: أرسل بيانات اختبار لترى كيف يستجيب تدفقك.

تنفيذ خطوة بخطوة: شاهد كيف تتحرك البيانات عبر كل عقدة في الوقت الفعلي.

السجلات: راجع سجلات التنفيذ التفصيلية لتصحيح أي مشكلات.

يمكنك استخدام مساعد الذكاء الاصطناعي لتعديل Canvas نيابة عنك. اطلب ببساطة:

"أضف خطوة تحقق للتأكد مما إذا كان المستخدم مشرفاً."

"اربط مخرج قاعدة البيانات بعقدة إشعار WhatsApp جديدة."

أفضل الممارسات

أبقِه معيارياً: قسّم المنطق المعقد إلى تدفقات أصغر قابلة للإدارة.

استخدم أسماء وصفية: أعد تسمية عقدك لتعكس غرضها المحدد (مثلاً "Fetch User Profile" بدلاً من مجرد "Query").

اختبر كثيراً: استخدم لوحة الاختبار بعد إضافة عقد جديدة للتأكد من أن كل شيء يعمل بشكل صحيح.