Ana içeriğe geç

Araçlar

Araç, bir akışın söylediği değil yaptığı şeydir — bir siparişi sorgulamak, bir CRM kaydı oluşturmak, fiyat API'nizi çağırmak. Flowera yerleşik bir araç kataloğuyla gelir; Araçlar sayfası ise kendi araçlarınızı eklediğiniz yerdir.

Çalışma alanının araçlarını listeleyen Araçlar sayfası.

Çalışma Alanı aracı nedir​

Yerleşik araçlar (HTTP, Instagram, Zoho CRM ve kataloğun geri kalanı) her zaman kullanılabilir. Çalışma alanı aracı ise bir kez tanımlayıp akışlar arasında yeniden kullandığınız araçtır — adı olan, girdi şeması tarif edilmiş ve bir agent çağırdığında çalışan bir fonksiyon.

Şu durumlarda tanımlayın:

  • birden fazla akışın aynı işleme ihtiyacı varsa ve düzeltmeyi tek yerde yapmak istiyorsanız;
  • mantık tek bir HTTP çağrısından fazlaysa — doğrulama, birkaç istek, sonucu yeniden biçimlendirme;
  • bir agent'ın onu kullanmaya karar verebilmesini istiyorsanız; bu da net bir ad ve açıklama gerektirir.

Özel araç oluşturma​

Araçlar sayfasında Create düğmesine basın. Bir aracın dört şeye ihtiyacı vardır:

AlanNe işe yarar
Araç AdıModelin gördüğü tanımlayıcı. Küçük harf ve alt çizgi — get_order_status, tool2 değil
Araç açıklamasıEn önemli alan. Bir agent aracınızı çağırıp çağırmayacağına buradan karar verir. Ne yaptığını ve ne zaman kullanılacağını yazın
Girdi ŞemasıAracın kabul ettiği argümanlar; her biri için özellik adı, tür, açıklama ve zorunluluk
Javascript FonksiyonuÇalışan kod

Load bir araç tanımını dosyadan içe aktarır; JSON Yapıştır ise satır satır yazmak yerine girdi şemasını bir JSON parçasından doldurur. Araç çalıştıktan sonra Şablon Olarak Kaydet onu yeniden kullanım için mağazaya koyar — bkz. Şablonlar.

ipucu

Açıklamayı, kodu göremeyen bir okuyucu için yazın. "Bir siparişin güncel durumunu ve teslim tarihini sipariş numarasına göre sorgular. Müşteri siparişinin nerede olduğunu sorduğunda kullanın." cümlesi "sipariş aracı"ndan her zaman iyidir — ve bir agent'ın aracınızı kullanmasıyla görmezden gelmesi arasındaki fark budur.

Girdi şemasını tanımlama​

Her özelliğin bir adı, türü, açıklaması ve zorunluluk işareti vardır. Açıklama en az aracın kendi açıklaması kadar önemlidir: modele alana ne koyacağını söyleyen şey odur.

Bir sipariş durumu aracı için:

ÖzellikTürZorunluAçıklama
orderNumberstringevetMüşterinin sipariş numarası, örn. ORD-10432
includeHistorybooleanhayırYalnızca güncel durum yerine tüm durum geçmişini döndür

Listeyi kısa tutun. Her isteğe bağlı argüman, modelin yanlış tahmin etmesi için bir şans daha demektir.

Fonksiyonu yazma​

Fonksiyon gövdesi JavaScript'tir. Modelin verdiği argümanları, şema özelliklerinizin adını taşıyan $ önekli değişkenlerle alır; döndürdüğü şey de aracın sonucu olarak agent'a verilir.

const res = await fetch(`https://api.acme.co/v1/orders/${$orderNumber}`, {
    headers: { Authorization: `Bearer ${$vars.acmeApiKey}` }
})

if (!res.ok) {
    return `Sipariş ${$orderNumber} bulunamadı.`
}

const order = await res.json()
return `Durum: ${order.status}. Tahmini teslim: ${order.eta}.`

Edinmeye değer iki alışkanlık:

  • Tüketici bir agent olduğunda ham JSON değil düz metin döndürün. Modelin sonucu okuması gerekir; bir cümle üzerinde akıl yürütmek iç içe bir nesneden kolaydır.
  • Başarısızlık durumunu açıkça ele alın. "Sipariş bulunamadı" işe yarar bir yanıttır. Bir istisna değildir — agent'ın sorunu açıklamasına izin vermek yerine çalıştırmayı bitirir.

Çalışma alanı değişkenlerine $vars.<ad> ile başvurun; böylece anahtarlar ve adresler kodun dışında kalır.

Araç içe ve dışa aktarma​

Araçlar JSON olarak taşınır. Araçlar sayfasındaki Load bir tanımı dosyadan okur; hesap menüsündeki Dışa Aktar / İçe Aktar ise araçlar dahil bütün çalışma alanlarını Flowera kurulumları arasında taşır.

Bunu bir aracı yeniden yazmadan hazırlık ortamından üretime terfi ettirmek için kullanın.

Akışta araç kullanma​

İki yol var ve aradaki fark önemli:

  • Araç node — akış aracı sabit bir noktada, sizin eşlediğiniz argümanlarla çağırır. Belirlenimcidir: her seferinde tam olarak yapılandırdığınız gibi çalışır.
  • Agent node — araç agent'ın listesine eklenir ve onu çağırıp çağırmayacağına, ne zaman ve hangi argümanlarla çağıracağına agent karar verir.

Adım her hâlükârda gerçekleşmeliyse Araç node'unu seçin. Müşterinin ne söylediğine bağlıysa Agent'ı seçin.

İlgili​