أخبار الذكاء الاصطناعي · 9 دقيقة للقراءة

سلاسل رسائل Claude API: ما الذي يتغير في جلسات الوكلاء الطويلة؟

تحتفظ Messages API من Anthropic بالمحادثة مؤقتًا على الخادم. تعرّف إلى أثر Message Threads في زمن الاستجابة وفاتورة الرموز وقواعد النسخة التجريبية.

رسم يوضح إضافة رسائل قصيرة إلى خط زمني مضيء لمحادثة محفوظة على الخادم بدلًا من إعادة إرسال السجل كاملًا.

تتيح سلاسل رسائل Claude API، أو Message Threads، لواجهة Messages API الاحتفاظ بمحادثة قصيرة العمر على الخادم، بحيث لا ترسل كل جولة لاحقة سوى الرسائل الجديدة بدلًا من إعادة إرسال السجل كاملًا. وقد أُعلن عن الميزة في نسخة تجريبية عامة في أوائل نوفمبر 2026، وهي تقلل حجم الطلب والوقت اللازم لظهور الرمز الأول في عمليات تشغيل الوكلاء الطويلة، لكن استخدام الرموز المحتسب في الفاتورة يظل كما هو تمامًا.

إذا أنشأت مساعدًا للبرمجة أو حلقة أدوات متعددة الخطوات، فأنت تعرف معاناة الجولة 40. ففي كل مرة ينفذ فيها النموذج أمرًا أو يفحص لقطة شاشة، يجمع برنامج العميل جميع المطالبات والردود ونتائج الأدوات السابقة ويرسل الحزمة كاملة عبر الشبكة من جديد. تمثل Message Threads حل Anthropic لاختناق النقل والتحقق هذا، مع بعض القواعد الصارمة المتعلقة بانتهاء الصلاحية بعد خمس دقائق، والتخزين المؤقت للمطالبات (prompt caching)، والاحتفاظ بالبيانات، والتي يجب مراعاتها عند التصميم قبل تفعيل الميزة.

ما سلاسل رسائل Claude API؟

سلاسل الرسائل هي ذاكرة تخزين مؤقت للمحادثة على الخادم مخصصة لواجهة Claude Messages API، وتُفعّل في النسخة التجريبية باستخدام الترويسة message-threads-2026-08-12. وبدلًا من التعامل مع كل استدعاء للواجهة على أنه صفحة فارغة تتطلب سجل الدردشة كاملًا، يحتفظ الخادم بالمحادثة في الذاكرة بين الجولات، بحيث لا يرسل برنامج العميل إلا ما تغير منذ آخر رد.

وفقًا لملاحظات إصدار Anthropic ووثائقها بتاريخ 2 نوفمبر 2026، تختلف هذه الميزة عن سلاسل الجلسات في Claude Managed Agents. وهي تعمل مباشرة على /v1/messages مع كل نموذج في النسخة التجريبية، وتتوافر عبر Claude API المباشرة وClaude Platform on AWS وClaude Models on Google Cloud، بإدارة Anthropic، وClaude in Microsoft Foundry.

بين الجولات، تحتفظ Anthropic بالسلسلة في ذاكرة الخادم مشفرة بمفتاح يديره الخادم، ولا تكتبها مطلقًا على وحدة تخزين دائمة على القرص.

ما الذي توفره Message Threads وما الذي لا توفره؟

تقلل Message Threads حجم البيانات المرفوعة عبر الشبكة والوقت حتى الرمز الأول (TTFT) في المحادثات الطويلة، لكنها لا تخفض عدد الرموز المحسوبة في الفاتورة ولا تغير حدود معدل الاستخدام.

عندما تنمو جلسة الوكيل إلى مئات الآلاف من الرموز، وهو أمر شائع عندما تقرأ حلقة برمجية ملفات كبيرة أو يتبادل وكيل يستخدم الحاسوب لقطات الشاشة، فإن إعادة إرسال هذه البيانات والتحقق منها في كل جولة تضيف تأخيرًا ملحوظًا قبل أن يبدأ النموذج التوليد أصلًا. وتقول Anthropic إن سلاسل الرسائل مفعلة افتراضيًا لمعظم مستخدمي Claude Code، وإن الطلبات التي تحمل من 500k إلى 1M رمز تشهد انخفاضًا في وسيط TTFT بنحو 35%.

أما الفاتورة فلا تتغير. فحتى لو لم يتضمن طلب HTTP سوى أحدث رسالة من المستخدم أو مخرجات أداة، يظل Claude يقرأ المحادثة كاملة في كل جولة. وتطبق أسعار الرموز القياسية: اعتبارًا من نوفمبر 2026، يبلغ السعر المعلن لـ Claude Opus 5.5 مبلغ $4 لكل مليون رمز إدخال و$0.20 عند التخزين المؤقت، و$20 لكل مليون رمز إخراج، بينما تبلغ أسعار Sonnet 5.5 مبلغ $2 للإدخال و$0.10 عند التخزين المؤقت و$10 للإخراج. راجع مقارنة أسعار واجهات الذكاء الاصطناعي ودليل Claude Opus 5.5 مقابل Sonnet 5.5 لمعرفة كيفية مقارنة هذه الفئات.

ما يتغير مع Message Threads ما يبقى كما هو
حمولات طلبات HTTP أصغر في الجولات اللاحقة قراءة رموز المحادثة كاملة واحتسابها في كل جولة
وقت أقل حتى الرمز الأول (انخفاض وسيط TTFT بنحو ~35% في طلبات 500k–1M رمز في Claude Code، وفقًا لـ Anthropic) أسعار رموز الواجهة القياسية وحدود معدل الاستخدام القائمة
إرسال system وtools مرة واحدة عند إنشاء السلسلة يظل تطبيقك المصدر المعتمد لسجل الرسائل

كيف تنشئ سلسلة وتواصلها؟

تبدأ سلسلة بإرسال طلب /v1/messages عادي يتضمن "thread": {"type": "create"} وترويسة النسخة التجريبية message-threads-2026-08-12، ثم تواصلها في الجولة التالية بتمرير id الخاص بالرد على أنه previous_message_id. وإذا كنت تستخدم حزم تطوير Anthropic، فإن الدالة المساعدة client.beta.messages.thread(...) تدير عملية الإنشاء والمتابعة وتضيف ترويسة النسخة التجريبية تلقائيًا.

في استدعاء create الأول، أدرج المحادثة كاملة حتى تلك اللحظة مع system وtools:

{
  "model": "claude-sonnet-5-5",
  "max_tokens": 2048,
  "system": "You are a careful repository refactoring assistant.",
  "tools": [
    {
      "name": "run_tests",
      "description": "Run the project test suite",
      "input_schema": { "type": "object", "properties": {} }
    }
  ],
  "thread": {
    "type": "create"
  },
  "messages": [
    { "role": "user", "content": "Check why the auth test is failing." }
  ]
}

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

{
  "model": "claude-sonnet-5-5",
  "max_tokens": 2048,
  "thread": {
    "type": "continue",
    "previous_message_id": "msg_01XYZ..."
  },
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "tool_result",
          "tool_use_id": "toolu_01ABC...",
          "content": "FAIL src/auth.test.ts: expected 200, got 401"
        }
      ]
    }
  ]
}

قواعد قد توقعك في الخطأ إذا تجاوزت الوثائق

تفرض Anthropic اتساقًا صارمًا طوال عمر السلسلة:

  • حقول الإنشاء فقط: يجب حذف system وtools من كل طلب continue. تؤدي إعادة إرسالهما إلى خطأ 400.
  • الحقول الثابتة: يجب أن تتطابق قيم model وtool_choice وthinking وmcp_servers، باستثناء رمز مصادقة كل خادم، وcontext_management وoutput_config ومهارات الحاوية وcache_control في المستوى الأعلى والمجموعة الدقيقة لقيم ترويسة anthropic-beta مع استدعاء create الأول. يؤدي تغيير أي منها إلى خطأ 400 من نوع thread_fingerprint_mismatch.
  • حقول كل جولة: يظل بإمكانك تغيير max_tokens وstop_sequences وstream وmetadata وservice_tier من جولة إلى أخرى.
  • سجل للإضافة فقط: لا يمكن متابعة كل id للرد إلا مرة واحدة، ويجب دائمًا المتابعة من أحدث id للرد. إذا احتجت إلى تعديل رسالة سابقة أو تفريع المحادثة، فعليك بدء سلسلة جديدة باستخدام create.

ما مدة بقاء سلسلة الرسائل؟

تنتهي صلاحية سلسلة الرسائل بعد 5 دقائق من آخر طلب، وتُحذف نهائيًا من ذاكرة الخادم في مدة لا تتجاوز 1 ساعة بعد آخر استخدام. وتعيد كل استجابة حُفظت بنجاح ضبط مؤقت 5 دقائق.

ولأن السلاسل محفوظة في ذاكرة متطايرة كذاكرة مؤقتة بأفضل جهد، لا تخبرك استجابة الواجهة مسبقًا بما إذا كانت جولة معينة قد حُفظت بنجاح. ولن تعرف ذلك إلا عند استدعاء continue التالي. إذا انقضت نافذة 5 دقائق، أو أزال الخادم السلسلة مبكرًا، تعيد الواجهة خطأ 404.

عندما يتلقى برنامج العميل خطأ 404، تكون طريقة الاستعادة بسيطة: أعد إرسال سجل المحادثة كاملًا مع system وtools في طلب "thread": {"type": "create"} جديد. يجب أن يظل تطبيقك المصدر المعتمد وأن يحتفظ بنسخته الكاملة من كل رسالة ونتيجة أداة.

كيف تعمل سلاسل الرسائل مع prompt caching؟

تعالج Message Threads وprompt caching جانبين مختلفين من مشكلة السياق الطويل، ولا يُفعّل prompt caching تلقائيًا عند تفعيل السلاسل. تقلل Message Threads عدد البايتات التي ترفعها وتتحقق منها عبر الشبكة؛ أما prompt caching فيخفض ما تدفعه مقابل رموز الإدخال المتكررة، مثل خفض سعر رموز إدخال Sonnet 5.5 من $2 إلى $0.10 لكل مليون، كما هو موضح في مقارنة أسعار واجهات الذكاء الاصطناعي.

إذا أردت TTFT أسرع وتكلفة أقل لرموز الإدخال معًا، فعليك تفعيل كليهما. لتخزين كل جولة داخل سلسلة مؤقتًا، أدرج cache_control في المستوى الأعلى لطلب create الأول، واستمر في إرسال cache_control نفسه في المستوى الأعلى لكل طلب continue. وتذكر أن cache_control في المستوى الأعلى أحد الحقول الثابتة التي يجب أن تتطابق في السلسلة. تسمح Anthropic بحد أقصى 4 نقاط توقف cache_control عند تعيين thread.

من ينبغي له تفعيل Message Threads؟

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

الحالات الأنسب لاستخدام Message Threads:

  • وكلاء البرمجة: حلقات تقرأ الملفات وتشغّل المترجمات وتكرر العمل عبر عشرات الجولات السريعة ضمن نافذة النشاط البالغة 5 دقائق. وقد فعّلت Anthropic الميزة افتراضيًا بالفعل لمعظم مستخدمي Claude Code.
  • وكلاء استخدام الحاسوب: مهام تُرفق فيها لقطة شاشة جديدة لسطح المكتب أو المتصفح في كل جولة؛ ويحول الاحتفاظ باللقطات السابقة على الخادم دون إعادة رفع ميغابايتات من بيانات الصور بترميز base64 في كل خطوة.
  • الدردشات الغنية بالمستندات والصور: جلسات تفاعلية يرفع فيها المستخدم ملفات PDF كبيرة أو مجموعات صور ويطرح أسئلة متابعة سريعة. وحتى إذا كان وكيلك ينسق مسارات وسائط خارجية، مثل كتابة النصوص وبدء عمليات التصيير في أداة مثل AI Studio، فإن حفظ سياق التخطيط الكبير والصور المرجعية في سلسلة على الخادم يحافظ على سرعة حلقة التنسيق.

الحالات المحظورة أو غير المدعومة اعتبارًا من نوفمبر 2026:

  • مؤسسات Zero Data Retention (ZDR) وHIPAA: سلاسل الرسائل غير مؤهلة لـ ZDR، ولا تستطيع المؤسسات التي فعّلت جاهزية HIPAA استخدامها.
  • ميزات الواجهة غير المدعومة: لا يمكنك استخدام thread مع Message Batches، أو طلبات حساب الرموز التي تتضمن thread، أو ضغط السياق عند الطلب، أو معظم استراتيجيات تحرير السياق، باستثناء clear_thinking_20251015 مع keep: "all"، أو في المؤسسات التي فعّلت Inference hooks.

ما الذي سأفعله عمليًا؟

إذا كنت تدير بيئة تشغيل وكلاء مبنية على Claude Messages API، فسأفعّل Message Threads في كل موضع تتجاوز فيه المهمة الواحدة 100k رمز بانتظام وتفصل بين جولاتها أقل من خمس دقائق، بشرط أن تسمح متطلبات الامتثال بذلك. وهذه قائمة خطوات النشر التي سأتبعها:

  1. أبقِ مخزن المحادثات المحلي كما هو. تعامل مع السلاسل الموجودة على الخادم بوصفها وسيلة لتسريع النقل فقط، وليس قاعدة بياناتك أبدًا. أضف محليًا كل جولة للمستخدم وكل رد للمساعد وكل نتيجة أداة كما تفعل اليوم.
  2. أحط continue بآلية احتياطية تلقائية لخطأ 404. عندما يعيد استدعاء continue خطأ 404، سواء بسبب توقف لمدة 5 دقائق أو إزالة من ذاكرة التخزين المؤقت بأفضل جهد، تعامل معه وأعد فورًا إرسال السجل المحلي كاملًا مع "thread": {"type": "create"} وsystem وtools.
  3. استخدمها مع cache_control في المستوى الأعلى. لا تفعّل Message Threads متوقعًا انخفاض فاتورتك. ضع cache_control في المستوى الأعلى في استدعاءات create وcontinue معًا لتحصل على خصم 90%+ على الإدخال المخزن مؤقتًا إلى جانب تسريع TTFT. راجع مقارنة أسعار واجهات الذكاء الاصطناعي لتقدير تكلفة الإدخال غير المخزن مؤقتًا مقارنة بالمخزن مؤقتًا عند 500k رمز.
  4. ثبّت إعدادات السلسلة وقت إنشائها. راجع حلقة الوكيل للتأكد من أنها لا تغير tools أو system أو thinking أو ترويسات anthropic-beta ديناميكيًا أثناء المهمة، وإلا فستواجه أخطاء 400 من نوع thread_fingerprint_mismatch.
  5. تحقق أولًا من إعدادات ZDR وHIPAA. إذا كانت مساحة عملك تعتمد على Zero Data Retention أو جاهزية HIPAA، فاترك Message Threads معطلة، فالنسخة التجريبية غير مؤهلة لأي منهما.

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

هل تقلل Message Threads تكلفة رموز Claude API الخاصة بي؟

لا. رغم أن كل طلب HTTP لاحق يحمل الرسائل الجديدة فقط، يظل Claude يقرأ سجل المحادثة كاملًا في كل جولة. تُحتسب جميع رموز الإدخال والإخراج بأسعار Claude القياسية، وتظل حدود معدل الاستخدام القائمة سارية. لتخفيض فاتورة رموز الإدخال عند تكرار السياق، اجمع بين Message Threads وprompt caching.

هل ما زلت بحاجة إلى prompt caching إذا استخدمت سلاسل الرسائل؟

نعم. تحتفظ Message Threads بالمحادثة في ذاكرة الخادم فقط حتى لا تضطر إلى إعادة رفع الرسائل السابقة والتحقق منها عبر الشبكة. وهي لا تفعّل prompt caching تلقائيًا. للحصول على سعر الإدخال المخزن مؤقتًا في كل جولة، أرسل cache_control في المستوى الأعلى في طلب create الأول وكل طلب continue لاحق، بحد أقصى 4 نقاط توقف إجمالًا.

ماذا يحدث بعد 5 دقائق من عدم النشاط؟

تنتهي صلاحية سلسلة الرسائل بعد 5 دقائق من آخر طلب، وتُحذف من الذاكرة في مدة لا تتجاوز 1 ساعة بعد آخر استخدام. إذا أرسلت طلب continue بعد انتهاء السلسلة، تعيد الواجهة رمز الحالة 404. ينبغي لبرنامج العميل التعامل مع 404 وإعادة إرسال المحادثة كاملة مع "thread": {"type": "create"} لبدء سلسلة جديدة.

هل تتوافر Message Threads على AWS وAzure وGoogle Cloud؟

نعم. وفقًا لملاحظات إصدار Anthropic بتاريخ 2 نوفمبر 2026، تتوافر النسخة التجريبية العامة (message-threads-2026-08-12) عبر Claude API المباشرة وClaude Platform on AWS وClaude Models on Google Cloud، بإدارة Anthropic، وClaude in Microsoft Foundry.

هل يستخدم Claude Code سلاسل الرسائل بالفعل؟

نعم. تذكر Anthropic أن سلاسل الرسائل مفعلة افتراضيًا لمعظم مستخدمي Claude Code، حيث تشهد الطلبات التي تتراوح بين 500k و1M رمز انخفاضًا في وسيط الوقت حتى الرمز الأول بنحو 35%.

آخر تحقق من تفاصيل الميزة: 3 نوفمبر 2026. المراجعة التالية: 3 ديسمبر 2026.

المصادر

بقلم

Chunyu Cai

Chunyu Cai هو الرئيس التنفيذي لشركة Lotook, LLC ورائد أعمال يكتب عن نماذج الذكاء الاصطناعي ووكلائه وكيف تغير العمل اليومي. يحمل Chunyu Cai درجة الماجستير من Imperial College London.