بنية الوكلاءالمهارات العامة

Session Memory Management

حالة الجلسة المطبقة — تخزين/استرجاع السياق، إعادة تشغيل اللقطات، استئناف سير العمل المتوقف، وحجب البيانات الحساسة عند الانتهاء.

افتح مصدر المهارة اقرأ الدليل الرسمي ↗

ما تعلمه هذه المهارة

دليل قابل لإعادة الاستخدام لنوع معين من العمل.

يخبر خادم MCP الوكيل بالإجراءات المتاحة. تضيف المهارة الحكم حول تلك الإجراءات: كيفية التعرف على المهمة، التسلسل الذي يجب اتباعه، ما يجب تجنبه، وكيفية تحديد اكتمال النتيجة.

إدارة حالة الجلسة والذاكرة — تخزين/استرجاع بيانات مكتوبة النوع، إعادة تشغيل اللقطات، استئناف تدفقات العمل المتقطعة، وحجب المعلومات الحساسة. استخدم عند حفظ السياق، استئناف تدفقات العمل، استدعاء بيانات سابقة، إدارة الذاكرة عبر الجلسات، أو تنظيف الحالة الحساسة.

الهيكلية

كيف يوجه Session Memory Management وكيل ADK-Rust.

تبقى المهارة قابلة للقراءة وقابلة للنقل لأنها تحتوي على تعليمات بدلاً من بيانات اعتماد الخدمة أو بيانات العمل. يوفرها ADK-Rust للوكيل، يختار الوكيل من حدود الأدوات المراجعة، ويؤدي خادم MCP المتصل العملية المصادق عليها.

طلب المستخدم

يتلقى الوكيل هدفًا معبرًا عنه بلغة عادية.

→

مهارة Session Memory Management

يطابق النية، يزود دليل القرار، ويضيق حدود الأداة.

→

وكيل ADK-Rust

يخطط سير العمل ويبث كل خطوة ذات معنى عبر بيئة التشغيل.

→

mcp-session-memory

ينفذ العمليات المصادق عليها ضد النظام الذي يمتلك القدرة.

→

النتيجة الموثوقة

تشكل قواعد إكمال المهارة الأدلة التي تُعاد إلى المستخدم.

تعليمات محمولة: SKILL.md · حدود القدرة: mcp-session-memory · الأدوات المسموح بها: 10

دليل القرار

كيف يحول الوكيل الطلب إلى الإجراء الصحيح.

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

"تذكر"، "تخزين"، "حفظ"؟

تخزين الذاكرة

"استرجاع"، "ما كان"، "آخر مرة"؟

استرجاع الذاكرة / قائمة مراجع الذاكرة

"استئناف"، "الاستمرار من"، "متابعة"؟

استئناف الجلسة / إنشاء لقطة إعادة تشغيل

"نسيان"، "حذف"، "حجب"؟

حذف الذاكرة / حجب الذاكرة

"جلسة"، "أحداث"، "تاريخ"؟

الحصول على حالة الجلسة / قائمة أحداث الجلسة

سير عمل مثبتة

تسلسلات قابلة للتكرار لنتائج مفيدة.

يربط سير العمل عدة استدعاءات أدوات في مهمة يتعرف عليها المستخدم فعليًا. تشرح المهارة التسلسل والنتيجة المقصودة بينما يقوم ADK-Rust ببث تقدم الوكيل عبر بيئة التشغيل المشتركة.

011 استدعاء

تخزين

حفظ البيانات المطبقة مع مدة صلاحية

021-2 استدعاء

استدعاء

استرجاع حسب المفتاح/النطاق

032 استدعاء

استئناف

لقطة → تحقق → متابعة

041 استدعاء

حجب

إزالة البيانات الحساسة

حدود الأداة

قد تستخدم المهارة 10 أدوات موثقة.

يتم إعلان هذه القائمة المسموح بها من قبل المهارة. تحافظ على تركيز الوكيل على الإجراءات اللازمة لهذه المهمة بينما يحتفظ mcp-session-memory بالمسؤولية عن المصادقة، التحقق، والنظام المتصل.

get_session_state

list_session_events

retrieve_memory

store_memory

update_memory

delete_memory

redact_memory

list_memory_refs

create_replay_snapshot

resume_session

قواعد العمل

ما الذي يجب على الوكيل القيام به.

حدد TTL على كل حالة مخزنة (لمنع النمو غير المحدود)
تحقق من حداثة البيانات قبل استئناف تدفقات العمل
احجب البيانات الحساسة (المعلومات الشخصية، بيانات الاعتماد) بعد الاستخدام
حدد نطاق الوصول للذاكرة (الوكلاء يرون بياناتهم فقط)

حدود التشغيل

ما الذي يجب على الوكيل تجنبه.

لا تخزن بيانات الاعتماد في ذاكرة الجلسة (استخدم الخزنة)
لا تستأنف دون التحقق من تغير الحالة الخارجية
لا تحتفظ بالذاكرة إلى أجل غير مسمى دون TTL

التثبيت والاتصال

أضف المهارة بجانب القدرة التي تتوقعها.

ثبت المستودع حيث يمكن لمحمّل مهارات ADK-Rust اكتشافه، اتصل بـ mcp-session-memory، وتأكد من توفر الأدوات المعلنة قبل طلب الوكيل استخدام سير العمل.

ثبت المهارة

git clone https://github.com/zavora-ai/skill-session-memory-management.git \
  ~/.skills/skills/session-memory-management

شكل تحميل ADK-Rust

let skills = SkillLoader::from_dir("~/.skills/skills").await?;
let skill = skills.load("session-memory-management").await?;

let agent = LlmAgentBuilder::new("agent")
    .instruction(skill.instructions())
    .tools(skill.allowed_tools(toolset)?)
    .build()?;

بيان التوافق الخاص بالمستودع: يتطلب اتصال بخادم mcp-session-memory.

الوثائق الرسمية

اقرأ حزمة المهارة الكاملة.

يبقى المستودع هو المرجع الدقيق لتعليماته، أمثلته، سكريبتات المساعدة، الأصول، متطلبات MCP، الترخيص، والتحديثات اللاحقة.

نظرة عامة ↗README.md تعليمات المهارة ↗SKILL.md تدفقات عمل عبر Mcp ↗references/cross-mcp-workflows.md أمثلة ↗references/examples.md تسلسلات الأدوات ↗references/tool-sequences.md التحقق من الحداثة ↗scripts/check_freshness.py تقرير الجلسة ↗assets/session-report.md

استمر في الاستكشاف