Entegrasyon Eylemi ve Araç Çağrısı adımları nasıl kurulur?

Ne işe yarar?

İki adım da asistanın bir noktasında dış bir sistemde iş yapar; ziyaretçi ikisini de görmez.

• “Entegrasyon Eylemi” bağladığınız bir entegrasyonun hazır bir eylemini çalıştırır (ör. Trello kartı açmak, Slack ya da Teams'e bildirim göndermek).
• “Araç Çağrısı” “Araçlar” sayfasında kendi sisteminiz için tanımladığınız bir aracı çağırır (ör. bir siparişin durumunu sorgulamak).

İkisinin de “Tamamlanınca” ve “Hata olursa” çıkışları vardır; “Hata olursa tekrar dene” ayarı ikisinde de aynı çalışır.

Entegrasyon Eylemi

Bu adım ziyaretçiye görünmez: akış burada bağlı bir entegrasyonun eylemini çalıştırır (ör. Trello kartı açmak, Slack ya da Teams'e bildirim göndermek) ve sonraki adıma geçer.

1. “Adım ekle” paletinde “Entegrasyonlar” kategorisini açın, entegrasyona tıklayın, ardından eyleme tıklayın; adım kanvasa eklenir.
2. Adım panelinde “Eylem”i kontrol edin ve alanları doldurun. Değerleri listeden seçebilir (“Listeden seç”) ya da kendiniz yazabilirsiniz (“Kendim yazacağım”); {degisken} ile önceki cevapları kullanabilirsiniz.
3. Eylemin sonucunu sonraki adımlarda kullanmak için “Değişkene yaz” bölümünden bir değişken adı verin. Değişkenler ziyaretçinin tarayıcısında durur; gizli kalması gereken değerleri seçmeyin.

Adımın iki çıkışı vardır: “Tamamlanınca” ve “Hata olursa”. Entegrasyon bağlı değilse ya da sağlayıcı hata verirse asistan “Hata olursa” koluna geçer. “Hata olursa” kolu boşsa konuşma bir sorun oluştu diye kapanır. Başarısızlıkta da devam etmesini istiyorsanız “Hata olursa”yı “Tamamlanınca” ile aynı adıma bağlayın. Zorunlu bir alan boşsa sağlayıcı hiç çağrılmaz; adım “Hata olursa” koluna geçer. “Adım notu” yalnız sizin içindir; ziyaretçi görmez.

Veri değiştiren bir eylem, ziyaretçi geri düğmesine bastığında ya da mesajı yeniden gönderdiğinde tekrar çalışmaz. Konuşma bu adımdan yeniden geçerse (ör. menüden geri dönülünce) yeniden çalışır.

Adım çalışırken ziyaretçi “Düşünüyor” yerine ne yapıldığını görür: işe uygun bir metin (“İşleminiz yapılıyor…”, “Bilgiler kontrol ediliyor…”); ekibe bildirim gibi iç işlerde yalnız “Bir saniye…”. Kendi metninizi “Beklerken gösterilecek metin” alanına yazabilirsiniz (ör. “Randevunuz oluşturuluyor…”); bu metin diğer dillere çevrilir.

Kalıcı silme ya da iptal yapan eylemler “Bu adımın geri alınamaz bir iş yaptığını biliyorum”, sizin hesabınızdan gönderim yapan eylemler “Bu adımın hesabımdan gönderim yaptığını biliyorum” onayı işaretlenmeden çalışmaz. Silme eylemleri saatte en çok 20, gönderimler saatte en çok 100 kez çalışır (çalışma alanı başına). Silinecek kaydın değeri ziyaretçinin cevabından gelemez.

Araç Çağrısı

“Araçlar” sayfasında tanımladığınız bir aracı asistanın tam bu noktasında, yapay zekâ kullanmadan çağırır. Ziyaretçi bu adımı görmez; adımın metni yalnız sizin notunuzdur.

1. Araç Çağrısı adımını ekleyin ve listeden aracı seçin.
2. Aracın alanlarına değer verin: sabit bir değer, önceki bir cevabın değişkeni (örneğin {siparis_no}) ya da önceki cevabın bir alanının yolu (örneğin {siparis.no}).
3. “Değişkene yaz” bölümünde cevabın tamamını ya da hata kodunu bir değişkene kaydedin; sonraki adımlarda {değişken} olarak kullanabilirsiniz.
4. “Tamamlanınca” ve “Hata olursa” kollarını bağlayın. Araç cevap vermezse ya da hata dönerse asistan “Hata olursa” koluna geçer. “Hata olursa” kolu boşsa konuşma bir sorun oluştu diye kapanır. Başarısızlıkta da devam etmesini istiyorsanız “Hata olursa”yı “Tamamlanınca” ile aynı adıma bağlayın.

Araç çalışırken ziyaretçi “Bilgiler kontrol ediliyor…” ya da “İşleminiz yapılıyor…” gibi bir metin görür (mağaza araçlarında “Ürünler aranıyor…” gibi işin kendisi). Kendi metninizi “Beklerken gösterilecek metin” alanına yazabilirsiniz.

Aracın Nesne alanlarının alt alanları ayrı kutularda doldurulur. Öğesi Nesne olan bir listede önce “Liste kaynağı”na bir liste değişkeni yazın (örneğin bir eylemin listesi ya da Liste Düzenle adımının sonucu), sonra “Her öğenin alanları”nda öğenin alanlarını eşleyin: {item.sku} gibi. Kaynağın her öğesi listede bir satır olur; eşlemeyi boş bırakırsanız öğeler olduğu gibi gider.

Veri değiştiren bir araç, ziyaretçi geri düğmesine bastığında ya da mesajı yeniden gönderdiğinde tekrar çalışmaz. Konuşma bu adımdan yeniden geçerse (ör. menüden geri dönülünce) yeniden çalışır. Veri okuyan araç ise ziyaretçi adıma her geldiğinde yeniden çağrılır.

Zorunlu bir alan boşsa ya da bir değer alanın tipine uymuyorsa araç çağrılmaz; adım “Hata olursa” koluna geçer. Tipine uymayan sabit değeri editör adımda uyarı olarak gösterir. Çağrılar “Araçlar” › “Çağrı istatistikleri” sayfasında görünür.

Hata olursa tekrar dene

Entegrasyon Eylemi ve Araç Çağrısı adımlarında “Hata olursa tekrar dene” ayarını açarsanız geçici bir hatada adım yeniden çalışır. Denemeler bitince akış “Hata olursa” kolundan devam eder; bu kol boşsa konuşma bir sorun oluştu diye kapanır.

• “Deneme sayısı”: 2 ile 5 arası; varsayılan 3.
• “Denemeler arası bekleme (sn)”: 0 ile 5 saniye arası; varsayılan 1.

Bütün denemeler en çok 18 saniye sürer; süre yetmezse kalan denemeler yapılmaz.

Yalnız geçici hatalar tekrar denenir: zaman aşımı, bağlantı hatası, sağlayıcının arızası ve hız sınırı. Yetki ya da eksik alan gibi hatalarda adım hemen “Hata olursa” koluna geçer.

Kayıt oluşturan ya da mesaj gönderen adımda dikkatli kullanın: zaman aşımında istek sağlayıcıya ulaşmış olabilir, aynı kayıt ya da mesaj iki kez oluşabilir.