مشاركة عبر


Upload knowledge documents to Azure SRE Agent

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

نصيحة

وكيلك ينشئ ويرفع دفاتر التشغيل أثناء المحادثات بدون إدارة ملفات يدوية. أرفق 31 نوعا من الملفات في الدردشة، بما في ذلك .kql، .bicep، .tf، ، .har.py، و .xlsx، لتحليل فوري في سياق التحليل. قم برفع 28 نوعا من الملفات إلى إعدادات المعرفة لتخزين مستمر ومفهرس عبر جميع المحادثات المستقبلية. تصبح حلول الحوادث معرفة مؤسسية تلقائيا.

كيف يلتقط وكيلك المعرفة

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

Create a runbook from the steps we just followed to fix this database
connection pool exhaustion issue and save it to Knowledge settings.

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

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

قبل وبعد

يقارن الجدول التالي سير عمل التقاط المعرفة قبل وبعد استخدام أداة رفع وثيقة المعرفة .

المساحة قبل بعد
التقاط المعرفة بعد الحادث: المهندس يكتب كتاب السلسلة (ربما) وكيلك يلتقط الحدث فور حدوثه
حان وقت التوثيق 30-60 دقيقة لكتابة دليل التمارين الثواني: وكيلك يقوم بإنشاء ورفع الملفات داخل الخط
نضارة المعرفة دفاتر السلسلة تصبح قديمة خلال أسابيع تنمو إعدادات المعرفة مع كل قرار
امكانيه الوصول المعرفة عالقة في رأس المهندس أو موضوع الدردشة يمكن للبحث عنه من قبل وكيلك في جميع المحادثات المستقبلية
اتساق التنسيق يختلف الأمر حسب المؤلف توثيق منظم ومتسق في كل مرة

ما الذي يجعل هذا النهج مختلفا

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

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

على عكس موصلات الويكي، المستندات المرفوعة لا تتطلب خدمات خارجية. المعرفة موجودة مباشرة في إعدادات المعرفة الخاصة بوكيلك، متاحة فورا دون تأخير في المزامنة.

طريقة العمل

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

المعلمة مطلوب الوصف
اسم الملف ‏‏نعم‬ اسم مع .md أو .txt امتداد (على سبيل المثال، database-pool-runbook.md)
محتوى ‏‏نعم‬ نص المستند الكامل بصيغة ماركداون أو النص العادي
فهرسة الزناد اختياري (افتراضي: true) ما إذا كان يجب جعل المستند قابلا للبحث فورا

عندما يرفع وكيلك مستندا:

  1. يقوم الوكيل بالتحقق من اسم الملف والمحتوى (الحد الأقصى 16 ميجابايت لكل ملف).
  2. يقوم الوكيل بتخزين المستند في إعدادات المعرفة الخاصة بوكيلك.
  3. يقوم الوكيل بفهرسة المحتوى للبحث الدلالي.
  4. يؤكد الوكيل الرفع برسالة نجاح.

ملحوظة

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

تنسيقات الملفات المدعومة

يتعامل وكيلك مع الملفات بثلاث طرق، كل منها يدعم صيغ مختلفة.

مرفقات الدردشة

اسحب الملفات إلى أي دردشة لإعطاء وكيلك سياقا فوريا للتحليل، بما في ذلك سكريبتات استكشاف الأخطاء، وملفات التكوين، ومسارات الشبكة، والمزيد.

الفئة Extensions
Images .png، .jpg، .jpeg، .gif، ، .webp.svg
الوثائق .txt، .md، .pdf، .docx، ، .pptx.xlsx
البيانات والتكوين .json، ، .csv.log، .yaml، .yml، .xml، .ini، ، .conf،.env
الويب والشبكة .html، .har
الشيفرة والنصوص .ts، .js، .py، .sh، ، .sql.kql
بنية تحتية .bicep، .tf

الحدود: 10 ميجابايت لكل ملف · 50 ميجابايت إجمالا لكل رسالة · 5 ملفات لكل رسالة

إعدادات المعرفة المثبتة

قم بتحميل الملفات من خلالإعدادات>Builder> Knowledgeأضف ملفا لمستندات الاستمرار ليستخدمها وكيلك في المحادثات المستقبلية. يقوم النظام بفهرسة الملفات المرفوعة للبحث الدلالي.

الفئة Extensions
Images .png، .jpg، .jpeg، .gif، .webp، .bmp، ، .tiff، .tif
الوثائق .txt، ، .md.pdf، .docx، .pptx، .xlsx، .doc، ، .ppt،.xls
البيانات والتكوين .json، .csv، .log، .yaml، .yml، .xml، .ini، .conf، .cfg، ، ، ، .config.properties

الحدود: 16 ميجابايت لكل ملف · 100 ميجابايت لكل رفع

ملحوظة

تحميلات إعدادات المعرفة تقبل صيغ Office القديمة (.doc, .ppt, .xls) وصيغ الصور الإضافية (.bmp, .tiff, .tif) التي لا تقبلها مرفقات الدردشة. مرفقات الدردشة تدعم الكود والسكريبتات والبنية التحتية وصيغ الويب التي لا تدعمها إعدادات المعرفة.

المستندات التي يولدها الوكيل

عندما يقوم وكيلك بإنشاء مستندات أثناء المحادثات (باستخدام أداة رفع وثيقة المعرفة )، يقوم .md.txt بإنشاء ملفات وحفظها مباشرة في إعدادات المعرفة. تحدث هذه العملية عندما تطلب من وكيلك "حفظ هذا كدليل تشغيلي".

حوار إضافة ملف في إعدادات المعرفة الذي يعرض الصيغ المدعومة والرفع بالسحب والإفلات

مثال: معرفة التقاط الحوادث

أثناء تحقيق الحادث، اسأل وكيلك:

We just resolved the high CPU issue on web-app-prod. It was caused by a
memory leak in the connection pool. Create a troubleshooting guide from
what we learned and upload it to Knowledge settings.

يقوم وكيلك بإعداد دليل منظم لاستكشاف الأخطاء وإصلاحها مع:

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

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

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

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

المتطلبات التفاصيل
إصدار العامل 26.1.57.0 أو ما بعد
إعدادات المعرفة مفعل على وكيلك
أذونات الكتابة وكيلك يحتاج إلى وصول كتابي إلى إعدادات المعرفة
وضع الجري المراجعة أو الاستقلالية (تتطلب إجراءات الكتابة الموافقة في وضع المراجعة)

الحدود

تنطبق الحدود التالية على مستندات المعرفة المرفوعة.

مرفقات الدردشة إعدادات المعرفة المثبتة أداة الوكيل
الحد الأقصى لحجم الملف 10 ميغابايت 16 ميغابايت 16 ميغابايت
الحد الأقصى للمجموع 50 ميجابايت لكل رسالة 100 ميجابايت لكل رفع
الحد الأقصى للملفات 5 لكل رسالة 1 لكل فعل
الامتدادات المدعومة 31 28 2 (.md, .txt)
رموز أسماء الملفات الحروف، الأرقام، الشرطات، الخط السفلي، النقاط متشابه
أقصى طول لاسم الملف 1,024 حرفا متشابه

متى تستخدم شيئا آخر

الجدول التالي يصف السيناريوهات التي يكون فيها نهج مختلف أكثر ملاءمة.

السيناريو نهج أفضل
ربط محتوى ويكي حي يبقى متزامنا معرفة ويكي Azure DevOps
رفع الملفات الثنائية (PDF، وورد، صور) الرفع عبرإعدادات>معرفة البناء>إضافة ملف
استيراد العديد من الوثائق بالجملة في آن واحد استخدم srectl doc upload --file <path> أمر CLI
الحفاظ على تحديث مستودعات الشيفرة تلقائيا Connect a GitHub أو Azure DevOps connector

الشروع في العمل

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