جلب الويب في Claude API يسترجع محتوى صفحة محددة أو ملف PDF، ويختلف عن البحث عن مصادر جديدة. هذا شرح للتحضير لعام 2027 وفق الواجهة الموثقة في 27 أكتوبر 2026، وليس وصفًا لإعدادات تطبيق بعينه.
نوع المحتوى وحدود الجلب
تدعم الأداة النص وHTML وPDF، ولا تدعم حاليًا المواقع التي تحتاج إلى تصيير ديناميكي بجافاسكربت. لذلك لا يعني وجود رابط أن محتواه الكامل سيصل، وقد تحتاج الصفحة التفاعلية إلى مسار تصفح مختلف.
يضبط max_uses عدد عمليات الجلب في الطلب، وتحسب المحاولات الفاشلة ضمن الحد. وإذا تجاوزت الأداة الحد ترجع max_uses_exceeded. ولا يوجد حد افتراضي حاليًا، لذا حدد ما يناسب التطبيق بدل افتراض سقف تلقائي.
حد النص ليس حدًا لحجم PDF
يحدد max_content_tokens مقدار النص المدخل إلى السياق تقريبًا، وقد يقتطع المحتوى إذا تجاوزه. لكنه لا يطبق بالطريقة نفسها على المحتوى الثنائي مثل PDF. لا تعتبر وصول نتيجة مقتطعة دليلًا على قراءة مستند كامل.
التخزين المؤقت وحداثة النتيجة
قد تعيد الأداة محتوى مخزنًا مؤقتًا لا يعكس أحدث نسخة من الصفحة. ومن نسخة web_fetch_20260309 وما بعدها يتيح use_cache=false تجاوز هذا التخزين، بينما القيمة الافتراضية true.
استعمل تاريخ الاسترجاع مع طبيعة المصدر لتقييم الحداثة. تجاوز التخزين قد يزيد زمن الطلب، ولا يجعل كل ادعاء في الصفحة موثوقًا أو كاملًا.
الاستشهادات ومصدر الرابط
الاستشهادات اختيارية ومعطلة افتراضيًا، بخلاف أداة البحث التي تفعلها دائمًا. ويمكن تمكينها للاستشهاد بمقاطع من المحتوى المسترجع.
تتحقق الأداة من ظهور الرابط سابقًا في مصادر السياق المسموح بها، مثل رسالة مستخدم أو نتيجة بحث أو جلب سابقة. ولا يكفي رابط يظهر في مخرجات النموذج وحدها. ويتيح url_sources تضييق المصادر المقبولة؛ وهذه آلية تحقق وليست ضمانًا لسلامة كل صفحة أو إذنًا بإرسال بيانات خاصة إليها.
الأخطاء والتكلفة
قد ترجع الواجهة HTTP 200 ويحتوي جسم النتيجة خطأ مثل url_not_accessible أو unsupported_content_type. افحص محتوى النتيجة بدل الاعتماد على حالة HTTP وحدها.
لا توجد رسوم جلب إضافية فوق تكلفة الرموز المعتادة للمحتوى الذي يدخل سياق المحادثة. المجانية هنا لعملية الجلب الإضافية، ولا تعني أن قراءة مستند كبير بلا تكلفة رموز.
