ملخص
يشرح هذا الدليل كيفية تكوين إجراء Google Sheets — Search and find row في Astra. يسمح هذا الإجراء لوكيلك بقراءة الصفوف واستردادها من ورقة عمل Google Sheets (علامة التبويب) المحددة وإرجاع النتائج كقائمة منظمة.
لضمان عمل الإجراء بشكل صحيح، يجب أن تحتوي ورقة العمل لديك على صف رأس غير فارغ واحد في الأعلى. تحدد هذه الرؤوس بنية البيانات التي تقرأها Astra.
قبل تكوين الإجراء، تأكد من توصيل حساب Google الخاص بك بـ Astra.
تعليمات
اتبع هذه الخطوات لتكوين إجراء Google Sheets — Search and find row:
الخطوة 1: افتح قالب الإجراء
سجّل الدخول إلى حساب Astra الخاص بك.
انتقل إلى Action Library.
حدد Google Sheets — Search and find row.
افتح صفحة Configuration.
ستقوم بتكوين عدة أقسام في هذه الصفحة.
الخطوة 2: تكوين هدف الإجراء
في قسم Action intent:
أدخل Action name.
اكتب Intent تشرح متى يجب على الوكيل البحث عن الصفوف في جدول البيانات.
أهمية ذلك
يساعد الهدف الوكيل على فهم متى يجب عليه استخدام هذا الإجراء.
تعمل الإرشادات الواضحة على تحسين دقة وقت تشغيل الإجراء.
على سبيل المثال، قد يبحث الوكيل في الورقة عندما يطلب المستخدم تفاصيل العميل أو عندما يحتاج إلى استرداد المعلومات المخزنة.
الخطوة 3: حدد حساب Google
في قسم Google account:
اختر حساب Google المتصل الذي لديه حق الوصول إلى جدول البيانات.
كيف يعمل هذا
تستخدم Astra الحساب المحدد للوصول إلى Google Sheets من خلال مصادقة OAuth الآمنة.
يجب أن يكون جدول البيانات قابلاً للوصول من هذا الحساب.
الخطوة 4: حدد جدول البيانات وورقة العمل
في قسم Spreadsheet and worksheet:
اختر Drive location.
حدد Spreadsheet.
حدد Worksheet (tab) التي تحتوي على البيانات.
مهم:
يمكن استخدام جداول البيانات الموجودة في My Drive أو Shared Drives فقط.
تقرأ Astra البيانات فقط من ورقة العمل المحددة.
الخطوة 5: تكوين تصفية الصفوف
يمكنك التحكم في كيفية قراءة Astra للصفوف باستخدام زر التبديل Read only relevant rows.
الخيار 1: إيقاف التبديل (قراءة الورقة بأكملها)
عندما يكون التبديل إيقاف التشغيل:
تقرأ Astra ورقة العمل بأكملها.
يتم إرجاع جميع الصفوف إلى الوكيل.
الأفضل لـ:
الأوراق التي تحتوي على مجموعات بيانات صغيرة (حوالي 1000 صف أو أقل).
الخيار 2: تشغيل التبديل (قراءة الصفوف ذات الصلة فقط)
عندما يكون التبديل تشغيل:
تحاول Astra تصفية وإرجاع الصفوف ذات الصلة فقط.
يبحث الوكيل في البيانات بدلاً من قراءة الورقة بأكملها.
ملاحظات مهمة حول المطابقة:
المطابقة تقريبية (غامضة) لنص ASCII.
عمليات البحث عادةً ما تكون:
غير حساسة لحالة الأحرف
أقل حساسية للمسافات أو علامات الترقيم
بالنسبة للنصوص غير اللاتينية، تكون المطابقة أكثر حرفية وقد تتطلب تطابقات أقرب.
الأفضل لـ:
الأوراق التي تحتوي على مجموعات بيانات كبيرة حيث ستكون قراءة الورقة بأكملها غير فعالة.
ماذا يحدث عند تشغيل الإجراء
عند تشغيل الإجراء:
تقرأ Astra ورقة عمل Google Sheets المحددة.
يسترجع الصفوف بناءً على الإعدادات التي تم تكوينها.
يتم إرجاع الصفوف إلى الوكيل كقائمة منظمة من البيانات.
يسمح هذا لسير العمل الخاص بك باسترداد المعلومات المخزنة في Google Sheets ديناميكيًا، مثل سجلات العملاء أو بيانات المنتج أو معلومات التتبع الداخلية.