# جداول Google للمساعد الذكي

بفضل ميزة طوّرها فريق Mavibot، يفسّر روبوت الدردشة بالذكاء الاصطناعي القيم المُدخلة في الجدول بدقة ثم يحفظها في متغير نظام ضمن إعدادات المشروع.

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

بالضبط كيف تستخدم روبوتًا لقراءة جدول Google متروك لك، ونحن بدورنا سنوضح لك كيفية إنشاء جدول وإعداد الروبوت للعمل معه.

## إعداد جدول Google

### الإنشاء والتعبئة

افتح محرر الجدول:

<figure><img src="/files/9fae69f12380b7f528657a43503d0116c3642a67" alt="" width="563"><figcaption></figcaption></figure>

تحتاج إلى ملء الصفوف بفئات الأعمدة:

<figure><img src="/files/75150bcaa84d26cc7d9d3f048178a7054965e454" alt="" width="563"><figcaption></figcaption></figure>

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

بعد ذلك، حدّد الأسماء اللازمة في الأعمدة:

<figure><img src="/files/639833174044df520a0d0c03117dfab66df60009" alt="" width="563"><figcaption></figcaption></figure>

لنلقِ نظرة على فئة العمود "وحدة القياس":

<figure><img src="/files/0af9b43bd2636b1e27e862c6a4089c637110d3a1" alt="" width="252"><figcaption></figcaption></figure>

يمكن أن تتضمن وحدة القياس ما يلي:

1. مؤشر كمي على شكل قطع/وحدات (وحدة واحدة من البضاعة، وحدتان من البضاعة، قطعة واحدة، إلخ):

<figure><img src="/files/6f58b008a39065e3b573f31ea5a43b5598067b25" alt=""><figcaption></figcaption></figure>

2. وحدات قياس الكميات: لترات، كيلوجرامات، غرامات، أمتار:

<figure><img src="/files/bf5b96149998e933e43065fc6ee8464cd613dc4f" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
سيفهم الروبوت تمامًا ما قصدته ويستخدم القيم المضمّنة في الخانات.
{% endhint %}

الخطوة الأخيرة في ملء جدول Google ستكون إدخال السعر لكل وحدة قياس.

<figure><img src="/files/df906db634b6883eed0937658d2c1ffef1306f31" alt=""><figcaption></figcaption></figure>

في هذه المرحلة، يكون جدول Google قد اكتمل.

### إعدادات الوصول

حتى يتمكن روبوت الذكاء الاصطناعي من أخذ القيم من الجدول، تحتاج إلى فتح إعدادات الوصول:

<figure><img src="/files/e0519a2faaf3cd19b15e6ac6a653b24d314d5f3b" alt=""><figcaption></figcaption></figure>

انقر على الإعدادات، وستفتح النافذة التالية:

<figure><img src="/files/3bcfccef777ed207b524490e20a0e8d342d76cd4" alt="" width="375"><figcaption></figcaption></figure>

هنا تحتاج إلى تغيير الإعداد من "الوصول مقيد" إلى "كل من لديه رابط":

<figure><img src="/files/d61c2c7727b8643215e9c80e479d91d913d07c58" alt="" width="563"><figcaption></figcaption></figure>

### معرّف الجدول

للعمل مع الدالة get\_info\_from\_table(!sheet\_id, number\_sheet, sheet\_json\_keys)، سنحتاج إلى معرّف الجدول، لأن الدالة تأخذ sheet\_id كمعامل مطلوب.

للحصول على المعرف، ما عليك سوى النقر على شريط العنوان:

<figure><img src="/files/2a1a6f002510f34700dabaf862f21c2fdd77a102" alt=""><figcaption></figcaption></figure>

سترى سطرًا يحتوي على عنوان الصفحة:

<figure><img src="/files/d9b3481e9d4942e9719af70825220d9486703391" alt=""><figcaption></figcaption></figure>

ومن هذا العنوان سنحتاج إلى مجموعة من الرموز والأحرف، وهي ببساطة معرّف الجدول:

<figure><img src="/files/466667ab3a2b3bef0a3a0e21907eba0291a838a6" alt=""><figcaption></figcaption></figure>

وبهذا تكتمل عملية العمل مع الجدول وإعداداته.

## العمل في منشئ القمع

### باستخدام الدالة get\_info\_from\_table()

لاستخدام الدالة get\_info\_from\_table()، ستحتاج إلى كتلة واحدة في منشئ القمع.

انتقل إلى علامة التبويب المناسبة في Mavibot وأنشئ كتلة تحقق من الشرط الأساسي:

<figure><img src="/files/a6196c69acfa1cef7b2c0552c92f1e05bd92c12c" alt=""><figcaption></figcaption></figure>

بدلًا من #{none}، سنكتب في الرسالة إشعارًا لوضع الاختبار بعد تشغيل هذه الكتلة ومتغيرًا مضمّنًا من خلال البنية #{}:

<figure><img src="/files/9c2ceb48cc418a1dc171057438f36f8f1fab7112" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
انتبه!&#x20;

المتغير المضمّن في الرسالة ضروري للتحقق من أن الروبوت يقرأ الدالة.&#x20;

عند تشغيل الكتلة في وضع الاختبار، سيعرض الروبوت القيم التي ستُضمَّن داخل المتغير.
{% endhint %}

{% hint style="success" %}
انتبه!

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

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

{% hint style="info" %}
يمكن أن يكون اسم المتغير أي اسم يناسبك.
{% endhint %}

بعد ذلك، نحتاج إلى الدالة get\_info\_from\_table(sheet\_id, number\_sheet, sheet\_json\_keys)، وهي دالة مخصصة لقراءة البيانات من جدول.

<table><thead><tr><th width="248">المعلمات</th><th>الوصف </th></tr></thead><tbody><tr><td><mark style="color:red;"><strong>!</strong></mark> sheet_id</td><td>معرّف جدول Google</td></tr><tr><td>number_sheet</td><td>رقم الورقة في الجدول؛ الافتراضي = 1</td></tr><tr><td>sheet_json_keys </td><td>معامل اختياري، مفتاح الوصول إلى بيانات الجدول</td></tr></tbody></table>

افتح الحاسبة وأدخل معرّف الجدول، مع وضعه داخل متغير (على سبيل المثال، sheet):

<figure><img src="/files/baaa0792ef2c616da2529e44ba6cb27dc3c36e12" alt="" width="537"><figcaption></figcaption></figure>

بعد ذلك، خصّص المتغير المحدد في رسالة الكتلة وأعطه قيمة على شكل الدالة get\_info\_from\_table() مع المعامل المطلوب sheet\_id (بدلًا منه أدخل المتغير sheet، حيث يوجد معرّف الجدول):

<figure><img src="/files/fe6c62510de5ed932e6295cd02c46fb2156c290b" alt="" width="563"><figcaption></figcaption></figure>

<mark style="color:red;">**انتباه!**</mark> قبل المتغير product\_pay\_info في الحاسبة، اكتب project. هذا ضروري لكي يتم إدخال المتغير والقيم من الجدول إلى إعدادات المشروع (المخزنة مؤقتًا):

<figure><img src="/files/7d0dd23fcaff475f52fd502f8496418eb3b598fc" alt=""><figcaption></figcaption></figure>

الآن اكتب أي كلمة/أرقام في شرط الكتلة:

<figure><img src="/files/481137b4c08d4caff7f5e74c9f73bd200aa2b0f9" alt="" width="563"><figcaption></figcaption></figure>

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

بعد ذلك، أنشئ كتلة Status ثانية:

<figure><img src="/files/835a1c753865453f13dcd423c5be71ce694be376" alt=""><figcaption></figcaption></figure>

ستكون كتلة Status هذه مطلوبة لنقل المتغيرات إلى بطاقة العميل.

يمكنك أيضًا إرسال رسالة نهائية من الروبوت في هذه الكتلة، مثل: "شكرًا لطلبك! سأرسل البيانات إلى مدير التواصل!":

<figure><img src="/files/6568b0f5651ca9ddb2d2a6f93202aa2a0d7353d6" alt=""><figcaption></figcaption></figure>

بعد ذلك، انسخ معرّف الكتلة - ستحتاج إليه لتكوين مساعد الذكاء الاصطناعي في الأمر "start\_block\_from\_ai 31241050"، حيث يجب استبدال المعرّف الوارد في المثال بمعرّف كتلتك.

### قراءة الجدول

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

<figure><img src="/files/c0a73223bfa6efed75d0d399950ec0b27f7c9c53" alt="" width="563"><figcaption></figcaption></figure>

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

يمكنك التحقق من ذلك بالانتقال إلى القسم المناسب:

<figure><img src="/files/86ccbc9a270aa4ddf3478344e6b5c848c36d2298" alt="" width="287"><figcaption></figcaption></figure>

بعد ذلك، سترى متغيرك مع القيم المضمنة فيه من الجدول:

<figure><img src="/files/e52a4d3901f5a048e00b87b8d1928c2843d74a77" alt=""><figcaption></figcaption></figure>

إذًا، أصبح داخل مشروعك الآن متغير يحتوي على المنتجات والتكلفة وكل ما حددته في الجدول.

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

انتقل إلى قسم "مساعد الذكاء الاصطناعي" وابدأ في إعداد الذكاء الاصطناعي.

دور المساعد: بائع

<figure><img src="/files/25374933af5cac68cd15e68de58b296c2a327112" alt="" width="512"><figcaption></figcaption></figure>

سنحدد أيضًا خياري "الأزرار" و"إدخال البيانات خطوة بخطوة":

<figure><img src="/files/a10a8ae17fc0316b9093eff57a516d20d0fdafca" alt=""><figcaption></figcaption></figure>

سنحتاج إلى الأزرار من أجل الاستجابات المصممة بصريًا من الروبوت، وكذلك لراحة العميل (حتى لا يضطر المستخدم إلى إدخال الكلمات يدويًا في المحادثة)؛ أما إدخال البيانات خطوة بخطوة فهو لكي يستعرض الروبوت الطلب الجاري إنشاؤه.

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

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

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

مثال:

<أنت بائع متجر. "كل التفاصيل الصغيرة.\
مهمتك هي أن تسأل العميل عن المنتج الذي يريد اختياره، وعدد وحدات المنتج، ثم تحسب التكلفة الإجمالية للمنتج، وهي تساوي وحدة واحدة من المنتج مضروبة في السعر.

بعد أن تستفسر من العميل عن عملية الشراء، قم بتكرار الطلب له واسأل: "هل الطلب صحيح؟">.

**انتبه** إلى السطر "احسب التكلفة الإجمالية للمنتج، وهي تساوي وحدة المنتج مضروبة في السعر" - سيعرض هذا السطر النتيجة النهائية لتكلفة جميع الفئات التي اختارها العميل:

مثال:

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

<figure><img src="/files/8d18d1b267ed603f7d73870ce35ea1037dad9e78" alt="" width="563"><figcaption></figcaption></figure>

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

<إذا كتب العميل "الطلب صحيح" أو "صحيح"، فقم بكتابة "start\_block\_from\_ai N">، حيث يتم استبدال N بمعرّف الكتلة التي تحتوي على الرسالة النهائية: تنقل كتلة Status البيانات إلى بطاقة العميل:

<figure><img src="/files/d5c88132d8bea6766eb322fca5397b805296e324" alt="" width="563"><figcaption></figcaption></figure>

تبدو الأوامر في إعدادات مساعد الذكاء الاصطناعي كما يلي:

<figure><img src="/files/5a79c36f74a54f5eca6368a857add4dddae055b8" alt=""><figcaption></figcaption></figure>

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

في حقل "معرفة الروبوت"، مرّر المتغير الذي تم تخزينه مؤقتًا سابقًا بواسطة كتلة التحقق الأساسي للشرط:

<figure><img src="/files/9315cb6a4bf35e610e975feb34c0b38aa4ea13ec" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/c137222ed794b074a8168344814b8cb9096fa48b" alt=""><figcaption></figcaption></figure>

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

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

في صيغة البيانات المرسلة، تحدد أنت البيانات التي تجمعها بنفسك (على سبيل المثال، منتج)، ثم تُدخل العبارة مع "المفتاح" وتُعيّن قيمة للمفتاح:

<figure><img src="/files/3963f81e1f276f71dd0ab69d3dbf6a7add2af8a8" alt=""><figcaption></figcaption></figure>

#### الشرح

السطر 1: "صيغة البيانات المرسلة: المنتج مع مفتاح المنتج، وحدة القياس مع مفتاح العنصر، السعر مع مفتاح العدد، التكلفة الإجمالية لجميع المنتجات المختارة مع مفتاح النتيجة" - يوضح للروبوت ما هي البيانات وبأي قيمة يجب إرسالها إلى النظام.

ستظهر هذه المتغيرات في بطاقة العميل:

<figure><img src="/files/ac54f9ea26ba003c0b83c23e3aa77768bbe2cd0c" alt="" width="563"><figcaption></figcaption></figure>

2. إذا كنت بحاجة إلى عرض كل منتج اختاره العميل بشكل منفصل، فأضف سطرًا ثانيًا:

"إذا اختار العميل عدة منتجات، فأضف المنتج الأول بمفتاح product1، والمنتج الثاني بمفتاح product2، والمنتج الثالث بمفتاح product3، وهكذا".

وبهذا يكتمل إعداد مساعد الذكاء الاصطناعي.

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

<figure><img src="/files/3e887952e34ba7ac7eeceedd45ea378afbc63f5f" alt="" width="563"><figcaption></figcaption></figure>

## اختبار الروبوت&#x20;

استخدم منشئ الشرط لإضافة عمل الروبوت في نافذة الاختبار:

الخطوة 1. انقر على منشئ الشرط

<figure><img src="/files/2a04144212694b7eb97481a7fbd0d500781a2b42" alt=""><figcaption></figcaption></figure>

الخطوة 2. اختر علامة التبويب التي تحتوي على مربع النص وانقر على "إضافة":

<figure><img src="/files/6b725c33cc07787880385b3b55ab169bc9fcc4ae" alt="" width="563"><figcaption></figcaption></figure>

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

<figure><img src="/files/8b3369ed80afc1f5afb2ce75dc6bba473c333768" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
وبهذه الطريقة، لن يعمل الروبوت إلا في نافذة الاختبار وليس في أي مكان آخر.

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

الآن لنختبر الروبوت:

1. لنطرح على الروبوت سؤال أمان حول مجموعة المنتجات:

<figure><img src="/files/105e5700ce163ae1285b7c996e7ad738a007f3db" alt="" width="375"><figcaption></figcaption></figure>

أظهر الروبوت مجموعة متنوعة من المنتجات التي تم إدخالها في جدول Google، مع التقاط القيم من متغير موجود في إعدادات المشروع.

2. بعد ذلك، سنختار المنتج ونتحدث إلى الروبوت الذكي:

<div><figure><img src="/files/44be806a749e6f2c53dc999e8efc0021fb792a25" alt="" width="375"><figcaption></figcaption></figure> <figure><img src="/files/c2da6858b08543ad28c81b1d11085b2e96fbb3bb" alt="" width="375"><figcaption></figcaption></figure></div>

3. لنختر منتجًا آخر:

<figure><img src="/files/c3935d1eab7e2fbd066097d8cf5123f2c4bbfa21" alt="" width="375"><figcaption></figcaption></figure>

كما يظهر الروبوت بشكل صحيح، ويعرض للعميل فئات المنتجات للاختيار لاحقًا.

4. اختار العميل عدة منتجات وحدد كميتها:

<div><figure><img src="/files/6cb075f23aee882e9eeb29abf14be47ea4b9bb04" alt=""><figcaption></figcaption></figure> <figure><img src="/files/5020e61fd7ae53633837a9f27a926cf4a9f961b0" alt=""><figcaption></figcaption></figure></div>

حسب الروبوت تكلفة السلع المختارة وحسب التكلفة الإجمالية.

5. إرسال البيانات إلى النظام:

<figure><img src="/files/e51ba9dc9027097146df9332d432ce905e46641c" alt="" width="375"><figcaption></figcaption></figure>

النتيجة: بعد أن كرر الروبوت الطلب وأجاب العميل بأن الطلب صحيح، استدعى روبوت الدردشة، بناءً على الإعدادات، كتلة "حالة الحوار":

<figure><img src="/files/6568b0f5651ca9ddb2d2a6f93202aa2a0d7353d6" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/dcc25f8ddfbea93e56e510ff8416500c71509992" alt="" width="563"><figcaption></figcaption></figure>

عمل الروبوت بشكل صحيح تمامًا.

{% hint style="success" %}
وبهذه الطريقة يمكنك إنشاء متجر إلكتروني بأي نوع واستخدام أي قيم لازمة داخل الجدول.

الحد الوحيد - هو خيالك فقط!
{% endhint %}

## دليل فيديو

{% embed url="<https://youtu.be/LTEmRgbRp8M>" %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mavibot.ai/doc/ar/chatbot/ai/jdawl-google-llmsaad-althky.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.