Azure SRE Aracısı'nda bellek ve bilgi

Ajanınız, geçmişteki olaylarda neyin işe yaradığını hatırlayarak ve belgelerinize başvurarak zaman içinde daha etkili hale gelir.

Bellek nasıl çalışır?

Bir soru sorduğunuzda, temsilciniz tüm bilgi kaynaklarını aynı anda arar.

Kaynak	Buldukları	En iyi kullanım alanı:
Geçmiş olaylar	Benzer sorunları çözen adımlar	"Bunu daha önce nasıl düzelttik?"
Kullanıcı anıları	Açıkça kaydettiğiniz olgular	Ortamımın kullanımlarını hatırla...
Bilgi bankası	Tarafınızdan yüklenen çalışma kitaplarınız ve belgeleriniz	Standart prosedürümüzü uygulayın

Aracı, bilgilerin tam olarak nereden geldiğini gösteren tıklanabilir alıntılar içeren temellendirilmiş bir yanıt döndürür.

Otomatik öğrenme

Temsilciniz her konuşmadan ders alır. El ile eğitime gerek yoktur.

Her iş parçacığı bittikten sonra aracı aşağıdaki bilgileri kaydeder.

Ne?	Açıklama
Gözlemlenen belirtiler	Hata iletileri, davranışlar, desenler
Çalışan adımlar	Başarılı olan çözüm yolu
Kök neden	Soruna neden olan şey
Kaçınılması gereken tuzaklar	İşe yaramadıysa, çıkmaz uçlar

Bu işlem otomatik olarak gerçekleşir. Bir yazışmanın sessize çıkmasından otuz dakika sonra aracı konuşmayı değerlendirir ve öğrenmeleri dizine alır.

Aynı kaynak önceliği

Bir kaynak sorununu araştırırken aracı, tam olarak aynı kaynakta geçmiş oturumların önceliğini belirler.

"App Service app-prod-01 is returning 503 errors"

Aracınız daha önce app-prod-01 üzerinde sorunları görüp görmediğini kontrol eder. Evet ise, bu öğrenmeler en ilgili olduğu için ilk olarak görünür.

Proaktif bilgi kalıcılığı

Tamamlanmış iş parçacıklarından öğrenmenin ötesinde, ajanınız konuşmalar sırasında keşfettiklerini etkin bir şekilde kaydeder. Aracınız önemli bir şeyle (karmaşık bir yapılandırma, gizli olmayan bir bağımlılık veya bir hata ayıklama gotcha) karşılaştığında, oturumlar arasında taşınan kalıcı bilgi dosyalarındaki içgörüleri kaydeder.

Nasıl çalışır?

Ajansınız memories/synthesizedKnowledge/ adresinde bir bilgi dizini tutar. Aracı, overview.mdher konuşmanın başlangıcında sistem istemine otomatik olarak özel bir dosya yükler. Bu yaklaşım, temsilcinizin ortamınızla ilgili en önemli bağlama anında erişmesini sağlar.

Bileşen	Ne yapar?
overview.md	Hizmet özeti ve dizin. Her zaman bağlama yüklenir (yaklaşık 2.000 karakterlik bütçe).
Konu dosyaları	Belirli konular hakkında ayrıntılı notlar (örneğin, aks-networking-gotchas.md).
Genel bakış bağlantıları	overview.md aracınızın hangi ayrıntılı bilgilerin mevcut olduğunu bilmesi için konu dosyalarına bağlantılar.

Temsilciniz ne saklar?

Temsilciniz, konuşmalar sırasında bilgileri proaktif olarak kaydeder.

Kategori	Örnekler
Sorun kısıtlamaları	"Bu hizmet, kota sınırları nedeniyle 10 kopyadan fazlasına ölçeklendirilemiyor."
Çalışan stratejiler	"--grace-period=0 ile pod'u yeniden başlatmak, takılmış dağıtım sorununu çözdü."
Başarısız olan stratejiler	"Bellek sınırını artırmak işe yaramadı. Sorun CPU kısıtlamasıydı.
Belirgin olmayan bağımlılıklar	"app-frontend, önce başlatılması gereken bir sidecar proxy'ye bağlıdır."
Yapılandırma ayrıntıları	"Üretim, Key Vault'ta depolanan özel TLS sertifikalarını kullanır."

Bilgi kuruluşu

Ajanınız bilgiyi konulara göre semantik olarak, kronolojik değil, düzenler. Her dosya kendi başına bir referanstır.

Dosya	Yakaladıkları
overview.md	Hizmet özeti, anahtar bağlantıları, konu dosyalarının dizini (yaklaşık 2.000 karakter)
team.md	Ekip üyeleri, roller, uzmanlık (yaklaşık 500 karakter)
architecture.md	Bileşenler, bağlantılar, ortamlar (yaklaşık 1.500 karakter)
logs.md	Günlük kaynakları, tablolar, anahtar alanları, yararlı sorgular (yaklaşık 1.500 karakter)
deployment.md	İşlem hattı ayrıntıları, sürüm arama, geri alma yordamları (yaklaşık 1.000 karakter)
auth.md	Kimlik doğrulama mekanizmaları, kimlik akışları (yaklaşık 800 karakter)
debugging.md	Yaygın sorunlar, sorun giderme kılavuzları, runbook bağlantıları (yaklaşık 1.000 karakter)
queries/*.md	Konuya göre düzenlenmiş ayıklanmış sorgular (her birinde yaklaşık 1.000 karakter)

Mevcut bilgileri güncelleştirirken aracınız geçerli dosyayı okur, yeni bilgileri birleştirir ve güncel olmayan veya yanlış olan her şeyi kaldırır.

Tip

Temsilcinizden de bilgi kaydetmesini isteyebilirsiniz

Otomatik kalıcılığın ötesinde, aracınızdan bilgileri bilgi dosyalarına kaydetmesini açıkça isteyebilirsiniz:

Save this to your knowledge: our Redis cache uses Premium tier with 6GB,
and failover takes about 90 seconds.

Temsilciniz uygun bilgi dosyasını oluşturur veya güncelleştirir ve overview.md'den bağlantı kurar.

Bu yaklaşım, ayrı olguları ayrı bir bellek deposuna kaydeden komutlardan #remember farklıdır (sonraki bölümde açıklanmıştır). Bilgi dosyaları, aracınızın her konuşmanın başında başvurduğu yapılandırılmış ve kalıcı başvurulardır. Kullanıcı bilgileri, #retrieve aracılığıyla aranabilir bireysel verilerdir.

Kullanıcı anıları

Ajanınızın otomatik olarak öğrendiklerinin ve hatırladıklarının ötesinde, ajanınızın hatırlaması için belirli bilgileri açıkça kaydedebilirsiniz. Kullanıcı anıları, olaylarda ortaya çıkmayabilecek ancak bağlam açısından önemli olan ortama özgü ayrıntılar için idealdir.

Aşağıdaki tabloda, kullanıcı anıları için iyi adaylar açıklanmaktadır.

Kategori	Örnekler
Ortam bilgileri	Üretim, Batı ABD 2'de üç Azure Kubernetes Hizmeti (AKS) kümesini kullanıyor.
Ekip tercihleri	"Dağıtımlar için portal yerine CLI tercih ediyoruz"
Mimari ayrıntıları	"app-service-01 sql-prod'a bağlıdır"
İlerletme yolları	"PagerDuty, ardından Teams kanalı, ardından telefon"

Bellek komutları

Bu sohbet komutlarını kullanarak kullanıcı anılarını yönetin.

Command	Ne yapar?	Example
#remember	Bir olguyu gelecekte başvurmak üzere kaydetme	#remember our Redis cache uses Premium tier
#retrieve	Kayıtlı anılarınızı arama	#retrieve what's our caching setup?
#forget	Kaydedilmiş belleği kaldırma	#forget the outdated Redis info

Aşağıdaki örnekte tipik bir bellek iş akışı gösterilmektedir.

Önemli bağlamı kaydedin:

#remember Production uses 3 AKS clusters in West US 2
#remember Our escalation path: PagerDuty, then Teams channel, then phone
#remember Database failover takes approximately 15 minutes

Daha sonra alın:

#retrieve how long does database failover take?

Aracı kaydedilen belleğe göre yanıt verir: "Veritabanı yük devretmesi yaklaşık 15 dakika sürer."

Bilgi bankası

Belgelerinizi karşıya yükleyin ve aracınıza daha geniş bir başvuru kitaplığı sağlamak için dış kaynakları bağlayın.

Belgeleri yükle

Belgelerinizi karşıya yüklemek için Oluşturucu>Bilgi Bankası'na gidin. Desteklenen biçimler, sınırlar ve aracınızın otomatik olarak bilgi oluşturma şekli hakkında ayrıntılı bilgi için bkz. Bilgi belgelerini karşıya yükleme.

Belge türü	Için iyi
Runbook'lar	Adım adım olay prosedürleri
Mimari kılavuzları	Ortamınızı anlama
Nöbet el kitapları	Yükseltme ve yanıt yordamları
API belgeleri	Hizmete özgü bilgiler
Takım prosedürleri	İş akışı ve işlem belgeleri

Desteklenen biçimler: Markdown, düz metin, PDF, Word, PowerPoint, Excel, resimler ve daha fazlası. Dosya başına boyut üst sınırı 16 MB'tır. Tam liste için bkz Bilgi belgelerini karşıya yükleme.

Dış kaynakları bağlama

Bağlayıcıları kullanarak doğrudan dış sistemlerden bilgilere erişin. Desteklenen kaynakların tam listesi için bkz. Bağlayıcılar.

Bağlayıcı	Ne sağlar?
Azure DevOps	ADO wiki sayfalarınızı sorgulama
GitHub	Depoları arama, wiki'ler, sorunlar
Özel MCP	Yapılandırdığınız herhangi bir bilgi kaynağı

Oluşturucu>Bağlayıcıları'nda bağlayıcıları yapılandırın. Daha fazla bilgi için bkz. Bağlayıcılar.

Konuşmalarda bilgi kullanma

Temsilciniz, soruyla ilgili olduğunda bilgileri otomatik olarak arar.

How should I handle a database failover?

Bir runbook yüklerseniz ajan, temel alınan bir yanıtla yanıt verir.

Veritabanı Runbook'unuza(alıntı bağlantısı) bağlı olarak yük devretme adımları şunlardır:

1. İkincil çoğaltmanın durumunu doğrulayın...

Kaynak belgenin tamamını görüntülemek için alıntı bağlantılarını seçin.

Oturum içgörüleri

Her iş parçacığından (zaman uyumlu sohbet konuşması veya zaman uyumsuz otomatik tetiklenen görev) sonra temsilciniz bir oturum içgörüsü oluşturur. Oturum içgörüleri, temsilcinizin zamanla nasıl daha akıllı hale geldiğini gösterir.

Yakalananlar

Her oturum içgörüsü, aranabilir belleğe dönüşen yapılandırılmış öğrenmeleri ayıklar.

Bileşen	Yakaladıkları	Example
Gözlemlenen belirtiler	Hata desenleri, davranışlar	HTTP 503 hataları, %95 bellek
Çözüm adımları	Ne işe yaradı?	App Service SKU'sunun ölçeği artırıldı
Kök neden	Neden oldu?	"v2.3 dağıtımında bellek sızıntısı"
Kaçınılması gereken tuzaklar	Ne işe yaramadı?	"Yeniden başlatma işe yaramadı"

Sistem içgörüler oluşturduğunda

Aşağıdaki tabloda, sistemin ne zaman oturum içgörüleri oluşturduğu açıklanmaktadır.

Thread türü	Ne zaman	Otomatik veya el ile
Sohbet senkronizasyonu	Son iletiden 30 dakika sonra	Automatic
Asenkron görevler	Tamamlandıktan 30 dakika sonra	Automatic
Kullanıcı geri bildirimi	Bir yanıtı derecelendirdiğinizde	Tetiklersiniz

Oturum içgörülerini görüntüleme

Şu bilgileri görmek içinOturum içgörülerini> bölümüne gidin:

• Ajan eylemleri zaman çizelgesi
• Değerlendirme puanları
• Çıkarılan önemli dersler
• Kaynak iş parçacığı bağlantıları: Her içgörü kartı, onu oluşturan iş parçacıklarına geri bağlanır, böylece her içgörüyü özgün konuşmasına kadar takip edebilirsiniz.

Ayrıntılı ölçümler ve yönetim için bkz. Aracı kullanımını izleme.

En iyi uygulamalar

Ajanınızın belleğinden ve bilgi özelliklerinden en iyi şekilde yararlanmak için bu önerileri izleyin.

Yükleme veya bağlama işlemini seçin

Yükle	Bağlayıcı aracılığıyla bağlanma
Olay runbook'ları	Canlı wiki sayfaları (ADO, GitHub)
Mimari diyagramları	Kaynak kod depoları
Eskalasyon Prosedürleri	Gerçek zamanlı izleme verileri
Statik API belgeleri	Sık güncelleştirilen belgeler

Bilgileri güncel tutma

Eski belgeler yanlış yanıtlara neden olur. Bilgi bankanızı üç ayda bir gözden geçirin. Temsilcinizin şu anda hangi belgelere sahip olduğunu öğrenmek için şunu sorabilirsiniz.

What knowledge documents do you have?

Builder > Bilgi Bankası'nda eski belgeleri kaldırın.

Belgeleri net bir şekilde adlandır

Temsilcinizin ve ekibinizin doğru belgeleri hızla bulmasına yardımcı olmak için açıklayıcı dosya adlarını kullanın.

Kullanmayın	Bunun yerine kullan
doc1.txt	production-database-failover.md
runbook.md	aks-cluster-scaling-runbook.md
notes.txt	yükseltme-prosedürleri-2026.txt

İlgili içerik

Kaynak	Neden önemlidir?
Bilgi belgelerini karşıya yükleme	Ayrıntılı dosya biçimi desteği, sınırları ve aracı tarafından oluşturulan bilgiler
Bağlayıcılar	Bağlayıcılar aracınıza dış verileri nasıl getirir?
Özel ajanlar	Özel aracılar iş akışlarında bilgileri nasıl kullanır?