Ana içeriğe geç

Custom Araç

Custom Araç, kendi aracınızı tanımlamanızı sağlar — bir dizi girdiye sahip adlandırılmış bir eylem ve ajan (veya akış) onu çağırdığında çalışan küçük bir fonksiyon. Yerleşik hiçbir araç uymadığında kullanın: özel iş mantığı, çok adımlı bir API çağrısı, bir hesaplama veya bir kez yazıp yeniden kullanmayı tercih edeceğiniz herhangi bir şey.

Aracı Flowera'nın Araçlar alanında bir kez oluşturur, ardından herhangi bir akışa eklemek için burada seçersiniz.

Bir akışa ekleme​

Araç node'un araç seçicisinde Custom Araç'u seçin, ardından Select Araç açılır menüsünden tanımladığınız araçlardan birini seçin.

Kurulum: önce aracı oluşturun​

Açılır menüde görünmeden önce, aracı Flowera'nın Araçlar alanında tanımlayın. Bir özel araç şunlara sahiptir:

  • Name — ajanın gördüğü ve çağırdığı ad (örn. check_inventory).
  • Açıklama — ajana onu ne zaman kullanacağını söyler. Bunu açıkça yazın; ajan böyle karar verir.
  • Schema — aracın kabul ettiği girdiler (ad, tür, zorunlu olup olmadığı). Ajan bunları doldurur.
  • Function — çalışan kod. Girdileri alır ve bir sonuç döndürür. Özel değişkenleriniz içinde kullanılabilir.
ipucu

Şema, aracı güvenilir kılan şeydir. Ajanın doğru değerleri sağlaması için her girdiye net bir ad ve açıklama verin.

Girdiler​

ParametreAçıklamaZorunlu
Select AraçKullanılacak özel araç (Araçlar alanında tanımlanmış).Evet
Return DirectAracın çıktısını ajana geri beslemek yerine doğrudan kullanıcıya geri gönderir.Hayır

Çıktılar​

Araç, fonksiyonunuzun döndürdüğü her şeyi döndürür. Tek çıktılı bir araçtır — akış bir sonraki node'a devam eder. Return Direct etkinken, çıktı yanıt olarak doğrudan kullanıcıya gider.

Örnek​

Bir ürün için stok kontrolü

  1. Araçlar alanında, tek bir sku girdisi (string, zorunlu) ve envanter API'nizi çağırıp sayıyı döndüren bir fonksiyonla check_inventory adlı bir araç oluşturun.
  2. Bir akışta, bir Agent node ekleyin ve ona check_inventory'yi seçerek Custom Araç'u verin.
  3. Bir müşteri "X stokta var mı?" diye sorduğunda, ajan aracı SKU ile çağırır ve sonuçla yanıtlar.

İpuçları​

  • Güçlü bir açıklama yazın. Ajan araçları açıklamalarına göre seçer — belirsiz açıklamalar aracın atlanmasına veya yanlış kullanılmasına yol açar.
  • Girdileri minimumda tutun. Daha az, iyi adlandırılmış girdiler, ajanın aracı doğru şekilde çağırmasını kolaylaştırır.
  • Return Direct'i kullanın araç zaten tam olarak kullanıcıya yönelik yanıtı ürettiğinde ve ajanın onu yeniden ifade etmesine gerek olmadığında.
  • Akışlar arasında yeniden kullanın. Bir kez tanımlanmış bir araç, her akışın Custom Araç açılır menüsünde görünür.

İlgili​