Ajan 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 yayılacaktır. Her aracının merkezinde, Foundry model kataloğundan gelen ve mantık yürütmeyi ve yanıt oluşturmayı yönlendiren bir model bulunur. 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. Ajanınızın davranışını oluşturmak, özelleştirmek ve test etmek için Foundry portalını veya kodunu kullanın. Ardından kalite ve güvenilirliği artırmak için izleme, değerlendirme ve gözlemle birlikte tekrarlayıp yenileyin. Hazır olduğunuzda, ajanınızı paylaşmak ve uygulamalarınıza entegre etmek için bir ajan uygulaması 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

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ı bir aracı veya Barındırılan aracı ile başlayın.
  2. Ajanınızı oluşturun ve test etmeye başlayın: Oyun alanında veya kodda tekrarlayarak geliştirin.
  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ı izlemeye 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 Aracı değerlendiricileri konusuna bakın.
  7. Barındırılan aracıları iyileştirme (önizleme): Aracı iyileştiricisini kullanarak barındırılan aracınızın yönergelerini otomatik olarak geliştirin ve becerileri keşfedin.
  8. Yayımlama ve tümleştirme: Kararlı bir uç nokta yayımlayın ve bunu uygulamanızla tümleştirin. Adımları görmek için bkz. Microsoft Foundry'deki Agent uygulamaları.
  9. İzleme ve yineleme: Üretim performansını ve kalitesini izleyin, ardından gerektiğinde güncelleştirin ve yeniden yayımlayın. Yönergeler için bkz. Ajanları izleme.

Microsoft Foundry'de aracı türleri

İki tür aracı vardır:

  • İstem tabanlı: İstem tabanlı aracı, davranışı yönlendirmek için Bir Dökümhane modelini, 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.

  • Barındırılan: Barındırılan aracılar, kod içerisinde desteklenen çerçeveler veya özel kod kullanarak oluşturduğunuz konteynerleştirilmiş aracılardır. Döküm Aracı Servisi 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 nedir?

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

Komut 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.

Not

Ajanınıza bir isim verdikten sonra, ismi değiştiremezsiniz. Kodda <agent_name>:<version> ile aracınıza 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.

Agent oyun alanının sohbet bölmesindeki Code sekmesinden, aracınıza referans veren kod parçacığını, Web için özel olarak ayrılmış Visual Studio Code bulut ortamına alabilirsiniz. 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.

Ajan geliştirme yaşam döngüsü için temel yetenekler

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

İstem tabanlı aracı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ü Açıklama
    Aracı kurulumu Sürümler arasındaki yapılandırma ayarlarını karşılaştırmak için sürüm açılır listesini kullanın.
    Sohbet çıkışı 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

Kararlı, get-or-create desenli başvuru aracıları

Kodda, tarafından <agent_name>:<version>bir aracıya başvurursunuz. Her aracıyı bir kez oluşturun, ardından bu tanımlayıcıyı oturumlar ve işlemler arasında kalıcı hale gelip yeniden kullanabilirsiniz.

  • Bir kez oluşturun, kimliği yeniden kullanın. Uygulamanızın bağlı olduğu aracı adını veya kimliğini önbelleğe alın. Her çalıştırmada yeniden oluşturma.
  • 404'e terminal olarak davranın. Daha önce oluşturduğunuz bir kimlik için bir GET, çalıştırma veya kullanma çağrısı döndürülüyorsa 404 Not Found aracı silinmiş olur. Yeniden oluşturun. Döngüde aynı kimliği yeniden denemeyin.
  • Get-or-create'ı tercih edin. Başlangıçta aracıyı ada göre arayın ve yalnızca arama 404 döndürdüğünde oluşturun. Bu yaklaşım tek bir kararlı kimlik tutar ve yalnız bırakılmış yinelemeleri önler.

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ı bir araç bağlı olarak 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.

Hata ayıklama ve doğrulama için iz sürme (önizleme) kullanma

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

  • Beklediğiniz araçları temsilcinin ç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 süresi etkin noktalarını belirleme.

Daha fazla bilgi için Aracı İzlemeye Genel Bakış'a bakın.

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

Etmen(leri)nizi yayımlamadan önce (ve anlamlı bir değişiklik yaptıktan sonra), regresyonları yakalamak ve sürüm(ler) arasında tutarlı bir şekilde kaliteyi ölçmek için değerlendirmeleri çalıştırın.

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 aracıları

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 temsilcinizin yalnızca ihtiyaç duyduğu erişime sahip olduğundan emin olun.

Ayrıntılar için bkz. Microsoft Foundry içinde Temsilci kimlik kavramları.

Güvenlik ve erişim

Aracı yapılandırmanıza uygulama kodu gibi davranın. Yaşam döngüsü boyunca sırları ve izinleri koruyun.

Temsilcinizi yayımlama

Memnun olduğunuz bir aracı 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 geçmez. Yayımladıktan sonra, aracı uygulamasının kimliğine gerekli ayrıcalıkları yeniden atayın.

Yaygın ajan geliştirme tuzağı

  • 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.
  • Silinen bir aracı kimliğini yeniden kullanıyor: Aracı silindiğinde aracı kimliği geçersiz kılınıyor. Silinmiş veya hiç oluşturulmamış kimlik dönüşlerine 404 Not Foundbaşvuran çağrılar. Daha önce geçerli bir kimlik için 404'e terminal olarak davranın. Aynı kimliği yeniden denemek yerine aracıyı yeniden oluşturun (veya get-or-create deseni kullanın). Silinen bir kimliğin sürekli yoklanması hiçbir zaman başarılı olmaz ve yalnızca hata trafiği oluşturur.

İlgili içerik

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

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

Aracıları yayımlama ve izleme:

Hata ayıklama ve değerlendirme:

  • Last updated on