Menghubungkan pengetahuan di Azure SRE Agent

Azure SRE Agent lebih efektif ketika dapat menggunakan konteks yang sama yang digunakan tim Anda untuk memecahkan masalah sistem. Sambungkan runbook, dokumentasi, halaman web, dan repositori sehingga agen Anda dapat mereferensikannya selama penyelidikan alih-alih memulai dari awal.

Petunjuk / Saran

• Gunakan Builder > basis pengetahuan untuk mengelola file, halaman web, dan repositori di satu tempat.
• Pengetahuan terindeks tersedia secara otomatis selama investigasi dan obrolan.
• Anda dapat mengunggah dokumen secara langsung, melampirkan file dalam obrolan, atau menyambungkan repositori untuk analisis sadar sumber.
• Sumber pengetahuan yang paling berguna adalah sumber pengetahuan yang sudah bergantung pada tim Anda, seperti runbook, catatan arsitektur, panduan pemecahan masalah, dan kode sumber.

Mengapa pengetahuan penting

Agen Anda sudah memiliki konteks Azure bawaan melalui alat pengamatan dan sistem yang terhubung. Apa yang tidak dimiliki secara default adalah pengetahuan internal tim Anda. Pengetahuan tersebut mencakup runbook yang menjelaskan langkah pemulihan umum, catatan arsitektur yang mengidentifikasi dependensi bersama, atau repositori yang mengungkapkan penyebaran mana yang memperkenalkan regresi.

Saat Anda menghubungkan pengetahuan tersebut, agen Anda dapat:

• Rujuk runbook tim selama insiden.
• Gunakan kembali langkah-langkah pemecahan masalah yang sudah didokumenkan tim Anda.
• Menghubungkan gejala dengan kode sumber dan konteks penyebaran.
• Jawab pertanyaan dengan menggunakan dokumen dan referensi yang sama yang digunakan manusia.

Mengelola pengetahuan di pangkalan pengetahuan

Gunakan basis pengetahuan Builder > untuk mengelola sumber pengetahuan agen Anda.

Halaman menampilkan setiap sumber beserta:

• Name
• Status
• Jenis
• Tanggal terakhir diubah

Tiga jenis sumber tersedia:

Jenis sumber	Apa yang disediakannya	Cara menambahkannya
File	Runbook, panduan pemecahan masalah, dokumen arsitektur, dan materi referensi	Unggah melalui portal atau minta agen untuk menyimpan dokumen selama obrolan
Halaman web	Dokumentasi eksternal, URL wiki internal, dan halaman status	Tambahkan URL halaman sehingga agen dapat mengindeks konten
Repositories	Kode sumber, file penyebaran, dan definisi infrastruktur	Menyambungkan repositori GitHub atau Azure DevOps

Periksa status pengindeksan dan kesegaran

Setiap sumber pengetahuan menunjukkan salah satu status berikut:

Status	Meaning
Terindeks	Konten diproses dan dapat dicari
Tertunda	Konten masih diproses
Tidak diindeks	Pemrosesan gagal atau sumber tidak dapat diindeks

Saat sumber diindeks, arahkan mouse ke atas indikator status untuk melihat tanda waktu Dibuat . Tanda waktu ini berguna saat Anda ingin mengonfirmasi bahwa versi terbaru sebuah runbook atau dokumen telah diproses.

Unggah dokumen

Unggah dokumen saat Anda ingin pengetahuan tetap tersedia di seluruh percakapan di masa mendatang.

Contoh umumnya meliputi:

• Panduan insiden
• Panduan eskalasi
• Referensi arsitektur
• Pemecahan masalah daftar periksa

Anda dapat mengunggah file melalui portal, atau Anda dapat meminta agen untuk menyimpan konten dari percakapan ke pangkalan pengetahuan.

Untuk format dan batas file yang didukung, lihat Mengunggah dokumen pengetahuan.

Untuk alur kerja lengkap, lihat Mengunggah dokumen pengetahuan.

Berbagi file dalam obrolan

Gunakan lampiran obrolan saat Anda ingin memberikan konteks langsung kepada agen dalam satu percakapan. Pendekatan ini berguna untuk cuplikan layar, log, file konfigurasi, dan materi lain yang membantu pemecahan masalah aktif.

Petunjuk / Saran

Jika file yang Anda lampirkan dalam obrolan harus menjadi pengetahuan jangka panjang, minta agen untuk menyimpannya ke pengaturan Pengetahuan. Agen dapat mengunggah salinan sehingga konten menjadi terindeks dan dapat dicari dalam percakapan selanjutnya.

Tabel berikut membandingkan unggahan pengetahuan jangka panjang dengan lampiran obrolan sementara:

Skenario	Unggah ke Pangkalan Pengetahuan	Berbagi dalam obrolan
Pilihan terbaik untuk	Panduan operasional, prosedur, dan dokumen yang ingin Anda sediakan untuk percakapan mendatang	File yang Anda inginkan untuk dianalisis agen sekarang
Cakupan penyimpanan	Pada tingkat agen dan dapat dicari di seluruh percakapan mendatang	Tingkat utas dan tersedia dalam percakapan saat ini
Cara menambahkan	Unggah di portal atau minta agen untuk menyimpan konten	Seret dan letakkan, tempel dari clipboard, atau gunakan + dalam obrolan
Dapat menjadi pengetahuan jangka panjang	Pengetahuan jangka panjang yang sudah ada	Ya, jika Anda meminta agen untuk menyimpannya

Untuk informasi selengkapnya, lihat Berbagi file di obrolan.

Menambahkan halaman web

Tambahkan halaman web saat panduan penting berada di luar file atau repositori yang diunggah.

Kandidat yang baik mencakup:

• Artikel wiki internal
• Dokumentasi produk publik
• Halaman status layanan
• Halaman referensi yang dikelola tim

Setelah Anda menambahkan URL, agen mengindeks konten halaman sehingga dapat mereferensikan informasi tersebut selama penyelidikan di masa mendatang.

Menyambungkan repositori

Sambungkan repositori GitHub atau Azure DevOps saat agen Anda memerlukan konteks sadar sumber.

Repositori yang terhubung membantu agen:

• Mencari pola kesalahan dalam kode sumber
• Menghubungkan insiden dengan perubahan kode terbaru
• Mereferensikan file penyebaran dan konfigurasi
• Menggunakan konten repositori selama analisis akar penyebab

Untuk menyambungkan kode sumber, lihat Menyambungkan kode sumber.

Pilih sumber pengetahuan yang tepat

Gunakan jenis sumber yang cocok dengan jenis konteks yang Anda butuhkan:

Jika Anda perlu menyambungkan...	Gunakan...
Runbook atau panduan pemecahan masalah yang disimpan dalam bentuk file	Mengunggah dokumen pengetahuan
Cuplikan layar, log, atau file untuk satu investigasi aktif	Berbagi file dalam obrolan
Repositori GitHub atau Azure DevOps	Menyambungkan kode sumber
Sistem eksternal seperti Datadog atau Splunk	Konektor MCP