Azure SRE Aracısı'nda özel aracılar

Özel aracılar, isteğe bağlı olarak çağırdığınız uzman aracılardır. Sohbete yazın /agent , uzmanınızı seçin ve sorunuzu sorun. Bu işlem, SQL sorunları için bir veritabanı uzmanına ve tehdit araştırması için bir güvenlik denetçisine erişmenizi sağlar.

Becerilerin aksine (her zaman kullanılabilir), özel aracılar açık çağrı gerektirir. Bu gereksinim uzmanlıklarını belirli görevlere göre kapsar.

Özelleştirilmiş aracılar nasıl çalışır?

Sohbette /agent eğik çizgi komutunu kullanarak özel aracı çağırın. Özel ajan, tüm konuşma bağlamını alır ve odaklanmış uzmanlıkla görev yapar.

Aşağıdaki örnekte temel bir özel aracı tanımı gösterilmektedir:

name: database_expert
system_prompt: |
  You are a database specialist. Analyze query performance,
  diagnose connection issues, and recommend optimizations.
handoff_description: Handles SQL and database troubleshooting
tools:
  - execute_kusto_query
  - azure_cli
connectors:
  - azure_sql
enable_skills: true  # Can use skills for additional expertise

Temel özellikler şunlardır:

• system_prompt: Uzman kişi profili ve talimatlar.
• handoff_description: Orkestratör, temsilci belirlemeye karar verirken ne görür?
• tools: Kullanılabilir özellikler.
• enable_skills: Bu özelliği kullandığınızda, özel aracı becerilere dinamik olarak erişebilir.

Tip

Beceriler otomatik olarak sağlanır. Temsilciniz bunları ilgili olduğunda kullanır. Özel aracılar açıktır ; odaklanmış uzmanlığa ihtiyacınız olduğunda kullanarak /agent bunları çağırırsınız.

Özel aracıları neden kullanmalısınız?

Özel aracılar, yeniden kullanım için etki alanı uzmanlığını, araçlarını ve bilgilerini paketlemenize olanak sağlar. Ana temsilciniz her şeyi halletmeye çalışmak yerine uzmanlara devreder.

Bir veritabanı sorunu düşünün: Özel aracılar olmadan, ana aracınız genel sorun gidermeyi dener. "Veritabanı Uzmanı" özel aracısı ile, sorgu analizi için ayarlanmış odaklanmış SQL uzmanlığı, veritabanına özgü runbook'lar ve araçlar elde edersiniz.

Özel aracılar, iletim zincirlerini de etkinleştirir. Olay sınıflandırma ve önceliklendirme özel aracınız, bir sorunu otomatik olarak sınıflandırır, uygun etki alanı uzmanına iletir, sorunu araştıran uzman, ardından bir bildirim yönlendiricisine devreder. Her adım özeldir.

Özel aracı oluşturma

Builder > Agent Tuvali'nde özel ajanlar oluşturun.

1. Azure portalında Azure SRE Aracınıza gidin.

2. Aracı Tuvali sekmesini seçin.

3. Oluştur'i seçin.

4. Özel Aracı seçin.

5. Aşağıdaki ayarlar için değerler sağlayın:

   Mülkiyet	Değer
   İsim	Özel aracınıza açıklayıcı bir isim girin.
   Yönergeler	Özel aracının nasıl davranması gerektiğini tanımlayan net ve özel yönergeler sağlayın.
   İletim Açıklaması	Diğer özel aracıların işlemeyi bu özel aracıya aktarması gereken senaryoları ve nedenini açıklayın.
   Özel Araçlar (isteğe bağlı)	Özelleştirilmiş temsilcinin işlemleri sırasında kullanması için bir veya daha fazla özelleştirilmiş araç seçin.
   Yerleşik Araçlar (isteğe bağlı)	Özel ajanın erişmesini istediğiniz yerleşik sistem araçlarını seçin.
   Devir Ajanları (isteğe bağlı)	Bu özel aracı görevlerini tamamladıktan sonra hangi özel aracının işlemeyi devralacağını belirtin.

   İsteğe bağlı olarak , Bilgi bankası özelliğini etkinleştirebilirsiniz. Bu seçenek, özel aracınızın sorguları yanıtlarken başvuru malzemesi olarak kullanabileceği dosyaları karşıya yüklemenize olanak tanır.

Bilgi bankası yönetimi

Belgeleri, runbook'ları ve yordam kılavuzlarını yükleyerek özel ajanlarınızın bilgisini artırın.

Acente sisteminize ekleyebileceğiniz dosya örnekleri:

• Mimari veya sistem tasarımı: Sistem bileşenlerini ve veri akışlarını açıklayan diyagramlar ve belgeler.
• Sorun giderme kılavuzları: Yaygın veya yinelenen sorunları tanılamak ve çözmek için adım adım yönergeler.
• Runbook'lar ve SOP'ler: Rutin işlemler, bakım ve olay yanıtı için ayrıntılı iş akışları.
• Olay raporları ve olay sonrası incelemeler: Kök neden analizi ve öğrenilen dersler de dahil olmak üzere geçmiş kesintilerin belgelenmesi.
• Sürüm notları ve değişiklik günlükleri: Yeni özellikler, hata düzeltmeleri ve değişiklikler dahil olmak üzere ürün veya hizmet güncelleştirmelerinin özetleri.

Desteklenen dosya türleri

Markdown () veya metin (.md.txt) biçiminde işlem yordamları.

Dosya yönetimi iş akışı

1. Ayarlar > Bilgi Bankası Dosyaları sekmesine giderek bilgi bankasına > erişin.
2. Dosyalarınızı sürükleyip bırakarak veya dosyaları seçmek için göz atarak dosyaları karşıya yükleyin (her dosya için maksimum 50 MB).
3. Daha iyi aranabilirlik için etiketler ve açıklamalar ekleyerek içeriği düzenleyin.
4. Belirli bilgi kaynaklarına erişebilecek özel aracıları yapılandırarak özel aracı erişimini etkinleştirin.
5. Özelleştirilmiş aracıların yanıtlarında yüklenmiş olan bilgileri kullanımlarını takip ederek izleyin.

Uyarı

Özel aracılarınız otomatik olarak dizin oluşturur ve karşıya yüklediğiniz dosyaları aranabilir hale getirir. Sistem, özel aracı örneği başına en fazla 1.000 dosyayı destekler.

Aracı Tuval görünümleri

Builder>Agent Canvas'ında özel aracılar oluşturun. Aşağıdaki görünümler kullanılabilir:

Görüntüle	Amaç
Tuval görünümü	Özel yapılandırılmış aracıları, araçları ve tetikleyici bağlantılarını gösteren görsel diyagram
Tablo görünümü	Hızlı erişime sahip tüm özel aracıların listesi
Test oyun alanı	Etkileşimli test ortamı

Özel aracılar ne zaman kullanılır?

Aşağıdaki tablo, özel aracıların ne zaman doğru seçim olduğunu belirlemenize yardımcı olur:

Scenario	Özel ajan kullanılsın mı?	Neden
Derin etki alanı uzmanlığı gerekiyor	Evet	PAKET SQL uzmanlığı, ağ bilgisi, en iyi güvenlik uygulamaları
Çok adımlı iş akışları	Evet	Olay önceliklendirmesi, dağıtım doğrulaması, yedekleme doğrulaması
Özelleştirilmiş araç kümeleri	Evet	Veritabanına özgü araçlar, maliyet iyileştirme araçları
Basit tek işlemler	Hayır	Basit, tekrarlanabilir eylemler için bunun yerine becerileri kullanın
Sadece okunabilir sorgular	Hayır	Ana etmen yetki devri olmaksızın yönetebilir.

Tam özel aracı kurulumu için bkz. Yanıt otomasyonu için olay yanıtı .

Özel temsilci devri

Ana temsilciniz özel bir aracıya devrettiğinde, tek bir konuşma bağlamını paylaşır. Alıcı gümrük memuru şunu görür:

• Tam konuşma geçmişi: önceki tüm iletiler, araç çağrıları ve sonuçlar.
• Alt görev mantığı: iletim, bu özel aracın gerçekleştirmesi gerekenleri ifade ediyor.
• Kullanıcının özgün sorusu: İletim zinciri boyunca korunur.

Uyarı

Özel ajanlar "temiz bir sayfa" alamaz. Aynı konuşma dizisini sürdürürler. Bu yaklaşım, her uzmanın önceki uzmanın çalışmalarına dayanarak inşa ettiği devretme zincirlerini etkinleştirir.

Çalışmasını tamamladıktan sonra, özel acente bir sonraki aracıya devreder veya kontrolü orkestratöre döndürür. Konuşma bağlamı zincir boyunca birikmeye devam eder.

Özel ajan şablonları

Aşağıdaki tabloda yaygın özel aracı desenleri açıklanmaktadır:

Desen	Örnekler	Kullanım örneği
Etki Alanı Uzmanı	VM Uzmanı, AKS Uzmanı, Ağ Uzmanı	Tek bir teknolojide derin uzmanlık (tüm VM sorunları, Kubernetes sorun giderme, VNet/NSG/yük dengeleyici)
Görev Uzmanı	Log Analyzer, Maliyet İyileştiricisi, Güvenlik Tarayıcısı	Belirli görevlere odaklanmış (günlükleri ayrıştırma, tasarrufları bulma, güvenlik açıklarını belirleme)
İş Akışı Yürütücüsü	Olay Önceliklendirme, Dağıtım Doğrulayıcı, Yedekleme Doğrulayıcı	Çok adımlı yordamlar (olayları sınıflandırma, dağıtım sonrası denetimler, yedekleme bütünlüğünü test et)

Becerileri, özel aracıları ve bilgi dosyalarını karşılaştırma

Aşağıdaki tabloda her genişletilebilirlik kavramı karşılaştırılır:

Özellik	Yetenekler	Özel ajanlar	Bilgi dosyaları
Access	Automatic	/agent komut	KB sorgu aracı aracılığıyla
Tools	Ekleyebilir	Araçlar var	Araç yok
Bağlam	İş parçacığı bağlamı kullanır	İş parçacığı bağlamını paylaşır	Sadece referans için
için en iyi	Procedures	Etki alanı uzmanları	Runbook’lar, belgeler

Doğru yaklaşımı seçmek için aşağıdaki kılavuzu kullanın:

• Yetenek: İsteğe bağlı yürütme ile ekip genelinde prosedür (AKS sorun giderme kılavuzu + Azure CLI)
• Özel temsilci: Belirli bir alanda uzman isteğe bağlı olarak çağrıldı (PostgreSQL Uzmanı)
• Bilgi dosyası: Bağlam için başvuru içeriği (mimari belgeleri)

Özel aracıları tetikleyicilere bağlama

Olaylar veya zamanlanmış görevler özel aracıları otomatik olarak tetikleyebilir. Tuval görünümünde bu bağlantılar görsel olarak gösterilir: tetikleyiciler özel aracılara bağlı düğümler olarak görünür, araçlar üst özel aracılarıyla gruplandırılır ve durum rozetleri etkin veya etkin değil durumunu gösterir.

Kurulum ayrıntıları için, özel aracıları olaylara bağlamak amacıyla olaya müdahale veya yinelenen otomasyon için zamanlanmış görevler bölümüne bakın.

Özel temsilci modları

Her özel ajan, ne kadar özerkliğe sahip olduğunu kontrol eden bir modda çalışır. Her yanıt planı veya zamanlanmış görev için modu ayarlayın.

Modu	Açıklama
Gözden geçir	Eylemler önerir, onay bekler
Otonom	İnsan onayı olmadan hareket eder

Riski temel alan modu seçin:

• Maliyet iyileştirme önerileri? Gözden Geçir'i kullanın (insan onayı gereklidir).
• İyi test edilmiş otomasyon mu? Otonom (güvenilen işlemler için) kullanın.

Her yanıt planı veya zamanlanmış görev için modları yapılandırın. Özel aracı YAML tanımında modları ayarlamayın. Daha fazla bilgi için bkz . Çalıştırma modları.

Özel aracıları test edin ve geliştirin

Dağıtmadan önce Test oyun alanında özel aracıları test edin. Oluşturucu>Aracı Tuvali'ne gidin ve görünüm geçiş düğmesinden Test oyun alanını seçin. Bölünmüş ekran düzeni, sol taraftaki yönergeleri düzenlemenize ve yapılandırmanızı puanlayarak yapay zeka destekli değerlendirmeyle sağ taraftaki canlı sohbette test etmenizi sağlar.

VS Code kullanıcıları için SRE Agent MCP sunucu uzantısı, düzenleyicinizde özel temsilci YAML dosyalarını düzenlemenize olanak tanır ve değişiklikler aracınıza otomatik olarak senkronize edilir.

Tüm ayrıntılar için Agent playground'a bakın.

İlgili içerik

Kaynak	Açıklama
Beceri	Etkeniniz için yeniden kullanılabilir yordamlar ve araçlar
Bildirim gönderme	Teams, Outlook ve daha fazlasına araştırma bulguları gönderme
Araçlarınızdan sohbet edin	Teams' den, web kancalarından ve daha fazlasından temsilcinizle etkileşim kurma