كيفية بناء أداة بحث عميقة مفتوحة المصدر باستخدام واجهة برمجة تطبيقات جمنائي

هل سبق لك أن تمنيت أن تتمكن من الاستفادة من قوة الذكاء الاصطناعي للقيام بأبحاث متعمقة حقًا، لكن شعرت بأنك مقيد بحلول المصادر المغلقة ومخاوف الخصوصية؟ حسنًا، استعد لرفع سواعدك لأنه في هذه المقالة، سنقوم ببناء أداتنا الخاصة لـ أبحاث عميقة مفتوحة المصدر مدعومة بـ Gemini API!

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

نحن متحمسون لمشاركة أن دعم MCP قادم قريباً إلى Apidog! 🚀

خادم Apidog MCP يتيح لك إطعام وثائق API مباشرة إلى الذكاء الاصطناعي Agentic، مما يعزز تجربتك في الترميز! سواء كنت تستخدم Cursor أو Cline أو Windsurf - ستجعل عملية التطوير الخاصة بك أسرع وأكثر سلاسة.… pic.twitter.com/ew8U38mU0K

— Apidog (@ApidogHQ) 19 مارس 2025

ما هي الأبحاث العميقة مفتوحة المصدر؟

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

لماذا استخدام Gemini API للأبحاث العميقة؟

يقدم Gemini API نهجًا متقدمًا للذكاء الاصطناعي، مما يمكّن من تفاعلات إنسان-آلة أكثر تلقائية وفاعلية. يتميز من خلال تقديم رؤى ليس فقط على أساس النص ولكن أيضًا من خلال دعم المدخلات متعددة الأشكال، مما يسمح بفهم أعمق لمواد البحث من خلال الصور ومقاطع الفيديو والصوت. وهذا يجعله ذا قيمة خاصة لمشاريع البحث الشاملة التي تتطلب تحليل أنواع بيانات متنوعة. علاوة على ذلك، فإن تصميم واجهة برمجة التطبيقات المرن والدعم القوي للمطورين يشجع الابتكار والتخصيص، مما يمكّن الباحثين من تكييف الأداة لتلبية احتياجاتهم وظروفهم المحددة، مما يعزز في النهاية فهمًا أعمق وأكثر تفصيلاً للموضوعات المعقدة.

الميزات الرئيسية لأداة الأبحاث العميقة مفتوحة المصدر لدينا

قبل أن نغوص في عملية البناء، دعنا نلقي نظرة على بعض الميزات التي سنقوم بإحيائها:

• أبحاث عميقة سريعة للحصول على رؤى سريعة.
• دعم متعدد المنصات للوصول السلس.
• مدعوم من Google Gemini لقدرات الذكاء الاصطناعي المتقدمة.
• نماذج التفكير والشبكات للتحليل الذكي.
• دعم القماش للتنظيم البصري.
• سجل الأبحاث لتتبع التقدم.
• دعم API محلي وخادم للمرونة.
• تصميم يركز على الخصوصية للأبحاث الآمنة.
• دعم الحمولة متعددة المفاتيح لتعزيز الوظائف.
• دعم متعدد اللغات: الإنجليزية، 简体中文.
• مبني بتقنيات حديثة للفاعلية والأداء.

البدء مع أداة الأبحاث العميقة مفتوحة المصدر

هل أنت مستعد لبناء مساعد بحث مدعوم بالذكاء الاصطناعي خاص بك؟ إليك ما ستحتاجه للبدء:

1. احصل على مفتاح API الخاص بـ Gemini: أولاً وقبل كل شيء، ستحتاج إلى مفتاح API لـ Gemini للوصول إلى قوة نماذج الذكاء الاصطناعي من Google. انتقل إلى استوديو Google AI وقم بالتسجيل للحصول على مفتاح API. احتفظ بهذا المفتاح آمنًا ومضمونًا - إنه جواز سفرك إلى عالم Gemini!

2. النشر بنقرة واحدة (اختياري): للبدء بأسرع ما يمكن، يمكنك استخدام خيارات النشر بنقرة واحدة:

• نشر مع Vercel (عادة ما تكون التعليمات الخاصة بـ Vercel مباشرة وتتطلب ربط مستودع GitHub الخاص بك وحساب Vercel).

• نشر مع Cloudflare (يمكنك حاليًا نشر المشروع إلى Cloudflare، لكن يجب عليك اتباع كيفية النشر إلى صفحات Cloudflare للقيام بذلك).

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

تطوير أداة الأبحاث العميقة مفتوحة المصدر

لنغوص في قلب عملية البناء! اتبع هذه الخطوات لجعل الأبحاث العميقة تعمل على متصفحك المحلي.

المتطلبات الأساسية

قبل أن نبدأ، تأكد من أنك قد قمت بتثبيت ما يلي على نظامك:

• Node.js: (يفضل الإصدار 18.18.0 أو أحدث). يمكنك تنزيله من الموقع الرسمي لـ Node.js.

• pnpm أو npm أو yarn: هذه هي مدراء الحزم لـ Node.js. سنستخدم pnpm في هذا الدليل، ولكن يمكنك استخدام أي منها تفضله.

التثبيت

1. استنساخ المستودع:

git clone https://github.com/u14app/deep-research.git
cd deep-research

سيقوم هذا بتنزيل الكود من GitHub ونقلك إلى دليل المشروع.

2. تثبيت التبعيات:

pnpm install  # أو npm install أو yarn install

سيقوم هذا الأمر بتثبيت جميع الحزم اللازمة للمشروع.

3. إعداد متغيرات البيئة:

هذه خطوة حاسمة! ستحتاج إلى إنشاء ملف .env في الدليل الجذري لمشروعك وتكوين متغيرات البيئة التالية:

# (اختياري) مفتاح API الخاص بـ Gemini على الخادم (مطلوب لاستدعاءات API للخادم)
GOOGLE_GENERATIVE_AI_API_KEY=YOUR_GEMINI_API_KEY

# (اختياري) عنوان URL الوكيل API للخادم. الافتراضي: `https://generativelanguage.googleapis.com`
API_PROXY_BASE_URL=

# (اختياري) كلمة مرور الوصول إلى API الخادم من أجل الأمان المحسن
ACCESS_PASSWORD=

# (اختياري) يمكن استخدام كود البرنامج المدمج لتتبع الإحصائيات أو الأخطاء.
HEAD_SCRIPTS=

استبدل YOUR_GEMINI_API_KEY بمفتاح API الفعلي الذي حصلت عليه من استوديو Google AI.

ملاحظات هامة حول متغيرات البيئة:

• GOOGLE_GENERATIVE_AI_API_KEY: اختياري ولكنه مطلوب لاستخدام API الجانبي للخادم. تحتاج للحصول على مفتاح Google Generative AI API من استوديو Google AI. يجب إبقاء هذا المفتاح سريًا وألا يتم الالتزام به في مستودعك العام.
• API_PROXY_BASE_URL: اختياري. إذا كنت بحاجة إلى استخدام خادم بروكسي لطلبات API، قم بتكوين هذه المتغير مع عنوان URL الأساسي لخادم البروكسي الخاص بك. هذا مهم لاستدعاءات API الجانبية للخادم.
• ACCESS_PASSWORD: اختياري ولكن موصى به بشدة للنشر على الخادم. قم بتعيين كلمة مرور قوية لحماية نقاط نهاية API الجانبية للخادم الخاصة بك. ستطلب هذه الكلمة المرور لدخول وظائف API الجانبية للخادم.
• HEAD_SCRIPTS: اختياري يمكن استخدام كود البرنامج المدمج لتتبع الإحصائيات أو الأخطاء.

تذكير بالخصوصية: تُستخدم هذه المتغيرات بشكل أساسي لاستدعاءات API الجانبية للخادم. عند استخدام وضع API المحلي، لا حاجة لمفاتيح API أو تكوينات جانبية للخادم، مما يعزز خصوصيتك أكثر.
دعم متعدد المفاتيح: يدعم مفاتيح متعددة، كل مفتاح مفصول بـ ,, أي key1,key2,key3. لا يمكن أن يستخدم Cloudflare متعدد المفاتيح في الوقت الحالي لأن البرنامج النصي الرسمي لا يدعم Next.js 15.

4. تشغيل خادم التطوير:

pnpm dev  # أو npm run dev أو yarn dev

سيقوم هذا ببدء خادم التطوير، ويمكنك الوصول إلى الأبحاث العميقة في المتصفح الخاص بك على http://localhost:3000.

• ابدأ في طرح أي أسئلة تحتاج إلى البحث عنها.

• وعرض النتائج!

نشر أداة الأبحاث العميقة مفتوحة المصدر

بمجرد أن تكون راضيًا عن إعدادك المحلي، يمكنك نشر أداة البحث الخاصة بك إلى السحابة! إليك بعض الخيارات الشائعة:

1. Vercel: انشر مع Vercel (عادةً ما تكون هذه هي الخيار الأسهل).

2. Cloudflare: حاليًا يدعم المشروع النشر إلى Cloudflare، لكن يجب عليك اتباع كيفية النشر إلى صفحات Cloudflare للقيام بذلك.

3. Docker:

• يجب أن تكون النسخة 20 أو أعلى.
• اسحب الصورة الجاهزة:

docker pull xiangfa/deep-research:latest

• قم بتشغيل الحاوية:

docker run -d --name deep-research -p 3333:3000 xiangfa/deep-research

يمكنك أيضًا تحديد متغيرات البيئة:

docker run -d --name deep-research \
   -p 3333:3000 \
   -e GOOGLE_GENERATIVE_AI_API_KEY=AIzaSy... \
   -e ACCESS_PASSWORD=your-password \
   xiangfa/deep-research

• أو بناء صورتك الخاصة:

docker build -t deep-research .
docker run -d --name deep-research -p 3333:3000 deep-research

• نشر باستخدام docker-compose.yml:

version: '3.9'
services:
   deep-research:
      image: xiangfa/deep-research
      container_name: deep-research
      environment:
         - GOOGLE_GENERATIVE_AI_API_KEY=AIzaSy...
         - ACCESS_PASSWORD=your-password
      ports:
         - 3333:3000

ثم قم ببناء تكوين Docker الخاص بك:

docker compose -f docker-compose.yml build

4. النشر الثابت:

• يمكنك أيضًا بناء نسخة صفحة ثابتة مباشرة ثم رفع جميع الملفات في دليل out إلى أي خدمة ويب تدعم الصفحات الثابتة، مثل Github Page وCloudflare وVercel، إلخ.

pnpm build:export

تكوين أداة الأبحاث العميقة مفتوحة المصدر

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

• GOOGLE_GENERATIVE_AI_API_KEY
• API_PROXY_BASE_URL
• ACCESS_PASSWORD

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

تذكر دائمًا أن تحافظ على أمان مفاتيح API وكلمات المرور الخاصة بك!

الخاتمة: تمكين أبحاثك باستخدام الذكاء الاصطناعي

لقد قمت الآن ببناء أداتك الخاصة للأبحاث العميقة مفتوحة المصدر المدعومة بـ Gemini API! هذه خطوة كبيرة نحو فتح الإمكانات الكاملة للذكاء الاصطناعي في عملية البحث الخاصة بك.

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

مستقبل البحث ذكي ومفتوح. احتضن الأبحاث العميقة مفتوحة المصدر وتمكن من المعرفة التي تحتاجها!