كيفية استخدام Flows مع واجهة برمجة التطبيقات Google Vision وGoogle Cloud Functions
منشئ التدفقات
·
06/10/2020

النقاط الرئيسية
Flows أكثر من أداة بدون كود — إنها محرك أتمتة مرن يتيح لك توسيع سير العمل باستخدام الكود من خلال خدمات خارجية مثل وظائف Google السحابية أو AWS Lambda.
تعرض هذه الدورة التدريبية كيفية بناء روبوت دردشة Telegram يستخدم واجهة برمجة التطبيقات لرؤية Google لتحديد الصور (مثل اكتشاف ما إذا كانت الصورة تحتوي على هوت دوج 🥪).
تظهر هذه المثال كيف يمكن أن تتصل Flows بسهولة بــ واجهات برمجة التطبيقات للتعرف على الصور لمعالجة المحتوى المقدّم من المستخدم تلقائيًا.
يمكن للمطورين الاستفادة من هذه البنية لبناء أتمتة في العالم الحقيقي، مثل تأكيد التسليم، أو التحقق من الهوية، أو سير عمل مراقبة الجودة.
يجعل دمج واجهة برمجة التطبيقات لرؤية Google داخل وظيفة سحابية تمكين الرؤى المدعومة بالذكاء الاصطناعي (اكتشاف الكائنات، وثقة التسمية، استخراج البيانات الوصفية) التي يمكن أن تتفاعل معها Flows ديناميكيًا.
تُعتبر خطوة “جلب المتغيرات” في مُنشئ التدفق هي الجسر — حيث إنها تستدعي الوظيفة السحابية وتخزن استجابة واجهة برمجة التطبيقات للاستخدام لاحقًا في المحادثة.
يمكن استخدام كتل الردود متغيرات مثل {{isHotDog}} لتخصيص الردود، مما يحول البيانات الخام إلى رسائل دردشة سياقية.
بينما العرض ترفيهي، فإنه يوضح كيف يمكن للمطورين دمج منطق بدون كود مع الوظائف السحابية لفتح قدرات أتمتة قوية عبر قنوات المراسلة.
أهم النقاط في الأسئلة والأجوبة
ما هو Flow Builder؟
محرر التدفقات (أو التدفقات) هو محرك الأتمتة المرئي من Bird لإنشاء سير العمل الخاص بالتواصل عبر القنوات - لا يتطلب الأمر أي برمجة، على الرغم من أنه يمكن توسيعه بكود مخصص.
لماذا استخدام Google Cloud Functions مع Flows؟
تسمح لك وظائف السحابة بتشغيل كود بدون خادم لمعالجة البيانات (مثل تحليل الصور أو جلب بيانات API الخارجية) وإدخال النتائج مرة أخرى في سير العمل الخاص بك.
ماذا تفعل واجهة برمجة التطبيقات Google Vision في هذا الإعداد؟
يقوم بتحليل الصور - تحديد الكائنات أو التسمية أو المفاهيم (مثل "هوت دوج") - ويعيد بيانات منظمة إلى تدفقك.
كيف أربط دالة سحابية ببرنامج إنشاء التدفقات؟
استخدم خطوة تحصيل المتغيرات لاستدعاء نقطة النهاية العامة للوظيفة عبر HTTPS. يمكن استخدام الاستجابة (مثل،
{ "isHotDog": true }) في الخطوات اللاحقة.هل يمكن استخدام هذا في حالات الأعمال الحقيقية؟
بالتأكيد. يمكن أن validate delivery photos نفس الأسلوب، كشف العناصر التالفة، التعرف على الوثائق، أو التحقق من الوسائط المرفوعة.
ما الذي يجعل هذا التكامل قوياً؟
يجمع بين رؤية الذكاء الاصطناعي و المرونة بدون خادم و التواصل عبر قنوات متعددة، مما يمكّن من أتمتة أذكى دون الحاجة إلى صيانة البنية التحتية.
هل أحتاج إلى خبرة في البرمجة لمتابعة ذلك؟
التعرف الأساسي على جافا سكريبت (لخدمة Google Cloud Function) مفيد، ولكن معظم العملية - من ربط القنوات إلى منطق التدفق - هي بصرية وملائمة للمبتدئين.
الـFlows هو محرك أتمتة قوي يعتمد على السحب والإفلات لإنشاء تدفقات الاتصال. لقد تخيلنا في البداية أنه حل بدون كود، ولكننا وجدنا أن العديد من المستخدمين يمكنهم تحقيق سلوك قوي حقًا من خلال كتابة بعض التعليمات البرمجية لحالات الاستخدام المحددة. يمكن أن تكون هذه المقاطع من التعليمات البرمجية داخل Flow Builder، أو يمكن أن تكون وظائف سحابية من جهات خارجية مثل وظائف AWS Lambda أو وظائف Google Cloud.
هذه عرض بسيط يستخدم وظائف GoogleCloud و Flows للقيام بالتعرف على الصور على صورة أُرسلت على تيليجرام.
التدفقات وما بعدها
خطة للنجاح
أولاً، سنقوم بإنشاء وظيفة سحابية، تتلقى طلبًا يحتوي على رابط لصورة، ثم تستخدم واجهة برمجة تطبيقات التعرف على الصور لمعالجة الصورة، وتستجيب سواء كانت هناك نقانق في الصورة أم لا.
ثم سنقوم ببناء تدفق، يستقبل رسالة من مستخدم عبر قناة الرسائل (تيليجرام في هذه الحالة)، ينفذ الوظيفة السحابية السابقة، ويستجيب للمستخدم سواء كانت هناك نقانق في الصورة التي أرسلها.
إعداد دالة Google Cloud
إعداد واجهة برمجة تطبيقات Google Vision
إنشاء تدفق في Flows
قم بتسجيل الدخول إلى لوحة معلومات Bird أو سجل للحصول على حساب إذا لم يكن لديك واحد.
إذا كنت جديداً على Flows وليس لديك أي قنوات تم إعدادها، ستحتاج إلى الانتقال إلى صفحة إعداد القناة، واختيار إعداد قناة Telegram. لقد اخترت Telegram لهذا العرض التقديمي لأنه سهل وسريع الإعداد.

الآن لديك قناة يمكننا استخدامها في Flows. انتقل إلى صفحة Flows، أنشئ تدفقاً مخصصاً جديداً، واختر مشغل قناة “Telegram”.

سيتم توجيهك إلى صفحة التدفق، حيث ينبغي عليك اختيار قناة Telegram الخاصة بك كمشغل، وفي حالتنا هي “Hotdog”. يرجى إضافة خطوتين: “Fetch variables” و“Reply to channel message”.
داخل خطوة “Fetch variables” سنقوم باستدعاء وظيفة السحابة الخاصة بنا واسترداد الاستجابة إلى المتغير “isHotDog” والتي ستحتوي على “true” أو “false” كاستجابة من وظيفة GoogleCloud. في حقل URL، يرجى إدراج عنوان URL لوظيفتك https://your-function-address.cloudfunctions.net/HotDogOrNot وملء جميع الحقول الأخرى كما هو موضح في صورة "محتوى خطوة Fetch variable".
وداخل خطوة “Reply to channel message” سنقوم بالرد على العميل برسالة تحتوي على إجابة نعم أو لا. لذلك، قم بإدخال النص التالي في حقل
نتائج


بينما يكون هذا مثالًا ممتعًا، نعتقد أن هذا النوع من الوظائف يمكن أن يكون مفيدًا جدًا لمستخدمينا.
إذا كنت تريد المزيد من الميزات مثل هذه مدمجة في Flows، اكتب إلى فريق الدعم لدينا لإعلامنا.






