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

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

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

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

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

الوقت المقدر: 15 دقيقة

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

قبل البدء، تأكد من أن لديك الموارد والأذونات التالية:

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

ابدأ من تحقيق

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

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

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

Investigate high memory usage on our container apps

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

أنشئ دليل من التحقيق

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

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. يحفظ المستند في إعدادات المعرفة ويؤكد الرفع.

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

في هذه المرحلة، أكد المعلومات التالية:

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

تحقق في إعدادات المعرفة

اذهب إلى إعدادات المعرفة للتأكد من أن مستندك مفهرس.

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

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

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

رفع ملف عبر البوابة

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

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

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

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

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

تأكد من أن الوكيل يمكنه العثور على المستندات المرفوعة واستخدامها.

1. اختر موضوع محادثة جديد في الشريط الجانبي.
2. اطرح سؤالا يجب أن تجيب عليه المستندات المرفوعة.

على سبيل المثال:

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

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

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

لإزالة مستند من إعدادات المعرفة، استخدم الخطوات التالية.

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

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

ملحوظة

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

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

استخدم الجدول التالي لحل المشكلات الشائعة المتعلقة برفع مستندات المعرفة.

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

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

مورد	الوصف
رفع مستندات المعرفة	كيف يعمل رفع مستندات المعرفة ولماذا يهم.
المهارات	كيف تتعاون المهارات والمعرفة.
Azure DevOps Repos connector	ربط محتوى الويكي الحي كمصدر معرفة.