نظام الذاكرة في معاينة وكيل SRE

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

مكونات الذاكرة

يتكون نظام الذاكرة من أربعة مكونات مكملة:

المكون	الغرض	Setup	الأفضل ل
ذكريات المستخدم	أوامر الدردشة السريعة لمعرفة الفريق	فوري (أوامر الدردشة)	معايير الفريق، تكوينات الخدمات، أنماط سير العمل
قاعدة المعرفة	رفع المستندات المباشرة لسجلات التشغيل	كويك (رفع الملف)	دفاتر التشغيل الثابتة، أدلة استكشاف المشكلات، التوثيق الداخلي
موصل الوثائق	تزامن Azure DevOps الآلي	التَكوين مطلوب	وثائق حية، أدلة يتم تحديثها باستمرار
رؤى الجلسة	الذكريات التي يولدها الوكيل من الجلسات	تلقائي	تعلمت أنماط استكشاف المشاكل، وحلول الحوادث السابقة

كيف يستعيد الوكلاء الذاكرة

خلال المحادثات، يقوم الوكلاء باسترجاع المعلومات من مصادر الذاكرة عبر أدوات معدلة.

تكوين الأدوات

تقوم الأداة SearchMemory باسترجاع جميع مكونات الذاكرة. يبحث عبر ذاكرة المستخدم، وقاعدة المعرفة، ورؤى الجلسة، وموصل التوثيق في نفس الوقت.

• وكيل SRE (الافتراضي): SearchMemory مدمج
• وكلاء فرعية مخصصة: أضف SearchMemory أداة إلى إعدادك

مهم

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

معلمات بحث محسنة

تدعم الأداة SearchNodes خيارات التصفية للبحث الأكثر استهدافا:

المعلمة‬	نوع	‏‏الوصف
entityType	خيط	تصفية النتائج حسب نوع الكيان، مثل Incident، Service، أو Resource.
includeNeighbors	منطقي	تضمين العقد المتصلة في نتائج البحث.

مثال:

Search for all incidents related to "database timeout" and include connected resources

عندما تعدين includeNeighbors إلى true، فإن البحث يعيد ليس فقط العقد الساقطة المتطابقة بل أيضا العقد المتصلة بها:

• Resources
• الخدمات
• الأحداث ذات الصلة
• الوثائق المرتبطة

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

بداية سريعة

ابدأ بتأسيس المعرفة الأساسية بذاكرة المستخدم، ثم توسع ليشمل تخزين المستندات والمزامنة الآلية مع تزايد احتياجاتك.

1. ابدأ بذكريات المستخدم

استخدم أوامر الدردشة لحفظ المعرفة الفورية بالفريق:

#remember Team owns services: app-service-prod, redis-cache-prod, and sql-db-prod

#remember For latency issues, check Redis cache health first

#remember Production deployments happen Tuesdays at 2 PM PST

هذه الحقائق متاحة الآن في جميع المحادثات.

2. رفع المستندات الرئيسية

أضف كتيبات السلسلة والأدلة الحرجة إلى قاعدة المعرفة:

1. افتح وكيل SRE الخاص بك في بوابة Azure.

2. اذهب إلىقاعدة معرفة>.

3. اختر إضافة ملف أو سحب وإفلات الملفات في منطقة الرفع.

4. ملفات أو .md.txt رفع (حتى 16 ميجابايت لكل ملف).

5. يقوم النظام بفهرسة الملفات وجعلها متاحة لاسترجاع من خلال SearchMemory.

3. رؤى جلسات المراجعة

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

4. ربط المستودعات (اختياري)

للفرق التي لديها وثائق موجودة في Azure DevOps:

1. اذهب إلى إعدادات>موصلات.

2. اختر إضافة موصل واختر موصل التوثيق.

3. أدخل عنوان مستودع Azure DevOps الخاص بك واختر هوية مدارة.

   يبدأ الموصل في الفهرسة تلقائيا.

ذكريات المستخدم

تتيح لك ذاكرة المستخدم حفظ حقائق الفريق والمعايير والسياق الذي يتذكره الوكلاء خلال جميع المحادثات. باستخدام أوامر الدردشة البسيطة (#remember, #forget, #retrieve), يمكنك بناء قاعدة معرفة دائمة تعزز تلقائيا استجابات الوكلاء.

أوامر الدردشة

احفظ المعلومات باستخدام #remember

احتفظ بالحقائق أو المعايير أو السياق لمحادثات مستقبلية.

إعراب:

#remember [content to save]

أمثلة:

#remember Team owns app-service-prod in East US region
#remember For app-service-prod latency issues, check Redis cache health first
#remember Team uses Kusto for logs. Workspace is "myteam-prod-logs"

يقوم النظام بتضمين المحتوى باستخدام OpenAI، ويخزنه في Azure الذكاء الاصطناعي Search، ويجعله متاحا للاسترجاع التلقائي عبر جميع المحادثات. ترى تأكيدا: ✅ Agent Memory saved.

إزالة الذكريات باستخدام #forget

احذف الذكريات المحفوظة سابقا بالبحث عنها.

إعراب:

#forget [description of what to forget]

أمثلة:

#forget NSG rules information
#forget production environment location

النظام يبحث دلاليا في ذاكرتك عن أفضل تطابق، ويعرض لك المحتوى، ثم يحذفه. ترى تأكيدا: ✅ Agent Memory forgotten: [deleted content]

استعلام الذكريات باستخدام #retrieve

ابحث وعرض الذكريات المحفوظة بشكل صريح دون تحفيز تفكير الوكيل.

إعراب:

#retrieve [search query]

أمثلة:

#retrieve production environment
#retrieve deployment process

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

النطاق والتخزين

• مشترك عبر الفريق: جميع مستخدمي وكيل SRE يمكنهم الوصول إليه.

• استمر في جميع المحادثات: احفظها مرة واحدة، وستصبح متاحة للأبد.

• يتم استرجاعها تلقائيا عند الضرورة: يقوم العملاء بالبحث في الذكريات دلاليا أثناء التفكير.

قاعدة المعارف

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

أنواع الملفات المعتمدة وحدودها

• الصيغ:.md (تخفيض السعر، موصى)، .txt (نص عادي)
• لكل ملف: الحد الأقصى 16 ميجابايت (حد البحث في Azure الذكاء الاصطناعي)
• لكل طلب: 100 ميجابايت إجمالا لجميع الملفات في رفع واحد

تحميل المستندات

1. اذهب إلىقاعدة معرفة>.

2. اختر إضافة ملف أو سحب وإفلات الملفات في منطقة الرفع.

   تقوم البوابة تلقائيا بالتحقق من صحة الملفات ورفعها وفهرستها.

الرفع عبر أداة الوكيل

يمكن للوكيل رفع المستندات مباشرة إلى قاعدة المعرفة باستخدام الأداة UploadKnowledgeDocument . تكون هذه الطريقة مفيدة عندما:

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

الأداة: UploadKnowledgeDocument

المعلمة‬	نوع	مطلوب	‏‏الوصف
fileName	خيط	نعم	اسم الملف مع امتداد (على سبيل المثال، runbook-database-issues.md). لابد أن يكون .md أو .txt.
content	خيط	نعم	محتوى المستند الكامل بنص عادي أو بصيغة ماركداون.
triggerIndexing	منطقي	لا	تفعيل الفهرسة الفورية (الافتراضي: true). ضبطه على false التحميل الدفعي.

مثال على الاستخدام:

اسأل الوكيل:

"احفظ خطوات استكشاف الأخطاء لمشكلة انتهاء وقت قاعدة البيانات في قاعدة المعرفة"

يستخدم UploadKnowledgeDocument الوكيل ل:

1. أنشئ مستندا باسم ملف مناسب.
2. قم بتنسيق المحتوى في Markdown.
3. رفع المستند إلى Azure Blob Storage.
4. تفعيل الفهرسة لإمكانية البحث الفوري.

القيود:

• الحد الأقصى لحجم الملف: 16 ميجابايت.
• الإضافات المدعومة: .md وفقط .txt .
• إذا كان هناك مستند بنفس اسم الملف، يقوم الوكيل بالكتابة فوقه.

معالجة الأخطاء:

خطأ	الحل
"ذاكرة الوكيل معطلة"	تفعيل ذاكرة الوكيل في الإعدادات.
"امتداد ملف غير صالح"	الاستخدام .md أو .txt التمديد فقط.
"محتوى المستند يتجاوز الحد الأقصى للحجم"	قسم المستندات الكبيرة إلى ملفات أصغر.

إدارة المستندات

• عرض: اذهب إلىقاعدة المعرفة في> لرؤية جميع المستندات المرفوعة.

• تحديث: لاستبدال النسخة السابقة، قم بتحميل ملف بنفس الاسم.

• حذف: اختر المستندات واستخدم إجراء الحذف. تدخل التغييرات حيز التنفيذ فورا.

رؤى الجلسة

بينما يتعامل الوكيل مع حوادثك، يتعلم. تلتقط رؤى الجلسة ما نجح وما لم ينجح، والمستفادات الرئيسية من كل جلسة. يقوم الوكيل تلقائيا بتطبيق تلك المعرفة للمساعدة في مشاكل مماثلة في المستقبل.

التحسين التلقائي

يتعلم الوكيل من كل جلسة دون أي جهد يدوي:

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

والنتيجة: يتحسن الوكيل مع مرور الوقت، مما يقترح حلولا مثبتة ويتجنب الأخطاء المعروفة.

اكتشف الفرص

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

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

فكر في رؤى الجلسات كنافذة لما يتعلمه الوكيل. قد تجد شيئا يستحق التصرف، أو قد تترك الوكيل يتولى أي مشاكل ظهرت.

طريقة العمل

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

ما يلتقطه العميل

يلتقط الوكيل سلسلة من نقاط البيانات من كل جلسة لتحسين استكشاف الأخطاء المستقبلية.

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

عندما يتم توليد رؤى

يقوم النظام بتوليد رؤى تلقائيا بعد انتهاء المحادثات، أو يمكنك طلبها عند الطلب.

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

تصفح الرؤى

اذهب إلىتحليلات جلسة> لترى ما تعلمه الوكيل:

• إجمالي العدد في الرأس
• قائمة الرؤى مع عنوان الجلسة والطابع الزمني
• عرض التفاصيل مع أقسام الجدول الزمني وأداء الوكلاء القابلة للتوسيع
• اذهب إلى Thread لإعادة النظر في المحادثة الأصلية

إشعار

بينما قد يظهر التصفح اليدوي الدوري للرؤى أنماطا متكررة تستحق المعالجة، يستفيد الوكيل من هذه الرؤى سواء راجعتها أم لا.

هيكل البصيرة

كل رؤية تشمل:

• الجدول الزمني: المعالم الزمنية لجلسة استكشاف الأخطاء (حتى ثمانية)
• أداء الوكلاء: ما الذي سار بشكل جيد، مجالات للتحسين، ونقاط التعلمات الرئيسية
• درجة جودة التحقيق: تقييم 1-5 لاكتمال التحقيق

المحتويات ذات الصلة

• موصل الوثائق