Mengunggah dokumen pengetahuan di agen SRE Azure

Petunjuk

  • Agen Anda membuat sekaligus mengunggah runbook selama percakapan tanpa perlu manajemen file manual.
  • Lampirkan 31 jenis file dalam obrolan, termasuk .kql, , .bicep, .tf.har, .py, dan .xlsx, untuk konteks analisis segera.
  • Unggah 28 jenis file ke Pengaturan pengetahuan untuk penyimpanan persisten dan terindeks di semua percakapan di masa mendatang
  • Resolusi insiden menjadi pengetahuan institusi secara otomatis

Masalahnya: pengetahuan mati dengan percakapan

Setiap insiden yang diselesaikan tim Anda menghasilkan pengetahuan yang berharga: apa yang salah, perintah apa yang memperbaikinya, dan apa yang harus diperiksa terlebih dahulu di lain waktu. Pengetahuan itu tersimpan dalam utas obrolan, ingatan insinyur, dan postmortem yang tidak dibaca siapa pun pada pukul 3 pagi.

Tim Anda memiliki runbook, tetapi mereka kedaluarsa. Perbaikan yang ditemukan akibat insiden tadi malam? Ada di kepala seseorang, atau terbenam dalam percakapan yang menghilang dari tampilan dalam beberapa hari. Lain kali masalah yang sama terjadi, teknisi yang berbeda dimulai dari awal.

Bagaimana agen Anda memecahkan masalah ini

Agen Anda dapat mengunggah dokumen ke pengaturan Pengetahuan selama percakapan dengan menggunakan alat Unggah Dokumen Pengetahuan . Saat agen Anda menemukan perbaikan, membuat panduan pemecahan masalah, atau mensintesis temuan investigasi, agen Anda menyimpan pengetahuan tersebut secara langsung dan membuatnya dapat dicari untuk setiap percakapan di masa mendatang.

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

Agen Anda menghasilkan runbook terstruktur dan mengunggahnya dalam hitungan detik. Dokumen diindeks secara otomatis dan menjadi dapat dicari untuk penyelidikan di masa mendatang.

Sebelum dan sesudah

Sebelumnya Sesudah
Penangkapan pengetahuan Setelah insiden: insinyur menulis runbook (mungkin) Agen Anda menangkap perbaikan saat terjadi
Waktu untuk mendokumen 30 hingga 60 menit untuk menulis runbook Detik. Agen Anda menghasilkan dan mengunggah sebaris.
Kesegaran pengetahuan Runbook kedaluarsa dalam beberapa minggu Pengaturan pengetahuan tumbuh dengan setiap resolusi
Aksesibilitas Pengetahuan terjebak di kepala insinyur atau utas obrolan Dapat dicari oleh agen Anda di semua percakapan di masa mendatang
Konsistensi format Bervariasi menurut penulis Dokumentasi terstruktur dan konsisten setiap saat

Apa yang membuat ini berbeda

Tidak seperti unggahan manual, agen Anda membuat pengetahuan secara proaktif. Anda tidak perlu ingat untuk mendokumentasikan apa yang Anda pelajari karena agen Anda melakukannya sebagai bagian dari percakapan.

Tidak seperti riwayat obrolan, dokumen yang diunggah diindeks untuk pencarian semantik. Ketika masalah serupa terjadi berbulan-bulan kemudian, agen Anda menemukan runbook yang relevan secara otomatis melalui pencarian pintar, bukan dengan menggulir utas lama.

Tidak seperti konektor wiki, dokumen yang diunggah tidak memerlukan layanan eksternal. Pengetahuan tersimpan langsung di pengaturan Knowledge agen Anda, tersedia secara instan tanpa penundaan sinkronisasi.

Cara kerjanya

Alat Unggah Dokumen Pengetahuan menerima tiga parameter:

Parameter Required Deskripsi
Nama file Yes Nama dengan .md atau .txt ekstensi (misalnya, database-pool-runbook.md)
Content Yes Teks dokumen lengkap dalam format Markdown atau teks biasa
Memicu pengindeksan Opsional (default: true) Apakah akan segera membuat dokumen dapat dicari

Saat agen Anda mengunggah dokumen:

  1. Memvalidasi nama file dan konten (hingga 16 MB per file).
  2. Menyimpan dokumen pada pengaturan Pengetahuan agen Anda.
  3. Mengindeks konten untuk pencarian semantik.
  4. Mengonfirmasi unggahan dengan pesan sukses.

Nota

Jika dokumen dengan nama file yang sama sudah ada, konten baru akan menggantikannya. Proses ini memudahkan agen Anda untuk memperbarui pengetahuan. Unggah dengan nama yang sama untuk memperbarui konten.

Format file yang didukung

Agen Anda menangani file melalui tiga metode, masing-masing mendukung format yang berbeda.

Lampiran Obrolan

Seret file ke obrolan apa pun untuk memberi agen Anda konteks langsung untuk analisis - pemecahan masalah skrip, file konfigurasi, jejak jaringan, dan banyak lagi.

Kategori Ekstensi
Images .png, .jpg, .jpeg, .gif, .webp, .svg
Dokumen .txt, .md, .pdf, .docx, .pptx, .xlsx
Data dan konfigurasi .json, .csv, .log, .yaml, .yml, .xml, .ini, .conf, .env
Web dan jaringan .html, .har
Kode dan skrip .ts, .js, .py, .sh, .sql, .kql
Prasarana .bicep, .tf

Batas: 10 MB per file · Total 50 MB per pesan · 5 file per pesan

Unggahan pengaturan pengetahuan

Untuk mempertahankan dokumen yang dirujuk agen Anda dalam percakapan mendatang, unggah file melalui pengaturan Builder → Knowledge → Tambahkan file. Sistem mengindeks file yang diunggah untuk pencarian semantik.

Kategori Ekstensi
Images .png, .jpg, .jpeg, .gif, .webp, .bmp, .tiff, .tif
Dokumen .txt, .md, .pdf, .docx, .pptx, .xlsx, .doc, .ppt, .xls
Data dan konfigurasi .json .csv .log .yaml .yml .xml .ini .conf .cfg .config .properties

Batas: 16 MB per file · 100 MB per unggahan

Pengunggahan folder

Untuk mengunggah semua file yang didukung sekaligus, seret seluruh folder ke zona drop unggahan. Proses ini mencakup file dalam subfolder berlapis. Portal secara otomatis mengekstrak setiap file dari hierarki folder dan memfilter jenis file yang tidak didukung.

Cara kerja unggahan folder:

  1. Sistem mengekstrak semua file dari subfolder berlapis ke dalam daftar datar.
  2. Sistem hanya menyertakan file dengan ekstensi yang didukung dan secara diam-diam memfilter jenis yang tidak didukung.
  3. Sistem mendeduplikasi file dengan nama duplikat dari subfolder yang berbeda dan hanya menyimpan file pertama.
  4. Sistem mengunggah dan mengindeks setiap file satu per satu untuk pencarian.

Nota

File yang diunggah muncul sebagai dokumen individual di Sumber pengetahuan. Hierarki folder asli tidak dipertahankan. File di runbooks/networking/dns-troubleshooting.md muncul sebagai dns-troubleshooting.md.

Unggahan pengaturan pengetahuan menerima format Office lama (.doc, .ppt, .xls) dan format gambar tambahan (.bmp, .tiff, .tif) yang tidak didukung oleh lampiran obrolan. Lampiran obrolan mendukung format seperti kode, skrip, infrastruktur, dan web yang tidak didukung oleh pengaturan pengetahuan.

Dokumen yang dihasilkan agen

Saat agen Anda membuat dokumen selama percakapan (dengan menggunakan alat Unggah Dokumen Pengetahuan ), agen tersebut menghasilkan .md atau .txt file dan menyimpannya langsung ke pengaturan Pengetahuan. Proses ini terjadi ketika Anda meminta agen Anda untuk "menyimpan ini sebagai runbook."

Contoh: menangkap pengetahuan tentang insiden

Selama penyelidikan insiden, tanyakan kepada agen Anda:

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.

Agen Anda menghasilkan panduan pemecahan masalah terstruktur dengan:

  • Langkah-langkah penyusunan ruang lingkup: Cara mengidentifikasi masalah.
  • Mitigasi cepat: Tindakan langsung untuk mengurangi dampak.
  • Analisis akar penyebab: Apa yang harus diselidiki.
  • Langkah-langkah resolusi: Perbaikan yang berfungsi.
  • Pencegahan: Cara menghindari pengulangan.

Lain kali masalah CPU serupa terjadi, agen Anda secara otomatis mereferensikan dokumen ini selama penyelidikan, mengubah pengalaman satu insinyur menjadi pengetahuan tim bersama.

Apa yang Anda butuhkan

Persyaratan Rincian
Versi agen 26.1.57.0 atau yang lebih baru
Pengaturan pengetahuan Diaktifkan pada agen Anda
Hak akses tulis Agen Anda memerlukan akses tulis ke pengaturan Pengetahuan
Mode operasi Tinjau atau Otonom. Tindakan tulis memerlukan persetujuan dalam mode Tinjau.

Batasan

Attribute Lampiran Obrolan Unggahan pengaturan pengetahuan Perangkat agen
Ukuran file maksimum 10 MB 16 MB 16 MB
Total maksimum 50 MB per pesan 100 MB per unggahan N/A
File maksimum 5 per pesan Tidak ada batas (ukuran total dibatasi pada 100 MB) 1 per tindakan
Unggahan folder Tidak didukung ✓ Seret folder untuk mengunggah semua file sekaligus Tidak didukung
Ekstensi yang didukung 31 28 2 (.md, .txt)
Karakter pada nama file N/A Huruf, angka, tanda hubung, garis bawah, titik Sama
Panjang nama file maksimum N/A 1.024 karakter Sama

Kapan menggunakan sesuatu yang lain

Skenario Pendekatan yang lebih baik
Menyambungkan konten wiki real-time yang tetap tersinkronisasi Pengetahuan Wiki ADO
Mengunggah file biner (PDF, Word, gambar) Unggah melalui Penyusun → Pengaturan pengetahuan → Tambahkan file
Mengimpor banyak dokumen secara massal sekaligus Mengunggah beberapa file melalui Builder → Pengaturan pengetahuan → Menambahkan file
Menjaga repositori kode tetap diperbarui secara otomatis Menyambungkan konektor GitHub atau ADO
Kemampuan Apa yang ditambahkannya
Pengetahuan wiki ADO Menyambungkan konten wiki yang hidup dan diperbarui secara otomatis
Analisis akar penyebab Menyelidiki masalah dan menangkap temuan
  • Last updated on