bilgi belgelerini Azure SRE Aracısı'nda karşıya yükleme

Tip

  • Aracınız, el ile dosya yönetimine gerek kalmadan görüşmeler sırasında runbooklar oluşturur ve yükler.
  • Anında analiz bağlamı için sohbete , .kql, .bicep, .tf, .harve .pydahil olmak üzere .xlsx31 dosya türü ekleyin.
  • Gelecekteki tüm konuşmalarda kalıcı, dizinli depolama için Bilgi ayarlarına 28 dosya türü yükleyin
  • Olay çözümleri otomatik olarak kurumsal bilgiye dönüşür

Sorun: bilgi konuşmayla birlikte ölür

Ekibinizin çözdüğü her olay değerli bilgiler oluşturur: nelerin yanlış gittiğini, hangi komutların bunu düzelttiğini ve bir dahaki sefere nelerin kontrol edileceğini. Ancak bu bilgi sohbet yazışmalarında, mühendislerin hafızasında ve kimsenin sabah 3'te okumadığı incelemelerde yer alır.

Ekibinizin runbook'ları var, ancak güncelliğini yitirmiş durumda. Dün geceki olay sırasında bulunan düzeltme mi? Bir kişinin zihninde ya da gelecek haftaya kadar dikkatten kaybolacak bir konuşmanın içinde gömülü. Aynı sorun bir daha oluştuğunda, farklı bir mühendis sıfırdan başlar.

Temsilciniz bu sorunu nasıl çözer?

Temsilciniz, Bilgi Belgesini Karşıya Yükle aracını kullanarak konuşmalar sırasında Bilgi Ayarlarına belge yükleyebilir. Temsilciniz bir düzeltme keşfettiğinde, bir sorun giderme kılavuzu oluşturduğunda veya araştırma bulgularını sentezlediğinde, bu bilgileri doğrudan saklar ve her gelecek konuşmada aranabilir hale getirir.

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

Ajanınız, yapılandırılmış bir runbook'u saniyeler içinde oluşturur ve karşıya yükler. Belge otomatik olarak dizine eklenir ve gelecekteki araştırmalarda aranabilir hale gelir.

Önce ve sonra

Önce Sonra
Bilgi yakalama Olay sonrası: mühendis bir kılavuz (runbook) yazar (belki) Ajanınız düzeltmeyi gerçek zamanlı olarak yakalar
Belge oluşturma zamanı Runbook yazmak için 30 - 60 dakika. Saniye. Ajanınız satır içi olarak oluşturur ve karşıya yükler.
Bilgi tazeliği Runbook'lar birkaç hafta içinde geçerliliğini yitirir Bilgi ayarları her çözünürlükte büyür
Erişilebilirlik Mühendisin kafasında veya sohbet yazışmasında takılı kalan bilgi Gelecekteki tüm konuşmalarda temsilciniz tarafından aranabilir
Biçim tutarlılığı Yazara göre değişir Her seferinde yapılandırılmış ve tutarlı belgeler

Bunu farklı kılan nedir?

Elle yapılan yüklemelerden farklı olarak aracınız proaktif bir şekilde bilgi oluşturur. Öğrendiklerinizi belgelemeyi hatırlamanıza gerek yok, çünkü temsilciniz bunu konuşmanın bir parçası olarak yapar.

Sohbet geçmişinin aksine, karşıya yüklenen belgeler anlamsal arama için dizine eklenir. Benzer bir sorun aylar sonra ortaya çıktığında, temsilciniz eski ileti dizilerini kaydırmak yerine akıllı geri getirme yoluyla ilgili çalışma kitabını otomatik olarak bulur.

Wiki bağlayıcılarından farklı olarak, karşıya yüklenen belgeler dış hizmetler gerektirmez. Bu bilgi doğrudan ajanınızın Bilgi Ayarları'nda bulunur ve senkronizasyon gecikmeleri olmadan anında kullanılabilir.

Nasıl çalışır?

Bilgi Belgesini Karşıya Yükle aracı üç parametre kabul eder:

Parametre Zorunlu Açıklama
Dosya adı Evet Ad .md veya .txt uzantılı (örneğin, database-pool-runbook.md)
Content Evet Markdown veya düz metin biçiminde tam belge metni
Tetikleyici dizini oluşturma İsteğe bağlı (varsayılan: true) Belgenin hemen aranabilir yapılıp yapılmaymayacağı

Temsilciniz bir belgeyi karşıya yüklediğinde:

  1. Dosya adını ve içeriği (dosya başına en fazla 16 MB) doğrular.
  2. Belgeyi aracınızın Bilgi ayarlarında depolar.
  3. İçeriği anlamsal arama için dizine ekler.
  4. Karşıya yüklemeyi başarı mesajıyla onaylar.

Uyarı

Aynı dosya adına sahip bir belge zaten varsa, yeni içerik onun yerini alır. Bu işlem, temsilcinizin bilgileri güncellemesini kolaylaştırır. İçeriği güncellemek için aynı adla yükleyin.

Desteklenen dosya biçimleri

Aracınız dosyaları her birinin farklı biçimlerini destekleyen üç yöntemle işler.

Sohbet dosya ekleri

Aracınıza analiz için anında bağlam sağlamak için dosyaları herhangi bir sohbete sürükleyin: sorun giderme betikleri, yapılandırma dosyaları, ağ izlemeleri ve daha fazlası.

Kategori Uzantılar
Images .png, .jpg, .jpeg, , .gif, .webp, .svg
Belgeler .txt, .md, .pdf, , .docx, .pptx, .xlsx
Veriler ve yapılandırma .json, .csv, .log, , .yaml, .yml, .xml, .ini, .conf, .env
Web ve ağ .html, .har
Kod ve betikler .ts, .js, .py, , .sh, .sql, .kql
Altyapı .bicep, .tf

Sınırlar: Dosya başına 10 MB · İleti başına toplam 50 MB · İleti başına 5 dosya

Bilgi ayarları yüklemeler

Builder → Bilgi ayarları → Dosya ekle yoluyla dosyaları karşıya yükleyerek, aracınızın dokümanlarını gelecekteki konuşmalarda başvurabilmesi için kalıcı olarak kaydedin. Sistem, karşıya yüklenen dosyaları anlamsal arama için dizine alır.

Kategori Uzantılar
Images .png, .jpg, .jpeg, , .gif, .webp, .bmp, .tiff, .tif
Belgeler .txt, .md, .pdf, , .docx, .pptx, .xlsx, .doc, .ppt, .xls
Veriler ve yapılandırma .json, .csv, .log, .yaml, .yml, .xml, .ini, .conf, .cfg, .config, .properties

Sınırlar: Dosya başına 16 MB · Karşıya yükleme başına 100 MB

Klasör yüklemeleri

Desteklenen bütün dosyaları tek seferde yüklemek için, bir klasörün tamamını yükleme alanına sürükleyin. Bu işlem iç içe alt klasörlerdeki dosyaları içerir. Portal, klasör hiyerarşisinden her dosyayı otomatik olarak ayıklar ve desteklenmeyen dosya türlerini filtreler.

Klasör yükleme işlemleri nasıl yapılır:

  1. Sistem, iç içe alt klasörlerdeki tüm dosyaları düz bir listeye ayıklar.
  2. Sistem yalnızca desteklenen uzantılara sahip dosyaları içerir ve desteklenmeyen türleri sessizce filtreler.
  3. Sistem, farklı alt klasörlerden gelen ve adları yinelenen dosyaları kaldırır ve yalnızca ilk dosyayı korur.
  4. Sistem, arama için her dosyayı tek tek karşıya yükler ve dizinler.

Uyarı

Yüklenen dosyalar Bilgi kaynaklarında ayrı belgeler olarak görünür. Özgün klasör hiyerarşisi korunmaz. konumundaki runbooks/networking/dns-troubleshooting.md bir dosya olarak dns-troubleshooting.mdgörünür.

Bilgi ayarlarının yüklemeleri, sohbet eklerinin kabul etmediği ek görüntü biçimleri (.doc, .ppt, .xls) ve eski Office biçimlerini (.bmp, .tiff, .tif) kabul eder. Sohbet ekleri, bilgi ayarlarının desteklemediği kodu, betikleri, altyapıyı ve web biçimlerini destekler.

Aracı tarafından oluşturulan belgeler

Aracınız konuşmalar sırasında belgeler oluşturduğunda (Bilgi Belgesini Karşıya Yükle aracını kullanarak), .md veya .txt dosyaları oluşturur ve bunları doğrudan Knowledge ayarlarına kaydeder. Bu işlem, aracınızdan "bunu runbook olarak kaydetmesini" istediğinizde gerçekleşir.

Örnek: olay bilgilerini yakalama

Olay araştırması sırasında temsilcinize şu soruyu sorun:

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.

Yazılım aracınız aşağıdakileri içeren yapılandırılmış bir sorun giderme kılavuzu oluşturur:

  • Kapsam belirleme adımları: Sorunu tanımlama.
  • Hızlı azaltmalar: Etkiyi azaltmak için anında eylemler.
  • Kök neden analizi: Araştırılması gerekenler.
  • Çözüm adımları: Çalışan düzeltme.
  • Önleme: Yinelenmeyi önleme.

Benzer bir CPU sorunu oluştuğunda, ajanınız araştırma sırasında bu belgeye otomatik olarak başvurur ve bir mühendisin deneyimini ekip tarafından paylaşılacak bilgiye dönüştürür.

Neye ihtiyacınız var?

Gereksinim Ayrıntılar
Aracı sürümü 26.1.57.0 veya üzeri
Bilgi ayarları Ajanınızda etkin
Yazma izinleri Ajanınızın Bilgi ayarlarına yazma erişimine ihtiyacı var
Çalıştırma modu Gözden Geçirme veya Otonom Yazma eylemleri gözden geçirme modunda onay gerektirir.

Limits

Özellik Sohbet dosya ekleri Bilgi ayarları yüklemeler Ajan Aracı
En büyük dosya boyutu 10 MB 16MB 16MB
En fazla toplam İleti başına 50 MB Karşıya yükleme başına 100 MB N/A
En fazla dosya sayısı İleti başına 5 Sınır yok (toplam boyut 100 MB ile sınırlandırılmış) Eylem başına 1
Klasör yükleme Desteklenmiyor ✓ Tüm dosyaları aynı anda karşıya yüklemek için klasörleri sürükleyin Desteklenmiyor
Desteklenen uzantılar 31 28 2 (.md, .txt)
Dosya adı karakterleri N/A Harfler, sayılar, kısa çizgiler, alt çizgiler, noktalar Aynısı
En fazla dosya adı uzunluğu N/A 1.024 karakter Aynısı

Başka bir şey ne zaman kullanılır?

Scenario Daha iyi bir yaklaşım
Eşitlenmiş durumda kalan canlı wiki içeriğini bağlama ADO Wiki Bilgisi
İkili dosyaları yükleme (PDF, Word, resimler) Oluşturucu → Bilgi ayarları aracılığıyla karşıya yükleme → Dosya ekle
Aynı anda birçok belgeyi toplu içeri aktarma Oluşturucu → Bilgi ayarları → Dosya ekle aracılığıyla birden çok dosya yükleme
Kod depolarını otomatik olarak güncel tutma GitHub veya ADO bağlayıcısı bağlama
Kapasite Eklenenler
ADO wiki bilgisi Otomatik olarak güncelleştirilen canlı wiki içeriğini bağlama
Kök neden analizi Sorunları araştırma ve bulguları yakalama