إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
كل حادثة يحلها فريقك تولد معرفة قيمة: ما الذي حدث خطأ، وما هي الأوامر التي أصلحته، وما الذي يجب التحقق منه أولا في المرة القادمة. لكن تلك المعرفة تعيش في خيوط الدردشة، وذاكرة المهندسين، والوفاة التي لا يقرأها أحد في الثالثة صباحا.
فريقك لديه دفاتر تشغيل، لكنها تصبح مملة. ما الذي تم اكتشافه خلال حادثة الليلة الماضية؟ إنه في رأس شخص ما، أو مدفون في محادثة تختفي عن الأنظار بحلول الأسبوع المقبل. في المرة التالية التي تتكرر فيها نفس المشكلة، يبدأ مهندس مختلف من الصفر.
كيف يحل وكيلك هذه المشكلة
يمكن لوكيلك رفع المستندات إلى إعدادات المعرفة أثناء المحادثات باستخدام أداة رفع وثيقة المعرفة . عندما يكتشف وكيلك حلا، أو ينشئ دليل استكشاف المشاكل، أو يجمع نتائج التحقيق، فإنه يخزن تلك المعرفة مباشرة. هذا النهج يجعل المعلومات قابلة للبحث في كل محادثة مستقبلية.
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) |
ما إذا كان يجب جعل المستند قابلا للبحث فورا |
عندما يرفع وكيلك مستندا:
- يتحقق من اسم الملف والمحتوى (حتى 16 ميجابايت لكل ملف).
- يخزن المستند في إعدادات المعرفة الخاصة بوكيلك.
- يفهرس المحتوى للبحث الدلالي.
- يؤكد الرفع برسالة نجاح.
ملحوظة
إذا كان هناك مستند بنفس اسم الملف موجود، فإن المحتوى الجديد يستبدله. تجعل هذه العملية من السهل على وكيلك تحديث المعرفة. قم بتحميل المستند باستخدام نفس الاسم لتحديث المحتوى.
تنسيقات الملفات المدعومة
يتعامل وكيلك مع الملفات بثلاث طرق، كل منها يدعم صيغ مختلفة.
مرفقات الدردشة
اسحب الملفات إلى أي دردشة لإعطاء وكيلك سياقا فوريا للتحليل - مثل حل المشكلات السكربتات، ملفات التكوين، تتبع الشبكة، والمزيد.
| الفئة | 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 ميجابايت لكل رفع
تحميل المجلدات
لرفع جميع الملفات المدعومة دفعة واحدة، اسحب مجلد كامل إلى منطقة التحميل الخاصة بالإسقاط. تشمل هذه العملية الملفات في مجلدات فرعية متداخلة. تقوم البوابة تلقائيا باستخراج كل ملف من تسلسل المجلدات وتصفية أنواع الملفات غير المدعومة.
كيفية عمل رفع المجلدات:
- يقوم النظام باستخراج جميع الملفات من المجلدات الفرعية المتداخلة إلى قائمة مسطحة.
- يشمل النظام فقط الملفات ذات امتدادات مدعومة ويقوم بتصفية الأنواع غير المدعومة بشكل صامت.
- يقوم النظام بإزالة النسخ من الملفات التي تحمل أسماء مكررة من مجلدات فرعية مختلفة ويحتفظ فقط بالملف الأول.
- يقوم النظام برفع وفهرسة كل ملف بشكل فردي للبحث.
ملحوظة
تظهر الملفات المرفوعة كمستندات فردية في مصادر المعرفة. التسلسل الهرمي الأصلي للمجلدات غير متوفر في العناية. يظهر ملف عند runbooks/networking/dns-troubleshooting.md ك dns-troubleshooting.md.
تحميلات إعدادات المعرفة تقبل صيغ 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 لكل رسالة | لا يوجد حد (الحجم الإجمالي محدود ب 100 ميجابايت) | 1 لكل فعل |
| رفع المجلد | غير مدعوم | ✓ سحب المجلدات لرفع جميع الملفات دفعة واحدة | غير مدعوم |
| الامتدادات المدعومة | 31 | 28 | 2 (.md, .txt) |
| رموز أسماء الملفات | غير قابل للتطبيق | الحروف، الأرقام، الشرطات، الخط السفلي، النقاط | متشابه |
| أقصى طول لاسم الملف | غير قابل للتطبيق | 1,024 حرفا | متشابه |
متى تستخدم شيئا آخر
| السيناريو | نهج أفضل |
|---|---|
| ربط محتوى ويكي حي يبقى متزامنا | معرفة ويكي ADO |
| رفع الملفات الثنائية (PDF، وورد، صور) | الرفع عبر إعدادات Builder → Knowledge → إضافة ملف |
| استيراد العديد من الوثائق بالجملة في آن واحد | رفع عدة ملفات عبر إعدادات Builder → Knowledge → إضافة ملف |
| الحفاظ على تحديث مستودعات الشيفرة تلقائيا | توصيل موصل GitHub أو ADO |
القدرات ذات الصلة
| القدرة | ما الذي يضيفه |
|---|---|
| معرفة ويكي ADO | ربط محتوى الويكي المباشر الذي يتم تحديثه تلقائيا |
| تحليل السبب الجذري | التحقيق في القضايا وجمع النتائج |