كيفية ربط Dify مع جداول بيانات جوجل وجوجل درايف

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

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

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

مقال ذو صلة:

كيفية تثبيت وتكوين Diify باستخدام Docker خطوة بخطوة

ما تحتاجه لربط Dify مع جداول بيانات جوجل

قبل أن نبدأ، يجدر بنا توضيح أن المكمل omluc/google_sheets هذه إضافة مجتمعية متوفرة في متجر Dify. وهي ليست جزءًا من الإضافات الرسمية التي طورها فريق Dify، على الرغم من إمكانية تثبيتها من متجر الإضافات الخاص بهم.

تتضمن هذه الإضافة حاليًا أداتين رئيسيتين:

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

يمكن إضافة هذه الوظائف كأدوات ضمن سير العمل أو إتاحتها للوكيل لاستخدامها عند الحاجة. لتكوينها، ستحتاج إلى:

• أ حساب جوجل مع إمكانية الوصول إلى جوجل كلاود.
• Un تم إنشاء المشروع على Google Cloud.
• La واجهة برمجة تطبيقات جداول بيانات جوجل ممكن.
• حساب خدمة مع مفتاح بتنسيق JSON.
• أ ورقة مشتركة باستخدام عنوان البريد الإلكتروني الخاص بذلك الحساب.

يعمل حساب الخدمة كهوية مستقلة. لذلك، لا يستخدم Dify حسابك الشخصي على Google مباشرةً، ولا يمكنه الوصول تلقائيًا إلى جميع جداول البيانات الخاصة بك. سيقتصر وصوله على المستندات التي تشاركها معه صراحةً.

كيفية إنشاء حساب خدمة على Google Cloud

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

ثم أدخل إدارة الهوية والوصول > حسابات الخدمة وقم بإنشاء حساب جديد. يمكنك تسميته باسم يسهل التعرف على الغرض منه، مثل "Dify Google Sheets".

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

بعد إنشاء الحساب:

1. افتح بياناتك من قسم حسابات الخدمة.
2. انتقل إلى علامة التبويب المفاتيح.
3. انقر على إضافة مفتاح > إنشاء مفتاح جديد.
4. اختر التنسيق JSON.
5. قم بتنزيل الملف وحفظه في مكان آمن.

يحتوي ملف JSON على معلومات حساسة، بما في ذلك مفتاح خاص. يُمنع نشره أو إرساله عبر البريد الإلكتروني أو تحميله إلى أي مستودع. أي شخص يحصل على هذا المفتاح سيتمكن من التصرف بصلاحيات حساب الخدمة.

كيفية تثبيت وتكوين الملحق في ديفي

في Dify، افتح متجر الإضافات وابحث عن إضافة جداول بيانات جوجل التي نشرتها شركة omlucتحقق من اسم المؤلف قبل تثبيته لتجنب الخلط بينه وبين إضافات أخرى قد تقدم وظائف مختلفة.

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

لا تقم بنسخ البريد الإلكتروني أو مُعرّف المشروع أو المفتاح الخاص بشكل منفصل. يتطلب الملحق بنية JSON كاملة للتحقق من صحة الطلبات المُرسلة إلى جداول بيانات جوجل.

بعد ذلك، احفظ بيانات الاعتماد وافتح جدول البيانات الذي تريد استخدامه. ستجد داخل ملف JSON حقلاً يسمى client_email، والتي ستكون قيمتها مشابهة لهذا الشكل:

[email protected]

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

• يمنح الإذن لـ قارئ إذا كانت Dify ستعتمد فقط على البيانات.
• يمنح الإذن لـ محرر إذا كنت بحاجة أيضًا إلى تحديث الخلايا.

لا يُنصح بمشاركة جدول البيانات علنًا عبر رابط. يتيح لك حساب الخدمة الحفاظ على خصوصية المستند وتقييد الوصول إليه لمستخدم محدد.

كيفية قراءة البيانات من جداول بيانات جوجل من سير العمل

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

ستحتاج إلى تقديم مُعرّف جدول البيانات. يظهر هذا المُعرّف في عنوان الويب الخاص به، بين /d/ y /editفي عنوان URL بهذا الشكل:

https://docs.google.com/spreadsheets/d/IDENTIFICADOR/edit

يجب عليك استخدام القيمة المحددة فقط IDENTIFICADOR.

ستحتاج أيضًا إلى تحديد اسم علامة التبويب ونطاقها باستخدام صيغة جداول بيانات جوجل. إليك بعض الأمثلة:

Clientes!A2:D50
Productos!A:C
Pedidos!B2:B20

الاسم الذي يسبق علامة التعجب يطابق علامة الجدولة. أما الأحرف والأرقام التي تليها فتحدد الأعمدة والصفوف المراد استرجاعها.

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

كيفية تحديث الخلايا من Dify

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

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

يُنصح أيضًا بمنع النموذج من اختيار أي نطاق أو قيمة بحرية. يتكون التكوين الأكثر أمانًا مما يلي: أولاً، تحقق من صحة البيانات، وقم بتقييد الأعمدة القابلة للتعديل، وقم ببناء النطاق باستخدام المتغيرات المتحكم بها. من خلال سير العمل.

على سبيل المثال، يمكنك تنظيم العملية على النحو التالي:

1. El يقوم المستخدم بإدخال رقم الطلب.
2. يعود باتش جيت إلى الصف مُتَجَانِس.
3. عقدة شرطية تحقق مما إذا كان الطلب موجودًا.
4. النموذج يقوم بتحليل أو تصنيف المعلومات.
5. يقوم التحديث المجمع بكتابة النتيجة في عمود محدد.
6. تؤكد عقدة الإخراج السجل الذي تم تعديله.

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

أخطاء شائعة عند ربط Dify بـ Google Sheets

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

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

• تم تفعيل واجهة برمجة تطبيقات جداول بيانات جوجل في المشروع الصحيح.
• تمت مشاركة الورقة بالقيمة الدقيقة لـ client_email.
• لا يحتوي مُعرّف الورقة على أي أجزاء إضافية من عنوان URL.
• اسم علامة التبويب مطابق، بما في ذلك الأحرف الكبيرة والصغيرة والمسافات والعلامات التشكيلية.
• يستخدم النطاق ترميزًا صحيحًا، مثل Datos!A2:C20.
• يملك الحساب صلاحية التحرير إذا حاول سير العمل الكتابة.

إذا قمت بحذف المفتاح أو تعطيله في Google Cloud، فستحتاج إلى إنشاء مفتاح جديد واستبدال بيانات الاعتماد المحفوظة في Dify. كما يُنصح بإنشاء مفتاح جديد إذا كنت تشك في أن ملف JSON قد تم تسريبه.

الاختلافات بين إضافات جداول بيانات جوجل وجوجل درايف

لا ينبغي التعامل مع جداول بيانات جوجل وجوجل درايف كوحدة متكاملة واحدة. تم تصميم إضافة مجتمع جداول البيانات لـ عرض وتعديل نطاقات الخلايا من خلال حساب خدمة.

في المقابل، تستخدم إضافة Google Drive الرسمية المتاحة كمصدر بيانات OAuth 2.0يتيح لك ذلك استعراض المجلدات، وعرض قائمة الملفات، وتنزيل محتوياتها للمعالجة أو الدمج في تدفق المعرفة الخاص بـ Dify.

موصل Google Drive للقراءة فقط: فهو لا يُنشئ ملفات، ولا يُنظّم مجلدات، ولا يُعدّل أو يحذف مستندات. عند تنزيل الملفات الأصلية من Google Workspace، يُصدّرها تلقائيًا إلى تنسيقات متوافقة. تُحوّل جداول بيانات Google إلى ملفات XLSX، بينما تُصدّر مستندات Google وعروض Google التقديمية كملفات PDF.

لذلك، يجب عليك اختيار التكامل وفقًا للمهمة:

• استخدم الإضافة لـ جداول بيانات جوجل لقراءة أو كتابة القيم في الخلايا.
• استخدم مصدر البيانات الخاص بـ جوجل درايف لتحديد موقع الملفات وتنزيلها.
• اجمع بينهما فقط إذا كانت سير العمل بحاجة إلى العمل مع الخلايا والمستندات بأكملها.

كيفية توسيع التكامل باستخدام n8n

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

في هذا التصميم المعماري، بإمكان Diify إرسال البيانات إلى رابط ويب n8n عبر طلب HTTP. يستقبل n8n الطلب، يقوم بتنفيذ عقد جداول بيانات جوجل الخاصة به ويعيد النتيجة إلى سير العمل.

يمكنك أيضًا عكس العملية. على سبيل المثال، يستطيع n8n اكتشاف صف جديد، ومعالجة قيمه، واستدعاء واجهة برمجة التطبيقات (API) لتطبيق منشور على Dify. بعد ذلك، يمكن كتابة النتيجة المُولّدة بواسطة الذكاء الاصطناعي في عمود آخر في نفس ورقة العمل.

يتيح لك هذا النظام إنشاء عمليات أتمتة مثل:

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

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

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

ومن هناك، تتيح لك وظيفة Batch Get الاستعلام عن النطاقات، بينما تقوم وظيفة Batch Update بكتابة النتائج.إذا كان المشروع يحتاج إلى العمل مع مستندات كاملة، أو التفاعل مع الأحداث، أو تنسيق تطبيقات متعددة، فيمكنك استكمال هذا الإعداد باستخدام Google Drive أو n8n دون الخلط بين وظائف كل أداة.

مقال ذو صلة:

كيفية إنشاء مساعد ذكاء اصطناعي دون كتابة سطر واحد من التعليمات البرمجية باستخدام Dify

ألبرتو نافارو

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

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