مساعد ذكي مع جداول MaviBot

باستخدام دالة مخصصة طورها فريق MaviBot، يمكن لروبوت المحادثة الذكي لديك قراءة القيم من Google Sheet بذكاء وتخزينها في متغير نظام داخل إعدادات مشروعك. وهذا ينشئ مصدر بيانات متزامنًا وديناميكيًا لمساعدك.

تطبيقات عملية

هذه الإمكانية ضرورية لسيناريوهات مثل:

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

• روبوت ترويج ذكي: روبوت يُروّج لعروضك من خلال إبراز الميزات أو المواصفات أو العروض ديناميكيًا مباشرةً من ورقة العمل الخاصة بك.

كيفية تجهيز الجدول الخاص بك للتكامل

للبدء، انتقل إلى قسم الأوراق:

بعد ذلك، سترى زر "Add sheet"، الذي يفتح نافذة منبثقة تحتاج فيها إلى إدخال اسم الورقة:

أدخل اسم الورقة وانقر على زر "Done". ثم سيتم إنشاء ورقة جديدة في المشروع وستظهر في قسم "Sheets":

إعدادات الورقة

بعد إنشاء الورقة، تحتاج إلى إضافة صفوف وأعمدة. للقيام بذلك، ابحث عن زر "Go to" على بطاقة الورقة المطلوبة وانقر عليه.

ترى الإعدادات التالية:

لإضافة عمود باسم، انقر على زر "+":

عند النقر على الزر، ستفتح نافذة منبثقة حيث يمكنك إدخال اسم للعمود الجديد.

بعد إدخال اسم العمود، انقر على زر "Done"، ثم ستتم إضافة العمود الجديد إلى الورقة. أضف العدد المطلوب من الأعمدة ثم الصفوف.

الآن، تبدو ورقتك هكذا.

انسخ (وتذكّر) معرّف الورقة: للقيام بذلك، انقر على شريط العنوان:

بعد ذلك، لننتقل إلى تهيئة الكتل في الباني.

العمل في باني روبوت المحادثة

الدالة get_records_from_table()

لاستخدام الدالة get_info_from_table()، تحتاج إلى كتلة واحدة في باني روبوت المحادثة.

انتقل إلى التبويب المناسب في Mavibot وأنشئ كتلة تحتوي على مُشغّل (كتلة البدء أو كتلة المُشغّل):

حدّد متغيرًا (سيُستخدم لمعارف مساعد الذكاء الاصطناعي): في هذا المثال، المتغير هو 'record'.

مثال على الكود من Calculator

project.record = get_records_from_table(1)

1. project. - هو مُنشئ لتعيين متغير في إعدادات المشروع؛

2. record - اسم المتغير؛

3. get_records_from_table(1) - دالة، حيث يتم تمرير المعامل على أنه معرّف الجدول.

اقرأ المزيد عن الدالة get_record_from_table()

get_records_from_table(table_id, start_row, count, start_col, end_col) – للحصول على السجلات من جدول

المعامل	الوصف	ملاحظة
! table_id	معرّف الجدول (معامل مطلوب)
start_row	معامل اختياري، عدد صحيح. يحدد صف البداية للنطاق	يقبل رقم الصف الذي يبدأ منه قراءة قيم الجدول، شاملًا. يجب تحديده بدون علامات اقتباس
count	معامل اختياري، عدد صحيح. يحدد عدد الصفوف المطلوب استرجاعها	القيمة الافتراضية: 1000. الحد الأقصى: 5000. يجب تحديده بدون علامات اقتباس
start_col	معامل اختياري، نص. يحدد عمود البداية للنطاق	يقبل اسم العمود الذي تبدأ منه قراءة قيم الجدول، شاملًا. يجب تحديده بين علامتي اقتباس
end_col	معامل اختياري، نص. يحدد عمود النهاية للنطاق	يقبل اسم العمود الذي سيتم القراءة حتى الوصول إليه، شاملًا. يجب تحديده بين علامتي اقتباس

لقراءة جميع البيانات من نقطة معينة: حدّد فقط بداية النطاق. لقراءة جميع البيانات حتى نقطة معينة: حدّد فقط النهاية النطاق.

بدلًا من #{none}، سنكتب متغيرنا في الرسالة باستخدام البنية #{} لنرى بصريًا ما البيانات التي تمت كتابتها في متغير المشروع.

انتباه

المتغير المضمّن في الرسالة مطلوب للتحقق مما إذا كان الروبوت يقرأ الدالة بشكل صحيح. عندما تشغّل الكتلة في وضع الاختبار، سيعرض الروبوت القيم التي سيتم تعيينها للمتغير.

يرجى الملاحظة

بعد تهيئة استدعاء الكتلة في وضع الاختبار وحفظ المتغير في إعدادات المشروع، لا تحذف هذه الكتلة.

قد تحتاج إليها: على سبيل المثال، إذا أضفت أي قيم أخرى إلى الجدول، فما عليك سوى تشغيل الكتلة في وضع الاختبار. عندها سيتم تحديث البيانات في متغير المشروع.

يمكن أن يكون اسم المتغير أي اسم تريده.

كتلة نقل البيانات

بعد ذلك، سننشئ كتلة "Chat" لنقل البيانات إلى بطاقة العميل.

"يمكن لهذه الكتلة أيضًا إرسال رسالة ختامية من الروبوت، مثل: 'أقوم بتمرير المعلومات إلى المدير! سيتواصل المدير خلال 10 دقائق.'"

بعد ذلك، انسخ معرّف الكتلة. ستحتاج إليه لتهيئة مساعد الذكاء الاصطناعي في الأمر "start_block_from_ai 11956" وأمر الاختبار "Block call 11956"، حيث بدلاً من معرّف الكتلة من المثال، تحتاج إلى إدراج معرّف الكتلة الخاص بك.

يرجى الملاحظة

بعد الاختبار، استبدل "Block call 31241050بالأمر "start_block_from_ai 31241050".

الأمر "Block call 31241050" هو للتصحيح ويساعد على فهم البيانات التي يسجلها الروبوت (انظر قسم "Testing").

لتشغيل الروبوت للعملاء، حدّد الأمر "start_block_from_ai 31241050".

قراءة جدول

1. انتقل إلى اختبار الروبوت وضع.

2. شغّل الكتلة التي تحتوي على المُشغّل لقراءة بيانات الجدول.

لقد عملت الكتلة بشكل صحيح. يمكنك رؤية ذلك مؤكدًا من خلال القيم المخزنة الآن في المتغير المقابل ضمن إعدادات مشروعك.

للتحقق يدويًا:

1. انتقل إلى إعدادات المشروع .

2. حدد موقع المتغير لعرض بياناته الحالية.

في تبويب "Variables" ضمن إعدادات المشروع، سترى متغيرك مع القيم المضافة إليه من الجدول. لذا الآن، داخل مشروعك، يوجد متغير يحتوي على السلع والتكلفة وكل ما حددته في الجدول.

العمل في مساعد الذكاء الاصطناعي

انتقل إلى قسم "AI assistant" وابدأ روبوت المحادثة بإعدادات الذكاء الاصطناعي.

تحتاج إلى اختيار دور "Sales assistant":

سنقوم أيضًا بتعيين إعدادات إضافية:

إعدادات مساعد الذكاء الاصطناعي

في إعدادات الروبوت اكتب البيانات التالية:

1. الموضع والتعليمات الخاصة بالروبوت.

1. يُكتب الأمر لاستدعاء الكتلة ونقل المتغيرات إلى النظام كما يلي:

"إذا كان كل شيء صحيحًا، فنفّذ الأمر "start_block_from_ai 11956"، حيث بدلًا من N يُكتب معرّف الكتلة مع الرسالة النهائية: كتلة Chat تنقل البيانات إلى بطاقة العميل:

معرفة الروبوت

في حقل "Bot Knowledge"، مرّر المتغير الذي تم تخزينه سابقًا ككتلة مع المُشغّل.

معرفة الروبوت.

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

تنسيق البيانات

في تنسيق البيانات المنقولة، تحدد أنت البيانات التي تجمعها (على سبيل المثال، منتج)، ثم تدخل العبارة مع "key" وتعيّن قيمة للمفتاح.

اسم العميل بالمفتاح client_name، ورقم هاتف العميل بالمفتاح phone_number، والمدينة والعنوان بالمفتاح city_address، والمنتج المختار بالمفتاح product، وكمية المنتج بالمفتاح quantity، وإجمالي مبلغ الطلب بالمفتاح total_amount.

بهذه الطريقة، عند استدعاء الكتلة، سيتم تمرير المتغيرات إلى بطاقة العميل: عندها يمكنك العمل مع المتغيرات، على سبيل المثال، في باني روبوت المحادثة:

في هذه المرحلة، يكون إعداد مساعد الذكاء الاصطناعي قد اكتمل.

يمكن ضبط المعلمات المتبقية وفقًا لتقديرك:

اختبار روبوت

"إذا كانت لديك روبوتات تعمل بالفعل، فحدّد في شرط تشغيل مساعد الذكاء الاصطناعي أن يبدأ فقط في نافذة الاختبار."

الخطوة 1. انقر على باني المُشغّل

الخطوة 2. اختر التبويب الخاص بنافذة الاختبار وانقر على "Add trigger":

الآن، في شرط المُشغّل، سترى القيمة التالية:

بهذه الطريقة، سيعمل الروبوت فقط في نافذة الاختبار وليس في أي مكان آخر.

بعد تصحيح أخطاء الروبوت، أزل هذا الشرط.

تُرسل هذه الرسالة في test mode بسبب الأمر "Block call 3124105

بعد اختبار الروبوت وتصحيح أخطائه، اكتب الأمر في إعدادات الروبوت "start_block_from_ai 31241050".

هذا النهج يمكّنك من إنشاء أي نوع من المتاجر الإلكترونية والاستفادة من أي قيم بيانات مخزنة داخل جدولك.

الحد الحقيقي الوحيد هو خيالك.