خاصية message threads في Claude API: إرسال الرسائل الجديدة فقط

أطلقت Anthropic خاصية message threads في Claude API بنسخة تجريبية (beta): تبقى المحادثة على الخادم لفترة قصيرة، وكل طلب لاحق يرسل الرسائل الجديدة فقط. ظهرت الميزة في Claude Release Notes يوم 2 نوفمبر، وتعمل مع ترويسة beta التالية: message-threads-2026-08-12.

كيف تعمل message threads في Claude API؟

حتى الآن، كانت كل جولة في محادثة مع Messages API تعني إرسال السجل الكامل من جديد: موجّه النظام والأدوات وجميع الرسائل. وبحسب توثيق message threads، كان على الـ API أن يتحقق من كل ذلك ويقسّمه إلى رموز (tokens) في كل مرة. أما مع الخيط (thread)، فمعظم هذا العمل يقتصر على الجولة الجديدة.

الآلية كلها معامل واحد جديد هو thread:

1. نرسل الطلب الأول كالمعتاد، مع المحادثة الكاملة وsystem وtools، ونضيف "thread": {"type": "create"}. يحفظ الـ API المحادثة مع رد Claude تحت id ذلك الرد.
2. الطلبات اللاحقة تحتوي على "thread": {"type": "continue", "previous_message_id": "<id>"} والرسائل الجديدة فقط، مثل رسالة المستخدم التالية أو نتائج الأدوات (tool_result).
3. نحذف system وtools لأن الخيط يتذكرهما. وإرسالهما في طلب continue يعيد خطأ 400.

بحسب Anthropic، النتيجة طلبات أصغر وزمن أقصر وأكثر ثباتًا حتى أول رمز، حتى عندما تطول المحادثة. وأكثر المستفيدين حلقات الوكلاء الطويلة، حيث ينفّذ الوكيل عشرات استدعاءات الأدوات وكان عليه في كل مرة إرسال سجل يتضخم باستمرار (للمزيد عن طريقة عمل هذه الحلقات، راجع مقال ما هو وكيل الذكاء الاصطناعي).

ماذا يفعل الـ SDK نيابة عنا؟

حصل الـ SDK على أداة مساعدة جديدة: client.beta.messages.thread(...). ننشئها بالحقول نفسها التي يحتويها الطلب العادي، ثم نرسل الجولات التالية عبر thread.send(...). تضيف الأداة ترويسة beta بنفسها، وتنشئ الخيط في الجولة الأولى وتتابعه في الجولات التالية.

اللافت أن أداة tool runner التجريبية في الـ SDK تستخدم الخيوط افتراضيًا، لذا قد تصبح الوكلاء المبنية عليها أسرع دون أي تغيير في الكود (يمكن إيقاف ذلك عند إنشاء الـ runner).

تتعامل الأداة المساعدة أيضًا مع حالات الفشل: عندما تنتهي صلاحية الخيط، تعيد إرسال المحادثة كاملة في طلب create جديد. لكنها تحتفظ بهذه النسخة الكاملة في الذاكرة فقط، ما دام كائن الأداة موجودًا.

ما الذي يجب الانتباه إليه؟

أولًا، العمر القصير. تنتهي صلاحية الخيط بعد 5 دقائق من آخر طلب، ويحذفه الـ API خلال ساعة على الأكثر من آخر استخدام. يصف التوثيق الخيوط بأنها „best-effort”: يجب أن يبقى تطبيقنا مصدر الحقيقة للمحادثة، وأن يتعامل منذ البداية مع إعادة إرسال كل شيء بعد خطأ 404 thread_not_found.

ثانيًا، ما لا يجوز تغييره. يجب أن تبقى حقول مثل model وthinking وtool_choice وcontext_management بالقيم نفسها طوال الخيط، وإلا يعيد الـ API الخطأ thread_fingerprint_mismatch. يمكن للخيط أن يطول فقط، ويمكن متابعة كل id رد مرة واحدة. ولتعديل رسالة سابقة أو تغيير موجّه النظام، نبدأ خيطًا جديدًا.

ثالثًا، التخزين المؤقت للموجّهات (prompt caching). الخيط لا يخزّن شيئًا مؤقتًا بنفسه. يعمل التخزين المؤقت كما كان، ويتسع الطلب الذي يحتوي على thread لأربع نقاط cache_control كحد أقصى. أبسط حل هو إرسال cache_control نفسه في المستوى الأعلى من الطلب في كل جولة.

رابعًا، الميزات التي لا تعمل معها الخيوط:

1. Message Batches وToken Counting.
2. Compaction، بما في ذلك الضغط عند الطلب، و context editing (مع استثناء واحد موضح في التوثيق).
3. المؤسسات التي فعّلت HIPAA readiness أو Inference hooks.

خامسًا، البيانات. الخيوط غير مؤهلة لـ ZDR (عدم الاحتفاظ بالبيانات). وبحسب التوثيق، تُحفظ المحادثة وموجّه النظام والأدوات في الذاكرة، مشفّرة بمفتاح يديره الخادم، ولا تُكتب أبدًا على قرص دائم.

أين تعمل ومع أي نماذج؟

تتوفر message threads بنسخة تجريبية على Claude API و Claude Platform on AWS و Claude Models on Google Cloud (التي تديرها Anthropic) و Microsoft Foundry. وتشمل النماذج المدعومة، من بين أخرى، Claude Fable 5.1 و Mythos 5.1 و Opus 5.5 و Sonnet 5.5 و Haiku 5.5، ومن النماذج الأقدم أيضًا Opus 4.5 و Sonnet 4.5 و Haiku 4.5.

الخيوط لا تغيّر الأسعار ولا حدود الطلبات. ندفع ثمن الرموز كما في السابق، فالتوفير يخص الوقت وحجم الطلبات، ويبقى من المفيد متابعة التكاليف، مثلًا عبر واجهة API الجديدة لتحليل تكاليف Claude. وهذا تغيير آخر في الـ API نفسه خلال الأيام الأخيرة، بعد رفع حد حجم الطلب إلى 128 ميغابايت.

(لا تخلطها مع „session threads” في Claude Managed Agents. فهي ميزة منفصلة، كما يذكّر التوثيق.)

الأسئلة الشائعة

ما هي message threads في Claude API؟

ميزة تجريبية يحفظ فيها الـ API المحادثة على الخادم لفترة قصيرة. بعد الطلب الأول، نرسل الرسائل الجديدة فقط وid الرد السابق.

هل تخفّض message threads تكاليف Claude API؟

ليس بشكل مباشر. بحسب التوثيق، لا تغيّر الخيوط الأسعار ولا حدود الطلبات. المكسب طلبات أصغر وزمن أقصر حتى أول رمز.

كم من الوقت يحتفظ Claude API بالخيط؟

تنتهي صلاحية الخيط بعد 5 دقائق من آخر طلب، ويحذفه الـ API خلال ساعة على الأكثر من آخر استخدام. بعد ذلك يجب إرسال المحادثة كاملة من جديد.

هل تعمل message threads على Amazon Bedrock؟

يذكر التوثيق Claude API و Claude Platform on AWS و Claude Models on Google Cloud (التي تديرها Anthropic) و Microsoft Foundry. أما Amazon Bedrock فليس في القائمة.