الانتقال إلى المحتوى الرئيسي

SerperDevTool

الوصف

هذه الأداة مصممة لإجراء بحث دلالي عن استعلام محدد من محتوى نصي عبر الإنترنت. تستخدم serper.dev API لجلب وعرض نتائج البحث الأكثر صلة بناءً على الاستعلام المقدم من المستخدم.

التثبيت

لاستخدام SerperDevTool بفعالية، اتبع هذه الخطوات:
  1. تثبيت الحزمة: تأكد من تثبيت حزمة crewai[tools] في بيئة Python الخاصة بك.
  2. الحصول على مفتاح API: احصل على مفتاح serper.dev API على https://serper.dev/ (طبقة مجانية متاحة).
  3. تكوين البيئة: خزّن مفتاح API الذي حصلت عليه في متغير بيئة باسم SERPER_API_KEY لتسهيل استخدامه بواسطة الأداة.
لدمج هذه الأداة في مشروعك، اتبع تعليمات التثبيت أدناه:

مثال

يوضح المثال التالي كيفية تهيئة الأداة وتنفيذ بحث باستعلام معين:
Code

المعاملات

تأتي أداة SerperDevTool مع عدة معاملات تُمرّر إلى API:
  • search_url: نقطة نهاية URL لـ search API. (الافتراضي هو https://google.serper.dev/search)
  • country: اختياري. تحديد البلد لنتائج البحث.
  • location: اختياري. تحديد الموقع لنتائج البحث.
  • locale: اختياري. تحديد اللغة المحلية لنتائج البحث.
  • n_results: عدد نتائج البحث المُرجعة. الافتراضي هو 10.
يمكن العثور على قيم country و location و locale و search_url في Serper Playground.

مثال مع المعاملات

إليك مثالاً يوضح كيفية استخدام الأداة مع معاملات إضافية:
Code
Code

الخلاصة

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