ميزة citations في Claude API تربط أجزاء من الإجابة بمواضع داخل مستندات تزودها للتطبيق، بدل الاكتفاء بطلب كتابة مراجع نصية. هذا دليل للتحضير لعام 2027 وفق الوثائق المتاحة في 27 أكتوبر 2026، ويتناول واجهة المورد العامة، لا تحققًا مستقلًا من صحة كل عبارة مولدة.
اختيار نوع المستند والتفعيل
تدعم الميزة مستندات النص العادي وPDF والمحتوى المخصص. يفعل الاستشهاد بوضع citations.enabled بقيمة true على المستندات، ويجب أن يكون التفعيل موحدًا: على جميع المستندات في الطلب أو دون تفعيله عليها جميعًا.
يقطع النص العادي ونص PDF إلى جمل يمكن الاستشهاد بها، بينما تستخدم كتل المحتوى المخصص كما قدمت دون تقسيم إضافي. اختر النوع بحسب حاجتك إلى حدود مرجعية عامة أو كتل تحكمت في تقسيمها مسبقًا.
ما يمكن الاستشهاد به؟
المحتوى داخل source هو المادة القابلة للاستشهاد. أما title وcontext فبيانات تساعد على وصف المستند وتقديم سياقه، لكنها ليست بحد ذاتها مادة للاستشهاد.
والدعم هنا للاستشهاد بالنصوص، لا الصور. استخراج نص PDF لا يجعل الرسم أو الصورة داخله قابلًا للإحالة بهذه الميزة؛ لذلك لا تتعامل مع غياب الاستشهاد بصورة على أنه إثبات لعدم وجود معلومة مرئية في الصفحة.
قراءة الفهارس دون خطأ موضع واحد
يبدأ document_index من الصفر بحسب ترتيب كتل المستندات في الطلب عبر رسائله. وفي النص العادي تبدأ فهارس المحارف من الصفر، بينما يبدأ ترقيم صفحات PDF من الواحد. وتبدأ فهارس كتل المحتوى المخصص من الصفر.
نهاية النطاق مستبعدة في هذه الأنواع. فإذا استخدمت start_page_number وend_page_number لإظهار الصفحات، لا تضف صفحة النهاية إلى المقتطف كما لو كانت مشمولة. اربط الإحالة بالمستند الصحيح قبل إظهارها للمستخدم.
المخرجات المنظمة والتخزين المؤقت
لا تجمع citations المفعلة مع المخرجات المنظمة عبر output_config.format؛ يعيد الطلب خطأ 400 في هذه الحالة. يتطلب عرض الاستشهادات تداخل إحالات مع نص الإجابة، وهو مختلف عن فرض بنية JSON صارمة بتلك الميزة.
ويمكن استخدام الاستشهادات مع التخزين المؤقت لمصدر المستند. لكن كتل الاستشهاد الناتجة لا تخزن مؤقتًا مباشرة بالطريقة نفسها. وجود مؤشر إلى موضع صحيح يساعد في المراجعة، ولا يغني عن قراءة المقطع وفحص ما إذا كان يدعم الادعاء فعلًا، ولا يثبت حداثة المستند الذي قدمته.
