يوفّر Venice واجهتي API منفصلتين لاكتشاف صفحات الويب واستخراج محتواها:
- Web Search تُعيد نتائج مُنظَّمة تتضمن العناوين وعناوين URL والمقتطفات والتواريخ.
- Web Scrape تحوّل صفحة عامة محددة إلى Markdown.
استخدمهما معًا عندما يحتاج تطبيقك إلى مواد مصدرية حديثة وقابلة للفحص قبل الاستدلال.
البحث في الويب
أرسل استعلامًا إلى Search API:
Brave هو المزود الافتراضي ويوفر عدم الاحتفاظ بالبيانات. Google متاح أيضًا مع استعلامات مجهولة الهوية يتم توجيهها عبر Venice. راجع مرجع Web Search API لاختيار المزود وللاطلاع على المخطط الكامل للاستجابة.
استخراج صفحة
بعد اختيار نتيجة، أرسل عنوان URL العام الخاص بها إلى Scrape API:
تُعيد نقطة النهاية محتوى الصفحة بصيغة Markdown. تطلب أولاً تمثيل Markdown الأصلي للموقع إن كان متاحًا، وإلا فتستخدم الاستخراج المعتمد على المتصفح.
سير العمل من البحث إلى الاستخراج
البحث
أرسل استعلامًا مركّزًا واجمع النتائج المُنظَّمة.
اختيار المصادر
قم بفلترة النتائج حسب الصلة والنطاق والتاريخ قبل جلب محتوى الصفحة.
الاستخراج
استخرج Markdown فقط من الصفحات التي ينوي تطبيقك استخدامها.
استخدام المحتوى أو تخزينه
ضمّن Markdown في مطالبة، أو أنشئ تضمينات، أو خزّنه مؤقتًا، أو احتفظ بعناوين URL المصدرية للاستشهادات.
البحث المستقل أم البحث عبر النموذج؟
استخدم واجهات API المستقلة عندما يحتاج تطبيقك إلى التحكم في اختيار المصادر أو إعادة استخدام المحتوى المسترجَع. فعّل البحث في الويب في طلب النموذج عندما تريد أن يتولى Venice عملية الاسترجاع كجزء من طلب استدلال واحد.
Web Search وWeb Scrape واجهتا API تجريبيتان. قد تتغيّر أشكال طلباتهما واستجاباتهما دون إشعار مسبق. يقبل Web Scrape الصفحات المتاحة للعموم فقط، وقد يتم رفض المواقع التي تحجب الوصول الآلي.
موارد ذات صلة
