Microsoft Agent Framework İş Akışları Düzenlemeleri - Döngüde İnsan

Tamamen otonom aracılar güçlü gibi görünse de, pratik uygulamalar genellikle devam etmeden önce kritik kararlar, onaylar veya geri bildirimler için insan müdahalesi gerektirir.

Tüm Microsoft Agent Framework orkestrasyonları İnsanın İşlemde Bulunduğu Süreç (HITL) özelliklerini destekleyerek iş akışının belirlenen noktalarda duraklamasına ve bir insan kullanıcıdan giriş istemesine olanak tanır. Bu, aşağıdakileri sağlar:

1. Hassas eylemler insanlar tarafından gözden geçirilip onaylanarak güvenlik ve güvenilirliğin artırılması sağlanır.
2. İnsanların aracı davranışına yol gösterip sonuçları geliştirebileceği bir geri bildirim döngüsü vardır.

Önemli

"Handoff düzenlemesi, kapsamlı insan etkileşimi gerektiren karmaşık çoklu ajan senaryoları için özel olarak tasarlanmıştır." Bu nedenle HITL özellikleri diğer düzenlemelerden farklı şekilde tasarlanmıştır. Ayrıntılar için Handoff Orkestrasyonu belgelerine bakın.

Önemli

Grup sohbeti tabanlı orkestrasyonlarda (Grup Sohbet ve Eflatun), orkestratörün uygulamasına bağlı olarak gerektiğinde insan geri bildirimi ve onayları da isteyebilir.

Döngüdeki İnsan Nasıl Çalışır?

İpucu

HITL işlevi, Microsoft Agent Framework iş akışlarında mevcut istek/yanıt mekanizmasının üzerine kurulmuştur. Bu mekanizmayı bilmiyorsanız lütfen önce İstek ve Yanıt belgelerine bakın.

Çok yakında...

HITL bir orkestrasyonda etkinleştirildiğinde, with_request_info() üzerindeki ilgili oluşturucu yöntemi aracılığıyla (örneğin, SequentialBuilder), ajan katılımcılar için insan etkileşimini kolaylaştırmak amacıyla bir alt iş akışı oluşturulur.

Sıralı düzenlemeyi örnek olarak alın. HITL olmadan, ajan katılımcılar doğrudan sıralı işlem hattı sürecine entegre edilir:

HITL etkinleştirildiğinde, aracı katılımcıları bir döngüdeki insan isteklerini ve yanıtlarını işleyen bir alt çalışma akışına takılıdır:

Bir aracı bir çıkış ürettiğinde, çıkış doğrudan sonraki aracıya veya düzenleyiciye gitmez. Bunun yerine, AgentRequestInfoExecutor öğesine alt çalışma akışında gönderilir; çıktıyı istek olarak gönderir ve AgentRequestInfoResponse türünde bir yanıt bekler.

Devam etmek için sistemin (genellikle bir insan kullanıcı) isteğe bir yanıt sağlaması gerekir. Bu yanıt aşağıdakilerden biri olabilir:

1. Geri bildirim: İnsan kullanıcı, aracının çıktısı hakkında geri bildirim sağlayabilir ve daha sonra daha fazla iyileştirme için aracıya geri gönderilir. AgentRequestInfoResponse.from_messages() veya AgentRequestInfoResponse.from_strings() aracılığıyla oluşturulabilir.
2. Onay: Aracın çıktısı insan kullanıcının beklentilerini karşılıyorsa, kullanıcı, alt çalışma akışının aracın yanıtını çıkarmasına ve üst iş akışının devam etmesine izin vermek için bunu onaylayabilir. aracılığıyla AgentRequestInfoResponse.approve() oluşturulabilir.

İpucu

Aynı işlem Eşzamanlı, Grup Sohbeti ve Manyetik düzenlemelerde de geçerlidir.

Yalnızca aracıların bir alt kümesi için HITL'yi etkinleştirme

Çok yakında...

çağrısı with_request_info()yaparken aracı kimliklerini belirterek düzenlemedeki aracıların yalnızca bir alt kümesi için HITL'yi etkinleştirmeyi seçebilirsiniz. Örneğin, üç aracı ile sıralı düzenlemede HITL'yi yalnızca ikinci aracı için etkinleştirebilirsiniz:

builder = (
    SequentialBuilder()
    .participants([agent1, agent2, agent3])
    .with_request_info(agents=[agent2])
)

HITL ile İşlev Onayı

Aracılarınız insan onayı gerektiren işlevleri (örneğin, ile @ai_function(approval_mode="always_require")süslenmiş işlevler) kullandığında, HITL mekanizması işlev onay isteklerini iş akışıyla sorunsuz bir şekilde tümleştirir.

İpucu

İşlev onayı hakkında daha fazla bilgi için İşlev Onayı belgelerine bakın.

Aracı böyle bir işlevi çağırmaya çalıştığında bir FunctionApprovalRequestContent istek oluşturulur ve onay için insan kullanıcıya gönderilir. Başka bir yol yoksa iş akışı duraklatılır ve kullanıcının kararını bekler. Kullanıcı daha sonra işlev çağrısını onaylayabilir veya reddedebilir ve yanıt uygun şekilde devam etmek için aracıya geri gönderilir.

Sonraki Adımlar

HITL'yi çalışırken görmek için Microsoft Agent Framework GitHub deposundaki örneklerimize gidin.