Tutorial: Mengunggah dokumen pengetahuan di agen SRE Azure

Dalam tutorial ini, Anda mengunggah dokumen pengetahuan ke Agen SRE Azure Anda sehingga dapat mereferensikannya selama penyelidikan di masa mendatang. Anda mempelajari cara menyimpan hasil investigasi langsung ke pengaturan Pengetahuan melalui obrolan dan cara mengunggah file yang ada melalui UI portal.

Dalam tutorial ini, Anda akan belajar cara:

  • Ubah penyelidikan menjadi runbook yang dapat digunakan kembali dan simpan di Pengaturan Pengetahuan.
  • Verifikasi bahwa konten yang diunggah diindeks dan dapat dicari
  • Mengunggah file atau folder individual melalui portal
  • Menguji bahwa agen Anda dapat mengambil konten yang diunggah dalam percakapan baru

Perkiraan waktu: 10 menit

Prasyarat

  • Agen SRE Azure dalam status Running
  • Menulis izin pada agen
  • Mode operasi agen diatur ke Tinjau atau Otonom

Langkah 1: Mulai dari investigasi

Dokumen pengetahuan terbaik berasal dari penyelidikan nyata. Alih-alih membuat konten dari awal, ambil apa yang sudah dipelajari agen Anda.

  1. Buka sre.azure.com dan pilih agen Anda.
  2. Di bilah sisi kiri di bawah Obrolan, temukan utas investigasi sebelumnya - percakapan apa pun tempat agen Anda mendiagnosis atau menyelesaikan masalah - dan pilih.

Jika Anda belum memiliki utas investigasi, mulai obrolan baru dan minta agen Anda untuk menyelidiki sesuatu:

Investigate high memory usage on our container apps

Tunggu hingga penyelidikan selesai, lalu lanjutkan dengan Langkah 2.

Langkah 2: Minta agen Anda untuk membuat runbook

Dalam utas investigasi yang sama, minta agen Anda untuk mengonversi temuannya menjadi sebuah runbook dan menyimpannya ke pengaturan Basis Pengetahuan. Spesifikkan tentang nama file.

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

Agen Anda:

  1. Menjuraikan konteks investigasi menjadi runbook terstruktur.
  2. Menghasilkan bagian seperti Analisis Akar Masalah, Langkah Diagnostik, Mitigasi, dan Pemicu Eskalasi.
  3. Menyimpan dokumen ke pengaturan Pengetahuan dan mengonfirmasi unggahan.

Agen mengonfirmasi bahwa dokumen telah disimpan dan menyediakan tautan unduhan. Runbook Anda sekarang disimpan di Pengaturan Pengetahuan dan diindeks untuk pencarian.

Checkpoint

  • Agen menghasilkan sebuah runbook terstruktur dari penyelidikan.
  • Agen mengonfirmasi bahwa dokumen telah disimpan.

Langkah 3: Verifikasi di Pengaturan pengetahuan

  1. Di bilah sisi kiri, pilih Penyusun untuk memperluas bagian.
  2. Pilih Pengaturan pengetahuan.

Halaman Pengaturan pengetahuan menampilkan dokumen Anda dalam tabel dengan kolom untuk Nama File, Status, Jenis, dan Terakhir diubah. Kolom Status memperlihatkan ✓ Diindeks saat dokumen diindeks dan siap untuk pencarian.

Jika status memperlihatkan Tertunda, pilih Refresh. Pengindeksan biasanya selesai dalam beberapa detik.

Checkpoint

  • Dinavigasi ke Penyusun → Pengaturan pengetahuan
  • Dokumen muncul dengan ✓ Status terindeks

Langkah 4: Mengunggah file melalui portal

Anda dapat mengunggah file individual atau seluruh folder secara langsung. Metode ini berguna untuk runbook, dokumentasi, atau materi referensi yang sudah dimiliki tim Anda.

Mengunggah file satu per satu

  1. Pada halaman Sumber pengetahuan , pilih Tambahkan file.
  2. Seret file ke zona drop, atau pilih telusuri file untuk memilih file .
  3. Pilih Tambahkan file untuk diunggah.

Mengunggah folder

Anda juga dapat menyeret seluruh folder - termasuk subfolder berlapis - ke zona drop.

  1. Pada halaman Sumber pengetahuan , pilih Tambahkan file.
  2. Seret folder dari manajer file Anda langsung ke zona drop.
  3. Portal mengekstrak semua file yang didukung dari folder dan subfoldernya, lalu mencantumkannya dalam dialog.
  4. Tinjau daftar file - hapus file apa pun yang tidak Anda inginkan dengan memilih ikon hapus di samping setiap file.
  5. Pilih Tambahkan file untuk mengunggah semua file yang tercantum.

Portal secara otomatis memfilter file dengan ekstensi yang tidak didukung. Untuk daftar lengkap ekstensi dan batas ukuran yang didukung, lihat halaman Kemampuan Unggah Dokumen Pengetahuan.

Ukuran file maksimum adalah 16 MB per file, dengan hingga 100 MB per unggahan.

Nota

Saat Anda mengunggah folder, portal tidak mempertahankan struktur folder - file dari subfolder muncul sebagai dokumen individual. Jika file di subfolder yang berbeda memiliki nama yang sama, hanya file pertama yang diunggah.

Checkpoint

  • Pilih Tambahkan file dan lihat dialog unggahan.
  • Mengunggah file atau berhasil menyeret folder.
  • File muncul di Sumber pengetahuan dengan ✓ Status terindeks .

Langkah 5: Uji pengambilan data dalam percakapan baru

Mulai utas obrolan baru dan ajukan pertanyaan yang harus dijawab oleh dokumen yang Anda unggah:

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

Agen Anda mencari Pengaturan Pengetahuan, menemukan runbook yang Anda unggah, dan mereferensikannya pada respons. Proses ini mengonfirmasi pengetahuan diindeks dan dapat diakses.

Checkpoint

  • Memulai utas obrolan baru
  • Mengajukan pertanyaan terkait dengan konten yang diunggah
  • Agen mereferensikan dokumen yang diunggah dalam responsnya

Menghapus dokumen pengetahuan

  1. Buka Pembuat → Pengaturan pengetahuan.
  2. Dalam daftar dokumen, pilih satu atau beberapa dokumen dengan menggunakan kotak centang.
  3. Pilih Hapus di toolbar.
  4. Dialog konfirmasi mencantumkan dokumen yang akan dihapus. Pilih Hapus untuk mengonfirmasi.

Saat menghapus dokumen, Anda menghapusnya dari pengaturan Pengetahuan agen dan dokumen tersebut tidak lagi muncul di hasil pencarian.

Nota

Anda tidak dapat mengedit dokumen pengetahuan di tempat. Untuk memperbarui dokumen, unggah versi baru dengan nama file yang sama. Versi baru menggantikan versi sebelumnya.

Apa yang telah Anda Pelajari

  • Agen Anda dapat mengubah penyelidikan nyata menjadi runbook terstruktur dan menyimpannya ke Pengaturan Pengetahuan.
  • Anda dapat mengunggah file secara manual melalui UI portal di pengaturan Builder → Knowledge. Ini mendukung banyak format, termasuk PDF, dokumen Office, dan gambar.
  • Sistem mengindeks dokumen yang diunggah untuk pencarian semantik, dan tersedia di semua percakapan di masa mendatang.
  • Untuk memperbarui dokumen, unggah dengan menggunakan nama file yang sama.

Troubleshooting

Kesalahan Penyebab Perbaiki
"Memori agen dinonaktifkan. Tidak dapat mengunggah dokumen." Pengaturan pengetahuan tidak diaktifkan di agen Anda Hubungi administrator Anda untuk mengaktifkan pengaturan Pengetahuan
"Saya tidak memiliki akses tulis ke pengaturan Pengetahuan Anda" Agen tidak dapat menemukan alat unggahan Mengulangi permintaan Anda: "Simpan ke pengaturan Pengetahuan sebagai filename.md"
"Ekstensi file tidak valid. Hanya file .md dan .txt yang diizinkan." Nama file tidak berakhiran .md atau .txt (unggahan percakapan) .md Gunakan ekstensi atau .txt saat meminta agen untuk menyimpan
"Konten dokumen melebihi ukuran maksimum 16MB" Konten terlalu besar untuk satu dokumen Pisahkan menjadi beberapa dokumen yang lebih kecil
"Nama file tidak boleh kosong" Tidak ada nama file yang disediakan Sertakan nama file dalam perintah Anda (misalnya, runbook.md)
Sumber Daya Yang Anda pelajari
Mengunggah dokumen pengetahuan Cara kerjanya dan mengapa itu penting
Membuat Keterampilan Membangun keterampilan prosedural yang melengkapi dokumen pengetahuan
Keterampilan Bagaimana keterampilan dan pengetahuan bekerja sama
Pengetahuan wiki ADO Menyambungkan konten wiki secara langsung sebagai sumber pengetahuan
  • Last updated on