الدرس التعليمي: رفع مستندات المعرفة في Azure SRE Agent

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

في هذا البرنامج التعليمي، تتعلم كيفية:

• حول التحقيق إلى كتاب تشغيل قابل لإعادة الاستخدام واحفظه في إعدادات المعرفة
• تحقق من أن المحتوى المرفوع مفهرس وقابل للبحث
• رفع الملفات أو المجلدات الفردية عبر البوابة
• اختبر أن وكيلك يمكنه استرجاع المحتوى المرفوع في محادثة جديدة

الوقت المقدر: 10 دقائق

المتطلبات المسبقه

• وكيل Azure SRE في حالة التشغيل
• أذونات الكتابة على الوكيل
• وضع تشغيل الوكيل مضبوط على المراجعة أو الوضع الذاتي

الخطوة 1: ابدأ من تحقيق

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

1. اذهب إلى sre.azure.com واختر وكيلك.
2. في الشريط الجانبي الأيسر تحت قسم الدردشات، ابحث عن موضوع تحقيق سابق - أي محادثة قام فيها وكيلك بتشخيص أو حل مشكلة - واختر ذلك.

إذا لم يكن لديك موضوع تحقيق بعد، ابدأ محادثة جديدة واطلب من وكيلك التحقيق في أمر ما:

Investigate high memory usage on our container apps

انتظر حتى يكتمل التحقيق، ثم تابع الخطوة 2.

الخطوة 2: اطلب من وكيلك إنشاء دفتر تشغيل

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

Create a runbook from the investigation we just did. Include the root cause
analysis, the diagnostic steps, mitigations, and escalation triggers.
Save it to Knowledge settings as high-memory-runbook.md

وكيلك:

1. يجمع سياق التحقيق في دليل تشغيل منظم.
2. تولد أقسام مثل تحليل السبب الجذري، خطوات التشخيص، التخفيفات، ومحفزات التصعيد.
3. يحفظ المستند في إعدادات المعرفة ويؤكد الرفع.

يؤكد الوكيل أن الوثيقة تم حفظها ويوفر رابط تحميل. الآن يتم تخزين دفتر التشغيل الخاص بك في إعدادات المعرفة ويتم فهرسته للبحث.

نقطة التحقق

• أنشأ العميل دليل عمل منظم من التحقيق.
• أكد العميل أن الوثيقة محفوظة.

الخطوة 3: التحقق في إعدادات المعرفة

1. في الشريط الجانبي الأيسر، اختر Builder لتوسيع القسم.
2. اختر إعدادات المعرفة.

تعرض صفحة إعدادات المعرفة مستنداتك في جدول يحتوي على أعمدة لاسم الملف، الحالة، النوع، وآخر تعديل. يظهر عمود الحالة✓ مفهرس عندما يكون المستند مفهرسا وجاهزا للبحث.

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

نقطة التحقق

• التنقل إلى إعدادات المعرفة → Builder
• يظهر المستند بحالة ✓ مفهرسة

الخطوة 4: رفع الملفات عبر البوابة

يمكنك رفع ملفات فردية أو مجلدات كاملة مباشرة. هذه الطريقة مفيدة لدفاتر التشغيل الموجودة، أو الوثائق، أو المواد المرجعية التي يملكها فريقك بالفعل.

رفع الملفات الفردية

1. في صفحة مصادر المعرفة ، اختر إضافة ملف.
2. اسحب ملفا إلى منطقة الإسقاط، أو اختر تصفح الملفات لاختيار واحد.
3. اختر إضافة ملف للرفع.

رفع مجلد

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

1. في صفحة مصادر المعرفة ، اختر إضافة ملف.
2. اسحب مجلدا من مدير الملفات مباشرة إلى منطقة الإسقاط.
3. تقوم البوابة باستخراج جميع الملفات المدعومة من المجلد ومجلداته الفرعية، ثم تعرضها في مربع الحوار.
4. راجع قائمة الملفات - قم بإزالة أي ملفات لا تريدها باختيار أيقونة الحذف بجانب كل ملف.
5. اختر إضافة ملف لرفع جميع الملفات المدرجة.

تقوم البوابة تلقائيا بتصفية الملفات التي تحتوي على امتدادات غير مدعومة. للاطلاع على القائمة الكاملة للإضافات المدعومة وحدود الحجم، راجع صفحة قدرات رفع مستندات المعرفة.

الحد الأقصى لحجم الملف هو 16 ميجابايت لكل ملف، مع ما يصل إلى 100 ميجابايت لكل رفع.

ملحوظة

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

نقطة التحقق

• اخترت إضافة ملف ورأيت مربع حوار الرفع.
• رفعت ملفا أو سحبت مجلدا بنجاح.
• تظهر الملفات في مصادر المعرفة بحالة ✓ مفهرسة .

الخطوة 5: استرجاع الاختبار في محادثة جديدة

ابدأ موضوع دردشة جديد واسأل سؤالا يجب أن تجيب عليه المستندات المرفوعة:

What are the steps for troubleshooting high memory usage on container apps?

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

نقطة التحقق

• بدأت موضوع دردشة جديد
• طرح سؤالا يتعلق بالمحتوى المرفوع
• أشار الوكيل إلى المستند المرفوع في رده

حذف وثيقة معرفة

1. اذهب إلى إعدادات المعرفة → Builder.
2. في قائمة المستندات، اختر مستندا أو أكثر باستخدام مربعات الاختيار.
3. حدد حذف في شريط الأدوات.
4. يعرض مربع التأكيد المستندات التي يجب إزالتها. حدد حذف للتأكيد.

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

ملحوظة

لا يمكنك تعديل مستندات المعرفة في مكانها. لتحديث مستند، قم برفع نسخة جديدة تحمل نفس اسم الملف. النسخة الجديدة تحل محل النسخة السابقة.

ما تعلمته

• يمكن لوكيلك تحويل التحقيقات الحقيقية إلى دفاتر تشغيل منظمة وحفظها في إعدادات المعرفة.
• يمكنك رفع الملفات يدويا من خلال واجهة البوابة في إعدادات Builder → Knowledge. يدعم العديد من الصيغ، بما في ذلك PDF، ومستندات Office، والصور.
• يقوم النظام بفهرسة المستندات المرفوعة للبحث الدلالي، وهي متاحة في جميع المحادثات المستقبلية.
• لتحديث المستندات، قم برفعها باستخدام نفس اسم الملف.

استكشاف الأخطاء وإصلاحها

خطأ	السبب	إصلاح
"ذاكرة العميل معطلة. لا يمكن رفع المستندات."	إعدادات المعرفة غير مفعلة على وكيلك	تواصل مع المسؤول الخاص بك لتفعيل إعدادات المعرفة
"ليس لدي وصول كتابي إلى إعدادات المعرفة الخاصة بك"	لم يتمكن العميل من تحديد أداة الرفع	أعد صياغة طلبك: "احفظها في إعدادات المعرفة كما filename.md"
"امتداد ملف غير صالح. يسمح فقط بملفات .md وملفات .txt."	اسم الملف لا ينتهي في .md أو .txt (رفع الدردشة)	استخدم إضافة أو .md.txt عند طلب حفظ الوكيل
"محتوى المستند يتجاوز الحد الأقصى للحجم البالغ 16 ميجابايت"	المحتوى أكبر من أن يكون مستندا واحدا	مقسمة إلى عدة مستندات أصغر
"لا يمكن أن يكون اسم الملف فارغا"	لم يتم توفير اسم ملف	أدرج اسم ملف في الطلبات (مثلا، runbook.md)

مرتبط‬

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