Ajan tasarım çerçevesini kullanın

Ajan tasarım çerçevesi, tetikleyiciler, araçlar, kanallar, yönetişim gereksinimleri ve daha fazlasını içeren ajanınızın amacını tanımlamanızda size rehberlik eden bir dizi yapı taşı sunar. Bu çerçeve katı bir şablon değildir—ekibinizin kararlarda uyum sağlamasına, riskleri erken belirlemesine ve yaygın tuzaklardan kaçınmasına yardımcı olan bir düşünme yardımcıdır.

Tip

Bu makale, aşağıdaki videoda ele alınan kavramlara dayanmaktadır. Ek bilgi ve rehberli bir inceleme için şunu izleyin: Copilot Studio iş planı – Ajanslar tasarlamak için şablonunuz

Ajan tasarımının yapı taşları

Temsilcinizi tam olarak tanımlamak için aşağıdaki yapı taşlarını kullanın.

Tip

Ajans projelerinizi haritalamak için düzenlenebilir tasarım tuvalini indirin.

Tetikleyiciler, kanallar, veriler, araçlar, akışlar, talimatlar, mimari, yönetişim ve değerlendirme bölümlerini gösteren ajan tasarım tuvalinin ekran görüntüsü.

Her bölüm tartışma ve hizalanmayı destekler, katı dokümantasyon değil.

Category Description Example Yaygın tuzaklar
Hedef Kendinize sorun, "Hangi sonucu elde etmeye çalışıyorum?"Hangi araçlara ihtiyacım var?", "Hangi konnektörleri aramalıyım?" ya da "Hangi konuyu oluşturmalıyım?" değil.

Temsilcinin neden var olması gerektiğini, neleri başarması gerektiğini ve hedef kitlenin kim olduğunu açıkça belirtin. Sonuçlara odaklanın. Aracının tasarımı sorunundan kaynaklansın.

Açıklama:
  • Sorun veya değer farkı
  • Hedef kullanıcılar
  • Beklenen etki
  • Başarı nasıl görünür

** Jobs-To-Be-Done formatını kullanın.
  • Bir <kullanıcı> olarak
  • Yapmam gerekiyor<yapılması gereken iş>
  • Yani<Sonuç>
  • Yeni bir çalışan olarak, işe alımda güvenle yol alabilmem için yerel İK politikalarımı anlamam gerekiyor.
  • Bir BT destek yöneticisi olarak destek e-postalarını otomatik olarak işleyebilmeliyim ki manuel triage azaltılsın.
  • Sonuçlar yerine özelliklerle başla.
  • Aşırı durumlar için tasarım.
  • Ölçülebilir başarı kriterlerini atlamak.
Tetikleyiciler Ajan tetikleyicisi, bir ajanın işine veya görevine başlaması için işaret veren özel olay, koşul veya girdidir. Bir insan eylemi veya otomatik bir olay tetikleyiciyi başlatabilir.

Daha fazla bilgi edinin: Etkinliğinize uygun tetikleyiciyi bulun.
  • Sohbette bir kullanıcı mesajı.
  • Paylaşılan gelen kutuda yeni bir e-posta.
  • Bir sistemde yeni bir kayıt.
  • Planlı veya tekrarlayan bir iş.
  • Otonom ajanlar açık tetikleyiciler gerektirir. Onlar olmadan, aracı çalışmaz.
  • Tetikleyici, örneğin kullanıcının belirli bir anahtar kelime veya ifadeyi yazmasına güvenmek gibi öngörülemez kullanıcı davranışına bağlıdır.
  • Tetikleyici gerekli bağlamı eksiktir, örneğin ajan başlıyor ama etkili hareket etmek için yeterli meta veriye (kayıt kimliği, kullanıcı kimliği) sahip değil.
  • Tetikleyiciler, senaryonun gerektirdiğinden daha sık aktive olur, bu da gereksiz uygulamalara ve kaynak tüketimine yol açar.
  • Tetikleyici tasarımı platform kotalarını veya sınırlarını hesaba katmaz, bu da ajanların kullanım eşiklerine ulaşmasına veya yük altında arızalanmasına neden olur.
Araçlar ve tümleştirmeler Ajanın sadece bildiklerini değil, hangi eylemleri yapabilmesi gerektiğini tanımlayın.

Araçlar, ajanın verileri almasını veya güncellemesini, API'leri çağırmasını, iş akışlarını tetiklemesini, mesaj göndermesini ve işlem işlemlerini tamamlamasını sağlar. Ajanın dayandığı sistemleri ve sınırlamalarını (API'ler, kimlik doğrulama modelleri, oran sınırları ve sahiplik/SLA sınırları) listeleyin.

Beklenen çıktıları, başarı ve kalite kriterlerini, geri dönüş ve hata davranışlarını göz önünde bulundurun. Bağımlılıklar genellikle uygulanabilirliği artırır—bunları erken ele alın.

Daha fazla bilgi edinin: Ajanlara araç ekleme mekanizmaları.
  • ServiceNow bağlantı noktası → bilet detaylarını almak
  • Microsoft Entra ID bağlayıcısı → kullanıcı konumunu getirme
  • Jira API → iş öğelerini güncelleme
  • Outlook bağlayıcısı → e-postaya yanıt ver
  • Eylemleri kaydetmiyor veya denetim için çıktıları depolamıyor.
  • API'lerin kararlı ve her zaman kullanılabilir olduğu varsayılarak.
  • Gereğinden fazla izin veren araçlar.
  • Araç çağrısı geri dönüş davranışını tanımlamamak (araç çıktısının doğrulanması yok, araçlar arızalandığında geri dönüş yok, yükseltme yolu yok).
  • Hız sınırlarını veya sınırlamayı görmezden gelmek.
  • Eksik bağımlılık eşlemesi (her API'nin sahibi kim, hizmet seviyesi anlaşması nedir).
  • Eylemleri yapmadan önce ön koşulları doğrulamamak.
Channels Kanal, ajanınızın konuşlandırıldığı ve kullanıcılarla etkileşime girdiği özel platform veya arayüzdür.

Kanal ayrıca gecikme, sıra alma ve deneyim konularında kullanıcı beklentilerini de etkiliyor.
  • Microsoft Ekipleri
  • SharePoint
  • Microsoft 365 Copilot
  • Web Sohbeti veya ses arabirimleri
  • Kanalları kullanıcıların nasıl ve nerede çalıştığına değil, kolaylık veya dağıtım basitliğine göre seçmek.
  • Kullanıcıların, kendilerinin bulunduğu yerde onlarla buluşmak yerine, aracının kanalına uyum sağladığını varsaymak.
  • Teknik fizibiliteyi kullanıcı deneyiminden üstün tutmak, ajanın doğru çalışmasına rağmen düşük benimsenmeye yol açar.
  • Gerçek kanalın e-posta veya iş akışı yönlendirmeli olduğu durumlarda "sohbet öncelikli" tasarım yapmak (destek gerçekten Outlook üzerinden yürütüldüğünde konuşmaya dayalı bir kullanıcı deneyimi oluşturmak; e-postanın esasında konuşma değil, sıra tabanlı olduğunu unutmak)
  • Kanala özgü kısıtlamaları göz ardı etmek (Outlook, soruları netleştiren değil, eksiksiz yanıtları gerektirir; Teams, Uyarlamalı Kartlar'ı destekler, e-posta desteklemez)
Bilgi ve veri Temsilcinin akıl yürütmesi gereken bilgileri ve bilgi veya verinin mevcut olduğu yeri belgeleyin. Veri kalitesi ve tazeliğini, yapılandırılmış ve yapılandırılmamış içeriği ile erişim ve izin sınırlarını göz önünde bulundurun.

Veri hazırlığı, erken ele alınmazsa geç aşama engelleyicilerin en yaygın kaynaklarından biridir.
  • Documents
  • Databases
  • Web siteleri
  • Bilgi tabanı
  • İç veya dış sistemler
  • Kötü veya tutarsız veri yönetişimi. Sahiplik, yenileme hızı ve güncelleme süreçleri tanımlanmadığında, veriler hızla modası geçmiş veya çelişkili hale gelir.
  • "Belgeleri" "bilgi" ile karıştırmak. Büyük belge depolarını gerçeğin kaynağı olarak işaret etmek, bu belgelerin güncel, iyi yapılandırılmış veya tutarlı etiketlenmiş olup olmadığını düşünmeden.
  • Bilgi kaynakları birbirine çarpışıyor. Bir politika, prosedür veya veri setinin birden fazla versiyonu, ajanı çelişkili talimatlara yönlendirir.
  • İzinler ve erişim kontrolleri açıkça tasarlanmamıştır. Hassas içerik istemeden açığa çıkar ya da ajan, son kullanıcıların erişemediği bilgilere referans verir.
  • Güvenlik sınırlarını doğrulamadan bilgi kaynaklarını genişletmek, erişim kısıtlandığında ajanların ya aşırı paylaşım yapmasına ya da başarısız olmasına yol açıyor.
Akışlar ve orkestrasyon Ajan genelinde işin nasıl yapılandırıldığını ve sıralandığını tanımlayın: ne zaman deterministik akışlar veya konular kullanılacağı, ne zaman orkestrasyona dayanılacağı ve ne zaman insan katılımının gerekeceği. Amaç, öngörülebilir davranış, güvenli otomasyon ve net tırmanmadır.

Akışlar veya konular ne zaman kullanılır:
  • Çok adımlı veri toplama
  • Rehberli sorun giderme veya karar ağaçları
  • Uyumluluk veya politika odaklı süreçler
  • Yüksek etkili veya geri dönüşü olmayan eylemler
Konular, deterministik mantığın birincil mekanizmasıdır.

Tanımlayın:
  • Ajan bağımsız olarak neler yapabilir
  • İnsan onayı, inceleme veya geçersiz kılma gerektiren şeyler
  • Aracının durumu üst makama görev aktarması veya geciktirmesi gerektiğinde
  • İnsan geri beslemesi nasıl iyileşmeye dönüşür?
  • Her Şeyi Sor Ajanı: Minimum deterministik akışlar; temel olarak orkestrasyon ve üretken akıl yürütmeye dayanır.
  • Otonom ajan: Kritik adımlar için dizileme, doğrulama ve koruma önlemlerini uygulamak amacıyla akışlar veya konular kullanır.
  • Onay iş akışları: Temsilci bağlam ve önerileri hazırlar; İnsanlar yüksek etkili eylemleri onaylar veya geçersiz kılar.
  • Akışları aşırı yapılandırmak, esnekliği sınırlamak ve ajanı sert veya kırılgan hissettirmek.
  • Akışların yetersiz yapılandırılması, güvenilirliğin azalması ve sonuçların öngörülemez hale gelmesi.
  • Konuları deterministik mantık için açıkça kullanmamak, bu da geçici veya tutarsız davranışlara yol açar.
  • İnsan ile ajan arasındaki sorumlulukların bulanıklaşması, belirsiz tırmanma yollarına yol açıyor.
  • İnsanları düşük riskli eylemler için onaylarla aşırı yüklemek, darboğazlar yaratıyor ve ajan kullanımını caydırıyor.
  • Özellikle kenar veya yüksek riskli durumlarda, net "harekete geçmeme" sınırları olmadan hareket eden ajanlar.
Talimatlar ve davranış Talimatlar şunları tanımlar:
  • Temsilcinin rolü ve sorumlulukları
  • Nasıl mantık çıkarır ve yanıt verir?
  • Bilgi, araç veya diğer ajanları ne zaman ve nasıl kullanması gerektiği
  • İzlemesi gereken eylemler dizisi
  • Ton, sınırlar ve güvenlik kuralları
Açık talimatlar, bilgiyi, araçları ve akışları tutarlı, öngörülebilir bir sisteme bağlar.

Daha fazla bilgi edinin: Üretken düzenleme için yüksek kaliteli talimatları yapılandırın ve deklaratif ajanlar için etkili talimatlar yazın.
  • Rol ve kapsam: "Gelen posta kutusu mesajlarını okumaktan, bilet numaralarını çıkarmaktan ve ServiceNow'dan onaylanmış bilgilerle yanıt vermekten sorumlu BT E-posta Destek Temsilcisisiniz."
  • Sıralı davranış: "Adım 1: Mevcut bir politika veya bilinen sorun için bilgi tabanını kontrol edin. Adım 2: Bilgi bulunmazsa veya eksikse, bilet detaylarını almak için ServiceNow aracını arayın. Adım 3: Gerekli veri hâlâ eksikse, 'Bilmiyorum' şeklinde yanıt verin ve yükseltin."
  • Araç kullanım kuralları: "Çıkarılmış kimlikleri yanıtlarda kullanmadan önce her zaman bir araç çağrısıyla doğrulayın."
  • Hata yönetimi: "Bilgi eksikse veya bir araç çağrısı başarısız olursa, tahmin yürütmeyin. Net bir sınırlama ve bir sonraki adımla yanıt verin."
  • Talimatlar çok belirsiz. Örneğin, "Destek sorunlarıyla ilgili kullanıcılara yardım et" bölüminde alan adını, sınırları veya izin verilen işlemleri belirtmez.
  • Bilgi, araçları ve diğer ajanların ne zaman kullanılacağı konusunda netlik yok, bu da tutarsız veya verimsiz davranışlara yol açıyor.
  • Talimatlar işlem dizisini tanımlamaz, bu da ajanın bilgi ve araç çıktılarını öngörülemez şekillerde karıştırmasına neden olur.
  • Araç kullanım kuralları açıkça tanımlanmamış olup, araçların gereksiz yere çağrılmasına veya hiç çağrılmamasına veya bilgi ile araç çıktılarının beklenmedik şekillerde karışmasına yol açabilir.
  • "Her zaman netleştirici sorular sor" ve "sadece nihai cevaplarla yanıt ver" gibi çelişkili talimatlar.
  • Hassas verileri değiştirmek, iç tanımlayıcıları paylaşmak veya doğrulanmış kaynaklar olmadan yasal veya İK tavsiyesi vermek gibi açık "yapılmamalıdır" rehberleri yok.
Ajan mimarisi ve bileşimi Aşağıdaki durumlarda birden fazla ajan kullanın:
  • Alan türleri büyük veya farklıdır
  • Sahiplik takımlar arasında farklılık gösterir
  • Erişim veya izinler farklılık gösterir
  • Özel akıl yürütme gereklidir
Delegasyon, modülerliği, netliği ve uzun vadeli sürdürülebilirliği artırır.

Daha fazla bilgi edinin: Çok ajanlı orkestrasyon kalıplarını keşfedin.
  • Ana ajan, bilet aramasını bir BT temsilcisine devreder.
  • Bilgi ajanı belge kalite değerlendirmesini yönetir.
  • Yönlendirme temsilcisi, hangi uzman temsilciyi çağıracağına karar verir.
  • Aşırı delegasyon (çok fazla ajan)—örneğin, her küçük görev için ayrı bir ajan oluşturmak—mimari yayılmaya yol açabilir ve ajanların bakımını, hata ayıklamayı, güvenliğini veya güncellemesini zorlaştırabilir.
  • Yetersiz yetkilendirme (tek bir dev ajan)—örneğin, bir ajandan İK sorularını yanıtlaması, BT biletlerini araştırması, sorunları çözmesi ve satın alma siparişleri ile olayları oluşturması bekleniyorsa—sonuç olarak sürdürülmesi zor, monolitik ve kırılgan bir ajan ortaya çıkabilir.
  • Tanımlanmamış delegasyon sınırları. Örneğin, ana aracı ne zaman devredeceğini bilmiyor, alt aracılar hangi girdileri beklemeleri gerektiğini bilmiyor veya sorumluluklar çakışıyor (iki aracı da BT destek kayıtlarını arıyor).
Yönetişim ve risk yönetimi Ajanın yaşam döngüsü boyunca sorumlu, güvenli ve öngörülebilir davranmasını sağlamak için nasıl yönetildiğini, güvence altına alındığını ve izlendiğini tanımlayın.

Bu tanım, erişim kontrolü, eylem izinleri, güvenlik engelleri, hesap verebilirlik ve hem operasyonel hem de yapay zeka ile ilgili risklerin ilk günden itibaren sürekli denetimini içerir.

Daha fazla bilgi edinin: Yönetişim gereksinimlerini yakalayın ve sorumlu yapay zeka ilkelerini uygulayın.
  • Kimlik doğrulama ve erişim modeli: Ajan, yalnızca kullanıcının görebileceği verileri almak için kullanıcı düzeyinde kimlik kullanırken, sistem düzeyindeki kimlikler net tanımlanmış hizmet işlemleriyle sınırlıdır.
  • Eylem izinleri ve koruma korkulukları: Ajan, iş notlarını güncelleyebiliyor veya yanıt taslağı yapabilir, ancak onay olmadan geri döndürülemez işlemler (örneğin bilet kapatmak veya harici iletişim göndermek gibi) gerçekleştiremez.
  • Güvenlik ve içerik korumaları: Hassas veya düzenlenmiş bilgiler, platform korumaları (örneğin, veri kaybı önleme veya güvenlik filtreleri) kullanılarak paylaşılması veya müdahale edilmesi engellenir ve tespit edilir.
  • Günlük kaydetme, denetim ve izlenebilirlik: Tüm aracı eylemleri, araç çağrıları, reddetmeler ve görev aktarmalar, uyumluluk ve inceleme amacıyla kaydedilir ve denetlenebilir.
  • Operasyonel sahiplik: Temsilcinin tanımlı bir sahibi, sponsoru ve operasyonel yöneticisi vardır; izinleri ve davranışları düzenli olarak incelenir.
  • Yönetişim ve risk kontrollerinin çok geç tasarlanması, tıkanmış dağıtımlara veya üretim gecikmelerine yol açıyor.
  • Ajanları "kolaylık için" aşırı izinlendirmek, veri açığa çıkma veya istenmeyen eylemler riskini artırır.
  • Eksik izin veren ajanlar, gerekli sistemler veya verilere ulaşılamadığında çalışma zamanında arızalara neden olur.
  • Sorumlu Yapay Zeka endişelerini temel yönetim kararlarına entegre etmemek.
  • Zayıf operasyonel yönetişim, net bir sahibin olmaması, izleme planı olmaması veya olay müdahalesi için tanımlanmış bir süreç olmaması.
  • Dağıtımdan sonra aracı davranışını izlememek, sadece koruyucu önlemlerin yeterli olduğunu varsaymak.
Değerlendirme ve optimizasyon Ajanlarınızın yanıtlarının doğruluğunu, alaka düzeyini ve kalitesini ölçmek için gerçek dünya senaryolarını simüle eden testler tanımlayın. Beklenen bir yanıt verin ve ajan yanıtının sizin yanıtınıza veya en standart yanıtla nasıl eşleştiğini gösterin.

Performansı nasıl ölçeceğinizi ve iyileştireceğinizi planlayın:
  • Doğruluk ve önemlilik
  • Zaman kazanımı veya verimlilik
  • Benimsenme ve kullanım
  • Memnuniyet ve güven sinyalleri
  • Atıf kalitesi
  • İzin uyumu
  • Yanlış bilginin tespiti
  • Soru davranışını netleştirmek

Hangi telemetri toplanacağını tanımlayın:
  • Araç çağrıları
  • Ajan eylemleri
  • Başarısızlıklar ve yeniden denemeler
  • Kullanıcı geri bildirimi

Değerlendirmeyi tasarımın bir parçası olarak değerlendirin, sonradan düşünülmüş bir şey olarak değil. Daha fazla bilgi edinin: Ajan değerlendirmesini tasarlayın ve operasyonel hale getirin.
  • Doğrulayın ki bilet sorgulama işlemi doğru durumu döndürüyor ve güncel olmayan bir durumu göstermiyor.
  • Atıf bağlantılarının mevcut onaylı içeriğe işaret ettiğini doğrulayın.
  • Temsilcinin başka bir kişinin biletiyle ilgili detayları vermeyi reddettiğini doğrulayın.
  • Temsilcinin bir bilet numarası veya KB maddesi uydurup uydurmadığını test edin.
  • Otonom ajanın günlük işlediği e-posta sayısını ve manuel kanallar yerine ajanı tercih eden kullanıcı yüzdesini ölçün.
  • Değerlendirmeleri çok geç yapmak (görevden sonra).
  • Hiçbir temel ya da kıyaslama yok.
  • Değerlendirmeler gerçek senaryolara bağlı değil.
  • Regresyon tespiti yok.
  • Çok turlu değerlendirme yok.
  • Araç kullanımı kalitesi için değerlendirici yok.
  • Sadece "mutlu yollar"ı kontrol ediyor.
  • Telemetri boşlukları.

Önemli temel bilgiler

Yapılandırılmış bir tasarım çerçevesi, ekiplerin sorunları akıl yürütmesine ve daha iyi kararlar almasına yardımcı olan bir düşünme yardımcısı olarak hizmet verir.

  • Özellikler yerine sonuçlarla başlayın.
  • Yönetişim ve veri tuzaklarından kaçının.
  • Daha güvenli ve güvenilir ajanlar oluşturun.
  • Ölçek, güven ve uzun vadeli sürdürülebilirlik için tasarım.

Tasarımın atlanması erken öğrenmeyi hızlandırabilir, ancak yapılandırılmış tasarım deneyleri dayanıklı ve güvenilir çözümlere dönüştürür.

Sonraki adım

Yapılandırılmış tasarım çerçevesinin nasıl uygulanacağına dair bir örneği inceleyin.