Ajan yürütücüsünü uygulamak

  • 5 dakika

Aracı Yürütücüsü, A2A aracısının temel bileşenidir. Aracınızın gelen istekleri nasıl işlediğini, yanıtlar oluşturup istemcilerle veya diğer aracılarla nasıl iletişim kuracağı tanımlar. Bunu A2A protokolüyle aracınızın özel iş mantığı arasındaki köprü olarak düşünün.

Aracı Yürütücüsü'ni anlama

Arabirim, AgentExecutor aracınıza gönderilen tüm gelen istekleri işler. İstek hakkında bilgi alır, aracının özelliklerine göre işler ve yanıtları veya olayları bir iletişim kanalı üzerinden geri gönderir.

Önemli sorumluluklar:

  • Kullanıcılar veya diğer aracılar tarafından istenen görevleri yürütür.
  • Yanıtları akışla aktarın veya tek tek iletileri istemciye geri gönderin.
  • Destekleniyorsa görev iptali ele alınmalıdır.

Arabirimi uygula

Aracı Yürütücüsü genellikle iki birincil işlemi tanımlar:

Yürütmek

  • Gelen istekleri işler ve yanıtlar oluşturur.
  • İstek ayrıntılarına (örneğin, kullanıcı girişi, görev bağlamı) erişir.
  • İletiler, görev güncellemeleri veya belgeler içerebilen bir olay kuyruğu aracılığıyla sonuçları geri gönderir.

İptal

  • Devam eden bir görevi iptal etme isteklerini işler.
  • Basit aracılar için desteklenmeyebilir.

Yürütücü gelen isteği anlamak için RequestContext ve sonuçları veya olayları istemciye geri iletmek için bir EventQueue kullanır.

İstek işleme akışı

"Hello World" aracı iş akışını göz önünde bulundurun:

  1. Aracının temel mantığını uygulayan küçük bir yardımcı sınıfı vardır (örneğin, bir dize döndürür).
  2. Yürütücü bir istek alır ve aracının mantığını çağırır.
  3. Yürütücü, sonucu bir olay olarak sarmalar ve olay sırasına yerleştirir.
  4. Yönlendirme mekanizması olayı istek sahibine geri gönderir.

İptal için, basit bir aracı yalnızca iptalin desteklenmediğini belirtebilir.

Aracı Yürütücüsü, A2A aracınızı işlevsel hale getirmek için merkezi bir unsurdur. Aracının görevleri yürütme ve sonuçları iletme şeklini tanımlar ve istemciler ve diğer aracılar için standartlaştırılmış bir arabirim sağlar. Düzgün uygulanan yürütücüler, çok aracılı iş akışlarında sorunsuz tümleştirme ve işbirliği sağlar.