SerperDevTool
الوصف
هذه الأداة مصممة لإجراء بحث دلالي عن استعلام محدد من محتوى نصي عبر الإنترنت. تستخدم serper.dev API لجلب وعرض نتائج البحث الأكثر صلة بناءً على الاستعلام المقدم من المستخدم.التثبيت
لاستخدامSerperDevTool بفعالية، اتبع هذه الخطوات:
- تثبيت الحزمة: تأكد من تثبيت حزمة
crewai[tools]في بيئة Python الخاصة بك. - الحصول على مفتاح API: احصل على مفتاح
serper.devAPI على https://serper.dev/ (طبقة مجانية متاحة). - تكوين البيئة: خزّن مفتاح 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، يكتسب المستخدمون القدرة على إجراء عمليات بحث فورية وذات صلة عبر الإنترنت مباشرة من تطبيقاتهم.
تسمح المعاملات المحدّثة بنتائج بحث أكثر تخصيصاً وتوطيناً. من خلال الالتزام بإرشادات الإعداد والاستخدام المقدمة، يصبح دمج هذه الأداة في المشاريع سلساً ومباشراً.