AI-translated from English; not yet reviewed by a fluent editor.

# أعطِ وكيلين سجل الذاكرة المراجع نفسه

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

By BIG CHANGE Editorial

Published: 2026-10-20T13:57:38.593Z
Updated: 2026-10-20T13:57:38.593Z
Canonical: https://bigchange.ai/blog/managed-agents-reviewed-memory-snapshot-guide

![Conceptual charcoal illustration of two separate laptops on a round table, each displaying the same five abstract text strokes with the third row orange.](https://bigchange.ai/api/media/file/reviewed-memory-two-sessions-hero-v3.png)
AI-generated conceptual illustration by BIG CHANGE.

يمكن لمخازن ذاكرة Managed Agents من Anthropic الاحتفاظ بالنص بين الجلسات. للتطبيق الذي يجب أن يعطي وكيلين الحقيقة المراجعة نفسها، التخزين المستمر هو الخطوة الأولى فقط. على التطبيق تحديد مالك السجل، وفحص الدليل الأصلي، واختيار مراجعة مخزنة، والحفاظ على بايتاتها الدقيقة قبل أن يراها أي وكيل. هذا الدليل للمطورين ذوي الوصول المصرح به إلى النسخة التجريبية من Managed Agents والتحكم في مصادقة تطبيقهم واختيار المخزن وإعدادات الوكلاء. يستند إلى [وثائق الذاكرة الحالية من Anthropic](https://platform.claude.com/docs/en/managed-agents/memory) ومراجع API التي فُحصت في 20 أكتوبر 2026؛ لم تجرِ BIG CHANGE اختبار حساب أو نموذج.

## التغيير الكبير

- **ما الذي تغيّر:** يمكن لذاكرة JSON مراجعة وذات أنواع محددة أن تستمر في مخزن Managed Agents. يفحص التطبيق مصدرها وبايتاتها الدقيقة المخزنة، ويثبّت لقطة خاصة واحدة، ثم يرسل البايتات المعتمدة نفسها إلى جلستين منفصلتين مصرح بهما من دون إرفاق مخزن ذاكرة.
- **لماذا يهم:** لا يمكن لتعديل لاحق في المخزن تغيير المدخلات التي بُنيت بالفعل لتلك الجلسات.
- **ما الذي ينبغي مراقبته:** ما زالت دقة المصدر وتفويض المستخدم وجودة الإجابة تحتاج إلى فحوص منفصلة.

## قبل البدء

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

يحتاج تطبيقك إلى ربط الهوية المصادق عليها بالنطاق. في حالة التطبيق الموثوقة، اربط الهوية بقيمة معتمدة للحقل `ownerScopeId` ومعرّف مساحة العمل ومعرّف المخزن ومعرّفي الوكيلين المسموح بهما. افصل مخازن المستخدمين أو المشاريع الخاصة عندما تختلف قواعد الوصول. مفتاح API لمساحة العمل لا يصادق المستخدم النهائي، والمسار ليس حدًا بين المستأجرين، والمطالبة لا تستطيع إزالة أداة أو بيانات اعتماد. تحقق من أن إعدادَي المستهلكين بلا مخزن مرفق وبلا موصل أو بيانات اعتماد بيئة أو مسار أداة يصل إلى المخزن القابل للتغيير. إذا لم تتمكن من إثبات هذا الحد، توقف قبل إرسال السجل.

## 1. اعتمد السجل بمقارنته بمصدره

استخدم هذا **القالب البنيوي** واستبدل كل قيمة بين القوسين الزاويين بدليل حقيقي معتمد. ليس حقيقة نموذجية ولا نتيجة مزعومة. حوّل الكائن المكتمل إلى نص JSON UTF-8 واحد دقيق قبل الاعتماد. يجب أن يقبل المدقق هذه الحقول والأنواع تحديدًا، ويرفض الحقول المجهولة، ويشترط سلاسل غير فارغة ولا تتألف من مسافات فقط وطوابع زمنية UTC صحيحة، ويقيّد `kind` بالقيم `fact`، `preference` أو `project_rule`، ويقيّد `status` بالقيم `active`، `disputed` أو `superseded`. لا يجوز حقن إلا السجلات ذات الحالة `active`. يجب أن يطابق الادعاء المعتمد الأصل المستشهد به، بما يشمل تاريخ النفاذ والنطاق.

```json
{
  "schemaVersion": "memory-record/v1",
  "recordId": "<opaque stable record ID>",
  "ownerScopeId": "<trusted mapped scope ID>",
  "kind": "<fact | preference | project_rule>",
  "claim": "<precise source-supported claim>",
  "sourceId": "<private original-source ID>",
  "sourceRevision": "<original revision or exact source hash>",
  "sourceQuoteOrPointer": "<minimal permitted quote or stable pointer>",
  "validFrom": "<UTC timestamp>",
  "checkedAt": "<UTC timestamp>",
  "status": "active",
  "reviewerId": "<approved human reviewer ID>",
  "reviewedAt": "<UTC timestamp>"
}
```

يجب أن يحدد إيصال اعتماد التطبيق الخاص المعتمد الحقيقي وإذن المالك والمصدر الأصلي ومراجعته والنطاق والوكلاء المسموح بهم وقاعدة الحداثة وSHA-256 لهذه **البايتات الدقيقة لنص JSON UTF-8**. إنه يسجل قرارًا بشريًا بشأن الادعاء الفعلي. السلسلة `reviewerId` في السجل ليست مصادقة. لا تحفظ سجلًا فيه تناقض غير محلول أو إذن مفقود. تخزن Anthropic النص، لكنها لا تتحقق من هذا المخطط ولا تثبت صحة الادعاء.

## 2. خزّنه واقرأه مجددًا

أنشئ أو اختر مخزن ذاكرة محدودًا في مساحة العمل المصرح بها وسجّل معرّفه الحقيقي `memstore_...`. استخدم مسارًا غير حساس، مثل `/records/{opaque-record-id}.json`. قبل الطلب، سجّل المنفذ ووقت UTC ومراجعة المصدر وبصمة البايتات المعتمدة والمخزن والمسار وحالة `pending`. في استدعاءات مخزن الذاكرة المباشرة استخدم `agent-memory-2026-07-22`؛ أما استدعاءات الجلسات فتستخدم `managed-agents-2026-04-01`. تقول Anthropic إن جمع هذين الترويسين التجريبيين في طلب مخزن يعيد HTTP 400. يعرض [مرجع الإنشاء](https://platform.claude.com/docs/en/api/beta/memory_stores/memories/create) ودليل الذاكرة هذا الشكل من SDK؛ قارن SDK المثبّت بالمرجع الحالي:

```python
mem = client.beta.memory_stores.memories.create(
    store.id,
    path="/records/<opaque-record-id>.json",
    content=approved_json_text,
)
```

الإنشاء لا يستبدل مسارًا موجودًا. احفظ معرّف `mem_...` المعاد، ثم اسرد `/records/` في المخزن المحدد، مستخدمًا كل `next_page` بوصفه قيمة `page` التالية. القائمة الأساسية الافتراضية لا تتضمن المحتوى. [استرجع الذاكرة المختارة](https://platform.claude.com/docs/en/api/beta/memory_stores/memories/retrieve) بمعرّفها للحصول على النص الكامل؛ قارن معرّف المخزن ومعرّف الذاكرة والمسار والمحتوى وقيمة `content_sha256` مع البايتات المعتمدة. سجّل الاستجابة والقراءة المباشرة في اليومية والسجل المرجعي. استجابة الإنشاء وحدها ليست فحص اكتمال. إذا كانت غير مؤكدة، افحص المسار الدقيق والسجل مباشرة قبل الحكم؛ غياب نتيجة بحث وحده لا يبرر تكرار الإنشاء.

## 3. ثبّت المراجعة المختارة

في كل تشغيل لاحق، صادق المتصل واستخرج نطاقه ومخزنه ومعرّف السجل المختار من السجل الموثوق. إذا احتجت إلى اكتشاف، اسرد كل صفحات البادئة المحددة ثم استرجع مباشرة السجل المختار `mem_...`. احسب SHA-256 باستخدام ترميز UTF-8 لهذا **المحتوى المعاد**، وقارنه بحقل المزوّد `content_sha256` وبصمة البايتات الدقيقة التي اعتمدها الإنسان، ثم تحقق من JSON مجددًا. افحص معرّف السجل ونطاق المالك ومراجعة المصدر وحالة `active` وحداثة المصدر وحد الصلاحية المحدد مسبقًا. إذا فشل أي فحص، فلا ترسل شيئًا.

اكتب البايتات المسترجعة الدقيقة مرة واحدة في تخزين خاص يُعنون ببصمتها، مع إنشاء حصري مثل استدعاء Python `open(path, "xb")`. أعد قراءة الملف وحساب بصمته فورًا وقبل **كل** إرسال. لا تستبدل لقطة موجودة أبدًا. ملف جزئي أو ملف موجود ببايتات مختلفة في العنوان نفسه سبب للتوقف والمطابقة. احتفظ بالاعتماد الأصلي ومعرّف المخزن ومعرّف الذاكرة وبصمة المزوّد وبصمة اللقطة وقرار النطاق في إيصال استرجاع خاص. هذه اللقطة ذات الكتابة الواحدة تصميم للتطبيق، وليست تركيبًا من Anthropic مثبتًا على إصدار.

## 4. قدّم البايتات نفسها إلى جلستين جديدتين

أنشئ جلسة جديدة للوكيل A بمعرّفي الوكيل والبيئة الحقيقيين المصرح بهما، مع الإعداد التالي: **من دون إدخال مخزن ذاكرة في `resources`**. تحقق من أن موارد الجلسة المعادة وأدوات الوكيل وبيانات اعتماده الفعلية لا تترك مسارًا بديلًا إلى المخزن. يوثق [دليل الجلسات](https://platform.claude.com/docs/en/managed-agents/sessions) من Anthropic الإنشاء وإرسال `user.message` كعمليتين منفصلتين:

```python
session = client.beta.sessions.create(
    agent=approved_agent_id,
    environment_id=approved_environment_id,
)
client.beta.sessions.events.send(
    session.id,
    events=[{"type": "user.message", "content": [{"type": "text", "text": message_text}]}],
)
```

قبل `events.send`، أعد قراءة اللقطة الخاصة وحساب بصمتها. أنشئ `message_text` بصورة حتمية من تسمية صريحة «بيانات مراجعة»، ومعرّفات السجل والمصدر والمراجعة، ونص JSON غير المعدّل وSHA-256 الخاص به، ثم سؤال ضيق يمكن للمصدر الأصلي إجابته. الحقول المعروضة هي **تنسيق رسالة للتطبيق**، وليست حقول استجابة المزوّد. قبل الإرسال، سجّل بايتات الرسالة UTF-8 كاملة وبصمتها، وبصمة اللقطة المختارة، ومعرّف الوكيل المصرح به، ومعرّف الجلسة وحالة الإرسال. احتفظ بالنتيجة ومعرّف الحدث المرسل الفعلي أو قراءة قائمة الأحداث عند توفرها. نتيجة إرسال مجهولة تستدعي قراءة الأحداث، لا إعادة إرسال عمياء.

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

## 5. حدّث بعد مراجعة جديدة للمصدر فقط

عندما يتغير الأصل، استرجع الذاكرة الحالية مباشرة وقارن الأدلة القديمة والجديدة مع المالك. اجعل إنسانًا يعتمد بايتات JSON البديلة الدقيقة مع معرّف السجل الثابت والادعاء أو مؤشر المصدر المصحح ومراجعة المصدر الجديدة وأوقات الفحص والمراجعة. احتفظ بالإيصال والبصمة القديمين. سجّل معرّف `mem_...` وقيمة `content_sha256` الحالية المقروءة مباشرة وبصمة البديل المقصودة والمنفذ والاعتماد والحالة المعلقة. هذا هو [التحديث المشروط](https://platform.claude.com/docs/en/api/beta/memory_stores/memories/update) الموثق:

```python
client.beta.memory_stores.memories.update(
    memory_id=memory_id,
    memory_store_id=store_id,
    content=approved_replacement_json_text,
    precondition={"type": "content_sha256", "content_sha256": fresh_old_hash},
)
```

يحسب المزوّد بصمة محتوى UTF-8 الدقيق بلا تطبيع. عدم التطابق يعيد HTTP 409 `memory_precondition_failed_error`. عند هذه الاستجابة أو نتيجة شبكة غير مؤكدة، استرجع الذاكرة الحية مجددًا وافحص تاريخ الإصدارات حسب الحاجة. قارن مراجعات المصادر المتعارضة واطلب من المالك دمج بديل دقيق جديد أو رفضه أو اعتماده؛ لا تعاود الكتابة القديمة عشوائيًا. عند النجاح، يجب أن يؤكد الاسترجاع المباشر المسار ونص البديل كاملًا والبصمة ومعرّف إصدار الذاكرة قبل انتقال اليومية إلى `confirmed`.

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

## ما الذي يُعد مكتملًا

يجب أن تصل الإيصالات الخاصة الإذن الأصلي ومراجعة المصدر ببصمة JSON الدقيقة المعتمدة؛ وهوية مساحة العمل والمخزن والمسار والمعرّف `mem_...` الحقيقية والقراءة المباشرة بعد الإنشاء؛ ولقطة واحدة غير قابلة للتغيير؛ ومعرّفي جلستين مختلفتين مصرح بهما وبلا تركيب مخزن، مع بصمات الرسائل المرسلة وإجابات مفحوصة مقابل المصدر؛ والتحديث المشروط المعتمد مع قراءة مباشرة جديدة وفحوص جلسات جديدة. إذا جُهل أي رابط، علّم التمرين كله غير مكتمل واحتفظ بسبب التوقف الدقيق. إن نفذته، سجّل استخدام الجلسات والأدوات الفعلي وتكلفة الحساب المحددة؛ لم يقس هذا الدليل الوثائقي وفورات أو أداء النموذج.

لعمل مرتبط لكنه مختلف، تتناول [مراجعة مخرج Dream واحد لجلسة لاحقة](https://bigchange.ai/blog/claude-managed-agents-reviewed-dream-memory-guide) اقتراحًا مولدًا للمخزن. يبدأ هذا المسار بسجل مصدر اعتمده المالك ويثبّت بدقة ما يتلقاه مستهلكان.

## Sources

- [دليل ذاكرة Anthropic Managed Agents](https://platform.claude.com/docs/en/managed-agents/memory) — يوثق الترويسات التجريبية ومخازن نصوص مساحة العمل والتركيبات القابلة للتغيير والإصدارات والحدود. لا يصادق المستخدم النهائي ولا يثبت صحة الادعاء ولا يثبّت مخزنًا مركبًا على مراجعة معتمدة.
- [Anthropic، API لإنشاء ذاكرة](https://platform.claude.com/docs/en/api/beta/memory_stores/memories/create) — يوثق الإنشاء بالمسار والمحتوى والهوية المعادة. لم ينفذ الدليل إنشاءً؛ تحقق التطبيق واعتماده منفصلان.
- [Anthropic، API لسرد الذاكرات](https://platform.claude.com/docs/en/api/beta/memory_stores/memories/list) — يوثق path_prefix وتقسيم الصفحات next_page والنتائج الأساسية بلا محتوى. ما زالت القراءة المباشرة الكاملة للسجل المختار ضرورية.
- [Anthropic، API لاسترجاع ذاكرة](https://platform.claude.com/docs/en/api/beta/memory_stores/memories/retrieve) — يوثق الاسترجاع الكامل للذاكرة المختارة لقراءة المحتوى والبصمة؛ دقة المصدر والنطاق فحوص للتطبيق.
- [Anthropic، API لتحديث ذاكرة](https://platform.claude.com/docs/en/api/beta/memory_stores/memories/update) — يوثق شرط UTF-8 content_sha256 الدقيق وHTTP 409 memory_precondition_failed_error. حل التعارضات بشريًا هو سياسة التطبيق المقترحة في الدليل.
- [Anthropic، بدء جلسة](https://platform.claude.com/docs/en/managed-agents/sessions) — يوثق إنشاء جلسة الوكيل والبيئة وuser.message عبر events.send. لم يشغّل الدليل جلسة؛ اللقطة الخاصة بلا مخزن مركب ويومية الرسائل ضوابط تطبيقية.
- [BIG CHANGE: راجع مخزن ذاكرة Claude Managed Agent بعملية Dream واحدة](https://bigchange.ai/blog/claude-managed-agents-reviewed-dream-memory-guide) — دليل مرتبط لمراجعة مخرج واحد. لا يبرهن دورة حياة السجل ذي الأنواع واللقطة الدقيقة لوكيلين في هذا المقال.