البحث على الويب في Claude API يتيح جلب معلومات حديثة مع مراجع، لكنه يحتاج إلى ضبط الاستخدام والنتائج والأخطاء. هذا شرح للتحضير لعام 2027 وفق الواجهة الموثقة في 27 أكتوبر 2026، لا وصف لإعدادات تطبيق معين.
اختيار النسخة وطريقة الاستدعاء
النسخة web_search_20250305 للبحث الأساسي، وتضيف web_search_20260209 التصفية الديناميكية، بينما تضيف web_search_20260318 التحكم في تضمين النتائج بالاستجابة. التصفية الديناميكية تمرر للموديل محتوى منتقى بدل تحميل كل النتائج، وتعتمد على دعم النموذج لها.
يمكن التحقق من دعم البحث عبر قدرات النموذج في Models API، بدل افتراض أن كل نموذج يقبل كل نسخة. ولا يعني دعم البحث الأساسي بالضرورة دعم التصفية الديناميكية في كل بيئة تشغيل.
عدد الاستخدامات والنطاقات
يحد max_uses عدد عمليات البحث في الطلب. ويحسب كل بحث استخدامًا واحدًا مهما بلغ عدد نتائجه؛ وعند تجاوز الحد يظهر max_uses_exceeded. هذا حد لعمليات البحث، وليس لعدد الروابط أو رموز النص.
استخدم allowed_domains للسماح بنطاقات محددة أو blocked_domains لمنعها، ولا تجمعهما في الطلب نفسه؛ فالجمع يعيد خطأ 400. وتكتب المدخلات كنطاقات دون بادئة بروتوكول، مع إمكان تضمين مسار.
ويمكن تخصيص النتائج عبر user_location التقريبي باستخدام مدينة أو منطقة أو دولة أو منطقة زمنية. حدّد بيانات الموقع المقصودة للتطبيق بدل استنتاج دقة مكانية لا يوفرها الإعداد.
النتائج والمراجع
تتضمن النتائج رابط المصدر وعنوانه ومعلومات المحتوى المشفر. وفي المحادثات متعددة الأدوار يجب تمرير كتل الاستجابة كما استلمت، بما فيها encrypted_content؛ حذفه أو تغييره يسبب خطأ تحقق 400.
الاستشهادات مفعلة للبحث، وتتضمن مرجعًا مشفرًا ومقتطفًا يصل إلى 150 حرفًا. احتفظ بمراجع المصادر عند عرض المخرجات المباشرة، ولا تعامل وجود عنوان ورابط كضمان كفاية المصدر لكل استنتاج.
نجاح HTTP لا يكفي
قد يعيد الطلب حالة HTTP 200 رغم فشل البحث، ويظهر الخطأ داخل جسم النتيجة، مثل تجاوز الحد أو عدم توافر الخدمة. النتيجة الخالية الناجحة قائمة فارغة، وليست الخطأ نفسه.
التكلفة المعلنة 10 دولارات لكل ألف بحث، إضافة إلى تكلفة الرموز المعتادة للمحتوى الناتج. ولا تحاسب عملية البحث التي حدث فيها خطأ. راقب الاستخدام الفعلي والأخطاء، لا عدد الاستجابات الناجحة ظاهريًا وحده.
