نظام ذاكرة بسيط: دع Jev يقرر ما يُحفظ
💡 الخلاصة في سطر واحد: ابنِ باستخدام Jev نظام ذاكرة للذكاء الاصطناعي — بوابة Noul واحدة تقرر ما يُحفظ، والذكريات تُخزَّن في قاموس Python عادي، وتُدمج تلقائيًا في state قبل الاستدعاء.
كل طلب Jev لا يرى إلا الـ state الذي ترسله إليه. ما أخبرك به العميل الشهر الماضي — أي إصدار يستخدم، وأي خطة، وهل وقّع عقدًا — ليس في الطلب التالي، إلا إذا وضعه كودك هناك.
نهج كتاب الطبخ الرسمي (Simple memory system) صريح للغاية: طلب Jev إضافي واحد لكل استدعاء، بالإضافة إلى قاموس Python.
سيناريو المثال لديه هو توجيه تذاكر الدعم. في الشهر 8، قال العميل إنهم يستضيفون بأنفسهم على Windows Server؛ وفي الشهر 9، كتبوا «Dashboards have been really slow since this morning». بدون ذاكرة، يرسل Jev هذه التذكرة إلى فريق السحابة؛ ومع الذاكرة، تُوجَّه جميع التذاكر اللاحقة الست إلى الفرق المتوقعة — كل واحدة تُوجَّه على حدة، وثلاث منها فقط تستفيد فعليًا من الذاكرة.
نظام ذاكرة الذكاء الاصطناعي هذا يتكون من مكوّنين فقط:
- بعد الاستدعاء: ينظر Jev إلى الطلب الأصلي وإجابته ويجيب عن سؤال Noul — تسميه الوثائق الرسمية the gate (البوابة): هل ذكر هذا الطلب حقيقة عن العميل تستحق الحفظ؟ إذا كانت P(yes) ≥ 0.5، تُخزَّن التذكرة مع الإجابة كذكرى لهذا العميل
- قبل الاستدعاء: تُضاف تذاكر العميل المخزنة (مع إجابات Jev) إلى state — مغلّفة في
ask_with_memory()، بمعاملات وقيمة إرجاع مطابقة لـask()
ask_with_memory(state, questions)
│
▼ ① state + ذكريات العميل المخزنة (تُرسل كما هي إن لم توجد)
طلب Jev رقم 1: يجيب عن سؤالك (في هذا المثال: أي فريق يجب أن يتولى هذه التذكرة)
│ ② الطلب الأصلي + إجابة Jev، مقترنان معًا
▼
طلب Jev رقم 2: البوابة (سؤال Noul واحد) — هل ذكر هذا الطلب حقيقة عن العميل تستحق الحفظ؟
│
▼ ③ هل P(yes) ≥ REMEMBER_AT (0.5)؟ — كودك هو من يقرر
نعم ──┤── لا ──┐
▼ │
تُخزَّن في MEMORIES │
(قائمة واحدة لكل معرّف عميل)
└──────┬────────┘
▼
④ تُعاد إجابة الطلب 1 كما هي، ويواصل كودك العمل كالمعتاد
↺ الذكريات المخزنة تدخل في الطلب التالي لهذا العميل (عودة إلى ①)ask_with_memory() دالة التغليف هذه هي أداة agent harness مصغّرة. التعريف الرسمي: الـ harness هو الكود المحيط بالنموذج الذي يمنحه قدرات إضافية (tool calls، التشغيل في حلقة). الـ harness في هذه الصفحة يمنح الذاكرة فقط — قاموس Python عادي، قائمة واحدة لكل معرّف عميل. لرؤية harness يضيف tool calls إلى النموذج، انتقل إلى الدرس السابق قرارات الوكيل.
هذا الدرس يستغرق نحو 15 دقيقة. جميع الأرقام في الصفحة مأخوذة من البيانات المسجلة في كتاب الطبخ الرسمي (jev-1.14.0، 2026-10-29): الملفات المسجلة الرسمية تعطي بعد إزالة التكرار 31 استدعاءً بإجمالي 21,456 رمز إدخال (input token) — بمعدل $42/Btok والإخراج مجاني، أي نحو $0.0009. الملفات المسجلة منشورة مع المستودع الرسمي، فيمكن إعادة تشغيلها والتحقق منها بدون أي مفتاح.
ماذا ستستطيع أن تفعل بعد إتمام الدرس
- إضافة ذاكرة إلى أي نظام قائم على «حكم Jev + تاريخ العميل»: بعد الاستدعاء تحكم بوابة Noul فيما إذا كان يجب الحفظ، وقبله تُدمج الذكريات المخزنة في state —
ask_with_memory()بنفس معاملات ونفس قيمة إرجاعask()، فالاستبدال لا يتطلب تعديل أي كود آخر - جعل «ما يُحفظ» سؤالًا صريحًا (GATE) بدلًا من قواعد متناثرة: الحقائق الدائمة مثل الإصدار والخطة والعقد تُخزَّن باحتمال 0.96–0.98؛ أما هاتف المطار والعطلة الرسمية فلا تُخزَّنان (0.02، 0.03)
- إعادة إنتاج الاختبار الرسمي بنفسك: الجملة نفسها «لوحة التحكم بطيئة جدًا»، Jev المجرد يوجّهها إلى فريق السحابة 0.55، ومع الذاكرة تصل إلى فريق Windows ذي الاستضافة الذاتية 0.98 — ست تذاكر لاحقة تتحول من 3/6 إلى 6/6
- شرح حدود هذا النظام الخمسة بوضوح (طلبان متتاليان لكل استدعاء، ذاكرة تزداد ولا تنقص...)، ومعرفة الخطوة الرسمية التالية لترقية الذاكرة (الانتقاء بالصلة، استبدال الذكريات القديمة، تغيير قاعدة البيانات)
لماذا Jev، بدلًا من حشو التاريخ كله في الـ prompt؟
| القدرة | حشو كل شيء في الـ prompt / ترك نموذج المحادثة يتذكر بنفسه | ذاكرة البوابة Jev |
|---|---|---|
| من يقرر ما يُحفظ | ❌ تخزين كل شيء في الذاكرة: هاتف المطار والعطلات العامة تشغل السياق أيضًا؛ نموذج المحادثة يتذكر: ما يُحفظ يتوقف على مزاج النموذج، والمخرجات لا يمكن مراجعتها | ✅ بوابة Noul واحدة تعطي احتمالية: ما يجب حفظه 0.96–0.98، وما لا يجب حفظه ≤ 0.04، والعتبة موجودة في الكود الخاص بك |
| هل الاحتمالية موثوقة | ❌ جعل النموذج يكتب درجة ثقته كنص، ثم الدعاء ألا يفشل التحليل | ✅ تدريب معايرة RLCD: الاحتمالات متوافقة مع النتائج الحقيقية، وخط P ≥ 0.5 هو وحده ما يكتسب معناه |
| عندما يطول السجل التاريخي | ❌ كل طلب يحمل كامل السجل التاريخي، وترتفع الـ token خطيًا مع عدد التذاكر | ✅ التذاكر التي تعبر البوابة فقط تدخل الذاكرة، والحالة (state) تنمو مع «الحقائق التي تستحق الحفظ»؛ كل استدعاء يضيف طلب بوابة واحدًا ثابتًا |
| الاندماج مع الكود الحالي | ❌ تعديل قوالب الـ prompt وسلسلة الاستدعاء | ✅ ask_with_memory() بنفس المعاملات ونفس قيمة الإرجاع مثل ask()—بنص المصدر الرسمي: ضعه مكانها دون تعديل أي كود آخر |
| ما تراقبه البوابة | ❌ حفظ إجابة النموذج معها: الإجابات العامة تطغى على الحقائق الحقيقية الواردة في الطلب | ✅ عدّ فقط ما كتبه العميل/فريق الدعم في الطلب؛ الحقائق التي تظهر في الإجابة وحدها لا تُحفظ |
مأزقك الحالي
- «أوضح العميل في شهر 8 أنهم يستخدمون استضافة ذاتية على Windows Server، وعندما تباطأت لوحة البيانات في شهر 9، أُسندت التذكرة مرة أخرى لفريق السحابة—مما اضطر العميل في كل مرة إلى إعادة شرح بيئته من البداية»
- «عندما تطلب من نموذج المحادثة أن يساعدك في «تذكر معلومات العميل»، فإن ما يعيده لا يمكن مراجعته: تارة يعتبر «اتصلت اليوم من المطار بهاتفي» حقيقة طويلة الأمد، وتارة يعيد حفظ استنتاجاته من الجولة السابقة مرة أخرى»
- «حاولت حشر كامل سجل التذاكر في كل طلب: الـ token تستهلك أكثر فأكثر، والتوجيه انحرف بفعل التذاكر القديمة غير ذات الصلة»
متى تستخدم هذه الطريقة
عندما تحتاج إلى:
- يكون نظامك يستخدم بالفعل Jev لاتخاذ القرارات (التوجيه، التصنيف، التحقق)، وجودة القرار تعتمد على «من هو هذا العميل»—الإصدار، نظام التشغيل، الباقة، العقد، التفضيلات طويلة الأمد
- «ما يُحفظ» هو سؤال صريح بعتبة صريحة—يمكن للبشر مراجعته، ووضعه في مستودع الإصدارات، وإعادة ضبطه في أي وقت
- ذاكرة مستقلة لكل عميل، تُرفق تلقائيًا بالاستدعاءات الجديدة، دون تغيير حرف واحد في السؤال
ولا تريد:
- حشر كامل السجل التاريخي في كل طلب، بارتفاع الـ token خطيًا مع طول السجل
- ترك نموذج المحادثة «يتذكر» بحرية، ثم تحليل النص الذي يخرجه
- إدخال خط أنابيب كامل للاسترجاع بالتضمينات لأجل ذلك—لا يلزم إلا عندما تطول الذاكرة (انظر التقنيات المتقدمة)
🎒 التحضير قبل البدء
- أن تكون قد أكملت أسئلة Noul بنعم/لا: البوابة هي Noul—كيف تقرأ الاحتمالية 0–1 وكيف تضبط العتبة، تستخدمها هذه الصفحة مباشرة
- أن تعرف أن state هو كل ما يراه Jev: الذاكرة ليست سوى مفتاح إضافي داخل الـ state، ولا يلزم تعديل السؤال تبعًا لذلك
- أن تكون قد شغّلت بنجاح التثبيت وأول طلب: يوجد
typesafe-sdkداخل.venv، وTYPESAFE_API_KEYفي متغيرات البيئة - تنزيل ذاكرة التخزين المؤقت الرسمية المسجلة: typesafe-public-examples الملف
json_cache.jsonمن المجلدcookbooks/basic_memoryداخل المستودع، ضعه في مجلد التشغيل—شغّل الكود الرسمي كما هو، دون أي مفتاح؛ احذفه وستمر جميع الاستدعاءات حقيقية - معرفة الحد الأعلى للتكلفة: التسجيل الرسمي بعد إزالة التكرار 31 استدعاء، و21,456 token إدخال، بسعر $42/Btok حوالي $0.0009، والإخراج مجاني—الأسعار في النماذج والأسعار
اتبع خطواتي
الخطوة 1: جهّز البيئة وذاكرة التخزين المؤقت الرسمية وخمس تذاكر مبكرة
لماذا: يحتاج نظام الذاكرة إلى نوعين من التذاكر—تذاكر مبكرة تصرّح بحقائق دائمة (يجب حفظها)، ورسائل لاحقة تتحدث عن الأمور الآنية فقط (تحتاج إلى الذاكرة). البيانات الرسمية كلها مكتوبة يدويًا لهذا المثال: 2 عملاء، و5 تذاكر مبكرة، و3 رسائل لاحقة.
أنشئ المجلد، ونزّل ذاكرة التخزين المؤقت الرسمية، وثبّت التبعيات:
mkdir jev-memory && cd jev-memory
curl -sLO https://raw.githubusercontent.com/typesafe-ai/typesafe-public-examples/main/cookbooks/basic_memory/json_cache.json
pip install ipython 'cooksafe>=0.2.0,<0.3.0' typesafe-sdkسطر pip الرسمي لم يكن يتضمن في الأصل typesafe-sdk (منصة التوثيق مثبتة مسبقًا)، وقد أضفناه هنا.
خلية Setup (كما هي رسميًا؛ make_playground_link وdisplay لن يُستخدما إلا في خلية Playground الأخيرة):
import json
import os
from pathlib import Path
from cooksafe import JsonCache, make_playground_link
from IPython.display import Markdown, display
from typesafe_sdk import Choice, Noul, NoulCriteria, SystemOneResponse, TypeSafeClient
TYPESAFE_MODEL = "jev-1.14.0"
REMEMBER_AT = 0.5 # save when P(lasting customer fact) reaches this starting threshold
MEMORY_KEY = "earlier_tickets_from_this_customer" # where saved tickets go in the state
client = TypeSafeClient(
api_key=os.environ.get("TYPESAFE_API_KEY", "cache-only"), # keyless kernels replay the cache
base_url=os.environ.get("TYPESAFE_ENDPOINT"),
timeout=120.0,
)
json_cache = JsonCache(Path("json_cache.json"))ثلاثة ثوابت، كل واحد مسؤول عن أمر واحد: TYPESAFE_MODEL يثبّت الإصدار (الأرقام الرسمية المسجلة تستخدم jev-1.14.0)؛ REMEMBER_AT = 0.5 هو عتبة البداية لحفظ البوابة في الذاكرة؛ MEMORY_KEY هو اسم المفتاح المستخدم عند وضع الذاكرة في الـ state. "cache-only" هو القيمة الافتراضية التي تركها المصدر الرسمي للمفتاح—عند مطابقة الذاكرة المؤقتة لا يُرسل أي طلب أصلًا، فيمكن إعادة إنتاج جميع أرقام هذه الصفحة بدون أي مفتاح.
عميلان، وخمس تذاكر مبكرة، وثلاث رسائل لاحقة (DATA الرسمية كما هي؛ expected_team موسومة يدويًا حسب ما قاله كل عمميل في التذاكر المبكرة):
DATA = {
"customers": {
"C-1042": {"id": "C-1042", "company": "Acme Corp"},
"C-2210": {"id": "C-2210", "company": "Example Studio"},
},
"earlier_tickets": [
{"id": "T-101", "customer_id": "C-1042", "received_on": "2026-08-04",
"subject": "Adding an admin",
"text": "Hi, we run your self-hosted edition on Windows Server 2022 in our own data "
"centre. How do I add a new admin user?"},
{"id": "T-102", "customer_id": "C-2210", "received_on": "2026-08-11",
"subject": "Exporting to PDF",
"text": "We're a small design studio on your cloud edition, paying monthly on the "
"self-serve Team plan. How do I export a dashboard as a PDF?"},
{"id": "T-103", "customer_id": "C-1042", "received_on": "2026-08-19",
"subject": "Invoice download",
"text": "Sorry for the typos, typing this on my phone at the airport. Where can I "
"download last month's invoice?"},
{"id": "T-104", "customer_id": "C-2210", "received_on": "2026-09-02",
"subject": "Dark mode?",
"text": "Our whole team is out on Friday for a public holiday, so no rush on this "
"one. Is there a dark mode?"},
{"id": "T-105", "customer_id": "C-1042", "received_on": "2026-09-10",
"subject": "Sandbox environment",
"text": "For context, we signed an Enterprise contract with you in March. Can we get "
"a sandbox environment for testing?"},
],
"later_messages": [
{"subject": "Slow dashboards",
"text": "Dashboards have been really slow since this morning."},
{"subject": "Upgrade failing",
"text": "The upgrade to version 5.2 keeps failing halfway through."},
{"subject": "More seats",
"text": "We'd like to add 20 more seats before next quarter."},
],
"later_received_on": "2026-09-28",
# Labelled by hand from what each customer said in the earlier tickets.
"expected_team": {
"C-1042": {"Slow dashboards": "selfhosted_windows",
"Upgrade failing": "selfhosted_windows", "More seats": "enterprise_desk"},
"C-2210": {"Slow dashboards": "cloud_ops", "Upgrade failing": "cloud_ops",
"More seats": "billing"},
},
}
CUSTOMERS = DATA["customers"]
def ticket_state(customer_id: str, ticket_id: str, received_on: str, subject: str,
text: str) -> dict:
"""The state Jev sees for one ticket: a simplified ticket, like one from a helpdesk."""
return {
"customer": CUSTOMERS[customer_id],
"ticket": {
"id": ticket_id,
"received_on": received_on,
"subject": subject,
"messages": [{"from": "customer", "text": text}],
},
}
EARLIER = [
ticket_state(t["customer_id"], t["id"], t["received_on"], t["subject"], t["text"])
for t in DATA["earlier_tickets"]
]
print(f"{len(CUSTOMERS)} customers, {len(EARLIER)} earlier tickets, "
f"{len(DATA['later_messages'])} later messages. The first ticket as Jev sees it:\n")
print(json.dumps(EARLIER[0], indent=2))يجب أن ترى (الإصدار الرسمي):
2 customers, 5 earlier tickets, 3 later messages. The first ticket as Jev sees it:
{
"customer": {
"id": "C-1042",
"company": "Acme Corp"
},
"ticket": {
"id": "T-101",
"received_on": "2026-08-04",
"subject": "Adding an admin",
"messages": [
{
"from": "customer",
"text": "Hi, we run your self-hosted edition on Windows Server 2022 in our own data centre. How do I add a new admin user?"
}
]
}
}حالة (state) كل تذكرة تتكون من جزأين فقط (تجميع ticket_state()): customer هو من يبلّغ، وticket هو سلسلة تذاكر مبسطة. المقصد من تصميم البيانات واضح في النص الرسمي: ثلاث تذاكر مبكرة تصرّح بحقائق دائمة—إصدار T-101 (استضافة ذاتية على Windows Server)، وباقة T-102 (سحابي ذاتي Team)، وعقد T-105 (Enterprise)؛ وتذكرتان لا تصرّحان—T-103 هاتف المطار، وT-104 العطلة العامة. الرسائل الاحقة الثلاث لا تذكر أيًا من بيئة العميل، لذا بدون ذاكرة لا يستطيع Jev إلا التخمين.
2 customers, 5 earlier tickets, 3 later messagesيُطبع دون أخطاء؛ أستطيع الإشارة إلى التذاكر الثلاث التي تصرّح بحقائق دائمة والتذكرتين اللتين لا تصرّحان
الخطوة 2: شغّل أولًا توجيه Jev المجرد، لترى أين يقع الخطأ بدون ذاكرة
لماذا: نبني أولًا خط الأساس—بدون ذاكرة، إلى أين ستُوجَّه تذكرة «لوحة البيانات البطيئة» هذه.
سؤال التوجيه هو Choice، و7 خيارات تغطي 7 فريق دعم. لاحظ none_suitable: المصدر الرسمي علّق على استخدامه—المكان الذي تذهب إليه التذاكر عندما لا يناسب أي فريق، فالتذاكر ذات السياق غير الكافي تصل إلى هنا:
ROUTE = {
"team": Choice(
instructions="Which support team should handle `ticket`?",
criteria={
"cloud_ops": "Cloud team: problems with the hosted cloud edition, run by us",
"selfhosted_linux": "Self-hosted team, Linux: installs, upgrades and "
"performance of the self-hosted edition on Linux servers",
"selfhosted_windows": "Self-hosted team, Windows: installs, upgrades and "
"performance of the self-hosted edition on Windows Server",
"billing": "Billing: invoices, payments, seats and plan changes for "
"self-serve plans",
"enterprise_desk": "Enterprise desk: seats, contracts and account changes for "
"customers on an Enterprise contract (their technical problems go to the "
"technical teams)",
"general": "General product questions: features, how-to, settings",
"none_suitable": "None of these teams fits the ticket",
},
),
}
@json_cache
def _system_one(model: str, state: str, questions: str) -> dict:
response = client.system_one(
state=json.loads(state), questions=json.loads(questions), model=model
)
return response.model_dump(mode="json")
def ask(state: dict, questions: dict) -> SystemOneResponse:
"""client.system_one, with the model pinned and the call cached."""
as_json = {qid: q.model_dump(mode="json", exclude_none=True) for qid, q in questions.items()}
raw = _system_one(TYPESAFE_MODEL, json.dumps(state), json.dumps(as_json))
return SystemOneResponse.model_validate(raw)
def later_state(customer_id: str, message_index: int) -> dict:
"""One of the later messages, sent by this customer, with a fixed ticket ID."""
n = 201 + 3 * list(CUSTOMERS).index(customer_id) + message_index
message = DATA["later_messages"][message_index]
return ticket_state(customer_id, f"T-{n}", DATA["later_received_on"], message["subject"],
message["text"])
slow = later_state("C-1042", 0)
team = ask(slow, ROUTE).answers["team"]
print(f"C-1042: {slow['ticket']['messages'][0]['text']!r}")
print(f" plain Jev -> {team.choice} {team.probabilities[team.choice]:.2f}")ask() هي ببساطة client.system_one مع تثبيت النموذج وإرفاق ذاكرة التخزين المؤقت @json_cache؛ وlater_state() تخصص أرقام تذاكر ثابتة للرسائل الاحقة (بدءًا من T-201).
يجب أن ترى (الإصدار الرسمي):
C-1042: 'Dashboards have been really slow since this morning.'
plain Jev -> cloud_ops 0.55هذه التذكرة، إذا نُظر إليها منفردة، يبدو أن «بطء لوحة البيانات» مشكلة في النسخة السحابية—Jev أرسلها لفريق السحابة، باحتمالية 0.55. أما كون C-1042 يستخدم استضافة ذاتية على Windows Server، فلم تذكره التذكرة بحرف واحد.
الخطوة 3: اكتب بوابة الذاكرة—Noul واحد يحكم «هل يستحق الحفظ»
لماذا: يجب أن يكون «ما يُحفظ» سؤالًا صريحًا، لا شروط if-else متناثرة في الكود. انظر أولًا إلى شكل ما سيُحفظ—as_memory() يقرن الـ state الأصلية بإجابة Jev كزوج واحد:
def answer_text(question, answer):
"""The readable part of an answer: the chosen option's description, or the number."""
if answer.type == "choice":
return question.criteria[answer.choice]
return answer.noul if answer.type == "noul" else answer.score
def as_memory(state: dict, questions: dict, response: SystemOneResponse) -> dict:
return {
"request": state,
"jev_answered": {
q.instructions: answer_text(q, response.answers[qid])
for qid, q in questions.items()
},
}
def remember_probability(memory: dict) -> float:
"""P(the request states an important fact about the customer), with the answer as context."""
return ask(memory, GATE).answers["remember"].noulاسما المفتاحين مقصودان: request يخزن الـ state الأصلية قبل إضافة الذاكرة—الذاكرة القديمة لن تتداخل أبدًا داخل الذاكرة الجديدة؛ jev_answered يربط كل سؤال بنص الإجابة (إجابات Choice تخزن وصف الخيار المختار).
البوابة نفسها هي Noul (نص GATE الرسمي). ركّز على الجملتين المقيدتين في instructions—عدّ فقط ما كتبه العميل/فريق الدعم في request.ticket؛ jev_answered مجرد سياق، وما يقوله أو يشير إليه لا يُحتسب:
GATE = {
"remember": Noul(
instructions=(
"In `request.ticket`, does the thread state a lasting fact about the customer that "
"should change how their future, unrelated tickets are handled? Count what the "
"customer or our support staff wrote in `request.ticket`. `jev_answered` shows how "
"the ticket was routed, which may rely on things learned earlier: do not count "
"anything it says or implies."
),
criteria=NoulCriteria(
true=(
"Yes: in `request.ticket` the customer or our support staff state something "
"about the customer that stays true after this ticket, such as the product "
"edition or operating system they run, their plan or contract, or a standing "
"preference."
),
false=(
"No: `request.ticket` only contains things specific to this one ticket or "
"moment, such as a one-off request, today's schedule, or the device they "
"happen to be typing on; or the lasting fact appears only in `jev_answered`."
),
),
),
}لماذا لا تُحتسب الإجابة؟ المصدر الرسمي يعطي سببين: أولًا الإجابات العامة—مثل «General product questions: features, how-to, settings» وهي إجابات تناسب أي أحد—تطغى على حقائق العميل الحقيقية الواردة في الطلب؛ ثانيًا الإجابات المستنتجة من الذاكرة القديمة ستُحفظ مرة أخرى كحقائق جديدة، فتتكاثر الذاكرة ذاتيًا.
::: نصيحة 💡 اختبر التذاكر الصينية قبل الإطلاق الشرح الرسمي: الإنجليزية هي اللغة الأساسية لتدريب Jev، واللغات الأخرى بما فيها الصينية تعمل لكن بدقة أقل. قبل استبدال GATE و ROUTE بالصينية أو وضع بوابة للتذاكر الصينية، شغّل دفعة من تذاكرك الخاصة أولاً، وانظر ما إذا كانت احتمالات مجموعتَي «يجب التذكر / لا يجب التذكر» منفصلتين بوضوح، ثم حدّد REMEMBER_AT.
Noul لا يملك confidence منفصلاً — لتوحيد العتبة مع أنواع الأسئلة الأخرى، يمكنك حساب |2p − 1| بنفسك وفق الصيغة الرسمية (انظر Confidence الثقة). :::
يجب أن ترى: هذه الخطوة لا تنتج أي مخرجات — remember_probability() لا يُستدعى فعلياً إلا في القسم التالي.
الخطوة 4: تغليف ask_with_memory() — جوهر نظام ذاكرة الذكاء الاصطناعي
لماذا: ثلاث دوال صغيرة تخيط البوابة مع state — هذا هو نظام ذاكرة الذكاء الاصطناعي الكامل، الكود الرسمي 18 سطراً في المجموع:
MEMORIES: dict[str, list[dict]] = {} # customer ID -> that customer's saved memories
def customer_id(state: dict) -> str:
return state["customer"]["id"]
def ask_with_memory(state: dict, questions: dict) -> SystemOneResponse:
"""ask(), plus memory: same arguments, same return value."""
# 1. Answer the call with this customer's existing memories.
saved = MEMORIES.get(customer_id(state), [])
response = ask({**state, MEMORY_KEY: saved} if saved else state, questions)
# 2. Ask Jev whether the original request states an important fact worth keeping.
memory = as_memory(state, questions, response)
if remember_probability(memory) >= REMEMBER_AT:
MEMORIES.setdefault(customer_id(state), []).append(memory)
return responseاقرأ هذه الأسطر الـ 18 ثلاث مرات: ① عند وجود ذاكرة تُرسل {**state, MEMORY_KEY: saved}، وعند غيابها تُرسل كما هي؛ ② لا تتم الإضافة إلا بعد اجتياز البوابة و P ≥ 0.5؛ ③ القيمة المرجعة مطابقة تماماً لـ ask() — المتصل لا يحتاج إلى معرفة ما إذا تم تخزين ذاكرة أم لا.
أشار المسؤول إلى خمس نتائج لهذا التصميم، وكل واحدة تستحق التذكر:
| # | النتيجة | التفاصيل |
|---|---|---|
| 1 | طلبان متسلسلان في كل استدعاء | التوجيه أولاً ثم البوابة — البوابة تحتاج إلى رؤية الجواب، لذا لا يمكنها العمل إلا بعد طلب التوجيه؛ إذا كانت بوابتك لا تنظر إلى الجواب، يمكن دمجها في طلب التوجيه كسؤال ثانٍ (الأسئلة المتوازية والتوسع التخميني) |
| 2 | الذاكرة تتزايد ولا تنقص | كل ذاكرة تدخل كل استدعاء لاحق لهذا العميل؛ لا حد للحجم، ولا فحص للصلة، ولا انتهاء صلاحية |
| 3 | السؤال لا يذكر الذاكرة أبداً | الذاكرة تدخل مفتاح earlier_tickets_from_this_customer في state، وJev يقرأ state بالكامل — لا حاجة لتغيير حرف واحد في ROUTE |
| 4 | يجب أن يحتوي state على customer.id | Jev المجرد يقبل أيضاً state كسلسلة نصية، لكن دالة التغليف تحتاج إلى ID للعثور على قائمة ذلك العميل |
| 5 | الأجوبة المخزنة تكرر الأخطاء | البوابة لا تعد الأجوبة، والأجوبة وحدها لا يمكنها جعل تذكرة تُخزن؛ لكن التذاكر المخزنة مرتبطة بأجوبتها وتُقرأ في كل استدعاء لاحق — الاستدلالات الخاطئة ستستمر في الانتقال |
::: نصيحة 💡 هذه هي القيمة الفريدة لـ Jev «ماذا نتذكر» ليست توصيات متناثرة في prompt، وليست حل وسط بتخزين كل شيء — بل هي Noul باحتمال معاير: في التسجيل الرسمي، التذاكر الثلاث التي يجب تذكرها كانت 0.96–0.98، والتي لا يجب تخزينها كانت جميعها ≤ 0.04، والمجموعتان متباعدتان جداً، ولهذا فقط يجرؤ خط REMEMBER_AT = 0.5 على أن يُرسم في المنتصف. تغيير «ماذا نتذكر» = تغيير صياغة GATE؛ تغيير «ما مقدار التأكد قبل التذكر» = تغيير ثابت واحد — دون لمس سلسلة الاستدعاء في الحالتين. :::
يجب أن ترى: هذه الخطوة أيضاً بلا مخرجات جديدة — القسم التالي يجعلها تعمل.
الخطوة 5: إرسال خمس تذاكر مبكرة لرؤية كيف تعيد كل ذاكرة صياغة الجواب
لماذا: تجربة الاستكشاف الرسمية — قبل وبعد كل تذكرة مبكرة تُرسل رسالتان متابعتان (لوحة تحكم بطيئة، إضافة 20 مقعداً)، لرؤية التأثير الفوري لكل ذاكرة. الرسائل المكررة تمر عبر البوابة أيضاً، لذا تعطي البوابة حكمها عليها أيضاً:
PROBES = {"Slow dashboards": 0, "More seats": 2} # later messages to send after each ticket
def memory_ids(cid: str) -> str:
return ", ".join(m["request"]["ticket"]["id"] for m in MEMORIES.get(cid, [])) or "none"
def send_probes(cid: str) -> None:
for subject, i in PROBES.items():
team = ask_with_memory(later_state(cid, i), ROUTE).answers["team"]
print(f" {subject:<16} -> {team.choice:<19} {team.probabilities[team.choice]:.2f}")
for cid in CUSTOMERS:
print(f"{cid}, memories: {memory_ids(cid)}")
send_probes(cid)
for state in EARLIER:
cid = customer_id(state)
response = ask_with_memory(state, ROUTE)
p = remember_probability(as_memory(state, ROUTE, response)) # cached: the wrapper's call
verdict = "saved" if p >= REMEMBER_AT else "not saved"
text = state["ticket"]["messages"][0]["text"]
print(f"\n{cid} {state['ticket']['id']} {response.answers['team'].choice:<19} "
f"P(remember) {p:.2f} {verdict}")
print(f" {text[:84]}")
print(f"{cid}, memories: {memory_ids(cid)}")
send_probes(cid)سطر التعليق # cached: the wrapper's call يستحق الانتباه: دالة التغليف سألت البوابة مرة بالفعل، والسؤال هنا مرة أخرى سيصيب ذاكرة التخزين المؤقت دون إنفاق طلب جديد.
يجب أن ترى (النشر الرسمي، جدول الاستكشاف الكامل):
C-1042, memories: none
Slow dashboards -> cloud_ops 0.55
More seats -> enterprise_desk 0.53
C-2210, memories: none
Slow dashboards -> cloud_ops 0.68
More seats -> billing 0.58
C-1042 T-101 selfhosted_windows P(remember) 0.97 saved
Hi, we run your self-hosted edition on Windows Server 2022 in our own data centre. H
C-1042, memories: T-101
Slow dashboards -> selfhosted_windows 0.99
More seats -> enterprise_desk 0.53
C-2210 T-102 general P(remember) 0.98 saved
We're a small design studio on your cloud edition, paying monthly on the self-serve
C-2210, memories: T-102
Slow dashboards -> cloud_ops 0.98
More seats -> billing 0.98
C-1042 T-103 billing P(remember) 0.02 not saved
Sorry for the typos, typing this on my phone at the airport. Where can I download la
C-1042, memories: T-101
Slow dashboards -> selfhosted_windows 0.99
More seats -> enterprise_desk 0.53
C-2210 T-104 general P(remember) 0.03 not saved
Our whole team is out on Friday for a public holiday, so no rush on this one. Is the
C-2210, memories: T-102
Slow dashboards -> cloud_ops 0.98
More seats -> billing 0.98
C-1042 T-105 enterprise_desk P(remember) 0.96 saved
For context, we signed an Enterprise contract with you in March. Can we get a sandbo
C-1042, memories: T-101, T-105
Slow dashboards -> selfhosted_windows 0.98
More seats -> enterprise_desk 1.00اقرأ هذا الجدول (التفسير الرسمي يطابقه بنداً بنداً):
- التذاكر الثلاث التي يجب تخزينها خُزنت بـ 0.96–0.98: نسخة T-101 0.97، باقة T-102 0.98، عقد T-105 0.96
- T-102 وُجهت إلى فريق general ومع ذلك خُزنت — البوابة تعد ما كتبه العميل، لا جواب التوجيه؛ لكن حكم «إضافة 20 مقعداً» قفز بسببه من billing 0.58 إلى 0.98
- المطار 0.02 والعطلة الرسمية 0.03 لم يُخزنا — أجوبة الاستكشاف بعدهما لم يتغير أي منها
- كل ذاكرة تغيّر فقط الأجوبة المتعلقة بها: تذكرة Windows الخاصة بـ C-1042 نقلت لوحة التحكم البطيئة من فريق السحابة 0.55 إلى فريق Windows 0.99، وعقد Enterprise رفع enterprise_desk لإضافة المقاعد من 0.53 إلى 1.00؛ وباقة Team الخاصة بـ C-2210 رفعت فريق السحابة 0.68 إلى 0.98 وbilling 0.58 إلى 0.98
- البوابة لم تخزن أي رسالة مكررة — إرسال تذكرة الاستكشاف نفسها مرتين لا يغيّر حكم البوابة
يجب أن ترى: مخرجاتك مطابقة للجدول أعلاه سطراً بسطر (مطابقة تماماً عند إعادة تشغيل الذاكرة المؤقتة؛ عند التشغيل الحي ستختلف الاحتمالات، والاتجاه يُعتمد وفق النسخة التي ثبّتها).
- هذا الجدول قابل للتشغيل؛ وأستطيع تفسير سبب تخزين T-102 رغم توجيهها إلى general
الخطوة 6: المطابقة — الرسالة نفسها تُوجَّه مرتين، مرة عبر Jev المجرد ومرة مع الذاكرة
لماذا: المطابقة النهائية. لكل عميل تُرسل رسائل المتابعة الثلاث كاملة، بنفس state ونفس السؤال، مرة عبر ask() ومرة عبر ask_with_memory(). الفريق المتوقع ليس تخميناً — التعليق في DATA يوضح: وُسم يدوياً وفق ما قاله العميل في التذاكر المبكرة (نسخة مستضافة ذاتياً + عقد Enterprise لـ C-1042، نسخة سحابية وباقة Team لـ C-2210):
EXPECTED = DATA["expected_team"]
plain_correct = memory_correct = total = 0
example_state = None
def cell(answer, expected: str) -> str:
mark = "✓" if answer.choice == expected else "✗"
return f"{mark} {answer.choice} {answer.probabilities[answer.choice]:.2f}"
print(f"{'customer':<9}{'message':<17}{'expected':<20}{'plain Jev':<27}{'with memory':<27}")
for cid in CUSTOMERS:
for i, message in enumerate(DATA["later_messages"]):
state = later_state(cid, i)
expected = EXPECTED[cid][message["subject"]]
plain = ask(state, ROUTE).answers["team"]
if example_state is None:
# Keep the exact state used for this call for the playground link.
saved = MEMORIES.get(cid, [])
example_state = json.loads(json.dumps({**state, MEMORY_KEY: saved} if saved else state))
response = ask_with_memory(state, ROUTE)
remembered = response.answers["team"]
plain_correct += plain.choice == expected
memory_correct += remembered.choice == expected
total += 1
print(f"{cid:<9}{message['subject']:<17}{expected:<20}{cell(plain, expected):<27}"
f"{cell(remembered, expected):<27}")
print(f"\nExpected routes: {plain_correct}/{total} without memory, "
f"{memory_correct}/{total} with memory.")example_state تلك الأسطر محفوظة لرابط Playground الأخير — لالتقاط الحالة الدقيقة (بما فيها الذكريات المخزنة حينها) لاستدعاء لوحة التحكم البطيئة الأولى لـ C-1042 وقت حدوثه.
يجب أن ترى (الإصدار الرسمي):
customer message expected plain Jev with memory
C-1042 Slow dashboards selfhosted_windows ✗ cloud_ops 0.55 ✓ selfhosted_windows 0.98
C-1042 Upgrade failing selfhosted_windows ✗ none_suitable 0.64 ✓ selfhosted_windows 1.00
C-1042 More seats enterprise_desk ✓ enterprise_desk 0.53 ✓ enterprise_desk 1.00
C-2210 Slow dashboards cloud_ops ✓ cloud_ops 0.68 ✓ cloud_ops 0.98
C-2210 Upgrade failing cloud_ops ✗ none_suitable 0.58 ✓ cloud_ops 0.95
C-2210 More seats billing ✓ billing 0.58 ✓ billing 0.98
Expected routes: 3/6 without memory, 6/6 with memory.3/6 مقابل 6/6. أربعة أسطر تستحق المراقبة:
- الجملة نفسها تُوجَّه إلى فرق مختلفة: لوحة بيانات بطيئة، C-1042 يذهب إلى فريق Windows وC-2210 يبقى في الفريق السحابي؛ إضافة مقاعد، C-1042 يذهب إلى enterprise_desk وC-2210 يذهب إلى billing—الذاكرة تجعل «كيفية التوجيه» تتبع العميل، لا الجملة فقط
- أُنقذت كلتا تذكرتي
none_suitable: التذكرة الفاشلة في الترقية لا تذكر البيئة والسياق غير كافٍ، وJev المجرد لا يستطيع إلا الإجابة «لا يوجد فريق مناسب»؛ مع الذاكرة، تذهب كلتاهما إلى فريق Windows 1.00 وفريق السحابة 0.95 - ثلاثة أسطر كان Jev المجرد مصيباً فيها، والذاكرة رفعت احتمالاتها: إضافة مقاعد C-1042 من 0.53 إلى 1.00 — الذاكرة لا تغيّر الصواب والخطأ فقط، بل تغيّر الثقة أيضاً
- لم يحفظ البوابة واحدة من هذه الرسائل الست اللاحقة— فهي لا تذكر حقائق دائمة، ولم يُضف شيء جديد إلى الذاكرة
📋 الـ Prompt السحري
«Prompt» في هذه الصفحة هو قالب السؤال والتغليف المُرسل إلى API—انسخه واستبدل العناصر النائبة 【】 (التي تحمل ? اختيارية) لتستخدمه مباشرة.
📝 بوابة الذاكرة (نسخة Noul)
التأثير المتوقع: صياغة «ماذا نحفظ» كسؤال صريح بنعم/لا، والحصول على احتمال بين 0–1، وقرار الحفظ أو عدمه تحدده العتبة في الكود.
GATE = {
"remember": Noul(
instructions=(
"【在 `request.ticket` 里,这个线程是否陈述了关于客户的一条持久事实——"
"它应该改变客户未来、与这张工单无关的工单的处理方式?只数客户或支持人员"
"在 `request.ticket` 里写下的话。`jev_answered` 显示这张工单被如何路由,"
"可能依赖早先学到的东西:它说的或暗示的任何内容都不要数。】"
),
criteria=NoulCriteria(
true="【是:客户或支持人员在 `request.ticket` 里陈述了这张工单之后仍然为真的东西——如产品版本、操作系统、套餐、合同、长期偏好】",
false="【否:`request.ticket` 只有属于这张工单或这一刻的内容——如一次性请求、当天日程、碰巧在用的设备;或持久事实只出现在 `jev_answered` 里】",
),
),
}
# 必填项:state = as_memory() 配好的 {"request": 加记忆前的原始 state, "jev_answered": {问题 instructions: 答案文本}}
# 选填项:true/false 里的例子换成你领域「值得记 / 不值得记」的清单?
# 输出规范:response.answers["remember"].noul → 0–1 概率(Noul 无单独 confidence)
# 约束条件:
# ✅ 一道 Noul 只问「该不该记」;记多久、给谁看,是代码的事
# ✅ 官方英文原文最稳(见第 3 步);中文化先用你自己的数据验证再上线
# ❌ 不要数 `jev_answered`——通用答案会压过真事实,靠旧记忆得出的答案会被当新事实再存✅ تغليف الذاكرة والعتبة (نسخة ask_with_memory)
التأثير المتوقع: إحضار الذاكرة تلقائيًا قبل الاستدعاء وتمريرها عبر البوابة تلقائيًا بعده؛ بنفس المعاملات ونفس قيم الإرجاع مثل ask()، فيمكن استبدالها دون أي تعديل على الكود الحالي.
REMEMBER_AT = 【0.5】 # 多确定才记:官方给这道闸门的起点阈值
MEMORY_KEY = "【earlier_tickets_from_this_customer】" # 记忆放进 state 用的键名
MEMORIES: dict[str, list[dict]] = {} # 客户 ID -> 该客户的记忆列表
def ask_with_memory(state: dict, questions: dict) -> SystemOneResponse:
"""ask(), plus memory: same arguments, same return value."""
saved = MEMORIES.get(customer_id(state), [])
response = ask({**state, MEMORY_KEY: saved} if saved else state, questions)
memory = as_memory(state, questions, response)
if remember_probability(memory) >= REMEMBER_AT:
MEMORIES.setdefault(customer_id(state), []).append(memory)
return response
# 必填项:state 里必须有 customer.id——包装函数靠它找该客户的记忆列表
# 选填项:记忆长了加一道相关性问题,只挑子集并进 state?
# 输出规范:返回值与 ask() 完全相同——存没存记忆,调用方都不用管
# 约束条件:
# ✅ 先路由后闸门——闸门要看答案,只能在路由请求之后跑
# ✅ as_memory() 的 request 键存加记忆前的原始 state——旧记忆不会嵌套进新记忆
# ❌ 别把 MEMORIES 直接上线——内存字典进程退出就没了,官方 Next steps:换按客户 ID 键的数据库🔧 سؤال التوجيه الخاص بك (نسخة Choice)
التأثير المتوقع: سؤال Choice واحد يوجّه التذكرة إلى مجموعة فرق ثابتة؛none_suitable يمنح التذاكر التي يفتقر سياقها إلى الوضوح وجهة تذهب إليها.
ROUTE = {
"team": Choice(
instructions="【这张工单该哪个支持团队接?判断 `ticket`】",
criteria={
"【选项 ID】": "【选项描述:什么情况归这个团队】",
"none_suitable": "【以上团队都不适合这张工单】",
},
),
}
# 必填项:选项 map——ID 是代码读的,描述是 Jev 读的
# 选填项:官方 7 选项全集见第 2 步(cloud_ops / selfhosted_linux / selfhosted_windows / billing / enterprise_desk / general / none_suitable)?
# 输出规范:answers["team"].choice + probabilities(每个选项)+ confidence
# 约束条件:
# ✅ 列表可能不全时留 none_suitable(或 other)——上下文不足的工单有地方去
# ✅ 记忆进 state 后,这道题一个字不用改——Jev 读整个 state
# ❌ 不要在 instructions 里提「记忆」——记忆是 state 的事,不是问题的事نقطة تحقق ✅
- أستطيع ذكر مكوّنين لهذا النظام الذكي للذاكرة القائم على الذكاء الاصطناعي: بوابة Noul بعد الاستدعاء تحدد ما إذا كان يجب الحفظ (يُحفظ فقط عندما P ≥ 0.5)، وقبل الاستدعاء تُدمج التذاكر المحفوظة سابقًا لذلك العميل مع إجاباتها في state
- أعرف لماذا تحصي البوابة فقط ما كُتب في
request.ticket: الإجابات العامة تطغى على الحقائق الحقيقية، والإجابات المستنبطة من ذاكرة قديمة تُخزَّن مرة أخرى كحقائق جديدة - خمس تذاكر مبكرة: ثلاثة حُفظت واثنتان لم تُحفظ: الإصدار / الباقة / العقد 0.96–0.98 حُفظت، وهاتف المطار 0.02 والعطلة الرسمية 0.03 لم يُحفظا—T-102 وُجّهت إلى general ومع ذلك حُفظت
- تجربة المطابقة 3/6 ← 6/6: نفس عبارة «لوحة التحكم بطيئة»، C-1042 ذهبت إلى فريق Windows وC-2210 بقيت في الفريق السحابي؛ Jev المجردة كانت صحيحة في ثلاثة أسطر أصلًا، والذاكرة رفعت الاحتمال من 0.53 إلى 1.00
- من العواقب الخمسة أستطيع ذكر ثلاثة: طلبان متتاليان في كل استدعاء، وذاكرة تزداد فقط ولا تنقص، وstate تحتاج إلى customer.id (الاثنان الآخران: السؤال لا يذكر الذاكرة أبدًا، والإجابات المحفوظة تكرر الأخطاء)
تنبيهات من العثرات
❌ تحصي البوابة إجابة Jev ضمن العد
إذا أدخلت jev_answered في حساب «يستحق الحفظ»، فسيحدث أمران أشار إليه المسؤولون رسميًا: الإجابات العامة («General product questions: features, how-to, settings») ستطغى على حقائق العميل الحقيقية في الطلب—T-102 قد لا تُحفظ إذن؛ والإجابات المستنبطة من ذاكرة قديمة ستُخزَّن مرة أخرى كحقائق جديدة، فتتكاثر الذاكرة ذاتيًا.
الحل الرسمي مثبّت حرفيًا في تعليمات GATE: احصِ فقط ما كتبه العميل/موظف الدعم في request.ticket؛jev_answered مجرد سياق، وما تقوله أو توحي به لا يُحتسب.
❌ تريد توفير طلب واحد فتدمج البوابة في طلب التوجيه دون تفكير
تحتاج البوابة إلى رؤية «التذكرة + إجابة Jev»، والإجابة لا تتوفر إلا بعد طلب التوجيه—لذلك في العواقب الخمسة للخطوة 4، كان الأول «طلبان متتاليان في كل استدعاء». الاستثناء المذكور رسميًا: إذا كانت بوابتك لا تنظر إلى الإجابة، فيمكن تحويلها إلى سؤال ثانٍ في طلب التوجيه (تفريع تخميني، انظر الأسئلة المتوازية والتفريع التخميني).
فكّر أولًا إن كانت بوابتك تحتاج إلى رؤية الإجابة، ثم قرر ما إذا كنت ستدمجها.
❌ لا يوجد customer.id في state فتستبدل بالدالة المغلّفة
Jev المجردة تقبل state كسلسلة نصية بأي شكل؛لكن ask_with_memory() تعتمد على state["customer"]["id"] للعثور على قائمة ذاكرة ذلك العميل. قبل استبدال الدالة المغلّفة، تأكد من أن state لديك تحمل معرّف العميل.
❌ تشغيل ذاكرة العرض «تزداد فقط ولا تنقص» مباشرة في الإنتاج
ثلاثة «لا يوجد» كتبها المسؤولون بصراحة: لا يوجد حد للحجم، ولا فحص للصلة بالموضوع، ولا انتهاء صلاحية. كل ذاكرة تدخل كل استدعاء لاحق لذلك العميل—و«state كبيرة مليئة بتفاصيل غير ذات صلة» هي بالضبط نمط الفشل المعروف في Jev 1.13 دليل العثرات.
وهناك خطران آخران أشار إليهما المسؤولون بالاسم: التذاكر المحفوظة مرتبطة بإجاباتها، فالاستدلالات الخاطئة تُحمل معها باستمرار؛MEMORIES قاموس في الذاكرة، يختفي عند انتهاء العملية. حل المسؤولين في Next steps موجود في التقنيات المتقدمة.
تقنيات متقدمة (اختيارية)
ضبط REMEMBER_AT: طريقة المعايرة الرسمية. أول بند في Next steps الرسمي هو هذا: من حركتك، علّم مجموعة من أزواج «طلب + إجابة»، وقسّمها يدويًا إلى كومة «تستحق الحفظ» وأخرى «لا تستحق»، واختر الاحتمال الذي يفصل بين الكومتين بأوضح شكل كعتبة، ثم تحقق بالمجموعة التي لم تشارك في الاختيار. إذا كانت تكلفة الذاكرة المضللة عالية فارفع العتبة.
لماذا نقطة البداية الرسمية هي 0.5، وهي أكثر تساهلًا من «yes ≥ 0.7» في نقطة بداية Noul العامة؟ تعليق الكود يقول فقط إنها starting threshold (عتبة البداية)؛مبدأ Confidence هو أن العتبة تتدرج مع المخاطرة—حفظ ذاكرة فعل منخفض المخاطرة قابل للتراجع، و0.5 يكفي، وتُرفع عند عدم تكافؤ التكلفة. كما أعطى المسؤولون مرجعًا: نمط confidence-based routing.
عندما تكبر الذاكرة، مسار الترقية الرسمي ذو الخطوات الأربع. بقية Next steps أربعة بنود، طبّقها حسب الحاجة: ① أضف سؤالًا عن الصلة بالموضوع لاختيار مجموعة فرعية من الذاكرة الطويلة ودمجها في state؛② اسأل ما إذا كانت الذاكرة الجديدة تستبدل القديمة، واحذف في الكود الإدخالات المستبدلة؛③ استبدل MEMORIES بقاعدة بيانات مفهرسة بمعرّف العميل؛④ أضف ردود تطبيقك أيضًا إلى خيط التذكرة كرسائل دعم، وتحكم عليها البوابة معها.
إعادة تشغيل بلا مفتاح وحساب التكلفة. جميع الاستدعاءات مسجلة في json_cache.json المنشور رسميًا: بعد إزالة التكرار 31 استدعاءً (طلبات الاستكشاف المكررة تصيب نفس إدخال الكاش، وهذا سبب كون عدد الإدخالات أقل من عدد الاستدعاءات المنطقية)—19 استدعاء توجيه و12 استدعاء بوابة؛بإجمالي 21,456 token إدخال و1,752 token إخراج. بسعر $42/Btok للإدخال والإخراج مجاني، تكلفة الصفحة كاملة حوالي $0.0009.
إذا أردت تجربة استدعاء توجيه واحد مع الذاكرة فقط: في أسفل صفحة cookbook الرسمية يوجد رابط مشاركة Playground جاهز—يحمل state وقت استدعاء C-1042 الأول للوحة التحكم البطيئة (بما فيها ذاكرتا T-101 وT-105 المحفوظتان حينها) + سؤال التوجيه، افتحه وعدّل في المتصفح مباشرة:
افتح في TypeSafe playground تذكرة C-1042 وذاكرتها →
أنتجته الخلية الرسمية الأخيرة: make_playground_link(example_state, ROUTE)—نفس نسخة state التي التُقطت في الخطوة 6.
أدخِله في تطبيقك. أصبح GATE وROUTE ملكك أنت، والدالة المغلّفة انسخها كما هي. إذا كنت تستخدم Claude Code، ثبّت TypeSafe Agent Skill ثم سلّم هذه الصفحة إليه:
claude plugin marketplace add typesafe-ai/skills
claude plugin install typesafe@typesafe-aiيوصي المسؤولون بتجميع الأسئلة وثوابت العتبة في ملف واحد لتسهيل المراجعة البشرية—صياغة GATE وREMEMBER_AT هما «السياسة» لديك في موضعين، وكل تعديل ينبغي أن يمر بمراجعة الكود.
خلاصة الدرس
✅ نظام ذاكرة ذكي واحد = مكوّنان: بوابة Noul بعد الاستدعاء (يُحفظ فقط عندما P ≥ 0.5)، وقبل الاستدعاء تُدمج التذاكر المحفوظة لذلك العميل مع إجاباتها في state—ask_with_memory() وask() بنفس المعاملات ونفس قيم الإرجاع، والاستبدال لا يتطلب تعديل أي كود آخر.
✅ «ماذا نحفظ» سؤال صريح: GATE تحصي فقط ما كتبه العميل/موظف الدعم في الطلب؛ما يستحق الحفظ 0.96–0.98 وما لا يستحق ≤ 0.04—المجموعتان متباعدتان، لذلك يجرؤ خط 0.5 على الرسم.
✅ قياس رسمي موثق: باستخدام Jev مجردًا (بلا ذاكرة)، تذاكر المتابعة 3/6 صحيحة؛ مع الذاكرة 6/6 كلها وصلت إلى الفريق المتوقع. لوحة المؤشرات البطيئة 0.55 فريق السحابة → 0.98 فريق Windows؛ إضافة مقعد 0.53 → 1.00؛ كلتا حالتي none_suitable تم إنقاذهما.
✅ الحدود واضحة: كل استدعاء يتضمن طلبين متتاليين؛ الذاكرة تزيد فقط ولا تنقص؛ السؤال لا يذكر الذاكرة أبدًا؛ يحتاج state إلى customer.id؛ الإجابات المخزنة ستكرر الأخطاء.
مراجعة حقول الإعداد الرئيسية:
| الحقل | قيمة هذه الصفحة | الشرح |
|---|---|---|
REMEMBER_AT | 0.5 | عتبة نقطة البداية لحفظ الذاكرة، النص الأصلي في التعليق الرسمي: starting threshold |
MEMORY_KEY | earlier_tickets_from_this_customer | اسم المفتاح الذي تدخل به الذاكرة إلى state؛ يقرأ Jev الـ state بالكامل، فلا حاجة لتغيير السؤال |
TYPESAFE_MODEL | jev-1.14.0 | الإصدار الذي سجّل به الفريق الرسمي الأرقام؛ في التشغيل المباشر ثبّت معرّف إصدارك الخاص |
MEMORIES | dict[str, list[dict]]، قاموس في الذاكرة حسب معرّف العميل | يضيع عند خروج العملية؛ عند الإطلاق استبدله بقاعدة بيانات |
| نوع سؤال العتبة | Noul (بدون confidence منفصل) | تُضبط العتبة مباشرة على P(yes)؛ لتوحيد المقياس مع الأنواع الأخرى، احسب بنفسك «القيمة المطلقة لـ 2p − 1» |
| شكل state | customer (يشمل id) + ticket | تعتمد دالة التغليف على customer.id للعثور على قائمة الذاكرة |
دروس ذات صلة:
- قرارات الـ Agent: اختيار المهارات والتحويل إلى استدعاء دوال——الدرس السابق: نفس بنية الطلبين من نوع «يجب أن يحصل الكود على الإجابة السابقة قبل إرسال الطلب التالي»
- فرز فقرات RAG: إدخال المحتوى ذي الصلة فقط إلى السياق——مشكلة من العائلة نفسها: الفرز يحدد «ما يدخل إلى السياق»، وهذه الصفحة تحدد «ما يدخل إلى state»، وكلاهما سؤال واحد + عتبة في الكود الخاص بك
- Confidence درجة الثقة——اقرأه قبل ضبط REMEMBER_AT: العتبة تتدرج مع حجم المخاطرة
استعراض الدرس التالي
بهذا ينتهي المسار B (تطبيقات LLM والـ Agent). يبدأ الدرس التالي المسار C (المستندات والبيانات): استخراج القيم: التواريخ والبريد الإلكتروني والهاتف والمبالغ.
ستتعلم:
- التواريخ: اسأل المستند عن الأجزاء (مطلق أم نسبي)، ثم يحلل الكود ويتحقق، ثم confidence للمراجعة
- البريد الإلكتروني والهاتف والمبالغ: التعبير النمطي يجمع المرشحين أولًا، ثم Jev يختار الصحيح منها، ثم يقوم الكود بالتطبيع
- نفس العادة الموجودة في هذه الصفحة: صحة الاستخراج لا تعتمد على وعي النموذج، بل على أسئلة ذات أنواع محددة + تحقق في الكود