Ajans geliştirme yaşam döngüsü

Microsoft Foundry'deki aracı geliştirme yaşam döngüsü, ilk oluşturma işleminden üretim izlemesine kadar devam eder. Bu yaşam döngüsünü takip etmek güvenilir aracılar oluşturmanıza, sorunları erken yakalamanıza ve güvenle göndermenize yardımcı olur. Acentenizin davranışını oluşturmak, özelleştirmek ve test etmek için Foundry Portalı veya kodunu kullanın. Ardından kalite ve güvenilirliği artırmak için iz sürme, değerlendirmeler yaparak ve izleme ile yineleyin. Hazır olduğunuzda, aracınızı paylaşmak ve uygulamalarınıza entegre etmek için bir aracı uygulama olarak yayımlayın.

Bu makale, üretime hazır aracılar oluşturmak, test etmek ve göndermek isteyen geliştiricilere yöneliktir.

Önkoşullar

• Microsoft Foundry projesi
• Agents oyun alanı hakkında bilgi
• Kod geliştirme için: Geliştirme ortamı kurulumu hakkında bilgi

Bir bakışta yaşam döngüsü

Bir aracı oluşturup gönderirken bu yaşam döngüsünü pratik bir denetim listesi olarak kullanın.

1. Bir aracı türü seçin: İstem tabanlı aracı, iş akışı veya barındırılan aracı ile başlayın.
2. Temsilcinizi oluşturun ve test etmeye başlayın: Oyun alanında veya kodda yinelen.
3. Araç ve veri ekleme: Alma ve eylemler için araçlar ekleyin ve kaydetmeden önce yapılandırmayı doğrulayın.
4. Değişiklikleri sürüm olarak kaydedin: Anlamlı kilometre taşlarını yakalayın ve sürümleri karşılaştırın.
5. İzleme ile hata ayıklama: Araç çağrılarını, gecikme süresini ve uçtan uca davranışı onaylamak için izlemeyi kullanın. Ayrıntılar için bkz Aracı İzlemeye Genel Bakış.
6. Kalite ve güvenliği değerlendirme: Yayımlamadan önce regresyonları yakalamak için yinelenebilir değerlendirmeler çalıştırın. Kavramsal rehberlik için bkz. Aracı değerlendiricileri.
7. Yayımlama ve tümleştirme: Kararlı bir uç nokta yayımlayın ve bunu uygulamanızla tümleştirin. Adımlar için bkz. Microsoft Foundry'de aracıları yayımlama ve paylaşma.
8. İzleme ve yineleme: Üretim performansını ve kalitesini izleyin, ardından gerektiğinde güncelleştirin ve yeniden yayımlayın. Rehberlik için bkz. Kalite ve güvenliği izleme.

Microsoft Foundry'de aracı türleri

Üç tür etmen vardır:

• İstem tabanlı: İstem tabanlı aracı, davranışı yönlendirmek için model yapılandırmasını, yönergeleri, araçları ve doğal dil istemlerini birleştiren bildirim temelli olarak tanımlanmış tek bir aracıdır. Bilgi ve bellek için araçlar ekleyerek genişletin. Foundry portalındaki Agents oyun alanından istem tabanlı aracıları düzenleyin, sürüm oluşturun, test edin, değerlendirin, izleyin ve yayımlayın.

• İş akışı: Bir dizi eylemi düzenleyen veya birden çok aracıyı koordine eden daha gelişmiş bir iş akışı oluşturmak için iş akışlarını kullanın. İş akışlarının portalda kendi arabirimi vardır, ancak aynı yaşam döngüsü geçerlidir. Ayrıntılar için bkz. Microsoft Foundry'de iş akışı oluşturma.

• Barındırılan (önizleme): Barındırılan aracılar, desteklenen çerçeveleri veya özel kodu kullanarak kodda derlediğiniz kapsayıcılı aracılardır. Döküm Ajan Hizmeti bu ajanları dağıtır ve yönetir. Aracı oluşturma kullanıcı arabiriminde barındırılan aracıları düzenlemezsiniz, ancak yine de çağırabilir, değerlendirebilir, izleyebilir ve yayımlayabilirsiniz. Ayrıntılar için bkz. Barındırılan aracılar nelerdir?

CLI, SDK veya REST API kullanarak Foundry portalında veya kendi geliştirme ortamınızda istem tabanlı aracılar ve iş akışları oluşturun. Daha fazla bilgi için bkz. hızlı başlangıç.

Prompt tabanlı ajan oluşturma

Ne tür bir aracı oluşturmak istediğinizi zaten biliyorsanız, aracıyı adlandırın ve model yönergelerini ve araçlarını yapılandırmaya başlayın.

Uyarı

Aracınızı adlandırdıktan sonra adı değiştiremezsiniz. Kodda aracınıza ile başvurursunuz.

Kodda aracı geliştirme

Kodda çalışmayı tercih ediyorsanız, aracı kodunuzu yerel olarak test edip Azure dağıtabileceğiniz bir geliştirme ortamına getirmek için desteklenen yolları kullanın.

Aracı oyun alanının sohbet bölmesindeki Code sekmesinden, aracınızı referans alan bir kod parçacığını özel bir Visual Studio Code Web bulut ortamına taşıyabilirsiniz. Kod parçacığı, ihtiyacınız olan paketler ve uzantılarla birlikte, Foundry aracınızı verimli bir şekilde geliştirme ve Azure dağıtma yönergeleriyle birlikte önceden yapılandırılmış olarak gelir. Kod parçacığını doğrudan tercih ettiğiniz geliştirme ortamına da kopyalayabilirsiniz. Ayrıntılar için oyun alanı belgelerine bakın.

Temsilci geliştirme yaşam döngüsü için temel işlevler

Aracı oluşturma deneyimi, aracı geliştirme yaşam döngüsünün her temel adımı için tümleşik deneyimler sunar. Üretime hazır aracı uygulamanızı geliştirirken bu temel özellikleri kullanın. Her özelliğin daha fazla bilgi edinebileceğiniz ayrıntılı belgeleri vardır.

Değişiklikleri sürüm olarak kaydetme

bir istem tabanlı aracının veya iş akışının ilk sürümünü oluşturduktan sonra, sonraki değişiklikleri yeni sürümler olarak kaydedin. Ajan oyun alanında kaydedilmemiş değişiklikleri test edebilirsiniz. Ancak konuşma geçmişini görüntülemek, aracınızın performansını izlemek veya tam değerlendirmeler çalıştırmak istiyorsanız değişikliklerinizi kaydetmeniz gerekir.

Aracı sürümü oluşturma aracı yapılandırmalarını ve yinelemelerini yönetmek için aşağıdaki özellikleri sağlar. Bu sistem, tüm değişikliklerin sürümler arasında izlenmesini, test edilebilir ve karşılaştırılabilir olmasını sağlar.

• Sürüm değiştirilemezliği: Bir aracıyı kaydettikten sonra her sürümü sabittir. Mevcut bir sürümde yapılan tüm değişiklikler, yeni bir sürümün kaydedilmesini ve oluşturulmasını gerektirir. Bu gereksinim, sürüm bütünlüğünü sağlamaya yardımcı olur ve yanlışlıkla üzerine yazmaları önler.

• Taslak durum yönetimi: Deneme için aracıları kaydedilmemiş durumda test edebilirsiniz. Foundry portalından ayrılırsanız kaydedilmemiş değişiklikleri kaybedersiniz, bu nedenle önemli değişiklikleri korumak için sık sık kaydedin.

• Sürüm denetimi işlemleri: Denetimli dağıtım ve geri alma özelliklerini etkinleştirmek için istekleri belirli aracı sürümlerine yönlendirebilirsiniz.

• Sürüm geçmişi gezintisi: Herhangi bir aracı için sürüm geçmişine erişin, belirli bir sürüme gidin ve aşağıdaki karşılaştırmaları gerçekleştirin:

  Karşılaştırma türü	Description
  Ajan kurulumu	Sürümler arasındaki yapılandırma ayarlarını karşılaştırmak için sürüm açılan listesini kullanın.
  Sohbet çıktısı	Aynı girişleri kullanarak aracı sürümleri arasındaki yanıt farklarını analiz etme
  YAML tanımı	Aracı tanımlarındaki farkları gözden geçirme

Araç ekleme

Aracınızı bilgi vererek (belirli dosyalar veya dizinler) veya eylem gerçekleştirmesine izin vererek (dış API'leri çağırarak) daha güçlü hale getirin. Araçlar, basit dosya yüklemelerinden özel Model Bağlam Protokolü (MCP) sunucu bağlantılarına kadar çoğu kullanım örneğinde kullanılabilir. Daha karmaşık araçlar için kimlik doğrulamasını yapılandırmanız veya bunları bir aracıya eklemenin bir parçası olarak bağlantılar eklemeniz gerekebilir.

Bir aracı bağlı bir araçla kaydetmek için aracı başarıyla yapılandırmanız gerekir. Yapılandırılmış araçları aracılar arasında yeniden kullanın. Kullanılabilir araçlar hakkında bilgi için bkz. araçlar kataloğu.

İzlemeyi kullanarak hata ayıklama ve doğrulama (önizleme)

Araçlar ekleyip istemleri yinelerken, uçtan uca davranışı doğrulamak için izlemeyi kullanın:

• Aracının beklediğiniz araçları çağırıp çağırmadığını onaylayın.
• Araç girişlerini ve çıkışlarını inceleyin.
• Model ve araç çağrıları arasında gecikme noktalarını belirleme.

Daha fazla bilgi için Aracı izlemeye genel bakış bölümüne bakın.

Kalite ve güvenliği değerlendirme (önizleme)

Ajanınızı yayımlamadan önce (ve her anlamlı değişiklikten sonra), regresyonları yakalamak ve sürümler arasında kaliteyi tutarlı bir şekilde ölçmek için değerlendirmeler yapın.

• Aracılar için kilit değerlendirme boyutlarına bakmak için, bkz. Aracı değerlendiricileri.
• Otomatikleştirebileceğiniz kod öncelikli bir iş akışı için bkz. Yapay zeka aracılarınızı değerlendirme.

Yayımladıktan sonra izleme

Bir aracı uygulamasını yayımladıktan sonra bunu üretim yazılımı gibi değerlendirin:

• Kalite ve güvenlik sinyallerini izleyin.
• Davranış değiştiğinde izlemeleri gözden geçirin.
• Sorunları düzeltirken veya iyileştirmeler yaptığınızda güncelleştirin ve yeniden yayımlayın.

Yönergeler için bkz. İzleme ajanları.

Kimlik ve izinler için planlama

Araçlar ve aşağı akış kaynakları genellikle kimlik doğrulaması gerektirir. Bir aracı yayımladığınızda, aracının kimliği ve izin modeli değişebilir. Yayımlanan aracınızın yalnızca ihtiyaç duyduğu erişime sahip olduğundan emin olun.

Ayrıntılar için bkz. Microsoft Foundry'de aracı kimliği kavramları.

Güvenlik ve erişim

Aracı yapılandırmanıza uygulama kodu gibi davranın. Yaşam döngüsü boyunca gizli bilgileri ve izinleri koruma altına alın.

• Anahtar eklemek yerine en az ayrıcalık ve rol ataması kullanın. Daha fazla bilgi için bkz. Dökümhane portalında rol tabanlı erişim denetimi.
• Gizli dizileri yönetilen bir gizli dizi deposunda depolayın ve bunları kod, yapılandırma dosyaları veya istemlerde sabit kodlamak yerine bağlantılar aracılığıyla bunlara başvurun. Yönergeler için bkz. Key Vault bağlantısı kurma.
• Yayımlamadan önce, yayınlanan ajan uygulamasındaki ajan kimliği ve araç bağlantılarının yalnızca ihtiyaç duydukları erişime sahip olduklarını onaylayın. Ayrıntılar için bkz. Microsoft Foundry'de aracı kimliği kavramları.

Aracınızı veya iş akışınızı yayımlama

Memnun olduğunuz bir aracı veya iş akışı sürümü oluşturduktan sonra aracı uygulaması olarak yayımlayın. Tarayıcıda açıp test edip başkalarıyla paylaşabileceğiniz veya mevcut uygulamalarınıza ekleyebileceğiniz kararlı bir uç nokta elde edersiniz. Siz ve ortak çalışanlarınız performansı doğrulayabilir ve iyileştirme gerekenleri belirleyebilirsiniz. Gerekli güncelleştirmeleri yapın ve istediğiniz zaman yeni bir sürümü yeniden yayımlayın.

Önemli

Proje kimliğine atanan izinler, yayımlanan aracıya otomatik olarak aktarılmaz. Yayımladıktan sonra, ajan uygulamasının kimliğine gerekli ayrıcalıkları yeniden atayın.

Yaygın ajan geliştirme tuzakları

• Kaydedilmemiş değişiklikler geçicidir: Sürümleri karşılaştırmak, geçmişi görüntülemek veya tam değerlendirmeleri çalıştırmak istiyorsanız, değişikliklerinizi sürüm olarak kaydedin.
• Araçlar kaydetmeden önce yapılandırılmalıdır: Bir araç kimlik doğrulaması veya bağlantı gerektiriyorsa, kaydetmeden önce kurulumu tamamlayın.
• Yayımlama için izin güncelleştirmeleri gerekebilir: Yayımladıktan sonra yayımlanan aracı kimliği için kaynak erişimini yeniden denetleyin ve aracıya artık gerekmeyen tüm erişimi kaldırın.

İlgili içerik

Aracı türleri hakkında daha fazla bilgi edinin:

• Barındırılan aracılar nedir?
• Ajan çalışma zamanı bileşenleri

Aracıları yapılandırma ve genişletme:

• Döküm Araçları'nda araçları bulma
• Microsoft Foundry Agent Service'te araçları kullanmaya yönelik en iyi yöntemler

Aracıları yayımla ve izle:

• Microsoft Foundry'de aracıları yayımlama ve paylaşma
• Kaliteyi ve güvenliği izleme

Hata ayıklama ve değerlendirme:

• Ajan izlemeye genel bakış
• Ajan değerlendiricileri