Döngü adımı nasıl kurulur?

Ne işe yarar?

“Döngü” bir listenin her öğesi için aynı adımları çalıştırır. Adımın iki çıkışı vardır: “Her öğe için” ve “Bitince”.

Ziyaretçi bu adımı görmez, avatar bir şey söylemez; asistan ziyaretçiyi beklemeden devam eder.

Adımı eklemek için “Akış” sekmesinde “Adım ekle”ye basın ve “Mantık” kategorisinde “Döngü”ye tıklayın; adım kanvasın ortasına eklenir. Ayarları, adıma tıklayınca sağda açılan adım panelinin “İçerik” sekmesindedir.

Bu adımda “Ekranda görünen metin” yoktur; panelin en altında “Adım notu” durur. Not yalnız sizin içindir: ziyaretçi görmez, seslendirilmez ve çevrilmez.

Değerlere önceki adımlardan değişken yazarsınız: {sehir} gibi. Bir cevabın içindeki alan için alanın adını noktayla ekleyin: {siparis.durum}. Kutulardaki “Değişken ekle” düğmesi o noktada kullanabileceğiniz değişkenleri listeler. Henüz dolmamış bir değişken boş metin sayılır.

Adımı kurmak

1. “Öğeler nereden gelsin” listesinden kaynağı seçin ve öğeleri girin (aşağıda).
2. “Değişken adı”nı verin (ör. hizmet). Her turda o turun öğesi bu değişkene yazılır.
3. Her öğe için çalışacak adımları “Her öğe için” çıkışına bağlayın. Koldaki son adımın çıkışını boş bırakın: kolun ucu bitince sıradaki öğeye geçilir. İsterseniz son adımı Döngü adımına kendiniz de bağlayabilirsiniz.
4. Öğeler bitince gidilecek adımı “Bitince” çıkışına bağlayın.

Öğelerin kaynağı

• “Değişkendeki liste”: “Liste” kutusuna bir liste değişkeni yazın: çoklu seçimin cevabı, bir aracın ya da eylemin listesi ya da Liste Düzenle'nin sonucu.
• “Elle yazılan öğeler”: her satır bir turdur; satırları “Öğe ekle” ile eklersiniz. Satırlarda değişken de kullanılabilir.
• “Sayı aralığı”: “Başlangıç”, “Bitiş” ve “Artış” (boşsa 1). Bitiş dahildir; geriye saymak için artışı eksi yazın (-1). Değerler değişken de olabilir: {kisi_sayisi}.
• “Metni parçala”: “Metin” “Ayırıcı”dan bölünür: “Virgül”, “Noktalı virgül”, “Her satır”, “Dikey çizgi (|)” ya da “Başka” (kendi karakteriniz). Her parça bir turdur; boş parçalar atlanır. “Boşlukları kırp” parçaların başındaki ve sonundaki boşlukları atar.

Her turda yazılan değişkenler

Değişken adı hizmet ise her turda şunlar yazılır: {hizmet} turun öğesi, {hizmet.alan} öğenin bir alanı, {hizmet_index} kaçıncı tur, {hizmet_total} öğe sayısı, {hizmet_last} son tur mu (true/false). Döngü bitince bu değişkenler silinir. “Sayaç kaçtan başlasın” {hizmet_index}'in ilk turdaki değerini (varsayılan 1), “En çok tur” işlenecek en fazla öğe sayısını belirler; sayı aralığında bu iki ayar yoktur.

Turlar ve koldaki adımlar

Bir döngü en çok 100 tur çalışır; listenin fazlası işlenmez. Liste boşsa asistan doğrudan “Bitince”ye geçer. Koldaki bir adımı “Bitince”den sonraki bir adıma bağlarsanız asistan döngüden erken çıkar; kolda bir Bitiş adımı varsa konuşma orada biter. Döngü içinde döngü de kurulabilir: içteki döngünün “Bitince” çıkışı boşsa dıştaki döngünün sıradaki öğesine geçilir.

Kola ziyaretçinin gördüğü adımlar da (Mesaj, Soru, Form) koyabilirsiniz. Koldaki bir Entegrasyon Eylemi ya da Araç Çağrısı her turda ayrı çalışır: “her öğe için kart aç” her öğe için bir kart açar. Koldaki bir sorunun cevabı her turda aynı değişkene yazılır; yeni turun cevabı öncekinin yerini alır.

Örnek

Ziyaretçi “Çoklu” bir Seçim adımında ilgilendiği hizmetleri işaretledi; cevap {hizmetler} değişkeninde. Döngüde “Öğeler nereden gelsin” “Değişkendeki liste”, “Liste” {hizmetler}, “Değişken adı” hizmet. “Her öğe için” çıkışındaki bir Entegrasyon Eylemi her hizmet için ekibinize ayrı bir bildirim gönderir (“{hizmet} için yeni başvuru”); “Bitince” çıkışı bir teşekkür Mesajına gider.

Dikkat edilecekler

Editör şu durumlarda uyarır: öğeler belirtilmemişse; sayı aralığı geçersizse (başlangıç, bitiş ve artış sayı olmalı, artış 0 olamaz); değişken adı geçersizse (en çok 50 karakter); “Her öğe için” bağlı değilse (döngü hiçbir şey çalıştırmaz) ya da “Bitince” bağlı değilse (öğeler bitince akış kapanır). Koldaki adımların boş çıkışları için uyarı çıkmaz: o çıkışlar döngüye döner.

Değişken adında yalnız a–z harfleri, rakam ve alt çizgi (_) kullanılır; ç, ğ, ı, ö, ş, ü ve boşluk yazarken kutudan düşer. “system” adı sistem değişkenlerine ayrılmıştır; başka bir ad verin.

Mantık adımları ziyaretçiyi beklemez. Onları (ya da Mesaj, Araç Çağrısı, Entegrasyon Eylemi gibi beklemeyen adımları) birbirine bağlayıp bir halka kurarsanız asistan durmadan döner: editör “Ziyaretçiyi beklemeyen bir döngüde; akış burada takılır.” diye uyarır, konuşmada da asistan hatayla kapanır. Bir işi tekrarlamak için Döngü adımını kullanın ya da halkaya ziyaretçiyi bekleyen bir adım (Soru, Seçim, Form) koyun.

Eksikler kaydetmeyi engellemez: asistan kaydedilir, ama eksik adım konuşmada beklendiği gibi çalışmaz. İşaretli adımları düzeltin, sonra asistanı “Önizle” ile deneyin. Sorunlu adımları bulmak için bkz. Akış editörü.